mocode-software/meldestelle
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
88983f2b4e
meldestelle/docs/99_Journal/2026-04-17_Desktop-Wizard-OETO-ZNS-Update.md
Stefan Mogeritsch 3949ab21db refactor(desktop): V2-Suffixe entfernt und VeranstaltungKomponenten modularisiert 
Signed-off-by: Stefan Mogeritsch <stefan.mo.co@gmail.com>
2026-04-17 11:40:09 +02:00

3.7 KiB
Raw Blame History

Session Journal: 2026-04-17 - Vormittag

🎯 Ziele der Session

  1. Technischer Blocker: Stabilisierung des Consul-Health-Checks für den masterdata-service.
  2. ÖTO-Konformität: Implementierung von Guardrails für Turnier-Zeitspannen (1-2 Tage für C-Turniere) im Desktop-Wizard.
  3. OEPS-Validierung: Sicherstellung korrekter Vereinsnummern (B-NNN) bei manueller Erfassung.
  4. UX-Polishing: Integration des ZNS-Synchronisationsstatus in die Footer-Bar der Desktop-App.

🛠️ Durchgeführte Änderungen

🔧 1. Backend: Consul & Master-Data (Infrastruktur)

  • Datei: backend/services/masterdata/masterdata-service/src/main/resources/application.yml
  • Änderung:
    • health-check-interval von 10s auf 20s erhöht.
    • health-check-timeout auf 10s gesetzt.
    • deregister-critical-service-after auf 5m gesetzt.
  • Grund: Vermeidung von "Ghost-Failures" im Consul-Dashboard, wenn die Datenbank-Verbindung während des Ktor-Starts noch nicht vollständig bereit ist.
  • Update: Problematische Properties deregister-critical-service-after und health-check-port vorerst auskommentiert, da diese in der aktuellen Konfiguration zu Auflösungsfehlern führten.

📜 2. Frontend: ÖTO-Guardrails (Wizard Schritt 2)

  • Datei: frontend/shells/meldestelle-desktop/src/jvmMain/kotlin/at/mocode/desktop/v2/VeranstaltungScreens.kt
  • Änderung:
    • Logik zur Berechnung der Turniertage (ChronoUnit.DAYS) eingebaut.
    • Einblendung eines Info-Badges: "Hinweis: Gemäß ÖTO sind C-Turniere auf 2 Tage begrenzt.", falls die Zeitspanne > 2 Tage ist.
    • Korrektur: Typ-Mismatch bei Icon behoben (Parameter color zu tint geändert).
    • Kein harter Block, sondern eine fachliche Hilfestellung (Guardrails).

🏷️ 3. Frontend: OEPS-Nummer Validierung

  • Datei: frontend/shells/meldestelle-desktop/src/jvmMain/kotlin/at/mocode/desktop/v2/VeranstaltungScreens.kt
  • Änderung:
    • Regex-Validierung (^[1-9]-[0-9]{3}$) für die manuelle OEPS-Nummern-Eingabe hinzugefügt.
    • Fehlermeldung bei falschem Format (z.B. "4-001" erforderlich).
  • Grund: Sicherstellung der Datenqualität für den späteren OEPS-Ergebnisexport (A/B/C-Sätze).

🎨 4. UX: Status-Bar & ZNS-Badge

  • Datei: frontend/shells/meldestelle-desktop/src/jvmMain/kotlin/at/mocode/desktop/screens/layout/DesktopMainLayout.kt
  • Änderung:
    • ZnsImportProvider in die DesktopFooterBar injiziert.
    • Neues Status-Icon Dataset (ZNS) hinzugefügt.
    • Anzeige der letzten Sync-Version (z.B. ZNS: V12 oder ZNS: Kein Sync).
    • Farbliche Kennzeichnung (Grün/Gelb/Rot) je nach Synchronisationsstand.

🏗️ 5. Fachlich: Disziplinen & Bewerbe (Schritt 2 & 3)

  • Datei: frontend/shells/meldestelle-desktop/src/jvmMain/kotlin/at/mocode/desktop/v2/VeranstaltungScreens.kt
  • Änderung:
    • Schritt 2: Felder für PLZ und Disziplin-Auswahl (Springen, Dressur, etc.) hinzugefügt.
    • Schritt 3: Komplettes Bewerbs-Management implementiert. User können Prüfungsnummern, Klassen und Bezeichnungen erfassen.
    • Validierung: Der Wizard lässt sich erst finalisieren, wenn mindestens ein Bewerb angelegt wurde.
  • Grund: Vorbereitung der Datenstruktur für den OEPS-Export und Verbesserung der fachlichen Abdeckung im Wizard.

✅ Ergebnis & Status

  • Das Consul-Dashboard sollte nun einen stabilen "Grün"-Status für den masterdata-service anzeigen.
  • Der Desktop-Wizard leitet den User fachlich korrekt durch die Turnier-Anlage.
  • Der User hat jederzeit volle Transparenz über den Stand seiner lokalen ZNS-Daten.
  • Die Erfassung von Bewerben legt den Grundstein für die spätere Nennungs- und Ergebnisverwaltung.

🏗️ [Lead Architect] & 🧹 [Curator] Datum: 17. April 2026 | Status: Abgeschlossen