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

10 KiB

System

kern

Ermöglicht Systemadministration, Betriebsvalidierung und Datenmanagement für Admins

  • 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

Access-Denied-Fehler bereitstellen

Zeigt eine informative Fehlerseite mit kontextabhängigen Weiterleitungen an

  • Fehlercode 403 im Titel
  • Rollenabhängige Startseite
  • Anmeldung für Gäste
  • Rolle "Chat" führt zum Chat
  • Rolle "Admin" führt zum Dashboard
  • Seite ohne Anmeldung aufrufen
  • Klick auf geschützte Ressource
  • error403-Seite mit Anmelde-Button

Betriebsbereitschaft prüfen

Validiert die Enterprise-Readiness-Baseline ohne Chat-Runtime-Nebeneffekte

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

Cache leeren

Leert den PHP-Runtime-Cache und den Vector-Service Query-Cache

  • POST erfordert gültiges CSRF-Token
  • Erfolgreiches Leeren zeigt success-Flash
  • Fehler zeigt danger-Flash und bricht ab
  • POST an admin-runtime-cache-clear mit korrektem _token
  • Erfolgreicher Flash erscheint
  • Redirect zu admin-dashboard
  • Cache nach dem Leeren leer

Daten neu laden

Synchronisiert alle Indizes und das Embedding-Modell mit dem Dateisystem

  • 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
  • POST-Reload-Endpunkt aufrufen
  • 200 OK
  • status: reloaded

Daten sichern

Erstellt periodische Sicherungskopien, um Datenverlust zu verhindern

  • 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
  • mto:agent:enterprise:backup-run mit --json ausführen
  • JSON-Status auf SUCCESS prüfen
  • backup_id und target im JSON vorhanden

Deployment prüfen

Prüft Deployment-Bereitschaft und protokolliert das Ergebnis

  • CSRF-Token wird geprüft
  • DeploymentSchedulerReadinessService liefert Report
  • Prüfung wird im OperatorCheckProtocol protokolliert
  • Flash-Meldung zeigt Status der Prüfung
  • POST an Admin-Endpoint für Deployment-Prüfung senden
  • Weiterleitung zu admin_enterprise_operations
  • Flash-Meldung zeigt Deployment-Status

Dienststatus melden

Ermöglicht die Überwachung der Betriebsbereitschaft des Dienstes

  • Gibt JSON zurück
  • Enthält immer Status ok
  • Enthält alle Komponentenzustände
  • GET an health-Endpunkt senden
  • Antwort prüfen
  • Status ok vorhanden

Flow-Grenze sperren

Validiert die passive AgentRunner-Flow-Boundary-Linie ohne Runtime-Nebeneffekte

  • 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
  • Kommando mto:agent:architecture:flow-boundary-lock-self-test ausfuehren
  • Alle Pruefungen bestaetigen OK
  • Status OK zurueckgemeldet

Neuindizierung starten

Startet eine vollständige Neuindizierung aller Inhalte als Hintergrundprozess

  • Erfordert ROLE_SUPER_ADMIN
  • CSRF-Token wird geprüft
  • Fehlgeschlagener Start zeigt Flash-Meldung und Weiterleitung
  • 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

Normalisierung prüfen

Prüft ob die Normalisierungs-Infrastruktur korrekt aufgebaut ist

  • 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
  • mto:agent:ingest:markdown-normalization-foundation-self-test ausführen
  • Alle Testfälle mit OK bestätigt
  • Status OK im Report

Preview prüfen

Validiert die korrekte Verdrahtung der Admin-Markdown-Normalisierung ohne Nebeneffekte

  • 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
  • Bin console mto:agent:ingest:markdown-normalization-preview-self-test ausführen
  • Ausgabe auf Status OK prüfen
  • Alle Testfälle bestanden

Promptversion aktivieren

Macht eine gespeicherte Promptversion zur aktiven Version

  • 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
  • System-Prompt-Verwaltung öffnen
  • LMB auf "Aktivieren" neben einer inaktiven Version
  • Flash-Meldung "Version aktiviert" erscheint
  • Version zeigt aktivierten Zustand

Promptversion löschen

Entfernt eine nicht mehr benötigte Promptversion dauerhaft

  • Super Admin erforderlich
  • Post-Request erforderlich
  • LMB auf Löschen-Button der Version
  • Bestätigung bestätigen
  • Erfolgsmeldung wird angezeigt
  • Version nicht mehr in Liste

Promptversionen verwalten

Erstellt neue Versionen und listet vorhandene auf

  • POST erstellt neue Version
  • GET listet alle Versionen auf
  • Aktive Version hervorgehoben
  • Neueste Version zuerst sortiert
  • POST mit gültigen Daten absenden
  • Erfolgsmeldung sichtbar

Restore-Vorschau prüfen

Zeigt eine Vorschau des letzten Backups ohne Daten wiederherzustellen

  • Nur Super-Admin
  • CSRF-Token erforderlich
  • Kein Restore wird ausgeführt
  • Ergebnis als Flash-Meldung
  • Als Super-Admin anmelden
  • POST an Admin-Restore-Endpunkt dry-run latest
  • Flash-Meldung mit Ergebnis
  • Zurück zur Übersicht

Simulation ausführen

Testet die MCP-Evidence-Sanilisierung ohne AgentRunner

  • JSON und Datei schließen sich gegenseitig aus
  • Fehlende Eingabe lädt Fixture
  • Rückgabe enthält sanitisiertes Payload und EvidenceItem
  • php bin\console mto:agent:mcp:evidence-dry-run --payload-json='{}'
  • Befehl zeigt JSON-Ausgabe mit Status
  • Status ist OK oder empty

Systemzustand zurücksetzen

Setzt alle Dokumentversionen und den Wissensindex auf den Ausgangszustand zurück

  • 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
  • POST an Admin-Endpunkt zum Zurücksetzen senden
  • CSRF-Token im Request mitgeben
  • Erfolgsmeldung prüfen
  • Alle Versionen und Ingest-Jobs entfernt

Verzeichnis bereinigen

Hält den Eingangsbereich sauber und vermeidet vollaufende Speicher durch verwaiste Dateien

  • 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
  • POST an Admin-Batch-Cleanup senden
  • Gültiges CSRF-Token übergeben
  • Berichtsübersicht öffnet sich
  • Erfolgsmeldung mit Bereinigungszähler

Admin-Login bereitstellen

Fehlerseite anzeigen