Document successful production backup and byte-exact restore acceptance

Dokumentation.md

@@ -126,3 +126,28 @@ Die Sicherung schützt die durch das konfigurierte Nextcloud-Konto erreichbaren
 Bestehende Konfiguration und Passphrase wurden beibehalten. Die neuen Einstellungen wurden ausdrücklich ergänzt; die vorherige Konfiguration liegt privat unter `~/.config/nextcloud-borg-backup/config.pre-v2-20261026`. Beide Timer sind aktiviert. Das vorhandene Linger blieb aktiv. Der Desktop-Mount und dessen Autostart wurden nicht umgebaut.
 
 Für die Erstabnahme wurde der private Zwischenstand aus dem vorhandenen Archiv vom 23.10. vorgefüllt. Der anschließende direkte Cloud-Abgleich und sämtliche Prüfungen bleiben dadurch unverändert erforderlich; ein aus dem Altarchiv gelesener Stand gilt nicht automatisch als aktuelle Sicherung. Der beobachtete aktuelle Cloud-Bestand umfasst 8.218 Dateien mit 38.274.641.627 Bytes.
+
+### Erfolgreiche produktive Abnahme
+
+Der vollständige Lauf am 26.10.2026 dauerte von 12:26:38 bis 13:01:15 Uhr MEZ und endete einschließlich Wartung erfolgreich. Verwendet wurden Borg 1.4.5, rclone 1.75.2 und Python 3.14.8.
+
+| Prüfung | Ergebnis |
+| --- | --- |
+| Neues Archiv | `nextcloud-2026-10-26_12-48-01` |
+| Umfang | 8.218 Dateien, 38.274.641.627 Bytes |
+| Cloud-Inventur und Zwischenstand | Dateipfade, Größen und Zeiten gleich; alle angebotenen Hashes lokal geprüft, Dateien ohne Hash per Downloadvergleich geprüft |
+| Wechselnde WebDAV-Hash-Metadaten | Im erfolgreichen Lauf sechs betroffene Dateien zusätzlich inhaltlich geprüft; keine Datenabweichung |
+| Archivvergleich | Dateizahl und Original-Bytezahl entsprechen exakt der Cloud-Inventur |
+| Borg-Datenprüfung | `check --archives-only --verify-data` erfolgreich |
+| Repository-Prüfung | `check --repository-only` erfolgreich |
+| Wartung | Prune und Compact erfolgreich; bestehende Archive innerhalb der Aufbewahrung erhalten |
+| Wiederherstellungsprobe | Drei Dateien (ODS, PDF, JPG) aus dem neuen NAS-Archiv extrahiert; alle SHA-256-Werte stimmen mit dem geprüften Zwischenstand überein |
+| Health | `healthy: true`, `maintenance_pending: false` |
+| User-Service | `Result=success`, `ExecMainStatus=0` |
+| Wiederholungs-Timer | Folgeläufe erkennen den aktuellen Erfolg und überspringen unnötige Übertragungen |
+| Alterswächter | Timer aktiviert und Health-Service erfolgreich ausgeführt |
+| Automatisierte Tests | 18 erfolgreich, zusätzlich Syntaxprüfung und Verifikation aller vier systemd-Units |
+
+Die Wiederherstellungsprobe ist eine Stichprobe von drei Dateien; die Borg-Datenprüfung erfasst den vollständigen neuen Archivstand. Die extrahierten Proben und deren Hash-Nachweis liegen privat unter `~/.local/state/nextcloud-borg-backup/restore-proof-20261026/` bzw. `restore-proof.json`. Dateinamen und private Inhalte wurden nicht in Git übernommen.
+
+Nach dieser Abnahme wurde der endgültige Installer nochmals produktiv ausgeführt. Konfiguration und Passphrase blieben erhalten, installierte Programme entsprechen dem Repository. Die eigene rclone-Konfiguration wurde auf Dateirechte 0600 beschränkt. Der Zwischenstand belegt etwa 36 GiB; anschließend waren auf dem Home-Dateisystem noch etwa 124 GiB frei.

README.md

@@ -17,7 +17,7 @@ Die Übertragung geht ausschließlich **von Nextcloud zum NAS**. Dateien werden
 
 ## Installation / Update
 
-Voraussetzungen: Linux, systemd User Manager, Python 3, Borg **1.x**, rclone, util-linux (`findmnt`, `flock`), GNU coreutils und optional `notify-send`. rclone muss `Nextcloud:` bereits authentifiziert kennen; das NAS wird durch das vorhandene autofs eingebunden.
+Voraussetzungen: Linux, systemd User Manager, Python 3.9+, Borg **1.x** (getestet mit 1.4.5), rclone, util-linux (`findmnt`, `flock`), GNU coreutils und optional `notify-send`. rclone muss `Nextcloud:` bereits authentifiziert kennen; das NAS wird durch das vorhandene autofs eingebunden.
 
 ```bash
 cd ~/localdev/nextcloud-borg-backup
@@ -50,3 +50,7 @@ Eine manuelle Sofortsicherung kann lange dauern. Das Archiv wird erst nach erfol
 Die Passphrase in `~/.config/nextcloud-borg-backup/passphrase` und ein Borg-Schlüsselexport gehören zusätzlich an einen sicheren unabhängigen Ort. Niemals ins Repository einchecken. Der lokale Zwischenstand ist unverschlüsselt; seine Dateirechte sind privat, eine Datenträgerverschlüsselung richtet dieses Projekt nicht ein.
 
 Details, Fehlerbehandlung, Grenzen und Abnahme: [Dokumentation.md](Dokumentation.md).
+
+## Abnahme am 26.10.2026
+
+Auf der Workstation eingerichtet und produktiv geprüft: **8.218 Dateien, 38.274.641.627 Bytes**, Archiv `nextcloud-2026-10-26_12-48-01`. Vollständige Archivdatenprüfung und Repository-Prüfung erfolgreich. Drei Dateien aus dem NAS-Archiv wiederhergestellt und per SHA-256 mit dem geprüften Zwischenstand verglichen: alle identisch. `health` meldet `healthy: true`; beide Timer sind aktiv. 18 automatisierte Tests bestanden. Details stehen in der Betriebsdokumentation.