update

daten/RAG/dokumente.md

@@ -0,0 +1,127 @@
+<!-- titel -->
+Dokumente
+----------------------------------------
+<!-- art -->
+kern
+----------------------------------------
+<!-- ziel -->
+Organisiert Dokumente mit Versionierung und prüft deren Bereitschaft für den Wissensindex
+----------------------------------------
+<!-- regeln -->
+- POST-Operationen erfordern CSRF-Token
+- Versionen absteigend nach Versionsnummer sortiert
+- Fehler bei API-Routen liefern ok=false mit Meldung
+- Dateien im konfigurierten Upload-Verzeichnis gespeichert
+- Index-Neuaufbau erfordert bewusste Auslösung
+- Titelvorschläge erzeugen: Endpunkt fehlt
+- Version ableiten: Endpunkt fehlt
+- Version aktivieren: Endpunkt fehlt
+- Version ingest: Endpunkt fehlt
+- Formularansicht GET fehlt
+- TagController mit Tag erstellen, Tag entfernen, Tag zuweisen fehlt
+----------------------------------------
+<!-- funktion -->
+Abschnitte laden
+<!-- ziel -->
+Markiert eine Dokumentversion für den nächsten Index-Neuaufbau
+<!-- regeln -->
+- Nur aktive Versionen sind zulässig
+- CSRF-Token erforderlich
+- Editor-Rolle erforderlich
+<!-- testen -->
+- Abschnitte über Admin-Endpunkt laden mit gültigem Token
+- Aktive Version auswählen
+- Erfolgsmeldung: Version für Index-Neuaufbau vorgemerkt
+----------------------------------------
+<!-- funktion -->
+Abschnittsqualität laden
+<!-- ziel -->
+Zeigt Qualitätskennzahlen der Textabschnitte einer Dokumentversion im Admin-Bereich
+<!-- regeln -->
+- Benötigt ROLE_EDITOR
+- Liefert JSON mit Qualitätsdaten
+- Fehler liefert ok=false mit Fehlermeldung
+<!-- testen -->
+- Admin-Endpunkt abrufen
+- Valides CSRF und Version vorhanden
+- JSON mit ok=true und quality-Daten
+----------------------------------------
+<!-- funktion -->
+Dokument anzeigen
+<!-- ziel -->
+Zeigt alle Details eines Dokuments mit Versionshistorie und Qualitätsindikatoren
+<!-- regeln -->
+- Nur Benutzer mit ROLE_EDITOR
+- DocumentVersionPreviewService lädt Inhalt
+- DocumentChunkInspectionService prüft Segmentierung
+- DocumentMarkdownNormalizationInspector analysiert Markdown
+- DocumentIndexReadinessService zeigt Indexbereitschaft
+<!-- testen -->
+- Admin-Dokumentenansicht öffnen
+- Seite zeigt Dokument mit Versionen und Qualitätsdaten
+- Chunk-Übersicht sichtbar
+- Markdown-Normalisierungsstatus sichtbar
+- Index-Bereitschaftsanzeige sichtbar
+----------------------------------------
+<!-- funktion -->
+Dokument entfernen
+<!-- ziel -->
+Entfernt ein Dokument dauerhaft aus dem System
+<!-- regeln -->
+- Entfernt alle Versionen des Dokuments
+- Loescht verknuepfte Ingest-Jobs
+- Bereinigt zugeordnete Dateien
+<!-- testen -->
+- Entfernen-Knopf betaetigen
+- Bestaetigung bestaetigen
+- Dokument nicht mehr in Uebersicht
+----------------------------------------
+<!-- funktion -->
+Dokument erstellen
+<!-- ziel -->
+Erstellt ein neues Dokument aus einer hochgeladenen Datei
+<!-- regeln -->
+- Erfordert Rolle ROLE_EDITOR
+- Nur POST-Requests erzeugen ein Dokument
+- CSRF-Token Pflicht
+- Hochgeladene Datei Pflicht
+- Titel Pflicht
+- Titel maximal 255 Zeichen
+- Dateiname normiert
+- Datei gespeichert im konfigurierten Upload-Verzeichnis
+<!-- testen -->
+- Admin-Dokumente-Neu aufrufen
+- Formular mit Datei und Titel absenden
+- Erfolgsmeldung und Weiterleitung zur Dokumentdetailseite
+----------------------------------------
+<!-- funktion -->
+Dokumente auflisten
+<!-- ziel -->
+Zeigt alle Dokumente mit Statistiken und Filtern an
+<!-- regeln -->
+- Filter werden aus URL-Parametern geladen
+- Aktive Filter werden hervorgehoben
+- Zeigt Statistiken zur Dokumentenübersicht
+- Index-Bereitschaft wird angezeigt
+<!-- testen -->
+- admin/documents öffnet die Übersicht
+- Dokumente werden mit Titeln angezeigt
+- LMB auf Filterfeld
+- Filterkriterium auswählen
+- Ergebnis zeigt gefilterte Dokumente
+----------------------------------------
+<!-- funktion -->
+Markdown bereinigen
+<!-- ziel -->
+Erstellt eine normalisierte Markdown-Version aus dem Original
+<!-- regeln -->
+- CSRF-Token erforderlich
+- Neue Version ist inaktiv
+- Abgeleitet von ausgewaehlter Version
+<!-- testen -->
+- Seite der Dokumentversion öffnen
+- POST an markdown-normalize-Endpunkt senden
+- Neue inaktive Version erzeugt
+----------------------------------------
+<!-- funktion -->
+Version-Chunks abrufen