update

daten/RAG/admin.md

@@ -0,0 +1,93 @@
+<!-- titel -->
+Admin
+----------------------------------------
+<!-- art -->
+kern
+----------------------------------------
+<!-- ziel -->
+Bietet Zugriff auf Enterprise-Betriebsdaten und Systemüberwachung für Administratoren
+----------------------------------------
+<!-- regeln -->
+- POST-Operationen erfordern gültiges CSRF-Token
+- Wiederherstellung erfordert ROLE_SUPER_ADMIN
+- Ergebnis jeder Operation als Flash-Meldung
+- Backup-Download erfordert ROLE_SUPER_ADMIN
+----------------------------------------
+<!-- funktion -->
+Betrieb einsehen
+<!-- ziel -->
+Verschafft Admins einen Überblick über den Betriebszustand aller Systeme
+<!-- regeln -->
+- Backup- und Restore-Bereitschaft zeigt Status
+- Sicherheit und Datenschutz zeigt Bereitschaft
+- Deployment-Scheduler zeigt Bereitschaft
+- Backup-Übersicht zeigt vorhandene Sicherungen
+- Operator-Prüfprotokoll zeigt letzte 8 Prüfungen
+- Übersicht kombiniert alle Berichte
+<!-- testen -->
+- Admin-Dashboard öffnen
+- Backup- und Restore-Bereitschaft anzeigen
+- Sicherheit und Datenschutz anzeigen
+- Deployment-Scheduler anzeigen
+- Backup-Übersicht mit vorhandenen Sicherungen
+- Operator-Prüfprotokoll mit letzten 8 Einträgen
+- Kombinierte Übersicht aller Berichte
+----------------------------------------
+<!-- funktion -->
+Dashboard anzeigen
+<!-- ziel -->
+Zeigt Systemzustand und Konfiguration im Admin-Bereich
+<!-- regeln -->
+- Rendered admin dashboard index html twig
+- Enthält Chunk-Zähler und Chunk-Limit
+- Enthält Vektor- und Tag-Gesundheitsdaten
+- Enthält Reset-Konfiguration
+<!-- testen -->
+- Admin-Dashboard aufrufen
+- HTTP 200 zurückerhalten
+- admin-dashboard-index-html-twigt Template prüfen
+- Chunk-Zähler im Response vorhanden
+- Vektor-Gesundheitsdaten im Response vorhanden
+----------------------------------------
+<!-- funktion -->
+Logout einleiten
+<!-- ziel -->
+Beendet die aktive Adminsession sicher
+<!-- regeln -->
+- GET oder POST an Admin-Logout startet Logout
+- Wird vom Framework-Sicherheitssystem abgefangen
+- Leere Methoden-Signatur
+- Löscht Session und Authentifizierungsdaten
+<!-- testen -->
+- Klick auf Logout-Button im Admin
+- Weiterleitung zur Login-Seite
+- Session beendet
+----------------------------------------
+<!-- funktion -->
+Wiederherstellung testen
+<!-- ziel -->
+Prueft ob ein Backup sich vollständig wiederherstellen laesst
+<!-- regeln -->
+- Benoetigt ROLE_SUPER_ADMIN
+- POST-Request mit CSRF-Token
+- Prueft angegebene Backup-ID gegen Muster retriex-backup-YYYYMMDD-HHMMSS
+- Trockenlauf ohne tatsaechliche Wiederherstellung
+- Ergebnis als Flash-Meldung nach Startseite
+<!-- testen -->
+- Admin-Enterprise-Seite aufrufen
+- Dry-Run-Wiederherstellung mit gueltigem CSRF-Token absenden
+- Rueckleitung auf Admin-Enterprise mit Flash-Meldung pruefen
+- Flash-Meldung zeigt Warnungen und Fehler oder Erfolg
+----------------------------------------
+<!-- funktion -->
+Zum Dashboard weiterleiten
+<!-- ziel -->
+Leitet admin und admin- auf das Dashboard um
+<!-- regeln -->
+- Admin leitet zum Dashboard um
+- Verhindert doppelten Inhalt
+<!-- testen -->
+- admin aufrufen
+- Weiterleitung zu dashboard prüfen
+- admin-Abschluss aufrufen
+- Weiterleitung zu dashboard prüfen