Migrate frontend navigation to V3: archive Navigation V2, implement updated screen-tree and back-stack rules, and adapt documentation for startable MVP flow.

This commit is contained in:
Stefan Mogeritsch 2026-04-02 20:09:22 +02:00
parent 8b40a0624b
commit b787504474
10 changed files with 563 additions and 21 deletions

View File

@ -0,0 +1,66 @@
---
type: Architecture
status: ACTIVE
owner: 🏗️ Lead Architect & 🧹 Curator
last_update: 2026-04-02
sources:
- docs/01_Architecture/adr/0021-tenant-resolution-strategy-de.md
- Domain Workshop 2026-03-24
---
# TenantKonzept: „Eine Veranstaltung = eine Datenbank“ (in einfacher Sprache)
Kurz gesagt: Jede Veranstaltung bekommt ihre eigene kleine Datenbank. So bleiben Daten sauber getrennt, und die Meldestelle kann offline sicher arbeiten, ohne andere Veranstaltungen zu berühren.
---
## 1. Warum machen wir das?
- Sicherheit und Ordnung: Was zu Veranstaltung A gehört, landet nicht aus Versehen bei Veranstaltung B.
- OfflineTauglichkeit: Eine Datenbank pro Veranstaltung ist klein, lokal und schnell zu sichern/verteilen.
- Einfache Abrechnung: Die VeranstaltungsKassa und die TeilnehmerKonten sind klar auf EventEbene definiert.
---
## 2. Wie wird bestimmt, welche Datenbank benutzt wird?
Siehe ArchitekturEntscheidung (ADR0021):
- Datei: `docs/01_Architecture/adr/0021-tenant-resolution-strategy-de.md`
- Kerngedanke: Die App leitet aus dem aktuellen „Arbeitskontext“ (gewählte Veranstaltung) den Tenant ab. Alle Lese/SchreibOperationen gehen automatisch in die richtige EventDatenbank.
---
## 3. Auswirkungen im Überblick
### a) DatenbankSchema (Backend)
- Pro Veranstaltung ein eigenes Schema/Datei (z. B. `event-{eventId}.db`).
- Tabellen wiederholen sich je Veranstaltung (z. B. `turniere`, `bewerbe`, `abteilungen`, `startlisten`, `kassa_belege`).
- Keine Vermischung zwischen Veranstaltungen. Für Auswertungen über mehrere Veranstaltungen braucht es einen AggregationsProzess.
### b) APIDesign
- Jeder Request enthält implizit oder explizit den EventKontext (Header, Pfad oder SessionScope).
- SchreibOperationen validieren, dass die ZielIDs (Turnier, Bewerb, Abteilung) zur aktuellen Veranstaltung gehören.
- Export/Import: Datenpakete sind pro Veranstaltung abgegrenzt (leichte Weitergabe an Verband oder andere Systeme).
### c) Frontend (Navigation & State)
- Beim Eintritt in eine Veranstaltung wird der Tenant gesetzt; alle folgenden Screens arbeiten innerhalb dieses Kontexts.
- Wechsel der Veranstaltung leert relevante Caches und setzt den BackStack definiertermaßen zurück (→ Navigation V2).
- MultiTurnierFälle innerhalb EINER Veranstaltung bleiben möglich (Turnierkassa je Turnier, Konsolidierung in VeranstaltungsKassa).
---
## 4. Grenzen & Tradeoffs
- CrossEventSuche/Auswertung erfordert separate Aggregation (bewusste Entscheidung zugunsten OfflineFirst und Sicherheit).
- Datenmigration (z. B. Zusammenlegen/Teilen von Veranstaltungen) braucht Tools/Assistenten.
---
## 5. Beziehung zur Domäne
- Ubiquitous Language: `Veranstaltung` ist die Root. Kassen und TeilnehmerKonten sind auf EventEbene verankert.
- Zahlvorgänge können mehrere Rechnungen/Belege aus verschiedenen Turnieren derselben Veranstaltung ausgleichen.

View File

