README.md

   1 # IID Coffee Terminal
   2
   3 This repo contains git submodules with all source code of this coffee
   4 terminal. Fetch it with:
   5
   6         git submodule update --init
   7
   8 The `coffee-flask`  directory contains the server application, which
   9 runs on [rtime](https://rtime.felk.cvut.cz/coffee) server.
  10
  11 `terminal` directory is the code running on the terminal. It is a
  12 standard buildroot distribution. The most importat piece of code here
  13 is the `mtaio` application from `terminal/src/mt-apps`.
  14
  15 A more detailed documentation is available in [Jiří Matěják's Master
  16 thesis](https://dspace.cvut.cz/handle/10467/76276).
  17
  18 ## Collected data
  19
  20 Data collected by the terminal are stored in an sqlite database on the
  21 rtime server. Users with SSH access to that server have read-only
  22 access to the database. For example, the whole database can be dumped
  23 with this command:
  24
  25     sqlite3 /home/coffee/coffee-flask/coffee.db .dump
  26
  27 ## Hacking on the code
  28
  29 To improve the terminal, you can run all the relevant code on your
  30 Linux computer.
  31
  32 First install all prerequisities:
  33
  34     apt install python3-flask libev-dev cmake
  35         pip3 install flask_cors
  36
  37 Then compile and run all the software components:
  38
  39 1. Compile _mtaio_ simulator: `make -C terminal/src/mt-apps SIM=1`
  40 2. Run mtaio: `cd terminal/src/mt-apps && ./build/mtaio`
  41 3. Run the server application: `cd coffee-flask && FLASK_APP=app.py flask run`
  42 4. Point your web browser to http://localhost:8080/
  43 5. Pressing keys in _mtaio_ window simulates various activities.
  44    Numbers are cards of different users, letters A through F are
  45    different coffee machine buttons.