Mums and Dads Portal (MaD)

Contributing to the project

To start contributing you first need to fork this repository. It is not possible to clone and commit changes to the main repository. If you dont feel confident with using git then find out more here.

If you don't know what to start working on then have a look at the Issues tab in the repository and have a got at solving one of the tasks. If you have any questions feel free to contact any of the frequent contributors or ask in our slack, we are here to help you get started.

Setting up virtual environment (Recommended)

Virtual environment is where all libraries used in this project will be installed. It is not required to use one but its generally good practice to use one to avoid issues when different projects use different library versions. Find out more here.

Please also note that this project uses Python 3.6, if you have multiple versions of Python running on your computer, you may want to tell virtualenv this fact by issuing "virtualenv -p python3.6 .env" instead of "virtualenv .env" later down this document.

PyCharm

If you are using PyCharm there is no need to do this manually. Find out more here.

Command Line

pip install virtualenv
virtualenv .env

If you are running a POSIX-based operating system (i.e. Linux, macOS) with bash:

source .env/bin/activate

else try:

source .env/Scripts/activate

Installing dependencies

pip install -r requirements.txt

Setting up local config and database

Secret and local information should not be uploaded to git that is why you should NEVER commit config.py. Instead make a copy of sampleconfig.py and save it as config.py. Make changes if need be.

The database should not be pushed to git either because it will contain local data instead you should make a copy of sampledb.sqlite3 and save it as db.sqlite3.

Creating required database

Execute this operation every time you pull updates from the repository. This command updates your database to reflect the changes made.

python manage.py migrate

Loading static data - fixtures (Recommended)

This will load static data like questions for the parents/children. It is useful to see how the website will look with data.

python manage.py loaddata portal.json

Running the server

./manage.py runserver 8000

Testing

Before submitting a pull request run all tests to make sure you have not broken any functionality. To run tests use the following command.

./test.sh

Login

After entering your username in the login screen a popup will tell you that you will receive an email with a confirmation link (not yet implemented). Instead look into the console log of the server (or admin page) to get the activation link.

Continuous Integration (Recommended)

This project is compatible with Circle CI. We would encourage you to set up Circle CI for your forked repository to make sure you do not submit a pull request which does not pass all test. Find out more here.

Project Specification

Goals

• Automatic assignment of children and parents
• Remove bias when assigning
• Children should be assigned ASAP after registration so that they can ask their parents for advice

Features:

• Distinct pages for child and parent signup
• Parents can select a partner
  • The second person receives an email invitation to confirm and fill in details
• Both people have to fill in basic information
• Should parents be forced to log in using college details?
  • If not then should it be possible to change information after submission?
    • Generate some access link with unique id to access profile
• Assign all unregistered children after deadline
• Email notifications after child/parent assignment