documented helper.py and db.py