docs: Phase 3 — Aufgaben 16-20 (Config, Errors, systemd, Health, DB)

docs/alicia-aufgaben-phase3.md

@@ -0,0 +1,124 @@
+# Alicia — Aufgaben 16–20: BSN-Livesystem Phase 3 (Live-Vorbereitung)
+
+> **Repo:** `git@git.datenhimmel.work:danielkrause/BSN-Livesystem.git`
+> **Stand:** 15 Aufgaben fertig. Phase 2 abgeschlossen.
+> **Ziel:** Projekt live-fähig machen — Config, DB, Error-Handling, Service-Dateien.
+
+---
+
+## Aufgabe 16 — Konfigurations-Management (pydantic-settings)
+
+Ersetze hartcodierte Werte durch eine zentrale Config-Klasse.
+
+### Datei 1: `src/config.py`
+
+```python
+from __future__ import annotations
+from pydantic_settings import BaseSettings
+
+
+class Settings(BaseSettings):
+    """Zentrale Anwendungskonfiguration. Werte aus .env oder Environment."""
+
+    REDIS_HOST: str = "localhost"
+    REDIS_PORT: int = 6379
+    WHATSAPP_APP_SECRET: str = ""
+    WHATSAPP_VERIFY_TOKEN: str = "bsn_verify_token"
+    TELEGRAM_BOT_TOKEN: str = ""
+    APP_HOST: str = "0.0.0.0"
+    APP_PORT: int = 5002
+    APP_DEBUG: bool = False
+
+    class Config:
+        env_file = ".env"
+        env_file_encoding = "utf-8"
+
+
+settings = Settings()
+```
+
+### Datei 2: `.env.template`
+
+```
+REDIS_HOST=localhost
+REDIS_PORT=6379
+WHATSAPP_APP_SECRET=dein_secret_hier
+WHATSAPP_VERIFY_TOKEN=bsn_verify_token
+TELEGRAM_BOT_TOKEN=dein_bot_token_hier
+APP_DEBUG=false
+```
+
+### Integration: `src/app.py` umbauen
+
+`from src.config import settings` — ersetze alle Hart-Konfigurationen.
+
+### Test: `tests/test_config.py` — 4 Tests
+
+**Commit:** `feat: Pydantic-Settings Konfiguration mit .env-Support`
+
+---
+
+## Aufgabe 17 — Einheitliche Fehlerbehandlung
+
+Zentrale JSON-Error-Responses via Flask errorhandler.
+
+### Datei: `src/error_handler.py`
+
+Handler für 400, 401, 404, 422 (ValidationError), 500.
+Alle Responses im Format: `{"error": "...", "message": "...", "status": N}`
+
+### Integration: `register_error_handlers(app)` in `create_app()`
+
+### Test: `tests/test_error_handler.py` — 5 Tests
+
+**Commit:** `feat: Einheitliche JSON-Error-Responses`
+
+---
+
+## Aufgabe 18 — systemd Service-Dateien
+
+### Dateien:
+- `deploy/bsn-chatbot.service` — Flask-App als systemd-Service
+- `deploy/bsn-worker.service` — Queue-Worker als systemd-Service
+- `deploy/README.md` — Installationsanleitung
+
+### Kein Test nötig (Konfigurationsdateien)
+
+**Commit:** `feat: systemd-Service-Dateien für Chatbot + Queue-Worker`
+
+---
+
+## Aufgabe 19 — Health-Check erweitern
+
+### Datei: `src/routes/health.py`
+
+Blueprint mit:
+- `GET /health` — Status, queue_size, python_version, platform
+- `GET /health/ready` — Readiness-Check (Redis-Verbindung)
+
+### Integration: `app.py`: inline `/health` entfernen, `health_bp` registrieren
+
+### Test: `tests/test_health.py` — 4 Tests
+
+**Commit:** `feat: Erweiterter Health-Check mit Readiness-Endpunkt`
+
+---
+
+## Aufgabe 20 — SQLAlchemy-Persistenz
+
+### Dateien:
+- `src/database.py` — Engine, Session, Base
+- `src/models/spiel.py` — SpielDB (SQLAlchemy-Modell)
+- `src/services/game_service.py` — Umbau auf DB-Sessions
+
+### Test: `tests/test_database.py` — 5 Tests
+
+**Commit:** `feat: SQLAlchemy-Datenbank mit SQLite-Persistenz`
+
+---
+
+## ⚠️ Wichtig
+
+- `pip install pydantic-settings sqlalchemy`
+- **Qualität:** `ruff check . && ruff format . && mypy --config-file pyproject.toml . && pytest -v`
+- **Reihenfolge:** 16 → 17 → 18 → 19 → 20