Reservation system with modifiable bookables and timeslots. Make sure that you have Python 3 and pip installed and virtualenv to go with it.

Install prerequisites

sudo apt install virtualenv python3 python3-pip libsasl2-dev python3-dev libldap2-dev libssl-dev

cd into the fars directory and do the following:

Create virtualenv

virtualenv -p /usr/bin/python3 venv

Activate venv\

source venv/bin/activate

Install prerequisites with pip

pip install -r requirements.txt

Run migrations

python fars/manage.py migrate

Now you can run the dev instance

python fars/manage.py runserver

View the page in your browser: http://localhost:8000

Create a superuser account

python fars/manage.py createsuperuser

Use this account to log in on the adminsite

http://localhost:8000/admin

This adminpanel is where you will do all top-level administrating such as creating bookables, adding users (if you don't have another database for that) and choosing which users are admins over which bookables. This is about all setup you need to start using the system.

The top-level admins are able to access the admin site where they manage bookables, bookablespecific admins and other users. They are also able to remove any booking from any bookable as well as making bookings that don't follow the restrictions of the bookable, e.g. very long bookings and bookings that are far in the future. Bookablespecific admins have the same powers over bookings but only regarding the bookable they are admins for.

Logged in users can view the different bookables in the system and make bookings for them. They can also unbook their own bookings.

Bookables can however be configured to be restricted to a certain group, in which case only users part of that group (and administrators of course) can make bookings for it. Other authenticated users can still view the bookings.

Bookables can also be configured to be hidden, in which case only users that are allowed to make bookings for it can view the bookings. This only comes into play if a bookable is restricted to a certain group, since normally every logged in user can make bookings for all bookables.

Users that haven't logged into the site can only view the bookables that are public. All other functionality requires them to log in.

If your bookable requires any kind of metadata to be attached to each booking, simply create a standard django form in fars/booking/metadata_forms.py, then add it to the METADATA_FORM_OPTIONS and METADATA_FORM_CLASSES dicts. The data will be stored in the booking's metadata field.

• Django - The web framework used
• FullCalendar - Javascript plugin used for the calendar

• Thomas Langenskiöld
• Castor Köhler

This project is licensed under the MIT License - see the LICENSE file for details