31 lines
1.1 KiB
Markdown
31 lines
1.1 KiB
Markdown
# 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).
|