update

daten/RAG/versionen.md

@@ -0,0 +1,75 @@
+<!-- titel -->
+Versionen
+----------------------------------------
+<!-- art -->
+kern
+----------------------------------------
+<!-- ziel -->
+Verwaltet Versionen eines Dokuments mit Ablegen, Erstellen, Einlesen und Aktivieren
+----------------------------------------
+<!-- regeln -->
+- Versionen absteigend nach Versionsnummer sortiert
+- Preview-Daten als JSON mit ok-Feld
+- Version-Aktivierung mit CSRF-Schutz
+- Version-Aktivierung zeigt Flash-Nachricht
+- Neue Version zeigt Flash-Nachricht
+- Ableiten zeigt CSRF-Fehler bei ungültigem Token
+- Ableiten zeigt Fehler bei leerem Inhalt
+- Neue Version zeigt Fehler bei fehlender Datei
+----------------------------------------
+<!-- funktion -->
+Version ableiten
+<!-- ziel -->
+Erstellt eine neue Version aus bearbeitbaren Originaldaten
+<!-- regeln -->
+- Lädt die Originaldaten-Vorschau der Quellversion
+- POST erfordert gültiges CSRF-Token
+- Neue Version ist nach Erstellung inaktiv
+- Leerer Inhalt wird abgelehnt
+<!-- testen -->
+- Ableiten-Seite der Quellversion öffnen
+- Bearbeitbaren Quelltext im Formular anzeigen
+- POST mit Quelltext und CSRF-Token absenden
+- Neue Dokumentversion erstellt und Redirect zu Dokument
+----------------------------------------
+<!-- funktion -->
+Version einlesen
+<!-- regeln -->
+- Gibt JSON mit Preview-Daten zurück
+- Fehler als JSON mit ok: false
+<!-- testen -->
+- Dokument-Detailseite öffnen
+- LMB auf Version klicken
+- Vorschau-Request abwarten
+- JSON enthält ok: true und preview
+----------------------------------------
+<!-- funktion -->
+Version erstellen
+<!-- ziel -->
+Ermöglicht das Hinzufügen einer neuen Dokumentversion
+<!-- regeln -->
+- GET zeigt Formular mit Dokument-ID
+- POST erfordert gültiges CSRF-Token
+- POST erfordert hochgeladene Datei
+- Hochgeladene Datei wird in Upload-Verzeichnis verschoben
+- DocumentService erstellt neue Version
+<!-- testen -->
+- Admin-URL für neue Dokumentversion aufrufen
+- Formular mit Datei und CSRF-Token POSTen
+- Erfolgsmeldung Neue Dokumentversion wurde hochgeladen
+- Weiterleitung auf Dokumentdetailseite
+----------------------------------------
+<!-- funktion -->
+Versionvorschau anzeigen
+<!-- ziel -->
+Zeigt den Originaltext einer Dokumentversion in einem ausschnitt an
+<!-- regeln -->
+- LMB auf Version
+- Zeigt Textausschnitt mit Offset und Limit
+<!-- testen -->
+- Dokumentdetail öffnen
+- API version preview abrufen
+- preview enthält Textausschnitt
+----------------------------------------
+<!-- funktion -->
+Version aktivieren