# #029 Handbuch und Betriebsdokumentation
**Status:** erledigt
**Meilenstein:** v0.5.0
**Labels:** docs
**Geschätzt:** 3 h   **Tatsächlich:** 0 h 50 min

## Ziel
Installation, Bootstrap, Kern-Anwendungsfall mit Bildern; Bedrohungsanalyse, Backup-Konzept.

## Aufgaben
- [x] Handbuch mit Bildern (`docs/anleitung/README.md`, 12 Kapitel)
- [x] Installation, authentik, Reverse Proxy (`docs/betrieb/installation.md`)
- [x] Bedrohungsanalyse und Notfallplan (`docs/betrieb/sicherheit.md`)
- [x] Backup-Konzept mit Skripten und geprobter Wiederherstellung (`docs/betrieb/sicherung.md`)

## Akzeptanzkriterien
- [x] Handbuch mit Bildern (`docs/anleitung/README.md`, 12 Kapitel)
- [x] Installation, authentik, Reverse Proxy (`docs/betrieb/installation.md`)
- [x] Bedrohungsanalyse und Notfallplan (`docs/betrieb/sicherheit.md`)
- [x] Backup-Konzept mit Skripten und geprobter Wiederherstellung (`docs/betrieb/sicherung.md`)

## Abhängigkeiten
–

## Notizen / Entscheidungen
- **Wiederherstellung geprobt** auf einem Wegwerf-Stapel – dabei zwei Fehler gefunden und behoben (Schema pgboss mit `--clean` nicht rückspielbar; Abbruch ohne Transaktion löschte es halb). Jetzt: nur Schema `public`, eine Transaktion, Warteschlange neu, offene Vorgänge abgebrochen.
- **Master-Key wird nicht mitgesichert**, nur ein Prüfwert (SHA-256). Das Wiederherstellungsskript bricht vor jeder Änderung ab, wenn der bereitliegende Master-Key nicht passt; der Worker startet nicht mit einem falschen Master-Key.
- **Notfallplan „sshkv kompromittiert“** beschreibt das Entfernen des Deployment-Keys auf allen Hosts von Hand – eine eingebaute Rotation des Deployment-Keys gibt es noch nicht.
- Bilder entstehen aus `scripts/screenshots.ts` und den E2E-Abläufen.