@ -0,0 +1,82 @@
---
type: Guide
status: ACTIVE
owner: 🧹 Curator & 🏗️ Lead Architect
last_update: 2026-04-02
sources:
- docs/03_Domain/01_Glossary/Ubiquitous_Language.md
- Domain Workshop 2026-03-17
---
# EventFirstWorkflow (MVP)
Ziel: Ein neuer VeranstaltungsDurchlauf wird konsequent „EventFirst“ aufgebaut. Dabei folgt der Bedienfluss strikt der DomänenHierarchie:
Veranstaltung → Turnier → Bewerbe → Abteilungen → Startliste
---
## 1. Vorbedingungen
- Verein (→ Begriff: Veranstalter) ist im System vorhanden.
- Grundlegende Stammdaten synchron (Reiter, Pferde, Vereine) optional für die Planung, erforderlich für Startlisten.
Querverweis: → Ubiquitous Language, Abschnitt „Hierarchie der VeranstaltungsStruktur“ und Begriffe „Veranstaltung“, „Turnier“, „Bewerb“, „Abteilung“, „Startliste“.
---
## 2. SchrittfürSchritt
1) Veranstaltung anlegen
- Eingaben: Titel, Datum(e), Ort, Typ (Turnier, Reitertreffen, …), Veranstalter (Vereinsnummer), interne EventID (System vergibt).
- Output: Veranstaltung existiert, → VeranstaltungsKassa und → TeilnehmerKontoContainer werden vorbereitet.
2) Turnier anlegen (innerhalb der Veranstaltung; mehrfach möglich)
- Eingaben: Turniernummer (offiziell, wenn vorhanden), Sparte(n) (z. B. CDN, CSN), Kategorie (CNEU, C, …), geplanter Zeitraum.
- Output: Turnier angelegt, → Turnierkassa eröffnet; AusschreibungsMetadaten vorbereiten.
3) Bewerbe anlegen (pro Turnier)
- Eingaben: fortlaufende Bewerbsnummer, Bezeichnung, Klasse/Höhe, Richtverfahren, Startberechtigungen.
- Output: Bewerbe als Container für Abteilungen vorhanden.
4) Abteilungen planen/anlegen (pro Bewerb, mindestens eine)
- Eingaben: Abteilungsnummer (fortlaufend), AbteilungsTyp: `SEPARATE_SIEGEREHRUNG` oder `ORGANISATORISCH`, optional TeilnehmerkreisFilter (Lizenz, Altersklasse …).
- Systemhinweis: Bei Überschreiten von ÖTOSchwellenwerten zeigt das System WARNUNG + Option „Override“ (→ TBA hat letztes Wort).
- Output: Abteilungen stehen für Nennungen/Startlisten bereit.
5) Startliste erzeugen (pro Abteilung)
- Eingaben: Nennungen (Paar Reiter+Pferd), ReihenfolgenLogik (z. B. Zufall, Startwunsch), Kollisionen prüfen.
- Output: Fixierte Startliste je Abteilung; Grundlage für Ergebniserfassung und Abrechnung (Sportförderbeitrag, TierwohlEuro pro Start).
---
## 3. Rollen & Verantwortungen
- Meldestelle: Erfassung/Prüfung der Daten, Startlistenpflege, Kassenabwicklung.
- TBA (Turnierbeauftragter): Genehmigung von AbteilungsOverrides und RegelAbweichungen (OverrideEvent wird protokolliert).
- Veranstalter: Finanzielle Verantwortung, KassenSchluss, Freigabe der Ausschreibung.
---
## 4. Artefakte & Systemobjekte
- Veranstaltung (Root) → VeranstaltungsKassa, TeilnehmerKontoContainer, MultiTurnierVerrechnung.
- Turnier → Turnierkassa, Ausschreibung.
- Bewerb → Liste von Abteilungen.
- Abteilung → kleinste ausführbare Einheit (Nennungen, Startliste, Ergebnis, Siegerehrung nach Typ).
---
## 5. Akzeptanzkriterien (MVP)
- Erstellung in exakt der Reihenfolge möglich; Zwischenspeichern und spätere Fortsetzung unterstützt.
- Abteilungen mindestens 1 pro Bewerb; Typ wählbar; Warnungen bei ÖTOSchwellenwertÜberschreitung.
- Startliste pro Abteilung generierbar; Kollisionen und Startwünsche werden berücksichtigt.
- Abrechnung: Gebühren pro Start (Sportförderbeitrag, TierwohlEuro) werden korrekt ausgewiesen; Zahlvorgänge können turnierübergreifend auf TeilnehmerKonto verbucht werden (EventEbene).
---
## 6. Querverweise
- Domänenbegriffe: `docs/03_Domain/01_Glossary/Ubiquitous_Language.md`
- ÖTOSchwellenwerte: `docs/03_Domain/02_Reference/OETO_Regelwerk/Abteilungs-Trennungs-Schwellenwerte.md`

View File

