Files
Laufzettel/docs/issues/010-vorlagen-editor.md
T
Florian WildeandClaude Opus 5 abacad1cb7
Prüfung / pruefung (push) Canceled after 0s
Prüfung / pruefung (pull_request) Canceled after 0s
Prüfung / e2e (push) Canceled after 0s
Prüfung / e2e (pull_request) Canceled after 0s
feat(vorlagen): Versionierung, Unveraenderlichkeit und JSON-Austausch
Eine veroeffentlichte Vorlagen-Version ist fuer immer unveraenderlich — daran
haengt, dass ein archivierter Lauf in zehn Jahren noch genau die Schritte zeigt,
mit denen er gestartet wurde. Die Regel steht deshalb zweimal: im Service, der
die verstaendliche Meldung gibt, und in der Datenbank, die die Garantie gibt.
Vier Trigger fangen Schreibzugriffe ab, die nicht durch den Service kommen —
Migrationen, psql, der Seed und ab Phase 4 die Connectoren — und versperren den
Rueckweg nach ENTWURF, der alles andere ausgehebelt haette.

- Service: anlegen, Kopfdaten bearbeiten, Entwurf als tiefe Kopie der letzten
  veroeffentlichten Version, speichern, veroeffentlichen, verwerfen,
  duplizieren, archivieren
- Hoechstens ein Entwurf je Vorlage, durchgesetzt vom partiellen Index; zwei
  gleichzeitige Klicks auf „Bearbeiten“ bekommen denselben Entwurf statt eines
  Fehlers
- Optimistisches Sperren ueber geaendertAm: wer auf einem ueberholten Stand
  speichert, wird abgewiesen statt die Arbeit des anderen spurlos zu ersetzen
- JSON-Export und -Import samt Format-Dokumentation; der Export ist nachsichtig,
  der Import streng
- src/lib/validierung.ts als einzige Zod-Quelle mit deutschen Meldungen, per
  ESLint-Regel erzwungen

Der unabhaengige Review fand drei Blocker, alle an der Mandantengrenze: der
Suchfilter brachte ein zweites OR mit und ueberschrieb die Kundenbedingung,
Historie und Aufbau einer Version filterten gar nicht. Zu queries/vorlagen.ts
gab es keinen Test — jetzt gibt es tests/vorlagen-sicht.test.ts.

428 Tests gruen (vorher 336).

Schliesst #009

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-25 08:09:21 +02:00

1.7 KiB
Raw Blame History

#010 M5 – Vorlagen-Editor

Status: offen Meilenstein: v0.1.0 Labels: phase-1, frontend Geschätzt: 10 h Tatsächlich: –

Ziel

Der Editor, in dem ein Redakteur eine Vorlage baut, ohne den Kopf über Versionen zu verlieren.

Aufgaben

  • Vorlagenliste mit Suche, Filter nach Kategorie und Tag, Kennzeichnung „Entwurf vorhanden“
  • Editor: Abschnitte und Schritte anlegen, bearbeiten, löschen; Abschnitte mit zweistelliger Nummer (01 · Vorbereitung)
  • Sortieren per Drag & Drop mit @dnd-kit, auch am Handy mit dem Finger bedienbar
  • Je Schritt: Titel, Typ (HAKEN, TEXT, ZAHL, AUSWAHL, DATUM, BEFEHL), Pflicht (roter Stern), Hilfetext als Markdown, Doku-Link
  • Typabhängige konfig-Formulare: Auswahloptionen, Min/Max/Einheit, bei BEFEHL die Shell (powershell/bash/cmd), multiline und der Befehlstext
  • Variablen definieren: key, Label, Typ, Optionen, Pflicht, Position
  • Vorschau der Vorlage wie im Lauf, mit Beispielwerten
  • Veröffentlichen mit Änderungsnotiz, Versionshistorie ansehen, Vorlage duplizieren, JSON-Export und -Import
  • Warnung im Editor bei unbekannten Platzhaltern in Titel, Hilfetext und Befehlstext
  • Screenshots Liste, Editor, Historie in docs/screenshots/m5/

Akzeptanzkriterien

  • Eine Vorlage lässt sich vollständig ohne Umweg über die Datenbank anlegen, sortieren, veröffentlichen
  • Eine veröffentlichte Version ist im Editor nur lesend; „Bearbeiten“ erzeugt sichtbar einen Entwurf
  • Unbekannte Platzhalter werden als Warnung angezeigt, blockieren aber das Speichern nicht
  • Sortieren funktioniert am Handy bei 390 px Breite ohne horizontales Scrollen
  • Der Markdown-Hilfetext rendert ohne rohes HTML