A student representatives website. This project is live! You can see a working instance of 1327 here!
To be able to contribute to 1327, one needs to get the source code with all dependencies. Please note, that submodules for bootstrap, font-awesome and bootstrap-markdown are in use:
git clone https://github.com/fsr-itse/1327.git cd 1327 git submodule update --init
Freshly created code needs to be tested - besides our use of unit tests, linting and continous integration, it is possible to run the application in a non-production environment using Vagrant or a Virtual Environment.
One can simply set up an execution environment using
vagrant up --provision
At that point, one created a vagrant box, running a PostgreSQL database server, Apache web server and the Django application. The contents are available on the default port
8000, which allows one to access the website at
http://localhost:8000. To create a new superuser for the application, execute
vagrant ssh in the project directory and trigger the django user management system:
./manage.py createsuperuser --username=root
Another way of executing this django application is the use of a virtual python environment. This way bypasses the needs for a virtual machine and simplifies the life with multiple python versions installed:
virtualenv -p /usr/bin/python3 env source env/bin/activate pip install -r requirements.txt python manage.py migrate python manage.py createsuperuser --username=root python manage.py runserver 0.0.0.0:8000
For deploying on a single machine 1327 you'll need to install all requirements from
requirements-deploy.txt, and you can follow these instructions, for setting up a webserver and starting all scripts using a Process Control System, if you like.
The software is licensed under the terms of the MIT license. Please note, that non-MIT-licensed contents might be part of this repository.