@ -2,7 +2,7 @@
type: Reference
status: ACTIVE
owner: Lead Architect & ÖTO/FEI Rulebook Expert
last_update: 2026-03-28
last_update: 2026-04-02
sources:
- ÖTO 2026, Abschnitt A I, § 2 & § 3 & § 4
- Domain Workshop 2026-03-17
@ -48,7 +48,9 @@ Veranstalter (OEPS-Mitgliedsverein)
| Begriff | Definition | ÖTO-Referenz |
|-------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------|
| **Abteilung** | **Atomare operative Einheit für Startlisten und Ergebnisse.** Untereinheit eines Bewerbs mit eigenem Teilnehmerkreis (Lizenz, Pferdealter etc.) und eigener Platzierung/Siegerehrung. Erhält eine fortlaufende **Abteilungsnummer** (1, 2, ...) innerhalb des Bewerbs. Referenz auf Startliste/Ergebnisliste: `BW: 9 Abt: 1` bzw. `9-1`. Die ÖTO definiert sparten- und klassenabhängige Schwellenwerte, ab wievielen Startern eine Abteilung **verpflichtend** getrennt werden muss. Bei Überschreitung gibt das System eine **WARNUNG** (kein harter Fehler) der TBA hat das letzte Wort (→ *Override-Event*). Vollständige Schwellenwert-Tabellen: → [`Abteilungs-Trennungs-Schwellenwerte.md`](../02_Reference/OETO_Regelwerk/Abteilungs-Trennungs-Schwellenwerte.md) | ÖTO § 2 Abs. 7, § 39 |
| **Abteilung** | **Kleinste ausführbare, atomare Einheit** für Nennungen, Startlisten, Ergebnisse und Auswertungen. Untereinheit eines Bewerbs mit eigenem Teilnehmerkreis (Lizenz, Pferdealter etc.). Erhält eine fortlaufende **Abteilungsnummer** (1, 2, ...) innerhalb des Bewerbs. Referenz auf Startliste/Ergebnisliste: `BW: 9 Abt: 1` bzw. `9-1`.
**Abteilungs-Typen:** `SEPARATE_SIEGEREHRUNG` (= eigene Platzierung, eigene Siegerehrung, separater Ergebnislauf) | `ORGANISATORISCH` (= organisatorische Teilung, z.B. zur Ablaufoptimierung; Platzierung/Preise werden gemeinsam mit anderen Abteilungen dieses Bewerbs geführt).
Die ÖTO definiert sparten- und klassenabhängige Schwellenwerte, ab wievielen Startern eine Abteilung **verpflichtend** getrennt werden muss. Bei Überschreitung gibt das System eine **WARNUNG** (kein harter Fehler) der TBA hat das letzte Wort (→ *Override-Event*). Vollständige Schwellenwert-Tabellen: → [`Abteilungs-Trennungs-Schwellenwerte.md`](../02_Reference/OETO_Regelwerk/Abteilungs-Trennungs-Schwellenwerte.md) | ÖTO § 2 Abs. 7, § 39 |
| **Akteur** | Historischer Begriff (siehe → *Stammdaten*). Oberbegriff für alle Personen (Reiter, Richter, Funktionäre, Besitzer) und Organisationen (Vereine), die im System interagieren. | |
| **Ausschreibung** | Das offizielle Dokument, das alle Bedingungen eines Turniers festlegt. Pflichtfelder gemäß ÖTO (A-Satz der ZNS-Schnittstelle). | ÖTO Ausschreibungs-Struktur |
@ -152,6 +154,8 @@ Veranstalter (OEPS-Mitgliedsverein)
| **Turnier** | In unserer Software: Eine pferdesportliche Veranstaltung mit einer offiziellen **Ausschreibung** und einer vom OEPS/LFV vergebenen, eindeutigen **Turniernummer**. Entspricht ÖTO § 2 Abs. 2. Ist eine Spezialisierung von → *Veranstaltung*. | ÖTO § 2 Abs. 2, § 5, § 24 |
| **Turniernummer** | Vom OEPS vergebene, eindeutige Kennung eines Turniers (z.B. `25123`). Ohne diese Nummer darf keine offizielle Ausschreibung veröffentlicht werden. | ZNS A-Satz |
| **Turnierkategorie** | Siehe → *Kategorie*. | ÖTO § 3 Abs. 4 |
| **Turnierkassa** | Kassa auf Ebene des einzelnen → *Turniers*. Hält Belege, Tagesabschlüsse und Barbestände pro Turnier. Wird in der → *VeranstaltungsKassa* konsolidiert. | Billing Context |
| **TeilnehmerKonto** | Konto eines Zahlers auf Ebene der → *Veranstaltung* (nicht nur eines Turniers). Aggregiert Saldo, Einzahlungen und Verrechnungen über alle → *Turniere* derselben Veranstaltung hinweg (MultiTurnierAggregation). Ermöglicht, dass eine einzelne Zahlung mehrere Rechnungen in verschiedenen Turnieren derselben Veranstaltung ausgleicht. | Billing Context |
### V
@ -159,12 +163,14 @@ Veranstalter (OEPS-Mitgliedsverein)
|-------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------|
| **Veranstaltung** | In unserer Software: Der Oberbegriff für jede Art von pferdesportlicher Veranstaltung, die von einem Verein durchgeführt wird. Erhält eine **intern vergebene ID**. Entspricht dem ÖTO-Oberbegriff „Pferdesportliche Veranstaltung" (§ 2 Abs. 1). Kann vom Typ Turnier, Reitertreffen, Sonderprüfung, PS&S oder Turnierartig sein. | ÖTO § 2 Abs. 1 |
| **Veranstalter** | OEPS-Mitgliedsverein (über LFV angeschlossen), der eine Veranstaltung ausrichtet. Besitzt eine **Vereinsnummer**. | ÖTO § 2 Abs. 12 |
| **VeranstaltungsKassa** | Kassen- und Abrechnungsführer auf Ebene der → *Veranstaltung*. Konsolidiert alle Zahlungen, Belege und Rückgelder über mehrere → *Turniere* derselben Veranstaltung. Dient als zentrale Sammelkasse; kann Zahlvorgänge turnierübergreifend splitten und konsolidieren. | Billing Context |
### Z
| Begriff | Definition | ÖTO-Referenz |
|---------|--------------------------------------------------------------------------------------------------------------------------------------------|-------------------|
| **ZNS** | Zentrales Nennsystem des OEPS. Datenaustausch-Format für Stammdaten (Reiter, Pferde) und Nennungen. Quelle der Wahrheit für Akteurs-Daten. | ZNS-Schnittstelle |
| Begriff | Definition | ÖTO-Referenz |
|-----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------|
| **Zahlvorgang** | Eine einzelne Zahlungstransaktion (Bar, Karte, Überweisung), die einen Betrag einem → *TeilnehmerKonto* gutschreibt und dabei **eine Zahlung auf mehrere Rechnungen/Belege** aufteilen kann auch turnierübergreifend innerhalb derselben → *Veranstaltung*. | Billing Context |
| **ZNS** | Zentrales Nennsystem des OEPS. Datenaustausch-Format für Stammdaten (Reiter, Pferde) und Nennungen. Quelle der Wahrheit für Akteurs-Daten. | ZNS-Schnittstelle |
---

