30 lines
1.7 KiB
Markdown
30 lines
1.7 KiB
Markdown
# #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.
|