Infrastructure needed to bring up an instance of quicktill.tillweb,
plus the public-facing web pages for https://bar.emf.camp/
This is the EMF-specific fork of the project and contains assumptions about how the EMF till is configured. There is a separate repo for the generic version of the project here.
The infrastructure code in tillweb/config has been modified as
little as possible. Most EMF-specific code is in emf/
You need poetry and npm installed. You need a postgresql database available.
The package reads ~/.config/emftillweb.toml at startup. Example
suitable for development:
[django]
time_zone = "Europe/London"
[till]
database_name = "emfcamp"
currency_symbol = "£"
site_name = "EMF Bars"
To set up a development environment, ensure you have poetry
installed, and then in the project root run poetry install and npm install.
The various Django project management commands are then available via
poetry run tillweb, for example poetry run tillweb check, poetry run tillweb migrate, poetry run tillweb adduser and poetry run tillweb runserver to run the development server.
The tillweb repository does not include the packed Javascript and CSS
necessary for the quicktill web interface project to run in
tillweb/static/bundles/. To regenerate these run npm run build
The SCSS files in `emf/static/emf/scss/` can be converted to CSS by
running `npm run emfsass`, and you can start a process that watches
the SCSS files for changes by running `npm run emfsass-watch`.