Verleihtool

The Verleihtool helps with the administration of public depots and allows users to send rental requests for items in this depots. It also supports to assign managers for each depot and group them into several organizations.

This project uses Semantic Versioning and the latest releases can be found here.

Development

Setting up Vagrant

The development of the Verleihtool happens via Vagrant and preferably with the VirtualBox provider. After installing these components, invoking vagrant up from the project's directory will create the virtual machine and run the provisioner on it. When the process is finished, one can login to the machine using vagrant ssh. In case the provision script gets updated afterwards, the command vagrant provision will update the virtual machine accordingly.

Starting the tool

To install the dependencies, run pip install -r requirements.txt and npm install from the /vagrant directory in the virtual machine. On a Windows host, the parameter --no-bin-links is most likely required. Afterwards, apply all migrations using the command python manage.py migrate.

To generate the JavaScript and CSS files, enter npm run dev or alternatively npm run watch-poll if the script should automatically detect changes to the source files. The translation files can be updated from source files with the command python manage.py makemessages -l <lang>. This will update all messages in the django.po files which can be found in the locale directory.

Finally, the server can be started using the provided script in the home directory of the vagrant user called server.sh. The tool can then be reached at http://127.0.0.1:1337/.

To create a superuser, execute the command python manage.py createsuperuser in the /vagrant folder and follow the process.

Running the tests

The Verleihtool comes with a full test suite that can be run using the command python manage.py test. This will not touch the existing database but create a new test database every time. To run the lint script, execute flake8 from the /vagrant directory.

Alternatively, when using vagrant a test.sh script is provided to automate the steps described above.

Deployment

The Verleihtool requires Python 3.6 to be installed on the server as well as a database backend that is supported by Django. The web server must be configured to access static files from the static directory of this project. for more information, please consult the Django manual for deployments.

Before each deployment, the resource files have to be generated either on the production server or on another device using the npm run production command. This will place the minified JavaScript and CSS files in the static directory.

To create the optimized translation files, a call to python manage.py compilemessages is required whenever the translations are updated.

Credits

The Verleihtool was written as a Projektarbeit for the Fachschaft MPI at TU Munich during winter semester 2016/17 by Benedikt Seidl, Florian Stamer, Stefan Su and Leo Tappe.