4.1 KiB
4.1 KiB
Dokumente
kern
Organisiert Dokumente mit Versionierung und prüft deren Bereitschaft für den Wissensindex
- 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
Abschnitte laden
Markiert eine Dokumentversion für den nächsten Index-Neuaufbau
- Nur aktive Versionen sind zulässig
- CSRF-Token erforderlich
- Editor-Rolle erforderlich
- Abschnitte über Admin-Endpunkt laden mit gültigem Token
- Aktive Version auswählen
- Erfolgsmeldung: Version für Index-Neuaufbau vorgemerkt
Abschnittsqualität laden
Zeigt Qualitätskennzahlen der Textabschnitte einer Dokumentversion im Admin-Bereich
- Benötigt ROLE_EDITOR
- Liefert JSON mit Qualitätsdaten
- Fehler liefert ok=false mit Fehlermeldung
- Admin-Endpunkt abrufen
- Valides CSRF und Version vorhanden
- JSON mit ok=true und quality-Daten
Dokument anzeigen
Zeigt alle Details eines Dokuments mit Versionshistorie und Qualitätsindikatoren
- Nur Benutzer mit ROLE_EDITOR
- DocumentVersionPreviewService lädt Inhalt
- DocumentChunkInspectionService prüft Segmentierung
- DocumentMarkdownNormalizationInspector analysiert Markdown
- DocumentIndexReadinessService zeigt Indexbereitschaft
- Admin-Dokumentenansicht öffnen
- Seite zeigt Dokument mit Versionen und Qualitätsdaten
- Chunk-Übersicht sichtbar
- Markdown-Normalisierungsstatus sichtbar
- Index-Bereitschaftsanzeige sichtbar
Dokument entfernen
Entfernt ein Dokument dauerhaft aus dem System
- Entfernt alle Versionen des Dokuments
- Loescht verknuepfte Ingest-Jobs
- Bereinigt zugeordnete Dateien
- Entfernen-Knopf betaetigen
- Bestaetigung bestaetigen
- Dokument nicht mehr in Uebersicht
Dokument erstellen
Erstellt ein neues Dokument aus einer hochgeladenen Datei
- 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
- Admin-Dokumente-Neu aufrufen
- Formular mit Datei und Titel absenden
- Erfolgsmeldung und Weiterleitung zur Dokumentdetailseite
Dokumente auflisten
Zeigt alle Dokumente mit Statistiken und Filtern an
- Filter werden aus URL-Parametern geladen
- Aktive Filter werden hervorgehoben
- Zeigt Statistiken zur Dokumentenübersicht
- Index-Bereitschaft wird angezeigt
- admin/documents öffnet die Übersicht
- Dokumente werden mit Titeln angezeigt
- LMB auf Filterfeld
- Filterkriterium auswählen
- Ergebnis zeigt gefilterte Dokumente
Markdown bereinigen
Erstellt eine normalisierte Markdown-Version aus dem Original
- CSRF-Token erforderlich
- Neue Version ist inaktiv
- Abgeleitet von ausgewaehlter Version
- Seite der Dokumentversion öffnen
- POST an markdown-normalize-Endpunkt senden
- Neue inaktive Version erzeugt
Version-Chunks abrufen