Happy Project is a non-profit initiation founded by IT people from Jaffna, Sri Lanka. This is to help students in need and couldn't get hold of it. This project is originally targeted towards Sri Lankan Students, but people from other region also, with few alteration to the source code.

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. Refer deployment section for deployment process. It is recommended to create an isolated environment as Happy Project uses latest, pre-release versions to stay future-proof

All the backend and necessary prerequisites are mentioned in requirements.txt. They are mostly...

django **4.0**
django-storages
whitenoise
gunicorn
django-heroku
psycpg

1. Create a dev env

python3.10 -m venv env
pip3.10 install -r requirements.txt

2. Populate the environment variables

Edit the .env file accordingly and especially the SECRET_KEY

3. Migrate

# not neccessary to indicate python3.10 as the env is already created with python3.10
# it is assumed that the current working dir is the root dir

python manage.py migrate

Please if someone can, write tests and create a pull request

Originally, Happy Project is deployed as webapp in Heroku. Hence, you will see Procfile; runtime.txt; etc. But the source itself can be hosted anywhere that can run django apps.

In the future, it is anticipated that a desktop(offline) version can be supported via APIs

Happy Project uses SemVer for versioning.

• Shanthosh - Initial work - Happy-Project
• Birnadin E. - Code Authoring - Birnadin Erick

This project is licensed under the Apache 2.0 License - see the LICENSE.md file for details

Hope this will help you one way or the other