update

daten/RAG/knowledge-raeume.md

@@ -0,0 +1,141 @@
+<!-- titel -->
+Knowledge-Räume
+----------------------------------------
+<!-- art -->
+kern
+----------------------------------------
+<!-- ziel -->
+Stellt Knowledge-Räume bereit und verwaltet deren Inhalte sowie Anbindungen
+----------------------------------------
+<!-- regeln -->
+- CSRF-Token wird bei POST-Anfragen geprüft
+- no-report verhindert das Schreiben von Berichtsdateien
+- Anbindung Tool-Allowlist aktualisiert separate Anbindung
+----------------------------------------
+<!-- funktion -->
+Batch-Import durchführen
+<!-- ziel -->
+Importiert Wissensdokumente aus einem Verzeichnis in den Wissensspeicher
+<!-- regeln -->
+- upload-dir ist Zieldateiverzeichnis
+- user-email identifiziert Ersteller
+- activate-derived-on-success erfordert normalize-markdown
+- dry-run erzeugt keine Dateien oder Versionen
+- reindex startet genau einen Indexlauf
+- Berichte ohne --no-report in report-dir
+<!-- testen -->
+- Batch-Import im Dry-Run-Modus ausführen
+- PHPUnit-Test KnowledgeBatchImportCommandTest ausführen
+- Erfolgsstatus und Reportdateien prüfen
+----------------------------------------
+<!-- funktion -->
+Chat-Freigabe umschalten
+<!-- ziel -->
+Aktiviert oder deaktiviert den Chat-Zugriff für einen gespeicherten Inhalt
+<!-- regeln -->
+- Nur POST-Anfragen werden akzeptiert
+- CSRF-Token wird geprüft
+- Kanditat-ID muss existieren
+<!-- testen -->
+- Seite mit Anbindungsinhalten öffnen
+- POST an Endpunkt senden
+- candidate_id senden
+- chat_enabled senden
+- Übersicht wird angezeigt
+----------------------------------------
+<!-- funktion -->
+Chat-Verfügbarkeit prüfen
+<!-- ziel -->
+Schaltet den Chat-Zugriff für einen Wissensraum ein oder aus
+<!-- regeln -->
+- POST-Request erforderlich
+- CSRF-Token wird geprüft
+- Ungültiges Token zeigt Fehlermeldung
+- Unterscheidet Server-Ressource, gespeicherte Ressource und Standard-Raum
+- Erfolgreiche Änderung zeigt Bestätigung
+<!-- testen -->
+- POST an admin_knowledge_spaces_chat_availability_update mit _token und chat_enabled
+- Leerer RaumId liefert Flash danger
+- Gültiger Toggle liefert Flash success
+- Chat-Verfügbarkeit geändert
+----------------------------------------
+<!-- funktion -->
+Facts prüfen
+<!-- ziel -->
+Prüft die diagnostischen Ingest-Facts im Index auf Vollständigkeit und korrekte Struktur
+<!-- regeln -->
+- type filtert nach spezifischem Fact-Typ
+- query durchsucht Titel, Text und alle Fact-Felder
+- Standard-Limit zeigt maximal 10 Chunks
+- json gibt maschinenlesbare Ausgabe zurück
+- Warnung bei fehlenden oder leeren Fakten
+<!-- testen -->
+- Befehl ohne Argumente ausführen
+- Chunk-Überschriften mit Metriken prüfen
+- Warnung bei leerem Ergebnis prüfen
+----------------------------------------
+<!-- funktion -->
+Kandidaten wählen
+<!-- ziel -->
+Wählt einen Tool- oder Resource-Kandidaten zur Wissensraumnutzung aus
+<!-- regeln -->
+- CSRF-Token erforderlich
+- Nur Tool- oder Resource-Kandidaten verarbeitbar
+- Kandidat wird nach Auswahl auf approved gesetzt
+- Weiterleitung zur Überblickansicht mit Review-Dialog
+<!-- testen -->
+- Überblickansicht öffnen
+- POST an provider-candidate-select mit source_key, candidate_kind
+- Flash-Nachricht über Erfolg oder Warnung
+- Redirect zur Überblickansicht mit provider_review_open=1
+----------------------------------------
+<!-- funktion -->
+Knowledge-Räume anzeigen
+<!-- ziel -->
+Stellt alle Knowledge-Räume mit Status und Anbindungen übersichtlich dar
+<!-- regeln -->
+- Lädt Verfügbarkeit und Chat-Auswahl
+- Lädt Anbindungsinhalte und Kandidaten
+- Rendert admin knowledge-spaces index html-twig
+<!-- testen -->
+- Admin-Seite Knowledge-Räume aufrufen
+- Seite mit Wissensraum-Übersicht prüfen
+- Knowledge-Räume mit Verfügbarkeit angezeigt
+----------------------------------------
+<!-- funktion -->
+Live-Vorschau laden
+<!-- ziel -->
+Lädt Ressourceninhalt live zur Prüfung vor Freigabe
+<!-- regeln -->
+- POST-Request mit gültigem CSRF-Token
+- Gibt JSON mit Inhalt und Status zurück
+- Nur für Ressourcen vom Typ resource verfügbar
+<!-- testen -->
+- POST an admin knowledge-spaces provider-resource-live-preview mit candidate_id
+- Response enthält JSON mit ok und content
+- Im Dialog erscheint der live gelesene Inhalt
+----------------------------------------
+<!-- funktion -->
+Ressourcenprüfung durchführen
+----------------------------------------
+<!-- funktion -->
+Textteile suchen
+<!-- ziel -->
+Findet Textteile, die einer Suchanfrage semantisch ähneln
+<!-- regeln -->
+- Gibt Treffer absteigend nach Ähnlichkeit zurück
+- Limit wird auf maximal 200 begrenzt
+- Optionale doc_ids filtern Treffer nach Dokument
+- Ohne doc_ids werden Treffer aus allen Dokumenten zurückgegeben
+<!-- testen -->
+- POST such-chunks mit query und limit
+- Antwort enthält sortierte Treffer mit chunk_id
+----------------------------------------
+<!-- funktion -->
+Wissensräume prüfen
+<!-- ziel -->
+Prüft die Funktionsfähigkeit aller Wissensraum-Komponenten
+<!-- testen -->
+- Admin-Übersicht öffnen
+- Diagnose starten
+- Alle Prüfungen bestanden