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,30 @@
+---
+type: Journal
+status: FINAL
+owner: Curator
+date: 2026-03-30
+---
+
+# Session Log – Start-/Ergebnislisten Docs & Templates (v07)
+
+## Umfang dieser Session
+- Regel-Referenzen (ÖTO/Legacy) eingesehen und mit Frontend-Entwürfen abgeglichen.
+- Dokumentation konsolidiert und vervollständigt:
+  - Aktualisierung How‑to für Beispiele (Mustache + Renderpfad).
+  - Neuer Überblick `StartErgListen/README.md` (Bestand, Compliance, Render‑Pfad, bekannte Abweichungen).
+  - Implementierungsstand v07 in Checkliste verankert (Links, TODO‑Liste, Abweichungen).
+
+## Geänderte/neu angelegte Dateien
+- Update: `docs/06_Frontend/StartErgListen/examples/README.md` → Status ACTIVE, korrekte Pfade, TODO‑Hinweise.
+- Neu: `docs/06_Frontend/StartErgListen/README.md` → Referenz/How‑to für Templates v07.
+- Update: `docs/03_Domain/02_Reference/OETO_Regelwerk/Checkliste_Start-Ergebnislisten_Dressur-Springen.md` → Abschnitt „Implementierungsstand v07“.
+
+## Offene Punkte (übernommen in Checkliste)
+1) FEI‑Artikelzitate (238/239/269/274) präzisieren und nachpflegen.
+2) Dressur‑Rundungs-/Aggregationsregeln verbindlich dokumentieren.
+3) Einheitliche Statuscodetabelle (CR/DNS/RET/EL/DSQ/WO …) festlegen.
+4) Sichtbarkeitsmatrix Druck vs. Datei finalisieren (z. B. UELN, Besitzer).
+
+## Nächste empfohlene Schritte (außerhalb dieser Session)
+- Separate Templates `Startliste_v07.html` und `Ergebnisliste_v07.html` anlegen und Partials für Springen‑Varianten ergänzen.
+- Beispiel‑Datensätze für Dressur‑ und Springen‑Ergebnislisten hinzufügen und Golden‑Master‑PDFs erzeugen.
@@ -0,0 +1,57 @@
+---
+type: Journal
+status: FINAL
+owner: Curator
+date: 2026-04-20
+---
+
+# Session Log – Finalisierung Start-Sequenz & Layout (Phase 13)
+
+## 🏗️ Status-Update
+Die Nachmittags-Session am 20. April 2026 wurde erfolgreich abgeschlossen. Die gesamte Start-Sequenz, die Infrastruktur-Integration und das globale Layout wurden nach dem **ADR-0024 Plug-and-Play Pattern** finalisiert.
+
+## 🛠️ Umfang & Änderungen
+
+### 1. Onboarding & Geräte-Initialisierung
+- **Sidebar-Blocking:** Fachliche Module sind deaktiviert, bis das Gerät initialisiert ist.
+- **Client-Datensicherheit:** Der `backupPath` ist für alle Rollen verpflichtend (Lokale Datensouveränität).
+- **Navigations-Fix:** Login-Sackgasse behoben (`navigateBack` implementiert).
+- **Setup-Workflow:** Nahtloser Übergang zur Veranstaltungs-Verwaltung nach Abschluss ohne Neustart.
+
+### 2. Infrastruktur & Sicherheit
+- **Lifecycle-Awareness:** `ConnectivityTracker` und `DiscoveryService` starten reaktiv erst nach erfolgreicher Initialisierung.
+- **Plug-and-Play:** Dienste bleiben inaktiv, solange kein Gerätename/Key vorliegt (Ressourcenschonung).
+
+### 3. Globale Navigation & Layout (Vision_03)
+- **Top-Bar:** Integration eines pulsierenden WebSocket-Sync-Indikators (Echtzeit-Peer-Count).
+- **Breadcrumbs:** Konsistentes MD3-Styling mit Home-Anker und navigierbaren Pfaden für alle Bounded Contexts.
+- **Navigation-Rail:** Optimierung auf MD3-Standards (Ripple-Effekt, Surface-Indikatoren, Tooltips).
+- **Footer:** Umstellung auf High-Density Layout (28dp Höhe, optimierte Schriftgrößen) für maximale Informationsdichte.
+- **Refactoring:** `DesktopMainLayout.kt` von 1274 Zeilen auf ca. 95 Zeilen reduziert.
+- **Modul-Aufsplittung:** Extraktion der Sub-Komponenten in `NavRail.kt`, `TopHeader.kt`, `ContentArea.kt` und `FooterBar.kt` im Paket `at.mocode.frontend.shell.desktop.screens.layout.components`.
+- **API-Bereinigung:** Beseitigung ungenutzter Properties (z.B. `TopBarTextColor`) und Korrektur veralteter API-Signaturen in den Screen-Injektionen.
+- **Fehlerbehebung:** Beseitigung von Kompilerfehlern in `NavRail.kt` (Tooltip-Positionierung) und Bereinigung ungenutzter Parameter in `ContentArea.kt`.
+
+### 4. Fachlicher Einstieg & Start-Screen (Punkt 4)
+- **Extraktion:** Die Veranstaltungs-Verwaltung wurde aus der Shell in das Feature-Modul `veranstaltung-feature` extrahiert.
+- **Architektur:** Implementierung von `VeranstaltungManagementViewModel` und `VeranstaltungRepository` (ADR-0024 konform).
+- **Entkoppelung:** Einführung eines domänenspezifischen `VeranstaltungModel` zur Trennung von Shell-Datenstrukturen.
+- **UI/UX (Vision_03):** 
+    - High-Density Layout mit optimierten Cards und Spacings.
+    - Implementierung einer Echtzeit-Suche und Status-Filtern (Alle, In Planung, Aktiv, Abgeschlossen).
+    - Konsistente Status-Badges nach dem offiziellen Farbschema.
+- **Cleanup:** Löschung der redundanten `VeranstaltungVerwaltung.kt` in der Desktop-Shell.
+
+## 📐 Architektur-Check (ADR-0024)
+- **Self-Contained:** Feature-Module verwalten ihren State; Shell reagiert auf Events.
+- **Reaktivität:** UI reagiert sofort auf Konfigurationsänderungen (`settings.json`).
+- **Offline-First:** Visuelles Feedback über lokale DB, LAN-Peers und Cloud-Sync ist jederzeit präsent.
+
+---
+*Dokumentation erstellt durch den Curator im Rahmen des "Meldestelle"-Protokolls.*
+
+### 5. Hotfixes & Stabilisierung (Post-Release Review)
+- **Navigations-Sicherheit:** Das Logo-Icon in der `NavRail` wurde gesperrt (`enabled = isConfigured`), um unautorisierte Zugriffe vor dem Onboarding zu unterbinden.
+- **Koin-Fix:** Registrierung des `veranstalterModule` in der `main.kt` nachgeholt, um Abstürze beim Erstellen neuer Veranstaltungen zu beheben.
+- **UI-Polishing:** Entfernung des irritierenden Zurück-Pfeils in der Konnektivitäts-Diagnose (`PingScreen`), um die UX-Klarheit zu erhöhen.
+- **Home-Navigation-Sperre:** Das Home-Icon im Header wurde ebenfalls an den `isConfigured`-Status gebunden, um die Start-Sequenz final abzusichern.