chore(docs): füge ADRs 0025–0027 und Wizard-DSL-Referenz hinzu, aktualisiere Roadmap und ADR-Index

Signed-off-by: StefanMoCoAt <stefan.mo.co@gmail.com>
This commit is contained in:
2026-04-21 16:21:19 +02:00
parent 0ab1807235
commit ec124e9acd
7 changed files with 281 additions and 1 deletions
@@ -0,0 +1,31 @@
---
type: ADR
status: PROPOSED
owner: Lead Architect
date: 2026-04-21
---
# ADR-0027 — Draft-Domain & DeltaSync (Versionierung, Konfliktlösung, Idempotenz)
## Kontext
- OfflineFirst verlangt lokale Drafts, ResumeFähigkeit und robuste Synchronisation bei instabiler Konnektivität.
- Heute: kein einheitliches DraftModell, keine standardisierte Schrittweise Speicherung.
## Entscheidung
- Einführung einer DraftDomain mit Version/ETag und SchrittPatchs:
- `POST /api/events/drafts` (idempotent über IdempotencyKey) erstellt/vereinigt Drafts.
- `PATCH /api/events/drafts/{id}` speichert stepweise Deltas (nur geänderte Felder seit `version`).
- `POST /api/events` finalisiert (ServerValidierung, Erstellung `veranstaltungId`).
- Client OfflineQueue mit Retry/Backoff; Konflikte als nichtblockierende Hinweise.
## Konsequenzen
- Reproduzierbare, idempotente Speicherung; geringere Payloads; klare Konfliktauflösung.
- Erfordert Versionierung im DraftStore und Migrationspfade bei Flow‑Änderungen (`flowVersion`).
## Umsetzung
- Frontend: DraftStore (Autosave `onLeave`), DeltaBuilder je Step, Queue mit IdempotencyKey.
- Backend: Versionsverwaltung, IfMatch/ETag Unterstützung, ConflictDetect (409) mit MergeHinweisen.
## Verweise
- RoadmapAbschnitt: `docs/01_Architecture/MASTER_ROADMAP.md#3-initiative-wizard-orchestrator--offline-drafts-q2q3-2026`
- Contracts: folgen nach APISkizzierung (`contracts/` Verzeichnis)