This is a project that allows students to apply for sponsorships, which is received by staff who then approves or rejects the application based on some merit. When a sponsorship is approved, the sponsor can then be able to see a list of approved applicants. The sponsor can then choose to sponsor the applicant.
The application is built using Python programming language and the Django framework with database being Postgres. At the current state the project is only tested with python version 3.6.
Running the application
$ git clone https://github.com/silaskenneth/sponsorship.git
$ cd sponsorship
$ python -m virtualenv env
$ source env/bin/activate #For unix systems
$ .\env\bin\activate.bat # For windows systems.
Copy the .env.example
file into a .env
file and edit the credentials to match your credentials.
Note:
EMAIL_HOST_USER
,your email address, is used for sending emails so it is required.EMAIL_HOST_PASSWORD
, the password for the email address is used to authenticate with the mailing server toNote
For Google Mail, you are required to follow the procedure in the link to enable less secure apps to send emails for now.
Install application dependencies.
pip install -r requirements.txt
python manage.py migrate
python manage.py runserver
127.0.0.1:3000
in your browser to view you application.The application API is almost done, what is remaining is linking up things to work together.
In developing Software, one of the core things is writing automated tests to test your application for possible errors not just limited to logic errors, the application is not tested at the current state.
Another thing that is missing is that most of the package version are never locked especially, the ones that are dependencies of the installed packages. Adding a Pipefile to make sure dependencies are locked would be the best idea.