View File

@ -7,7 +7,7 @@
## 🔴 Sprint A — Sofort (diese Woche)
- [ ] **A-1** | `Ubiquitous_Language.md` aktualisieren (nach Domänen-Modell vom Architect)
- [x] **A-1** | `Ubiquitous_Language.md` aktualisieren (nach Domänen-Modell vom Architect)
- [ ] Hierarchie `Veranstaltung → Turnier → Bewerb → Abteilung` eintragen
- [ ] `Abteilung` als eigenständigen Begriff definieren (kleinste ausführbare Einheit)
- [ ] `SEPARATE_SIEGEREHRUNG` und `ORGANISATORISCH` als Abteilungs-Typen definieren
@ -15,24 +15,24 @@
- [ ] `Veranstaltungs-Kassa` und `TurnierKassa` als separate Begriffe definieren
- [ ] `Zahlvorgang` (eine Zahlung, mehrere Rechnungen) definieren
- [ ] **A-2** | Event-First-Workflow dokumentieren
- [ ] Ablauf: Veranstaltung anlegen → Turnier anlegen → Bewerbe anlegen → Abteilungen → Startliste
- [ ] Dokument in `docs/01_Architecture/` oder `docs/02_Guides/` ablegen
- [x] **A-2** | Event-First-Workflow dokumentieren
- [x] Ablauf: Veranstaltung anlegen → Turnier anlegen → Bewerbe anlegen → Abteilungen → Startliste
- [x] Dokument in `docs/01_Architecture/` oder `docs/02_Guides/` ablegen`docs/02_Guides/Event-First-Workflow.md`
- [ ] **A-3** | Navigation-V2 dokumentieren
- [ ] Aktuellen Screen-Baum und Back-Stack-Verhalten beschreiben
- [ ] Dokument in `docs/06_Frontend/` ablegen
- [x] **A-3** | Navigation-V2 dokumentieren
- [x] Aktuellen Screen-Baum und Back-Stack-Verhalten beschreiben
- [x] Dokument in `docs/06_Frontend/` ablegen → `docs/06_Frontend/Navigation_V2_Screen-Baum_und_Back-Stack.md`
- [ ] **A-4** | Tenant-Konzept dokumentieren (nach ADR-0021 vom Architect)
- [ ] ADR-0021 in `docs/01_Architecture/ADRs/` verlinken
- [ ] Konzept "eine Veranstaltung = eine Datenbank (Tenant)" in Laien-Sprache erklären
- [ ] Auswirkungen auf Schema, API und Frontend zusammenfassen
- [x] **A-4** | Tenant-Konzept dokumentieren (nach ADR-0021 vom Architect)
- [x] ADR-0021 in `docs/01_Architecture/ADRs/` verlinken`docs/01_Architecture/adr/0021-tenant-resolution-strategy-de.md`
- [x] Konzept "eine Veranstaltung = eine Datenbank (Tenant)" in Laien-Sprache erklären
- [x] Auswirkungen auf Schema, API und Frontend zusammenfassen`docs/01_Architecture/Reference/Tenant-Konzept_Eine-Veranstaltung-eine-Datenbank.md`
- [ ] **A-5** | Session-Log für heutige Besprechung (2. April 2026) erstellen
- [ ] Alle Beschlüsse der Meldestelle-Besprechung eintragen
- [ ] Domänen-Korrekturen (Abteilung, Kassa, Veranstaltungs-Hierarchie) festhalten
- [ ] Zurückgestellte Themen (USB-Fallback, Web-App, Nenn-System) als ⏸️ markieren
- [ ] Log in `docs/99_Journal/` ablegen
- [x] **A-5** | Session-Log für heutige Besprechung (2. April 2026) erstellen
- [x] Alle Beschlüsse der Meldestelle-Besprechung eintragen
- [x] Domänen-Korrekturen (Abteilung, Kassa, Veranstaltungs-Hierarchie) festhalten
- [x] Zurückgestellte Themen (USB-Fallback, Web-App, Nenn-System) als ⏸️ markieren
- [x] Log in `docs/99_Journal/` ablegen → `docs/99_Journal/2026-04-02_Meldestelle_Besprechung_Session-Log.md`
---

View File

