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,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 Desktop‑App und legt ein konsistentes Vorgehen für „V3“ fest.
+
+---
+
+## 1) Zusammenfassung (Executive Brief)
+
+- Problem: „Navigation V2“ enthält Elemente (Ping/SystemStatus, Login‑Flow), die in der aktuell startfähigen Desktop‑App nicht aktiv genutzt werden. Dadurch entstand ein Versions‑Drift 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/Back‑Stack, synchron mit Event‑First‑Workflow und der laufenden Desktop‑App.
+
+---
+
+## 2) Befunde (V2 vs. aktueller Stand)
+
+- Start‑Pfad
+  - V2: „Landing → SystemStatus (Ping), Login“ beschrieben.
+  - Aktuell: App startet ohne aktiven Ping‑Screen und ohne verpflichtenden Login‑Flow direkt in die Haupt‑Shell.
+
+- Auth/Login
+  - V2: Login/returnTo vorgesehen, Back‑Stack berücksichtigt Logout.
+  - Aktuell: Kein aktiver Login‑Zwang; Logout‑Regel daher für MVP nicht relevant.
+
+- Tabs/NavRail
+  - V2: Haupt‑Tabs wie Dashboard, Veranstaltungen, Suche, Einstellungen.
+  - Aktuell: „Veranstaltungen“ ist implementiert; weitere Bereiche sind (teils) Placeholder. Siehe „Navigation_Routing_Diagramm.md“ (Stand 2026‑03‑26).
+
+- Event‑First‑Workflow
+  - Konsistenz: Die fachliche Hierarchie Veranstaltung → Turnier → Bewerb → Abteilung bleibt gültig (Session‑Log 2026‑04‑02).
+  - Kleinste ausführbare Einheit: Abteilung.
+
+- Kassa‑Flows
+  - Terminologie und Platzierung (Turnierkassa, Veranstaltungs‑Kassa) bleiben konzeptionell richtig; UI‑Verfü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)
+  - Stammdaten‑Import: 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. Nennungs‑Tab / Stammdaten v2)
+        → Bewerb.Detail → Abteilung.Detail → Startliste
+  - Back: jeweils exakt eine Ebene hoch (keine modale Einträge im Stack)
+
+- Back‑Stack Regeln (V3)
+  - Tabs: SingleTop/SingleTask je Tab (Wechsel erhält jeweiligen Stack)
+  - Modale Override‑Dialoge: kein eigener Stack‑Eintrag; Schließen kehrt zurück
+  - Logout‑Sonderfall: vorerst „n. v.“ im MVP (kein erzwungener Login)
+
+---
+
+## 4) Migration & Aufräumen
+
+- Dokumente
+  - „Navigation_V2_Screen‑Baum_und_Back‑Stack.md“ → Status: DEPRECATED, Verweis auf „Navigation_V3_…“
+  - Neues Dokument: „Navigation_V3_Screen‑Baum_und_Back‑Stack.md“ (jetzt gültige Fassung)
+
+- Querverweise
+  - Session‑Logs und Roadmaps behalten Verweise auf V2 als historische Referenz, ergänzen aber den Link zu V3 als SSoT.
+
+- Code‑Ausrichtung (non‑functional in diesem Schritt)
+  - Prüfen, ob Routing‑Guards/Login‑Artefakte im Code noch referenziert werden; falls ja, als Feature‑Flags/TODO kennzeichnen oder entfernen, um Doku‑Drift zu vermeiden.
+
+---
+
+## 5) Akzeptanzkriterien (V3)
+
+- Beim App‑Start landet der User ohne Ping/Login direkt im Tab „Veranstaltungen“.
+- Tab‑Wechsel bewahrt je Tab den eigenen Stack (SingleTop/SingleTask Verhalten dokumentiert).
+- Drilldown und Back‑Navigation entlang Event‑First‑Workflow 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) V3‑Dokument 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