docs: massive restructuring of documentation, development guides and agent playbooks

2026-06-15 12:54:38 +02:00
parent e4988b4397
commit ce63303b2c
686 changed files with 45423 additions and 319 deletions
@@ -0,0 +1,68 @@
+---
+type: Journal
+status: ACTIVE
+owner: Curator
+last_update: 2026-04-02
+---
+
+# Sitzungs-Log – Meldestelle (Curator)
+
+* Datum/Zeit: 2026-04-02 00:34
+* Fokus: UI/UX-Verbesserungen in der Desktop-Frontend-App, Navigation und Profil-Ansichten
+
+## Zusammenfassung
+
+* Onboarding: Eingaben für „Gerätename“ und „Sicherheitsschlüssel“ bleiben beim Zurück-Navigieren erhalten;
+  Tab/Enter-Navigation funktionsfähig.
+* Profil-Seiten: Einheitliche Vorschau-Cards mit „bearbeiten“-Dialog für Veranstalter, Pferd, Reiter, Verein,
+  Funktionär.
+* Navigation/UX: Breadcrumbs und Zurück-Navigation korrigiert; Veranstaltungs-Wizard (Schritt 2) kehrt korrekt zum
+  zugehörigen Veranstalter-Profil zurück.
+* Abschlussdialog: Vor „Veranstaltung final anlegen“ wird eine Daten-Vorschau zur Bestätigung angezeigt.
+
+## Wichtige Änderungen (High-Level)
+
+* State-Lift im Onboarding mittels `rememberSaveable`; Routing-/Back-Handling im Desktop-Layout aktualisiert.
+* Profil-Ansichten auf Card-Vorschau mit Edit-Dialog umgestellt; Persistenz an `StoreV2` gebunden.
+* Veranstaltungs-Konfig: Bestätigungs-Dialog mit Datenübersicht vor finalem Anlegen.
+
+## Betroffene/Referenz-Dateien
+
+* frontend/shells/meldestelle-desktop/src/jvmMain/kotlin/at/mocode/desktop/screens/layout/DesktopMainLayout.kt
+* frontend/shells/meldestelle-desktop/src/jvmMain/kotlin/at/mocode/desktop/v2/Screens.kt
+* frontend/shells/meldestelle-desktop/src/jvmMain/kotlin/at/mocode/desktop/v2/VeranstaltungScreens.kt
+* frontend/core/navigation/src/commonMain/kotlin/at/mocode/frontend/core/navigation/AppScreen.kt
+* frontend/features/reiter-feature/src/commonMain/kotlin/at/mocode/frontend/features/reiter/domain/Reiter.kt
+* Design-Referenzen: docs/80_Assets/frontend/screens/A_EventVerwaltung/Veranstalter-Card-v01.png,
+  docs/80_Assets/frontend/screens/A_EventVerwaltung/Veranstalter-Profil-Card-v01.png
+
+## Qualitätssicherung
+
+* Lint: keine Fehler; nur harmlose Warnungen (unbenutzte Imports/Parameter, reduzierbarer Not-Null-Call, Legacy
+  Long→Duration-Overloads).
+* Manuelle Klickpfade geprüft (ohne Backend-Abhängigkeit).
+
+## Offene Punkte / ToDos
+
+* Onboarding: Werte-Persistenz in allen Rücknavigations-Pfaden erneut verifizieren (frühere Inkonsistenz gemeldet).
+* „VeranstalterNeu“: Vereins-Suche und „Daten übernehmen“ finalisieren (Suche, Auswahl, Mapping, Validierung,
+  Fehleranzeigen).
+* ZNS-Importer: Testbarkeit ohne Backend verbessern (Mock/Trockenlauf-Umschalter in der UI).
+* Lint-Aufräumen: ungenutzte Imports/Parameter entfernen; Long→Duration-Konvertierungen; not-null Call vereinfachen.
+
+## Handover für nächste Session
+
+* Fokusvorschlag: Fertigstellung „VeranstalterNeu“ mit Vereinssuche + Datenübernahme; Ergänzung von UI-Tests (
+  State-Retention im Onboarding, Wizard-Backpfade).
+* Optional: Export (PDF/Markdown) der Bestätigungsansicht für Veranstaltungsdaten evaluieren.
+
+## Glossar/Begriffe (konsistent verwenden)
+
+* „Veranstalter-Profil Card“: Vorschau-Ansicht mit Logo/Name/Kontakt + Button „bearbeiten“.
+* „Wizard Schritt 2 / Basisdaten der Veranstaltung“: Konfigurationsschritt mit Rücknavigation ins zugehörige
+  Veranstalter-Profil, wenn `veranstalterId` gesetzt ist.
+
+## Hinweise
+
+* Backend war in dieser Session nicht erforderlich; ZNS-Importer scheitert erwartungsgemäß ohne laufenden Endpoint (
+  `http://localhost:8081/api/v1/import/zns`).