@ -14,6 +14,12 @@ Generiert aus: `frontend/shells/meldestelle-desktop/src/jvmMain/kotlin/at/mocode
---
MVP-Hinweis (2026-04-02):
- Die DesktopApp startet im MVP ohne erzwungenen Login/Ping direkt in die HauptShell (VeranstaltungsVerwaltung).
- Der LoginKnoten und AuthGuard im Diagramm bleiben aus Planungsgründen sichtbar, sind jedoch im MVP deaktiviert.
---
## 1. Übersicht: NavRail-Einstiegspunkte
Die linke Navigationsleiste (NavRail) bietet folgende Direkteinstiege:

View File

@ -0,0 +1,15 @@
---
type: Redirect
status: MOVED
owner: 🧹 Curator
last_update: 2026-04-02
moved_to: docs/_archive/06_Frontend/Navigation_V2_Screen-Baum_und_Back-Stack.md
replaced_by: docs/06_Frontend/Navigation_V3_Screen-Baum_und_Back-Stack.md
---
# Navigation V2 — verschoben ins Archiv
Dieses Dokument wurde in das Archiv verschoben und durch „V3“ ersetzt.
- Archiv: `docs/_archive/06_Frontend/Navigation_V2_Screen-Baum_und_Back-Stack.md`
- Aktuelle Version: `docs/06_Frontend/Navigation_V3_Screen-Baum_und_Back-Stack.md`

View File

@ -0,0 +1,125 @@
---
type: Frontend
status: ACTIVE
owner: 🎨 Frontend Expert & 🧹 Curator
last_update: 2026-04-02
sources:
- docs/06_Frontend/Navigation_Routing_Diagramm.md
- docs/02_Guides/Event-First-Workflow.md
- docs/99_Journal/2026-04-02_Meldestelle_Besprechung_Session-Log.md
replaces: docs/06_Frontend/Navigation_V2_Screen-Baum_und_Back-Stack.md
---
# Navigation V3 — ScreenBaum & BackStackRegeln (jetzt gültig)
Dieses Dokument beschreibt die jetzt gültige, startfähige Fassung der DesktopApp Navigation (Compose Multiplatform, MVPStand ohne erzwungenen Login/Ping).
---
## 1. ScreenBaum (Routen)
- AppRoot
- MainShell (ohne Login/Ping)
- Veranstaltungen (TabRoot)
- Veranstaltung.Detail(eventId)
- Turnier.Detail(tournamentId)
- Bewerb.Detail(contestId)
- Abteilung.Detail(divisionId)
- Startliste(divisionId)
- Kassa.Turnier(tournamentId)
- Kassa.Veranstaltung(eventId)
- StammdatenImport (TabRoot)
- Reiter (TabRoot, Placeholder)
- Pferde (TabRoot, Placeholder)
- Funktionaere (TabRoot, Placeholder)
- Meisterschaften (TabRoot, Placeholder)
- Cups (TabRoot, Placeholder)
Hinweise:
- Fachliche Struktur folgt dem EventFirstWorkflow: Veranstaltung → Turnier → Bewerb → Abteilung. Abteilung ist kleinste ausführbare Einheit.
- KassenScreens existieren getrennt für Turnier und Veranstaltung (Terminologie gemäß Ubiquitous Language).
---
## 1a. HauptShell (Abfragen, Status & Einstieg)
Quellen: `frontend/shells/meldestelle-desktop/src/jvmMain/kotlin/at/mocode/desktop/DesktopApp.kt`,
`frontend/shells/meldestelle-desktop/src/jvmMain/kotlin/at/mocode/desktop/screens/layout/DesktopMainLayout.kt`,
`frontend/shells/meldestelle-desktop/src/jvmMain/kotlin/at/mocode/desktop/navigation/DesktopNavigationPort.kt`
- Einstieg/Startzustand
- StartScreen in der DesktopShell ist `AppScreen.Onboarding` (siehe `DesktopNavigationPort`, Initialwert und `DesktopApp` LoginGate).
- Onboarding setzt im MVP ein DummyToken via `AuthTokenManager.setToken(...)` und leitet in `VeranstaltungVerwaltung` weiter.
- Kein erzwungener Login im MVP: `DesktopApp` erlaubt zentrale Screens ohne Auth, LoginRoute existiert weiterhin optional.
- TopBar (Breadcrumb)
- Zeigt kontextabhängige Breadcrumbs (Verwaltung → Veranstalter → Veranstaltung → Turnier ...), inkl. KlickNavigation auf Eltern.
- Kein LogoutButton im MVP (auf Kundenwunsch entfernt).
- Content (Screens)
- Zentrale Verwaltung: `VeranstaltungVerwaltungV2` mit NavigationsCallbacks zu Profilen, Import, Reiter/Pferde/Funktionäre/Vereine.
- PingScreen existiert (`PingScreen`/`PingViewModel`), ist aber kein Einstiegspunkt und wird nicht automatisch abgefragt.
- Footer/Statusleiste (`DesktopFooterBar`)
- Zeigt Online/OfflineStatus (MVP: StubState), GeräteVerbindungsstatus inkl. Gerätename „RichterTurm“ (Stub) und ChatTrigger, wenn Gerät verbunden.
- Dient rein der Anzeige; keine NavigationsEinträge im BackStack.
- ValidierungsHinweise
- Bei inkonsistentem Kontext (z. B. IDs nicht vorhanden) wird ein `InvalidContextNotice` mit Rücksprung angeboten.
---
## 2. NavigationsKonventionen
- Route IDs: stabile, serialisierbare IDs (`eventId`, `tournamentId`, `contestId`, `divisionId`).
- SingleTop/SingleTask je Tab: erneuter Klick auf einen Tab bringt zum jeweiligen TabRoot, Stack bleibt je Tab erhalten.
- Hierarchischer Drilldown (Parent → Child). „Zurück“ führt jeweils eine Ebene hoch.
- Deep Links: `app://event/{eventId}/tournament/{tId}/contest/{cId}/division/{dId}` öffnen direkt die Abteilung; Eltern werden synthetisch für den BackPfad aufgebaut.
---
## 3. BackStackRegeln (V3)
1) AppStart
- Startet in MainShell → Tab „Veranstaltungen“.
2) Wechsel Tab → Tab
- Eigener Stack je Tab; Wechsel speichert und restauriert den jeweiligen Stack (SingleTask je Tab).
3) Navigieren innerhalb „Veranstaltungen“
- Veranstaltungen (Liste) → Veranstaltung.Detail → Turnier.Detail → Bewerb.Detail → Abteilung.Detail → Startliste.
- „Zurück“ springt exakt eine Ebene zurück; beim Verlassen von Startliste zurück zur Abteilung.
4) Kassa öffnen
- Von Turnier.Detail zu Kassa.Turnier: Push auf Stack, Back kehrt zu Turnier.Detail zurück.
- Von Veranstaltung.Detail zu Kassa.Veranstaltung: Push auf Stack, Back kehrt zu Veranstaltung.Detail zurück.
5) OverrideDialoge (Regelwerk)
- Modal/Sheet, kein eigener StackEintrag. Schließen kehrt zum aktuellen Screen zurück. OverrideEvents werden protokolliert.
6) Auth/Logout (MVP)
- Kein erzwungener Login; LogoutSonderregeln aus V2 sind im MVP nicht aktiv. Bei späterer Aktivierung gelten die bisherigen Regeln (MainShellStack leeren, zurück zum Entry).
---
## 4. Zustandsmanagement
- Screens sind UDF/MVVMkompatibel (Details separat dokumentiert).
- NavigationState kann optional `returnTo` für spätere LoginFlows halten; im MVP ohne Wirkung.
---
## 5. EdgeCases & Tests
- Abteilungswechsel: Beim Wechsel der Abteilung innerhalb eines Bewerbs bleibt der Stack auf BewerbEbene erhalten; nur das AbteilungDetail wird ersetzt.
- Datenverlust vermeiden: Vor Navigation prüfen, ob ungespeicherte Änderungen vorliegen (z. B. KassaBuchung), ggf. ConfirmDialog.
- DeepLink Pfadaufbau: synthetische Eltern korrekt in den BackPfad einhängen.
---
## 6. Querverweise
- RoutingDiagramm: `docs/06_Frontend/Navigation_Routing_Diagramm.md`
- EventFirstWorkflow: `docs/02_Guides/Event-First-Workflow.md`
- Begriffe: `docs/03_Domain/01_Glossary/Ubiquitous_Language.md`
- Analyse/Begründung: `docs/06_Frontend/Reports/2026-04-02_Navigation_Versionierung_Analyse_V2_vs_V3.md`

