305 lines
10 KiB
Markdown
305 lines
10 KiB
Markdown
<!-- 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
|