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