View File

@ -0,0 +1,103 @@
---
type: Report
status: ACTIVE
owner: 🎨 Frontend Expert
last_update: 2026-04-02
sources:
- docs/99_Journal/2026-04-02_Meldestelle_Besprechung_Session-Log.md
- docs/_archive/06_Frontend/Navigation_V2_Screen-Baum_und_Back-Stack.md
- docs/06_Frontend/Navigation_Routing_Diagramm.md
- docs/02_Guides/Event-First-Workflow.md
---
# Frontend Navigation — Versionsanalyse V2 → V3
Dieses Dokument analysiert die Abweichungen zwischen der Dokumentation „Navigation V2“ und der tatsächlich startfähigen DesktopApp und legt ein konsistentes Vorgehen für „V3“ fest.
---
## 1) Zusammenfassung (Executive Brief)
- Problem: „Navigation V2“ enthält Elemente (Ping/SystemStatus, LoginFlow), die in der aktuell startfähigen DesktopApp nicht aktiv genutzt werden. Dadurch entstand ein VersionsDrift in Doku und Kommunikation („V2“ wurde fälschlich als aktuell betrachtet).
- Entscheidung: Wir führen „V3“ als jetzt gültige, startfähige Fassung ein. „V2“ wird als „DEPRECATED“ markiert und bleibt als Referenz erhalten.
- Ziel: Einheitliche, aktuelle SSoT für Navigation/BackStack, synchron mit EventFirstWorkflow und der laufenden DesktopApp.
---
## 2) Befunde (V2 vs. aktueller Stand)
- StartPfad
- V2: „Landing → SystemStatus (Ping), Login“ beschrieben.
- Aktuell: App startet ohne aktiven PingScreen und ohne verpflichtenden LoginFlow direkt in die HauptShell.
- Auth/Login
- V2: Login/returnTo vorgesehen, BackStack berücksichtigt Logout.
- Aktuell: Kein aktiver LoginZwang; LogoutRegel daher für MVP nicht relevant.
- Tabs/NavRail
- V2: HauptTabs wie Dashboard, Veranstaltungen, Suche, Einstellungen.
- Aktuell: „Veranstaltungen“ ist implementiert; weitere Bereiche sind (teils) Placeholder. Siehe „Navigation_Routing_Diagramm.md“ (Stand 20260326).
- EventFirstWorkflow
- Konsistenz: Die fachliche Hierarchie Veranstaltung → Turnier → Bewerb → Abteilung bleibt gültig (SessionLog 20260402).
- Kleinste ausführbare Einheit: Abteilung.
- KassaFlows
- Terminologie und Platzierung (Turnierkassa, VeranstaltungsKassa) bleiben konzeptionell richtig; UIVerfügbarkeit im MVP ist noch selektiv.
---
## 3) Vorschlag „V3“ (jetzt gültige Fassung)
- Start & Shell
- AppRoot startet direkt in „MainShell“ (ohne Ping/Login).
- Primärer Einstiegspunkt: Tab „Veranstaltungen“.
- Tabs/NavRail (V3 Status)
- Veranstaltungen: ACTIVE (implementiert)
- StammdatenImport: ACTIVE (UI vorhanden; Polling noch offen laut Diagramm)
- Reiter, Pferde, Funktionäre, Meisterschaften, Cups: PLACEHOLDER
- Drilldown Veranstaltungen (V3)
- Veranstaltungen (Liste)
→ Veranstaltung.Detail
→ Turnier.Detail (inkl. NennungsTab / Stammdaten v2)
→ Bewerb.Detail → Abteilung.Detail → Startliste
- Back: jeweils exakt eine Ebene hoch (keine modale Einträge im Stack)
- BackStack Regeln (V3)
- Tabs: SingleTop/SingleTask je Tab (Wechsel erhält jeweiligen Stack)
- Modale OverrideDialoge: kein eigener StackEintrag; Schließen kehrt zurück
- LogoutSonderfall: vorerst „n. v.“ im MVP (kein erzwungener Login)
---
## 4) Migration & Aufräumen
- Dokumente
- „Navigation_V2_ScreenBaum_und_BackStack.md“ → Status: DEPRECATED, Verweis auf „Navigation_V3_…“
- Neues Dokument: „Navigation_V3_ScreenBaum_und_BackStack.md“ (jetzt gültige Fassung)
- Querverweise
- SessionLogs und Roadmaps behalten Verweise auf V2 als historische Referenz, ergänzen aber den Link zu V3 als SSoT.
- CodeAusrichtung (nonfunctional in diesem Schritt)
- Prüfen, ob RoutingGuards/LoginArtefakte im Code noch referenziert werden; falls ja, als FeatureFlags/TODO kennzeichnen oder entfernen, um DokuDrift zu vermeiden.
---
## 5) Akzeptanzkriterien (V3)
- Beim AppStart landet der User ohne Ping/Login direkt im Tab „Veranstaltungen“.
- TabWechsel bewahrt je Tab den eigenen Stack (SingleTop/SingleTask Verhalten dokumentiert).
- Drilldown und BackNavigation entlang EventFirstWorkflow funktionieren deterministisch (eine Ebene zurück).
- Dokumente sind konsistent: V3 beschreibt genau das implementierte Verhalten; V2 ist klar als veraltet markiert.
---
## 6) Nächste Schritte
1) V3Dokument erstellen und verlinken (dieser Commit)
2) V2 als DEPRECATED markieren (dieser Commit)
3) Optional: Navigation_Routing_Diagramm auf „kein Login/Ping im MVP“ ergänzen
4) Review durch 🏗️ Lead Architect und 🧹 Curator; danach V3 als SSoT in Roadmaps/Logs referenzieren

