feat(repairs): add repair management foundation

README-DEV.md

@@ -33,6 +33,7 @@ STORAGE_PROVIDER=local
 STORAGE_BASE_PATH=/data/storage
 STORAGE_MAX_UPLOAD_MB=50
 STORAGE_HOST_PATH=./storage
+OLYMPUS_REPAIR_INTAKE_TOKEN=
 ```
 
 Wenn `SECRET_KEY` Sonderzeichen wie `$` enthaelt, den Wert in der Shell oder Compose-Umgebung korrekt quoten. Secrets gehoeren nicht ins Git.
@@ -128,6 +129,32 @@ Hersteller -> Gerät -> Dokument -> Notiz/Reparaturhinweis
 
 Hermes legt beim Startup Standard-Hersteller an, wenn sie noch fehlen. Danach koennen Geraete angelegt werden. Dokumentuploads sind erst sinnvoll, wenn Hersteller und Geraet vorhanden sind; Athena blockiert unvollstaendige Uploads direkt im Formular.
 
+## Reparaturmanagement
+
+Das Reparaturmodul ist ab v0.8.0 aktiv.
+
+Lokaler Ablauf:
+
+```bash
+cd backend/hermes
+SECRET_KEY=local-check uv run alembic upgrade head
+```
+
+Athena erreicht Reparaturen ausschliesslich ueber BFF-Routen:
+
+- `/api/repairs`
+- `/api/repairs/[id]`
+- `/api/repairs/[id]/status`
+- `/api/repairs/[id]/history`
+
+Hermes stellt zusaetzlich `POST /public/repair-intake` fuer die spaetere Website-Anbindung bereit. Der Endpunkt ist fuer Server-zu-Server-Kommunikation gedacht und erwartet `X-Olympus-Intake-Token`. Der Token wird ueber `OLYMPUS_REPAIR_INTAKE_TOKEN` gesetzt und darf nicht im Browser verwendet werden.
+
+Vorbereitete Kundenportal-Routen fuer spaeter:
+
+- `/status`
+- `/reparatur/status`
+- `/portal/login`
+
 ## Typische Fehler
 
 Hermes restartet wegen fehlender Migration: