Files
planer2/daten/RAG/admin.md
2026-07-29 15:19:41 +02:00

94 lines
3.1 KiB
Markdown

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