1.7 KiB
1.7 KiB
#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
- Handbuch mit Bildern (
docs/anleitung/README.md, 12 Kapitel) - Installation, authentik, Reverse Proxy (
docs/betrieb/installation.md) - Bedrohungsanalyse und Notfallplan (
docs/betrieb/sicherheit.md) - Backup-Konzept mit Skripten und geprobter Wiederherstellung (
docs/betrieb/sicherung.md)
Akzeptanzkriterien
- Handbuch mit Bildern (
docs/anleitung/README.md, 12 Kapitel) - Installation, authentik, Reverse Proxy (
docs/betrieb/installation.md) - Bedrohungsanalyse und Notfallplan (
docs/betrieb/sicherheit.md) - 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
--cleannicht rückspielbar; Abbruch ohne Transaktion löschte es halb). Jetzt: nur Schemapublic, 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.tsund den E2E-Abläufen.