mocode-software/meldestelle
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
5cbf4fdfc0
meldestelle/docs/01_Architecture/adr/0026-validation-policy-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.1 KiB
Raw Blame History

type status owner date
ADR PROPOSED Lead Architect 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