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