From 68bfbd55a28e91aaaebb527c6fd53b5cd652ff9a Mon Sep 17 00:00:00 2001
From: Bjoern Welker <bjoern@welker.me>
Date: Fri, 30 Jan 2026 12:36:51 +0100
Subject: [PATCH] docs: add developer env section

---
 README.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)
 mode change 100644 => 100755 README.md

diff --git a/README.md b/README.md
old mode 100644
new mode 100755
index 6d22ba9..7b98135
--- a/README.md
+++ b/README.md
@@ -24,6 +24,24 @@ python app.py
 ```
 Standardzugriff: Login über Benutzerverwaltung (siehe unten).
 
+## Developer (ENV variablen)
+Diese App liest Konfiguration ausschließlich aus Umgebungsvariablen.
+Für lokale Entwicklung kannst du sie direkt im Shell-Session setzen oder
+eine `.env`-Datei in dein Startup-Script laden.
+
+Minimal sinnvoll für lokal:
+- `SECRET_KEY` – Session-Secret (beliebiger String)
+- `APP_USER` / `APP_PASSWORD` – initialer Admin-User
+- `URL_PREFIX` – leer lassen, wenn lokal ohne Sub-Pfad
+
+Für Bestellungen per Mail zusätzlich:
+- `SMTP_HOST`, `SMTP_PORT`, `SMTP_USER`, `SMTP_PASS`
+- `SMTP_FROM`, `ORDER_TO`
+
+Optional:
+- `APP_API_KEY` – Schutz fuer `/wawi/api/bestand` und `/wawi/order`
+- `COOKIE_SECURE` – `0` fuer http lokal, `1` fuer https
+
 ## Benutzerverwaltung
 Beim ersten Start wird **ein Admin** aus ENV erzeugt:
 - `APP_USER` (default: `admin`)