Drinks Touch

Digital replacement for the drinks tally list featuring a touchscreen, user management and a barcode scanner.

Table of Contents

1. Development
   • Build
   • Configuration
   • Deployment
2. Profiling
3. License

Development

Start dependencies like Postgre and keycloak with:

docker compose -f docker-compose.dev.yml up

• Mailpit: http://localhost:8025/
• Keycloak: http://localhost:8080/
• Webapp: http://localhost:5002/
  • Not part of compose; Requires game.py to be running

The project is using poetry. Install the dependencies with:

poetry install

To start the application, run:

FULLSCREEN=0 poetry run python drinks_touch/game.py

There are more environment variables available. Checkout the drinks_touch/config.py file for more information.

---

Python pre-commit helps to detect and fix common issues before committing. Install the git hooks with:

pre-commit install

It is also being run in the CI pipeline. If you see any rules that don't make sense for us, feel free to adjust the .pre-commit-config.yaml file or comment out invocation in the ci.yml file.

This project is deployed within the drinks-touch_stack in accordance to the DargStack template to make deployment a breeze.

The provided Dockerfile lets you build a localized Python image. Build it with the following command:

docker build -t flipdot/drinks-touch .

The following information is therefore only useful if you decide to deploy this project containerless.

Build

This project does not require any build procedure.

Configuration

The following configuration files are evaluated at execution time and must be derived from their respective examples, which can be found in the same directories.

• drinks_touch/config.py

Deployment

Dependencies

• LDAP server, reachable via ldap://rail/ (see users.py)
• PostgreSQL @localhost (see storage.py)
• touch display with a minimum of 480x800 px.

Install dependencies like this:

sudo apt-get install libsasl2-dev python-dev libldap2-dev libssl-dev
pip2 install -r requirements.txt

Then, start PostgreSQL and OpenLDAP with systemctl start. And finally, run the entrypoint script drinks_touch/game.py.

For embedded systems it is recommended to use @reboot runGame.sh inside a cron tab. This starts an X server, sets various display properties and puts the application itself in a loop.

Profiling

To profile the time individual lines of code take to execute install line_profiler.

pip install line_profiler

Then add @profile to the methods you are interested in.

Inside drinks_touch, run with

kernprof -l game.py

And analyze results with

python -m line_profiler game.py.lprof | less