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:
@@ -0,0 +1,28 @@
|
||||
---
|
||||
type: ADR
|
||||
status: PROPOSED
|
||||
owner: Lead Architect
|
||||
date: 2026-04-21
|
||||
---
|
||||
|
||||
# ADR-0026 — Step-Validation-Policy (Sync vs. Async, Fehlersichtbarkeit, Hotkeys)
|
||||
|
||||
## Kontext
|
||||
- Validierungen sind heute uneinheitlich verteilt (UI/Backend) und nicht klar priorisiert (blockierend vs. Hinweis).
|
||||
|
||||
## Entscheidung
|
||||
- Sync-Validierung pro Step als pure Funktion (schnell, offline, blockierend für „Weiter“).
|
||||
- Async-Validierungen (Server/DB) als nicht-blockierende Hinweise mit Retry; Ergebnisse im Footer aggregiert.
|
||||
- Einheitliche Hotkeys: Enter=Weiter, Shift+Enter=Zurück, Alt+S=Speichern (Draft), Alt+J=Step-Sprung.
|
||||
|
||||
## Konsequenzen
|
||||
- Konsistente Nutzererwartung, klare Trennung von Fehlerklassen, bessere Testbarkeit.
|
||||
- Erfordert Footer-Fehlersummary und Dev-Overlay (Guard/Validation-Trace).
|
||||
|
||||
## Umsetzung
|
||||
- API `validate(accumulator): ValidationResult` je Step.
|
||||
- Async-Pipeline mit Debounce (250ms) und Status-Pills; keine UI-Blocker bei Netzwerkfehlern.
|
||||
|
||||
## 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`
|
||||
Reference in New Issue
Block a user