homelab-infra/ops/restore-tests/paperless-plan.md

Paperless Restore Test Plan

Ziel

Nachweisen, dass ein Paperless-Backup in einer isolierten Testumgebung wieder startbar ist und sowohl Dokumentenpfade als auch PostgreSQL-Dump sauber zusammenlaufen.

Quelle

• Backup-Quelle: Borg / Share-Backup
• fachlich relevante Dateipfade:
  • /mnt/user/appdata/paperless-ngx/data
  • /mnt/user/documents/paperless
  • /mnt/user/documents/paperless/export
  • /mnt/user/documents/scans_inbox
• fachlich relevanter Dump:
  • /mnt/user/backups/borg/dumps/latest/postgresql17-paperless.dump

Test-Ziel

• Restore-Lab: /mnt/user/backups/restore-lab/paperless
• Testdatenpfade:
  • /mnt/user/backups/restore-lab/paperless/data
  • /mnt/user/backups/restore-lab/paperless/media
  • /mnt/user/backups/restore-lab/paperless/export
  • /mnt/user/backups/restore-lab/paperless/consume
  • /mnt/user/backups/restore-lab/paperless/postgres
• Testcontainer:
  • restoretest-paperless
  • restoretest-paperless-postgres
  • restoretest-paperless-redis
• Testport Web: 127.0.0.1:18120:8000
• Report-Ziel: /mnt/user/backups/restore-reports/paperless-YYYY-MM-DD.md

Schutzregeln

• produktive Pfade nie beschreiben
• produktive Domain paperless.kaleschke.info nicht fuer die Testinstanz uebernehmen
• keine Traefik-Labels fuer die Testinstanz
• keine produktive PostgreSQL- oder Redis-Instanz fuer den Test verwenden
• Testcontainer nur gegen Restore-Lab-Daten und isolierte Test-Backends starten

Geplanter Ablauf

1. Restore-Ziel unter /mnt/user/backups/restore-lab/paperless vorbereiten
2. Paperless-Dateipfade aus Borg in das Restore-Lab wiederherstellen
3. Test-Postgres und Test-Redis mit ops/restore-tests/paperless-compose.test.yml starten
4. postgresql17-paperless.dump in Test-Postgres importieren
5. Testinstanz restoretest-paperless starten
6. lokalen Smoke-Test gegen http://127.0.0.1:18120 ausfuehren
7. Report unter /mnt/user/backups/restore-reports/ schreiben
8. Testcontainer stoppen und Testumgebung bereinigen

Smoke-Test

Minimal erfolgreich:

• Test-Postgres startet
• Dump-Import gelingt
• Paperless-Web-UI antwortet
• mindestens ein Dokument liegt im Restore-Lab-Medienpfad

Optional spaeter:

• Login-Seite gezielt pruefen
• Dokumentanzahl aus UI oder DB querpruefen
• OCR-/Task-Worker-Status verifizieren

Noch offen vor dem ersten echten Lauf

• exakter Borg-Restore-Befehl fuer alle vier Dateipfade
• exakter pg_restore-Befehl im Test-Postgres
• wie stark wir consume im ersten Lauf ueberhaupt brauchen