View File

@ -0,0 +1,43 @@
---
type: Journal
status: ACTIVE
owner: 🧹 Curator
last_update: 2026-04-02
sources:
- Besprechung Meldestelle 2026-04-02
- docs/03_Domain/01_Glossary/Ubiquitous_Language.md
---
# SessionLog — MeldestelleBesprechung (2. April 2026)
## ✅ Beschlüsse
- Ubiquitous Language wird als SSoT geführt; Aktualisierungen zu Abteilung, Kassen, TeilnehmerKonto, Zahlvorgang sind angenommen.
- EventFirstWorkflow (Veranstaltung → Turnier → Bewerbe → Abteilungen → Startliste) ist der verbindliche Bedienfluss fürs MVP.
- Abteilung ist kleinste ausführbare Einheit; Typisierung eingeführt: `SEPARATE_SIEGEREHRUNG` und `ORGANISATORISCH`.
- KassenKonzept bestätigt: Turnierkassa je Turnier, Konsolidierung in VeranstaltungsKassa auf EventEbene.
- Zahlvorgang darf mehrere Rechnungen/Belege ausgleichen (auch turnierübergreifend innerhalb derselben Veranstaltung); Buchung auf TeilnehmerKonto (EventEbene).
- Navigation V2: ScreenBaum festgelegt, BackStackRegeln (SingleTop Tabs, Logout poppt MainShell, modale Overrides nicht im Stack) angenommen.
- TenantKonzept bestätigt: „Eine Veranstaltung = eine Datenbank (Tenant)“, gemäß ADR0021; Auswirkungen auf Schema, API, Frontend dokumentieren.
## 🛠️ DomänenKorrekturen
- Hierarchie fixiert: Veranstaltung → Turnier → Bewerb/Prüfung → Abteilung.
- Abteilung: Definition geschärft; Schwellenwerte liefern WARNUNG (kein harter Fehler); TBAOverride wird protokolliert.
- KassaBegriffe: Turnierkassa (tournamentscoped), VeranstaltungsKassa (eventscoped, konsolidiert).
## ⏸️ Zurückgestellte Themen
- ⏸️ USBFallback für Datensync (OffsiteExport/Import) Evaluierung Sprint B/C.
-
⏸️ WebApp (PWA) nach DesktopMVP, Anforderungen sammeln.
- ⏸️ NennSystemIntegration (ZNS LiveSync) nach Abschluss StammdatenStabilisierung.
## 🔗 Verweise
- Ubiquitous Language: `docs/03_Domain/01_Glossary/Ubiquitous_Language.md`
- EventFirstWorkflow: `docs/02_Guides/Event-First-Workflow.md`
- Navigation V2: `docs/06_Frontend/Navigation_V2_Screen-Baum_und_Back-Stack.md`
- Navigation V2 (Archiv): `docs/_archive/06_Frontend/Navigation_V2_Screen-Baum_und_Back-Stack.md`
- TenantKonzept (LaienErklärung): `docs/01_Architecture/Reference/Tenant-Konzept_Eine-Veranstaltung-eine-Datenbank.md`
- ADR0021: `docs/01_Architecture/adr/0021-tenant-resolution-strategy-de.md`

