<!-- titel -->
System
----------------------------------------
<!-- art -->
kern
----------------------------------------
<!-- ziel -->
Ermöglicht Systemadministration, Betriebsvalidierung und Datenmanagement für Admins
----------------------------------------
<!-- regeln -->
- ROLE_ADMIN_AREA für Adminbereich
- ROLE_SUPER_ADMIN für Super-Admin-Funktionen
- ROLE_EDITOR für Bearbeitungsfunktionen
- Flash-Meldungen zeigen Operationsergebnisse
- Fehlgeschlagene Validierung bricht Operation ab
- Rollenabhängige Startseite nach Anmeldung
- Restore-Vorschau führt kein Restore aus
- Bestätigungsphrase "KNOWLEDGE ENDGÜLTIG LÖSCHEN" ist hardcoded
- Fehlermeldungstext "Die Anfrage konnte nicht verarbeitet" ist nicht dokumentiert
----------------------------------------
<!-- funktion -->
Access-Denied-Fehler bereitstellen
<!-- ziel -->
Zeigt eine informative Fehlerseite mit kontextabhängigen Weiterleitungen an
<!-- regeln -->
- Fehlercode 403 im Titel
- Rollenabhängige Startseite
- Anmeldung für Gäste
- Rolle "Chat" führt zum Chat
- Rolle "Admin" führt zum Dashboard
<!-- testen -->
- Seite ohne Anmeldung aufrufen
- Klick auf geschützte Ressource
- error403-Seite mit Anmelde-Button
----------------------------------------
<!-- funktion -->
Betriebsbereitschaft prüfen
<!-- ziel -->
Validiert die Enterprise-Readiness-Baseline ohne Chat-Runtime-Nebeneffekte
<!-- regeln -->
- Erkennt fehlende Readiness-, Doku-, Boundary-, Backup- und Command-Artefakte
- Prüft Quell-, Konfigurations-, Dokumentations- und Eval-Verzeichnisse
- Validiert alle Services-Imports in Services-Konfiguration
- Prüft Governance-Dokument auf Maintainability-, Readiness- und Genre-Neutralitätsmarker
- Validiert Enterprise-Dokumente auf Betriebsbaseline-Marker
- Prüft Console-Binary auf Vorhandensein
- Prüft Command-Referenz auf alle Enterprise-Commands
- Prüft zentrale Qualitätschecks in der Command-Referenz
- Warnt bei fehlenden oder nicht beschreibbaren Betriebsverzeichnissen
<!-- testen -->
- Command ausführen ohne Option
- Tabelle zeigt Status, Case und Details
- Alle Cases mit PASS erscheinen
- Command mit --json ausführen
- JSON-Objekt mit status, summary und cases erscheint
----------------------------------------
<!-- funktion -->
Cache leeren
<!-- ziel -->
Leert den PHP-Runtime-Cache und den Vector-Service Query-Cache
<!-- regeln -->
- POST erfordert gültiges CSRF-Token
- Erfolgreiches Leeren zeigt success-Flash
- Fehler zeigt danger-Flash und bricht ab
<!-- testen -->
- POST an admin-runtime-cache-clear mit korrektem _token
- Erfolgreicher Flash erscheint
- Redirect zu admin-dashboard
- Cache nach dem Leeren leer
----------------------------------------
<!-- funktion -->
Daten neu laden
<!-- ziel -->
Synchronisiert alle Indizes und das Embedding-Modell mit dem Dateisystem
<!-- regeln -->
- Lädt Chunk-Index neu
- Lädt Tag-Index neu
- Lädt Embedding-Modell neu
- Leert den Query-Cache
- Gibt Service-Stempel zurück
- HTTPException bei Fehler
<!-- testen -->
- POST-Reload-Endpunkt aufrufen
- 200 OK
- status: reloaded
----------------------------------------
<!-- funktion -->
Daten sichern
<!-- ziel -->
Erstellt periodische Sicherungskopien, um Datenverlust zu verhindern
<!-- regeln -->
- Kopiert Dateien ins Sicherungsverzeichnis
- Entfernt Sicherungen jenseits der Aufbewahrungsfrist
- Datenbankdump als optionale Sicherung
- Dry-Run validiert den Plan ohne zu schreiben
- JSON-Ausgabe für maschinelle Verarbeitung
<!-- testen -->
- mto:agent:enterprise:backup-run mit --json ausführen
- JSON-Status auf SUCCESS prüfen
- backup_id und target im JSON vorhanden
----------------------------------------
<!-- funktion -->
Deployment prüfen
<!-- ziel -->
Prüft Deployment-Bereitschaft und protokolliert das Ergebnis
<!-- regeln -->
- CSRF-Token wird geprüft
- DeploymentSchedulerReadinessService liefert Report
- Prüfung wird im OperatorCheckProtocol protokolliert
- Flash-Meldung zeigt Status der Prüfung
<!-- testen -->
- POST an Admin-Endpoint für Deployment-Prüfung senden
- Weiterleitung zu admin_enterprise_operations
- Flash-Meldung zeigt Deployment-Status
----------------------------------------
<!-- funktion -->
Dienststatus melden
<!-- ziel -->
Ermöglicht die Überwachung der Betriebsbereitschaft des Dienstes
<!-- regeln -->
- Gibt JSON zurück
- Enthält immer Status ok
- Enthält alle Komponentenzustände
<!-- testen -->
- GET an health-Endpunkt senden
- Antwort prüfen
- Status ok vorhanden
----------------------------------------
<!-- funktion -->
Flow-Grenze sperren
<!-- ziel -->
Validiert die passive AgentRunner-Flow-Boundary-Linie ohne Runtime-Nebeneffekte
<!-- regeln -->
- Prueft vollstaendige und geordnete Flow-Sections
- Validiert AgentRunContext gegen deklarierte Boundaries
- Prueft Boundary-Vertraege auf trace-only-Grenzen
- Prueft kritische Runtime-Eigner-Token im AgentRunner
- Prueft Flow-Qellen auf verbotene Runtime-Aufrufsignaturen
- Prueft Patchline-Dokumentation auf aktuellen Flow-Lock
<!-- testen -->
- Kommando `mto:agent:architecture:flow-boundary-lock-self-test` ausfuehren
- Alle Pruefungen bestaetigen OK
- Status OK zurueckgemeldet
----------------------------------------
<!-- funktion -->
Neuindizierung starten
<!-- ziel -->
Startet eine vollständige Neuindizierung aller Inhalte als Hintergrundprozess
<!-- regeln -->
- Erfordert ROLE_SUPER_ADMIN
- CSRF-Token wird geprüft
- Fehlgeschlagener Start zeigt Flash-Meldung und Weiterleitung
<!-- testen -->
- POST an Global-Reindex-Endpoint mit gültigem CSRF-Token absenden
- Redirect nach admin_job_show mit neuer Job-ID prüfen
- Flash-Meldung Global Reindex wurde gestartet prüfen
----------------------------------------
<!-- funktion -->
Normalisierung prüfen
<!-- ziel -->
Prüft ob die Normalisierungs-Infrastruktur korrekt aufgebaut ist
<!-- regeln -->
- required_files_present
- prompt_is_versioned_and_markdown_only
- llm_transport_is_fit_for_large_ingest_prompt
- segmented_execution_boundary_present
- foundation_is_not_wired_into_automatic_runtime
- provenance_sidecar_is_safe
- validator_cleans_wrapper_and_common_prose
- validator_sanitizes_segment_code_fence_markers
- validator_blocks_failure_answer
- validator_removes_source_echo_markers
- source_noise_cleaner_removes_binary_pdf_artifact_lines
- no_genre_runtime_gate_markers
<!-- testen -->
- mto:agent:ingest:markdown-normalization-foundation-self-test ausführen
- Alle Testfälle mit OK bestätigt
- Status OK im Report
----------------------------------------
<!-- funktion -->
Preview prüfen
<!-- ziel -->
Validiert die korrekte Verdrahtung der Admin-Markdown-Normalisierung ohne Nebeneffekte
<!-- regeln -->
- Liest Controller, Template und Inspector
- Prüft explizite Admin-Aktion ohne automatische Verdrahtung
- Prüft read-only Provenienz ohne Prompt- oder Raw-Speicherung
- Prüft genreneutrale Verdrahtung
<!-- testen -->
- Bin console mto:agent:ingest:markdown-normalization-preview-self-test ausführen
- Ausgabe auf Status OK prüfen
- Alle Testfälle bestanden
----------------------------------------
<!-- funktion -->
Promptversion aktivieren
<!-- ziel -->
Macht eine gespeicherte Promptversion zur aktiven Version
<!-- regeln -->
- Nur Super-Admins haben Zugriff
- Aktivierung durch POST-Request
- CSRF-Token wird geprüft
- Aktivierte Version wird als aktuell markiert
- Fehler zeigen eine Flash-Meldung
<!-- testen -->
- System-Prompt-Verwaltung öffnen
- LMB auf "Aktivieren" neben einer inaktiven Version
- Flash-Meldung "Version aktiviert" erscheint
- Version zeigt aktivierten Zustand
----------------------------------------
<!-- funktion -->
Promptversion löschen
<!-- ziel -->
Entfernt eine nicht mehr benötigte Promptversion dauerhaft
<!-- regeln -->
- Super Admin erforderlich
- Post-Request erforderlich
<!-- testen -->
- LMB auf Löschen-Button der Version
- Bestätigung bestätigen
- Erfolgsmeldung wird angezeigt
- Version nicht mehr in Liste
----------------------------------------
<!-- funktion -->
Promptversionen verwalten
<!-- ziel -->
Erstellt neue Versionen und listet vorhandene auf
<!-- regeln -->
- POST erstellt neue Version
- GET listet alle Versionen auf
- Aktive Version hervorgehoben
- Neueste Version zuerst sortiert
<!-- testen -->
- POST mit gültigen Daten absenden
- Erfolgsmeldung sichtbar
----------------------------------------
<!-- funktion -->
Restore-Vorschau prüfen
<!-- ziel -->
Zeigt eine Vorschau des letzten Backups ohne Daten wiederherzustellen
<!-- regeln -->
- Nur Super-Admin
- CSRF-Token erforderlich
- Kein Restore wird ausgeführt
- Ergebnis als Flash-Meldung
<!-- testen -->
- Als Super-Admin anmelden
- POST an Admin-Restore-Endpunkt dry-run latest
- Flash-Meldung mit Ergebnis
- Zurück zur Übersicht
----------------------------------------
<!-- funktion -->
Simulation ausführen
<!-- ziel -->
Testet die MCP-Evidence-Sanilisierung ohne AgentRunner
<!-- regeln -->
- JSON und Datei schließen sich gegenseitig aus
- Fehlende Eingabe lädt Fixture
- Rückgabe enthält sanitisiertes Payload und EvidenceItem
<!-- testen -->
- php bin\console mto:agent:mcp:evidence-dry-run --payload-json='{}'
- Befehl zeigt JSON-Ausgabe mit Status
- Status ist OK oder empty
----------------------------------------
<!-- funktion -->
Systemzustand zurücksetzen
<!-- ziel -->
Setzt alle Dokumentversionen und den Wissensindex auf den Ausgangszustand zurück
<!-- regeln -->
- Nur POST-Requests werden akzeptiert
- CSRF-Token wird geprüft
- Benutzer muss ROLE_EDITOR besitzen
- Löscht alle Dokumentversionen
- Setzt alle Ingest-Jobs zurück
- Leert den Wissensindex
- Gibt eine Bestätigungsmeldung aus
<!-- testen -->
- POST an Admin-Endpunkt zum Zurücksetzen senden
- CSRF-Token im Request mitgeben
- Erfolgsmeldung prüfen
- Alle Versionen und Ingest-Jobs entfernt
----------------------------------------
<!-- funktion -->
Verzeichnis bereinigen
<!-- ziel -->
Hält den Eingangsbereich sauber und vermeidet vollaufende Speicher durch verwaiste Dateien
<!-- regeln -->
- Nur POST erlaubt
- CSRF-Token erforderlich
- ROLE_EDITOR erforderlich
- Leere Upload-Ordner werden entfernt
- Alte fehlgeschlagene Ablagen werden verschoben
- Alte übersprungene Ablagen werden verschoben
- Warnungen als Flash-Meldungen ausgegeben
<!-- testen -->
- POST an Admin-Batch-Cleanup senden
- Gültiges CSRF-Token übergeben
- Berichtsübersicht öffnet sich
- Erfolgsmeldung mit Bereinigungszähler
----------------------------------------
<!-- funktion -->
Admin-Login bereitstellen
----------------------------------------
<!-- funktion -->
Fehlerseite anzeigen