Konfiguration
Alle Einstellungen werden über Environment-Variablen in der .env Datei gesteuert.
Pflicht-Variablen
| Variable | Beschreibung |
|---|---|
SECRET_KEY | App-Secret für Sessions. Muss gesetzt werden. Mindestens 32 Zeichen. |
Optionale Variablen
| Variable | Default | Beschreibung |
|---|---|---|
DEBUG | false | Aktiviert Swagger UI (/docs), SQL-Echo und detaillierte Fehlermeldungen |
SEED_DEFAULT_DATA | true | Standard-Lagerorte und Kategorien beim ersten Start anlegen |
POSTGRES_USER | storestash | PostgreSQL Benutzername |
POSTGRES_PASSWORD | changeme | PostgreSQL Passwort — in Produktion ändern! |
POSTGRES_DB | storestash | PostgreSQL Datenbankname |
CORS_ORIGINS | http://localhost:3000 | Erlaubte CORS-Origins (kommagetrennt) |
LOG_LEVEL | info | Log-Level: debug, info, warning, error |
PORT | 3000 | Externer Port für die Web-UI |
Beispiel .env
# Pflicht
SECRET_KEY=mein-super-geheimer-schluessel-hier-rein
# Entwicklung
DEBUG=true
SEED_DEFAULT_DATA=true
# Datenbank (in Produktion ändern!)
POSTGRES_PASSWORD=sicheres-passwort-hier
# Optional
PORT=3000
LOG_LEVEL=info
CORS_ORIGINS=http://localhost:3000
Debug-Modus
Wenn DEBUG=true:
- Swagger UI erreichbar unter
http://localhost:8000/docs(direkt am Backend) - SQL-Queries werden geloggt
- Detaillierte Fehlermeldungen in API-Responses
- Version wird im Health-Check angezeigt
Produktion
In Produktion immer DEBUG=false setzen! Swagger UI, SQL-Logs und Detail-Errors sind Sicherheitsrisiken.