meldestelle/docs/04_Agents/Roadmaps/Architect_Roadmap.md

4.3 KiB

🏗️ [Lead Architect] — Zwischenstand & Roadmap

Stand: 12. April 2026 Rolle: Strategie, Architektur-Entscheidungen (ADRs), Domänen-Modell, Master-Roadmap


Erledigte Sprints

Sprint A — Abgeschlossen

  • A-1 | ADR-0021 Tenant-Resolution-Strategie

    • Schema-per-Tenant vs. Tenant-ID analysiert → Entscheidung: Eine Veranstaltung = eine Datenbank
    • ADR-0021 in docs/01_Architecture/adr/0021-tenant-resolution-strategy-de.md abgelegt
    • Backend Developer informiert (Backend A-1 gestartet)
  • A-2 | Domänen-Modell formal präzisiert

    • Hierarchie Veranstaltung → Turnier → Bewerb → Abteilung festgeschrieben
    • TeilnehmerKonto auf Veranstaltungsebene (Multi-Turnier) ins Modell aufgenommen
    • Veranstaltungs-Kassa mit Turnier-übergreifendem Saldo modelliert
    • Abteilungs-Typen SEPARATE_SIEGEREHRUNG und ORGANISATORISCH definiert
    • Curator beauftragt: Ubiquitous_Language.md aktualisiert

Sprint B — Abgeschlossen

  • B-1 | ADR für LAN-Sync-Protokoll schreiben
    • Optionen analysieren: Event-Sourcing vs. CRDT vs. Timestamp-Sync
    • Entscheidung für Meldestelle ↔ Richter-Turm Sync getroffen: Event-Sourcing Light mit Lamport-Uhren (Option D)
    • ADR-0022 in docs/01_Architecture/adr/0022-lan-sync-protocol-de.md abgelegt
    • Backend Developer und Frontend Expert über Entscheidung informiert (siehe jeweilige Roadmaps)

⏸️ USB-Stick Fallback — Separate Besprechung zu einem späteren Zeitpunkt (Sprint B/C)


Sprint C — Abgeschlossen

  • C-1 | Zeitplan-Optimierung Konzept

    • Fachliche Anforderungen (Use Cases) definiert
    • Zeitberechnungs-Algorithmus spezifiziert
    • Drag & Drop Logik für Kalender-Ansicht entworfen
    • Konzept-Dokument in docs/01_Architecture/ abgelegt → docs/01_Architecture/konzept-zeitplan-optimierung-de.md
  • C-2 | MASTER_ROADMAP aktualisieren

    • Phase 9 Fortschritt reflektieren
    • Link zum Zeitplan-Konzept ergänzt
    • Feature-Migration (Frontend) dokumentiert
    • Phase 10 & 11 (Series & Results) als abgeschlossen markiert (Stand 11.04./12.04.)

🟠 Sprint D — In Arbeit

  • D-1 | USB-Stick Fallback (Sync)

    • Technische Machbarkeit (File-Storage vs. SQLite-Export) prüfen
    • ADR für Offline-Transfer erstellen
  • D-2 | Abrechnungs-Architektur (Billing-Service Integration)

    • Datenmodell für Buchungskonten und Transaktions-Logik finalisiert
    • Integration des billing-service in die Gateway-Routing-Struktur
    • API-Spezifikation für automatisierte Buchungen aus entries und results Contexts

🔵 Sprint E — Desktop-Fokus (Beschleunigung)

  • E-1 | Desktop-Priorisierung (Strategie-Anpassung)

    • Analyse "Cloud-Connected" vs. "Offline-First Authority"
    • Fokus-Verschiebung: Desktop-Zentrale wird primärer Master (ADR-0022/Concept)
    • Identifikation fehlender lokaler Persistenz-Layer (SQLDelight)
  • E-2 | Offline-First Sync-Infrastruktur (Härtung)

    • Implementierung SyncEvent-Logger in core:sync
    • SQLDelight Schema-Migration für lokales Event-Log
    • Hintergrund-Sync Worker (opportunistisch)
  • E-3 | UI/UX Härtung für Offline-Betrieb

    • Globaler Sync-Status in der Desktop-Sidebar
    • Optimistisches UI für Nennungen und Ergebnisse
    • Fehler-Behandlung bei Verbindungsabbrüchen (mDNS/WAN)

📌 Abhängigkeiten

Meine Aufgabe Blockiert wen
ADR-0021 👷 Backend: Tenant-Isolation (Backend Sprint A)
Domänen-Modell 👷 Backend: Schema-Design; 🎨 Frontend: ViewModel-Design
LAN-Sync ADR (B-1) 🎨 Frontend: Sync-UI; 👷 Backend: Sync-Endpunkte
Sync-Konzept (C-1) 🐧 DevOps: mDNS/WebSocket-Infrastruktur
Billing-Arch (D-2) 👷 Backend: Buchungs-Logik; 🎨 Frontend: Kassa-UI

💡 Empfehlung

Fokus auf Phase 12: Die technische Infrastruktur für das Billing steht (Consul, Gateway, Repository). Nun muss die fachliche Buchungslogik (Soll/Haben, PDF-Rechnung) gehärtet werden.