#029 Handbuch und Betriebsdokumentation #29

New Issue

2026-10-12T15:12:49Z

florian.wilde commented

2026-10-12 15:12:49 +00:00

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 --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.

Quelle: docs/issues/029-handbuch.md – dort wird dieses Issue gepflegt.

## 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. --- Quelle: `docs/issues/029-handbuch.md` – dort wird dieses Issue gepflegt.

florian.wilde added this to the v0.5.0 milestone 2026-10-12 15:12:49 +00:00

florian.wilde added the docs label 2026-10-12 15:12:49 +00:00

florian.wilde closed this issue

2026-10-12 15:12:49 +00:00

florian.wilde referenced this issue

2026-10-12 18:11:50 +00:00

#034 Abnahme-Checkliste für 1.0.0 #34

Sign in to join this conversation.