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 either game.py or webapp.py to be running

The project is using poetry. Install the dependencies with:

poetry install

Initialize the database. Needs to be run again after the data model has changed:

alembic upgrade head

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.

Changing the database model

If you do changes to the database, you need to create a migration:

alembic revision --autogenerate

Check the migration file. It is located in alembic/versions/. If everything is fine, apply the migration like described above.

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

• Keycloak server, (see oidc.py)
• PostgreSQL @localhost (see storage.py)
• touch display with a minimum of 480x800 px.

Install dependencies like this:

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

Then, start PostgreSQL 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