initiales Projektsetup als skeleton für fresh flask + architecture

docs/dev-guide.md

@@ -0,0 +1,30 @@
+# Developer Guide & Local Emulation
+
+## 1. Local Auth Bypass (Zitadel-Dummy)
+
+Für die lokale Entwicklung auf `127.0.0.1` oder benutzerdefinierten Dev-Domains kann die OIDC-Authentifizierung umgangen werden.
+
+In der `.env`:
+```env
+DEV_MODE=true
+DEV_USER_ROLE=admin
+DEV_TENANT_ID=tenant_dev_123
+```
+
+Ist `DEV_MODE=true` gesetzt, injiziert die Middleware automatisch eine Mock-Session für den angegebenen Dev-User, ohne Redirects zu Zitadel auszuführen.
+
+---
+
+## 2. reCAPTCHA v3 Mocking
+
+Im Dev-Modus wird die Google reCAPTCHA API nicht kontaktiert.
+
+* **Erfolg-Simulation:** Standardmäßig gibt der Mock-Service einen Score von `0.9` zurück.
+* **Fehlschlag-Simulation:** Durch Setzen von `MOCK_RECAPTCHA_SCORE=0.1` in der `.env` kann das Abweisen von Spam-Submissions lokal getestet werden.
+
+---
+
+## 3. CLI Commands & Maintenance
+
+* **Datenbank-Seeding:** `flask seed-db` (Erstellt Test-Mandanten und Beispiel-Formulare).
+* **E-Mail Dump Trigger:** `flask run-scheduled-export --tenant-id=<ID> --period=daily` (Führt datenbank-agnostischen Export via SQLAlchemy aus und versendet die Mail).