florian.wilde/sshkeyvault
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(anleitung): Kapitel Einstellungen und Benachrichtigungen (#029)

Browse Source 
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
florian.wilde
2026-10-12 16:56:52 +02:00
co-authored by Claude Opus 5.5
parent ca05d6a58e
commit d9e218a6d3
3 changed files with 33 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/issues/029-handbuch.md
+14 -4
View File
@@ -1,19 +1,29 @@
# #029 Handbuch und Betriebsdokumentation
**Status:** offen
**Status:** erledigt
**Meilenstein:** v0.5.0
**Labels:** docs
**Geschätzt:** 3 h **Tatsächlich:** –
**Geschätzt:** 3 h **Tatsächlich:** 0 h 50 min
## Ziel
Installation, Bootstrap, Kern-Anwendungsfall mit Bildern; Bedrohungsanalyse, Backup-Konzept.
## Aufgaben
- [ ] wird zu Beginn der Phase verfeinert
- [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
- [ ] wird zu Beginn der Phase verfeinert
- [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.