meldestelle/docs/99_Journal/2026-04-20_Setup_Wizard_Professionalization.md

Journal: 20. April 2026 - Setup-Optimierung & Profi-Veranstaltungs-Wizard

🛠️ Bugfix & Optimierung (23:50)

• Scope-Korrektur: Behebung von Unresolved reference Fehlern in DeviceInitializationScreen.kt.
• State-Hoisting: Migration der Dialog-States (showRoleChangeWarning, pendingRole) vom Screen in den DeviceInitializationUiState und das ViewModel. Dies verbessert die Testbarkeit und Konsistenz bei UI-Rekonfigurationen.
• Zentralisierte Logik: Die Entscheidung, ob eine Warnung beim Rollenwechsel angezeigt werden soll, liegt nun im ViewModel.

🏗️ Device-Setup: Verlässlichkeit & Administration

• Review-Modus ("Lock-and-Edit"): Die Geräte-Initialisierung wechselt nach Abschluss in einen Read-only Modus. Änderungen erfordern eine explizite Bestätigung via Warn-Dialog, um Sync-Probleme zu vermeiden.
• Drucker-Integration: Auswahl eines Standard-Druckers direkt im Setup (Schritt 2).
• Security-Transparenz: Der sharedKey ist im Review-Modus maskiert, kann aber per Klick (Auge-Icon) für Richter-Devices sichtbar gemacht werden.
• Rollen-Schutz: Wechsel der Netzwerk-Rolle triggert nun einen Warn-Dialog, da dies bestehende Schritt-2-Konfigurationen ungültig machen kann.

🚀 "Neue Veranstaltung"-Wizard: Profi-Workflow

• ZNS-Guard: Automatischer Check der Stammdaten-Verfügbarkeit beim Start. Führt bei fehlenden Daten direkt zum ZNS-Importer.
• Sticky Preview-Card: Eine Echtzeit-Vorschau der Veranstaltung (Logo, Name, Ort, Datum) am oberen Bildschirmrand gibt sofortiges visuelles Feedback ("What You See Is What You Get").
• OEPS-Mapping (Satznummer): Integration der Satznummer-Logik für Ansprechpersonen (z.B. Ursula Stroblmair). Vorbereitung für nahtlose Verknüpfung mit Reiter-Stammdaten.
• Turnier-Struktur & PDF-Ausschreibung:
  • Unterstützung für mehrere Turniere pro Veranstaltung.
  • Integration des MsFilePicker für den PDF-Upload der Ausschreibung direkt bei der Turnier-Anlage.
  • Pfad-Validierung: Alle Felder müssen befüllt sein, bevor die Zusammenfassung erreicht wird.
• Finaler Review: Kompakter 6. Schritt zur Kontrolle aller Parameter vor dem Speichern.

🧐 Curator Abschluss

Die Desktop-App wurde heute Abend massiv professionalisiert. Das Setup schützt nun die Systemintegrität, während der neue Veranstaltungs-Wizard durch "Smart Defaults" (Vereinssitz als Ort, Vereinslogo als Platzhalter) und die Sticky-Preview ein effizientes Arbeiten ermöglicht. Die Grundlage für den realen Turnier-Betrieb am 25. April 2026 ist gelegt.

Gezeichnet durch den Curator.