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,56 @@
+# 🏗️ [Lead Architect] — Zwischenbericht zur Besprechung vom 3. April 2026
+
+> **Datum:** 3. April 2026, ca. 13:00 Uhr
+> **Rolle:** Strategie, Architektur-Entscheidungen (ADRs), Domänen-Modell, Master-Roadmap
+
+---
+
+## ✅ Was wurde erreicht?
+
+### Sprint A — vollständig abgeschlossen
+
+- **ADR-0021 (Tenant-Resolution):** Die zentrale Architektur-Entscheidung wurde getroffen: **Eine Veranstaltung = eine
+  Datenbank**. Die Analyse zwischen Schema-per-Tenant und Tenant-ID ist abgeschlossen. Das ADR liegt in
+  `docs/01_Architecture/adr/0021-tenant-resolution-strategy-de.md`.
+- **Domänen-Modell formal präzisiert:** Die Hierarchie `Veranstaltung → Turnier → Bewerb → Abteilung` ist
+  festgeschrieben. `TeilnehmerKonto` auf Veranstaltungsebene (Multi-Turnier), Veranstaltungs-Kassa mit
+  turnier-übergreifendem Saldo und die Abteilungs-Typen `SEPARATE_SIEGEREHRUNG` / `ORGANISATORISCH` sind modelliert.
+
+### Sprint B — vollständig abgeschlossen
+
+- **ADR-0022 (LAN-Sync-Protokoll):** Entscheidung für **Event-Sourcing Light mit Lamport-Uhren** (Option D) getroffen.
+  Optionen (Event-Sourcing, CRDT, Timestamp-Sync) wurden analysiert. ADR liegt in
+  `docs/01_Architecture/adr/0022-lan-sync-protocol-de.md`. Backend und Frontend wurden informiert — C-3 (LAN-Sync) bei
+  beiden freigegeben.
+
+---
+
+## 🔄 Was ist noch offen?
+
+### Sprint C — nächste Woche (Priorität 2)
+
+- **C-1 Synchronisations-Protokoll-Konzeption:** Offline-First-Konzept für Desktop ↔ Backend ausarbeiten,
+  Conflict-Resolution-Strategie definieren, Konzept-Dokument ablegen.
+- **C-2 MASTER_ROADMAP aktualisieren:** Desktop-App-Fokus eintragen, Sprint A/B Ergebnisse als erledigt markieren,
+  Offline-Sync-Meilensteine eintragen, Phase-8-Fortschritt reflektieren.
+
+---
+
+## 🔗 Abhängigkeiten & Auswirkungen
+
+| Meine Aufgabe      | Blockiert wen                                                |
+|--------------------|--------------------------------------------------------------|
+| ADR-0021 ✅         | 👷 Backend: Tenant-Isolation (abgeschlossen)                 |
+| Domänen-Modell ✅   | 👷 Backend: Schema-Design; 🎨 Frontend: ViewModel-Design     |
+| ADR-0022 ✅         | 🎨 Frontend C-3, 👷 Backend C-3, 🐧 DevOps D-2 (freigegeben) |
+| Sync-Konzept (C-1) | 🐧 DevOps: mDNS/WebSocket-Infrastruktur                      |
+
+---
+
+## 💬 Botschaft an die Runde
+
+Die zwei wichtigsten Architektur-Fundamente sind gesetzt: **Tenant-Isolation** (ADR-0021) und **LAN-Sync-Protokoll** (
+ADR-0022). Das Team kann auf diesen Entscheidungen aufbauen — Backend und Frontend haben ihre C-3-Aufgaben (
+LAN-Sync-Implementierung) bereits in der Roadmap. Die nächste dringende Aufgabe ist das konkrete *
+*Offline-First-Konzept (C-1)** und die Aktualisierung der **MASTER_ROADMAP (C-2)**, damit alle Teams einen aktuellen
+Überblick haben.