2022-03-16 19:19:51 +01:00
|
|
|
# Drinks Manager (season 2)
|
2022-03-16 12:11:30 +01:00
|
|
|
|
2022-05-29 20:56:16 +02:00
|
|
|
Note: This software is tailored to my own needs.
|
2022-03-16 18:31:30 +01:00
|
|
|
I probably won't accept feature requests, and don't recommend you
|
|
|
|
to use this software if this isn't exactly what you are looking for.
|
|
|
|
|
2022-03-16 12:11:30 +01:00
|
|
|
Can't keep track of the number of drinks your guests drink?
|
|
|
|
Now you have a web interface that *really tries* to make things less complicated- for
|
|
|
|
you and your guests.
|
|
|
|
|
|
|
|
This (exaggeration intended) most incredible piece of software is written in Python,
|
|
|
|
HTML, CSS, JS, Bash and uses Django and PostgreSQL.
|
|
|
|
You have to bring your own PostgreSQL Database though.
|
|
|
|
|
2023-02-11 17:23:57 +01:00
|
|
|
# Getting started
|
2022-03-16 12:11:30 +01:00
|
|
|
|
2023-02-11 17:23:57 +01:00
|
|
|
## System Requirements
|
2022-03-16 12:11:30 +01:00
|
|
|
|
2023-02-11 17:23:57 +01:00
|
|
|
Beneath a `PostgreSQL` DBMS, you need the following things:
|
2022-03-16 12:11:30 +01:00
|
|
|
|
2023-02-11 17:23:57 +01:00
|
|
|
- `pg_config` (Ubuntu: `libpq-dev`, RHEL: `libpq-devel`)
|
|
|
|
- `Caddy` 2.4.3+ (HTTP Reverse Proxy & Static File Server)
|
|
|
|
- `gcc`, `gettext`
|
|
|
|
- `Python` 3.9+
|
|
|
|
- `venv`
|
|
|
|
- `pip`
|
|
|
|
- `Python` header files (RHEL: `python3-devel`, Ubuntu: `python3-dev`)
|
2022-03-16 12:11:30 +01:00
|
|
|
|
2023-02-11 17:23:57 +01:00
|
|
|
## Create Environment & Install dependencies
|
2022-03-16 12:11:30 +01:00
|
|
|
|
2023-02-11 17:23:57 +01:00
|
|
|
Run the following from the main directory:
|
|
|
|
|
|
|
|
```
|
|
|
|
./scripts/setup-env.sh
|
|
|
|
```
|
|
|
|
|
|
|
|
## Activate Venv
|
|
|
|
|
|
|
|
**On every new session**, before running commands with manage.py or developing, you have to activate the venv:
|
|
|
|
|
|
|
|
```
|
|
|
|
source ./venv/bin/activate
|
|
|
|
```
|
2022-03-16 12:11:30 +01:00
|
|
|
|
2023-02-11 17:23:57 +01:00
|
|
|
If you see `(venv)` before your command prompt, it worked!
|
|
|
|
|
|
|
|
##
|
|
|
|
|
|
|
|
# Configuration
|
|
|
|
|
|
|
|
see [Configuration](docs/Configuration.md)
|
2022-03-16 12:11:30 +01:00
|
|
|
|
2023-02-11 17:23:57 +01:00
|
|
|
# Usage
|
2022-03-16 12:11:30 +01:00
|
|
|
|
2023-02-11 17:23:57 +01:00
|
|
|
...
|