Adult participant administration system, written in Django.
This Django project is part of a two-application system used to keep track of adult participants, experiments and appointments for the ILS Labs.
This project represents the frontend application, which is used by experiment leaders and participants.
- Python 3.9+ (3.8 might work, untested)
- Pip (for installing dependencies, see requirements.txt for details)
- A WSGI capable web server (not needed for development)
- A SQL database (tested with SQLite and MySQL)
For production/acceptation deployment, please see our Puppet script. (Hosted on our private GitLab server).
Development instructions:
- Configure a working backend first!
- Clone this repository
- Install the dependencies using pip (it is recommended to use a virtual
environment!).
pip install -r requirements.txt - Edit
ppn_backend/settings.pyto suit your needs. (Make sure you update the backend location setting to your local setup!) - Run all DB migrations
python manage.py migrate - Compile the translation files using
python manage.py compilemessages - You can now run a development server with
python manage.py runserver
The frontend does need a running backend to talk to! Otherwise it will be very unhelpful towards you.
We use pip-tools to manage our dependencies (mostly to freeze the versions used). It's listed as a dependency, so it will be installed automatically.
requirements.in lists the actual dependency and their version constraints.
To update requirements.txt just run pip-compile -U. Don't forget to test
with the new versions!