View File

@ -0,0 +1,96 @@
---
type: Frontend
status: ARCHIVED
owner: 🎨 Frontend Expert & 🧹 Curator
archived_at: 2026-04-02
moved_from: docs/06_Frontend/Navigation_V2_Screen-Baum_und_Back-Stack.md
deprecated_by: docs/06_Frontend/Navigation_V3_Screen-Baum_und_Back-Stack.md
sources:
- docs/99_Journal/2026-04-01_Session_Log_BackStack_Navigation.md
- docs/02_Guides/Event-First-Workflow.md
---
# Navigation V2 — ScreenBaum & BackStackRegeln (archiviert)
ACHTUNG: Dieses Dokument beschreibt eine ältere Fassung mit Ping/SystemStatus und LoginFlow. Die jetzt gültige, startfähige Fassung ist „V3“:
- Aktuelle Version: `docs/06_Frontend/Navigation_V3_Screen-Baum_und_Back-Stack.md`
- Dieses V2Dokument bleibt als Referenz im Archiv bestehen.
---
## 1. ScreenBaum (Routen)
- AppRoot
- Landing
- SystemStatus (Ping, Verbindungen)
- Login(returnTo?)
- MainShell (nach Login)
- Dashboard
- Veranstaltungen
- Veranstaltung.Detail(eventId)
- Turnier.Detail(tournamentId)
- Bewerb.Detail(contestId)
- Abteilung.Detail(divisionId)
- Startliste(divisionId)
- Kassa.Turnier(tournamentId)
- Kassa.Veranstaltung(eventId)
- Suche (global)
- Einstellungen
Hinweise:
- Die Struktur folgt dem EventFirstWorkflow (→ Guide). Abteilung ist die kleinste ausführbare Einheit.
- Separate KassaScreens für Turnier und Veranstaltung (→ Ubiquitous Language: VeranstaltungsKassa, Turnierkassa).
---
## 2. NavigationsKonventionen
- Route IDs: Verwende stabile, serialisierbare IDs (`eventId`, `tournamentId`, `contestId`, `divisionId`). Kopfnummern sind keine stabilen IDs.
- SingleTop für HauptTabs (Dashboard, Veranstaltungen, Suche, Einstellungen): erneuter Klick bringt zum TabRoot und ersetzt nicht den Stack.
- DetailDrilldown ist hierarchisch (Parent → Child). Zurück führt jeweils eine Ebene hoch.
- Deep Links: `app://event/{eventId}/tournament/{tId}/contest/{cId}/division/{dId}` öffnen direkt die Abteilung; Eltern werden als „synthetische“ BackKette aufgebaut.
---
## 3. BackStackRegeln
1) Logout
- Poppt den gesamten MainShellStack und landet auf Landing → Login.
2) Wechsel Tab → Tab
- Jeder Tab hat eigenen Stack. Wechsel zwischen Tabs speichert den jeweiligen Stack (SingleTask je Tab).
3) Navigieren innerhalb „Veranstaltungen“
- Veranstaltungen (Liste) → Veranstaltung.Detail → Turnier.Detail → Bewerb.Detail → Abteilung.Detail → Startliste.
- Back springt exakt eine Ebene zurück; beim Verlassen von Startliste zurück zur Abteilung.
4) Öffnen Kassa
- Von Turnier.Detail zu Kassa.Turnier: Push auf Stack.
- Von Veranstaltung.Detail zu Kassa.Veranstaltung: Push auf Stack.
- Back kehrt zur jeweiligen Detailseite zurück.
5) OverrideDialoge (Regelwerk)
- Modal/Sheet, kein eigener StackEintrag. Schließen kehrt zum aktuellen Screen zurück. OverrideEvents werden protokolliert.
---
## 4. Zustandsmanagement
- Screens sind UDF/MVVMkompatibel (Details in eigener Doku; Verweis aus Sprint B).
- NavigationState hält `returnTo` für LoginFlüsse (z. B. Deep Link → Login → zurück zum Ziel).
---
## 5. EdgeCases & Tests
- Abteilungswechsel: Beim Wechsel der Abteilung innerhalb eines Bewerbs bleibt der Stack auf BewerbEbene erhalten; nur das AbteilungDetail wird ersetzt.
- Datenverlust vermeiden: Vor Navigation prüfen, ob ungespeicherte Änderungen vorliegen (z. B. KassaBuchung), ggf. ConfirmDialog.
---
## 6. Querverweise
- BackStack Session Log: `docs/99_Journal/2026-04-01_Session_Log_BackStack_Navigation.md`
- EventFirstWorkflow: `docs/02_Guides/Event-First-Workflow.md`
- Begriffe: `docs/03_Domain/01_Glossary/Ubiquitous_Language.md`