update

daten/RAG/konfiguration.md

@@ -0,0 +1,129 @@
+<!-- titel -->
+Konfiguration
+----------------------------------------
+<!-- art -->
+kern
+----------------------------------------
+<!-- ziel -->
+Stellt Konfigurationsdaten für Ingest-Profile, Modelle, Chat-Nachrichten und Agent bereit
+----------------------------------------
+<!-- regeln -->
+- ROLE_SUPER_ADMIN darf alle Funktionen aufrufen
+- ROLE_KNOWLEDGE_ADMIN darf Konfigurationen lesen
+- POST erfordert gültiges CSRF-Token
+- Flash-Nachrichten zeigen Erfolg und Fehler
+- JsonResponse ohne Browser-Cache-Header
+- Default-Ausgabe ist JSON
+- Ingest-Profil entfernen fehlt
+- Model-Konfiguration löschen fehlt
+- Model-Konfiguration Retrieval testen fehlt
+----------------------------------------
+<!-- funktion -->
+Ingest-Profil anlegen
+<!-- ziel -->
+Legt ein Ingest-Profil an, das Dokument-Importe steuert
+<!-- regeln -->
+- Nur Super-Admin kann aufrufen
+- CSRF-Token erforderlich
+- Erfolgsmeldung bei Anlage
+<!-- testen -->
+- Seite admin-ingest-profiles-create öffnen
+- Alle Felder ausfüllen
+- Formular absenden
+- Erfolgsmeldung bestätigt Anlage
+----------------------------------------
+<!-- funktion -->
+Ingest-Profile anzeigen
+<!-- regeln -->
+- ROLE_KNOWLEDGE_ADMIN erforderlich
+- Tabelle mit Spalten
+- Aktives Profil hervorgehoben
+<!-- testen -->
+- Admin-Bereich öffnen
+- Seite "Ingest-Profiles" aufrufen
+- Tabelle mit Profilen sichtbar
+----------------------------------------
+<!-- funktion -->
+Konfiguration aktivieren
+<!-- ziel -->
+Macht eine Konfiguration zur aktiven Konfiguration
+<!-- regeln -->
+- Nur SUPER_ADMIN darf diese Funktion auslösen
+- POST-Request erforderlich
+<!-- testen -->
+- admin_model_config_list öffnen
+- POST-Request an activate-Endpunkt senden
+- Weiterleitung zur Liste
+- Konfiguration ist aktiv
+----------------------------------------
+<!-- funktion -->
+Konfiguration anzeigen
+<!-- ziel -->
+Zeigt die aktuelle RetrieX-Konfiguration zur Diagnose
+<!-- regeln -->
+- Standardausgabe ist JSON
+- summary zeigt formatierte Übersicht
+- Zeigt alle Konfigurationsbereiche
+<!-- testen -->
+- Befehl ausführen: mto:agent:config:dump-effective
+- JSON-Ausgabe mit Config-Struktur
+----------------------------------------
+<!-- funktion -->
+Konfiguration bereitstellen
+<!-- ziel -->
+Liefert dem Chatfrontend alle nötigen Konfigurationsdaten in einem Request
+<!-- regeln -->
+- Keine Browser-Cache-Header
+- JsonResponse mit Konfigurationsdaten
+- Mischt Konfiguration aus drei Quellen
+<!-- testen -->
+- GET chat-messages-frontend
+- Antwort ist JsonResponse
+- Enthält limits.prompt und limits.uploads
+- Keine Browser-Cache-Header gesetzt
+----------------------------------------
+<!-- funktion -->
+Konfigurationen anzeigen
+<!-- ziel -->
+Zeigt alle Model-Generation-Konfigurationen im Admin-Bereich
+<!-- regeln -->
+- ROLE_KNOWLEDGE_ADMIN erforderlich
+<!-- testen -->
+- Admin-Endpoint für Model-Konfiguration aufrufen
+- LMB auf Konfiguration in der Liste
+- Liste der Konfigurationen sichtbar
+----------------------------------------
+<!-- funktion -->
+Konfigurationsmuster prüfen
+<!-- ziel -->
+Prüft alle PHP-Dateien auf Verwendung von Kernmustern und markierten Token
+<!-- regeln -->
+- Ohne Option wird eine Zusammenfassung angezeigt
+- json gibt das vollständige Ergebnis maschinenlesbar aus
+- details zeigt die Warnungen als Tabelle
+- all fügt niedrigpriore REVIEW-Befunde hinzu
+- Fehlende Dateien werden als skipped_files gezählt
+<!-- testen -->
+- mto:agent:config:audit-patterns ausführen
+- Zusammenfassung mit Zählern prüfen
+- json anhängen und JSON-Struktur validieren
+- details anhängen und Tabelle prüfen
+- all anhängen und REVIEW-Zeilen prüfen
+----------------------------------------
+<!-- funktion -->
+Tool-Freigaben aktualisieren
+<!-- ziel -->
+Schaltet einzelne Werkzeuge einer Anbindung im Chat frei oder sperrt sie
+<!-- regeln -->
+- Freigabe toggelt zwischen an und aus
+- Ungültiges Token zeigt Fehlermeldung
+- Erfolg zeigt Bestätigung
+- Fehler zeigt Exception-Nachricht
+<!-- testen -->
+- Admin-Übersicht öffnen
+- POST-Anfrage mit source_key, tool_name und tool_enabled senden
+- Flash-Message prüfen
+- Zurückleitung zur Übersicht
+----------------------------------------
+<!-- funktion -->
+Ingest-Profil entfernen