68 lines
1.6 KiB
Markdown
68 lines
1.6 KiB
Markdown
# eva
|
||
|
||
A simple tool for on- and offboarding people in a mid sized organisation.
|
||
|
||
"EVA" is an german acronym for "Eintritt, Veränderung, Austritt",
|
||
meaning "Onboarding, Change, Offboarding"
|
||
|
||
# development
|
||
|
||
- install gettext for instance via "apt install gettext" for translations
|
||
|
||
- set up a virtual environment with virtualenvwrapper or some other
|
||
environment managing tool
|
||
|
||
- use this environment and do
|
||
|
||
pip install django django-multiselectfield django-formtools django-allauth requests whitenoise
|
||
|
||
- clone this repository
|
||
|
||
- ln -sr eva/settings_development.py eva/settings.py
|
||
|
||
- initialise your database with
|
||
|
||
python manage.py migrate
|
||
|
||
- You need to add oauth information in the django backend via .../admin in "Social Accounts"
|
||
|
||
python manage.py createsuperuser
|
||
|
||
- start your development server with
|
||
|
||
python manage.py runserver
|
||
|
||
- Configure OAuth:
|
||
|
||
Access the admin interface at http://127.0.0.1:8000/admin
|
||
Login with your superuser credentials
|
||
Go to ‘WEBSITE ANZEIGEN’
|
||
|
||
# production
|
||
|
||
- you can use gunicorn as server for example instead of the django development server.
|
||
|
||
- we use whitenoise for serving static files
|
||
|
||
- we still use the development SQLITE database from django
|
||
|
||
do the following in the project main directory:
|
||
|
||
ln -sr eva/settings_production.py eva/settings.py
|
||
|
||
edit /secrets.json to contain something similar to
|
||
|
||
{
|
||
"SECRET_KEY": "THIS IS ANOTHER SECRET!"
|
||
}
|
||
|
||
run the following commands:
|
||
|
||
python3 manage.py migrate
|
||
python3 manage.py collectstatic
|
||
django-admin compilemessages
|
||
|
||
server starts with
|
||
|
||
export PYTHONUNBUFFERED=TRUE; nohup gunicorn --forwarded-allow-ips="*" -b '0:8000' eva.wsgi &> logfile &
|