update

daten/RAG/backup.md

@@ -0,0 +1,97 @@
+<!-- titel -->
+Backup
+----------------------------------------
+<!-- art -->
+kern
+----------------------------------------
+<!-- ziel -->
+Erstellt, prüft und stellt Backups bereit
+----------------------------------------
+<!-- regeln -->
+- POST-Routen erfordern CSRF-Token
+- Super Admin darf Restore-Prüfungen ausführen
+- Flash-Meldung zeigt Status nach jeder Aktion
+- Alle Prüfungen werden protokolliert
+- Backup-IDs folgen dem Muster retriex-backup-Datum-Uhrzeit
+- json gibt maschinenlesbare Ausgabe zurück
+- Ungueltiges CSRF-Token zeigt Flash-Meldung
+- Backup herunterladen mit "Neueste" waehlt aktuelles Backup
+- Operator-Report als JSON exportieren
+- Deployment-Scheduler-Pruefung mit Beschreibung in Flash-Meldung
+- Sicherheit-und-Datenschutz-Pruefung mit Beschreibung in Flash-Meldung
+- Backup-Dry-Run erwähnt fehlende Dateischreibweise in Flash-Meldung
+----------------------------------------
+<!-- funktion -->
+Backup herunterladen
+<!-- ziel -->
+Ermöglicht dem Super Admin das Herunterladen einer Sicherungsdatei
+<!-- regeln -->
+- Nur Super Admin
+- Backup-ID aus Liste oder "Neueste"
+- Fehlgeschlagener Download zeigt Flash-Meldung
+- Erfolgreicher Download protokolliert OperatorCheckProtocol
+<!-- testen -->
+- admin_enterprise_operations öffnen
+- Backup-ID aus Liste auswählen
+- Klick auf Download-Button
+- Datei im Browser heruntergeladen
+----------------------------------------
+<!-- funktion -->
+Backup starten
+<!-- ziel -->
+Erstellt eine Sicherungskopie mit allen konfigurierten Quellen
+<!-- regeln -->
+- CSRF-Token erforderlich
+- Ablauf im Operator-Protokoll
+- Flash-Meldung je nach Status
+- Database-Dump als Option
+<!-- testen -->
+- Backup-Endpunkt per POST aufrufen
+- _token und include_database_dump senden
+- Flash-Meldung zeigt Status
+- Backup erstellt
+----------------------------------------
+<!-- funktion -->
+Backup-Tauglichkeit prüfen
+<!-- ziel -->
+Prüft ob das System alle Voraussetzungen für Backup und Restore erfüllt
+<!-- regeln -->
+- JSON-Ausgabe mit --json
+- Tabelle zeigt alle Testfälle
+- Rückgabe SUCCESS bei Status OK
+<!-- testen -->
+- Befehl mto:agent:enterprise:backup-restore-readiness ausführen
+- Tabelle mit Testfällen prüfen
+- Rückgabe SUCCESS bei Status OK
+----------------------------------------
+<!-- funktion -->
+Backup-Trockenlauf prüfen
+<!-- ziel -->
+Prüft die Wiederherstellbarkeit eines Backups ohne tatsächlichen Restore
+<!-- regeln -->
+- Nur Super-Admin darf Funktion ausführen
+- CSRF-Token wird geprüft
+- Report wird im Prüfprotokoll aufgezeichnet
+- Flash-Nachricht zeigt Status, Backup-ID und Anzahl Warnungen sowie Fehler
+<!-- testen -->
+- POST an admin enterprise restore dry-run latest
+- Erfolg: Redirect zur Übersicht mit Flash-Nachricht
+- Fehler: Redirect zur Übersicht mit Fehlermeldung
+----------------------------------------
+<!-- funktion -->
+Backup-Wiederherstellung prüfen
+<!-- ziel -->
+Prüft ob Backup-Pfad, Restore-Nachweis und Betreiberhinweise vorhanden sind
+<!-- regeln -->
+- CSRF-Token erforderlich
+- Flash-Meldung zeigt Zusammenfassung
+- Protokolliert den Check
+<!-- testen -->
+- POST an /admin/enterprise/check/backup-restore
+- ungültiges CSRF-Token senden
+- Weiterleitung mit Fehlermeldung
+- gültiges CSRF-Token senden
+- Weiterleitung mit Zusammenfassung
+----------------------------------------
+<!-- funktion -->
+Operatorbericht als JSON exportieren