mocode-software/meldestelle
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
162e2ef414
meldestelle/docs/01_Architecture/adr/0025-wizard-orchestrator-de.md
StefanMoCoAt ec124e9acd 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>
2026-04-21 16:21:22 +02:00

1.4 KiB
Raw Blame History

type status owner date
ADR PROPOSED Lead Architect 2026-04-21

ADR-0025 — Wizard-Orchestrator (State-Machine, DSL, Guards, Effects)

Kontext

  • Aktuelle Wizard-Implementierungen sind linear (next/previous) und hart verdrahtet in ViewModels.
  • Anforderungen: Kontextabhängige Pfade, Offline‑First (Autosave/Resume), testbare Regeln, einheitliche UX.

Entscheidung

  • Einführung eines generischen Orchestrators mit deklarativem Flow:
    • StepId (typsicher je Flow), WizardContext, WizardState, Guard, Transition, StepEffects.
    • Kotlin‑DSL: flow { step { whenGuard(id) go target; otherwise go … } }.
    • Side‑Effects an Hooks (onEnter/onLeave/onComplete) für Prefetch, Autosave, Finalisierung.

Konsequenzen

  • Vorteile: zentrale, testbare Navigationslogik; konsistente Draft‑Policy; bessere Übersicht/Erweiterbarkeit.
  • Risiken: Initialer Overhead, Lernkurve, Guard‑Sprawl; mitigiert durch README, DevTools, Linting/Namenskonventionen.

Umsetzung

  • Modul frontend/core/wizard (runtime, dsl, devtools, draft) und WizardScaffold (Breadcrumb, Footer, Hotkeys).
  • Strangler‑Migration beginnend mit Event‑Flow; Feature‑Flag WizardRuntimeEnabled.

Verweise

  • Roadmap‑Abschnitt: docs/01_Architecture/MASTER_ROADMAP.md#3-initiative-wizard-orchestrator--offline-drafts-q2q3-2026
  • Reference: docs/01_Architecture/Reference/Wizard-DSL-README.md