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
+53 -1
View File
@@ -2,7 +2,7 @@
type: Roadmap
status: ACTIVE
owner: Lead Architect
last_update: 2026-04-20
last_update: 2026-04-21
---
# MASTER ROADMAP: Meldestelle
@@ -175,6 +175,58 @@ und über definierte Schnittstellen kommunizieren.
---
## 3. Initiative: Wizard-Orchestrator & Offline-Drafts (Q2/Q3 2026)
🏗️ Verantwortlich: Lead Architect · 🎨 Frontend · 🖌️ UI/UX · 👷 Backend · 🧐 QA · 🧹 Curator
Ziel: Konsolidierung aller „Wizards“ auf ein deklaratives Orchestrierungs-Framework (Graph + Guards + Effects), vereinheitlichte Validierung und Offline-Draft-Fähigkeit inkl. DeltaSync. Desktop-first, tastaturbedienbar, testbar.
### 3.1 Kernbausteine
- Orchestrator Runtime & DSL: `StepId`, `WizardContext`, `WizardState`, `Guard`, `Transition`, `StepEffects`.
- WizardScaffold: Breadcrumb, Kontext-Chips, Footer mit Hotkeys (Enter/Shift+Enter/Alt+S), Fehler-Summary.
- DraftStore: Autosave pro Step (`onLeave`), Resume, `flowVersion`, Konfliktanzeige.
- DevTools: strukturierte Transition-Logs, Graph-Export (DOT/PlantUML).
Referenzen/Dokumente:
- ADR0025: Wizard-Orchestrator (StateMachine, DSL, Guards, Effects) → `docs/01_Architecture/adr/0025-wizard-orchestrator-de.md`
- ADR0026: Step-Validation-Policy (sync vs. async, Fehlersichtbarkeit, Hotkeys) → `docs/01_Architecture/adr/0026-validation-policy-de.md`
- ADR0027: Draft-Domain & DeltaSync (Versionierung, Konfliktlösung, Idempotenz) → `docs/01_Architecture/adr/0027-draft-domain-and-delta-sync-de.md`
- Reference: WizardDSL README (Beispiel-Flow Event) → `docs/01_Architecture/Reference/Wizard-DSL-README.md`
### 3.2 Migrationsstrategie (Strangler)
1) Parallelbetrieb: Neuer Orchestrator in `frontend/core/wizard`; bestehende VMs delegieren schrittweise.
2) Inkrement 1: EventFlow zunächst 2 Steps (ZNS_CHECK, VERANSTALTER_SELECTION), dann alle 6 Steps.
3) FeatureFlag `WizardRuntimeEnabled` für risikoarmen Rollout.
### 3.3 Phasenplanung (Auszug)
- Phase 1 (Core & Tooling, 23 Wochen): Runtime/DSL, DevLogs, GraphExport, ScaffoldMVP, UnitTests.
- Phase 2 (EventFlow, 23 Wochen): `EventStep/Acc/Guards`, FlowDSL, VMDelegation, Validierung, Autosave/Resume.
- Phase 3 (Backend, 24 Wochen): Draft-/ValidateAPIs, OfflineQueue, DeltaSync für Turniere.
- Phase 4 (Skalierung, 610 Wochen, parallel): Weitere Flows je Bounded Context.
- Phase 57 (23 + 12 + 12 Wochen): UXHärtung, Observability/RolloutGates, Stabilisierung & Abschaltung Altlogik.
Grobe Gesamtdauer: 1729 Wochen je nach Parallelisierung.
### 3.4 Akzeptanzkriterien (DoD Initiative)
- Alle priorisierten Flows laufen über Orchestrator; Next/Back/History deterministisch; GraphExport aktuell.
- DraftStore produktiv; Resume deterministisch; DeltaSync idempotent; Konflikte nichtblockierend sichtbar.
- ValidierungsPolicy konsistent; TastaturBedienung vollständig; PerformanceGates eingehalten.
- ADR0025/0026/0027 veröffentlicht; WizardDSLReference vorhanden; CI grün; Metriken/Alerts aktiv.
### 3.5 10TageStartplan
- Tag 12: Runtime/DSLSkelett, ScaffoldMVP, FeatureFlag, README Skeleton.
- Tag 3: EventStep/Acc/Guards, EventFlow (2 Steps), VMDelegation minimal.
- Tag 4: Tests Runtime/Guards, GraphExport, DevLogs.
- Tag 56: META_DATA/ANSPRECHPERSON migrieren, ValidierungsAPI, FehlerSummary.
- Tag 7: DraftStore lokal (Autosave/Resume), PropertyTest Resume.
- Tag 8: TURNIER_ANLAGE einbetten, Sync via `onComplete`.
- Tag 9: SUMMARY + Finalisierung, Offload in OfflineQueue (Stub).
- Tag 10: ADR0025/0026/0027 Review+Merge; JournalEintrag.
Journal: `docs/99_Journal/2026-04-21_Wizard-Orchestrator_Roadmap_Anchoring.md`
---
## 3. Aktuelle Phase
### PHASE 5: P2-Contexts & Integration ✅ ABGESCHLOSSEN