chore: entferne veraltete Architekturdokumente

Signed-off-by: StefanMoCoAt <stefan.mo.co@gmail.com>
This commit is contained in:
2026-05-05 21:22:46 +02:00
parent 6f15ada447
commit 15222b5453
258 changed files with 3388 additions and 6533 deletions
@@ -0,0 +1,95 @@
# Roadmap: System-Konsolidierung & Strategie
🏗️ **[Lead Architect]** & 🧹 **[Curator]** | 28. März 2026
## 1. Zusammenfassung
Dieser Fahrplan beschreibt die Schritte zur Konsolidierung der technischen Basis und die Strategie zur Ausrichtung der
Feature-Implementierung an der verfeinerten DDD-Struktur (ADR-0014) sowie der Design-Baseline Vision_03.
---
## 2. Abgeschlossene Meilensteine (Letzte Sessions)
### 🟢 Technische Stabilisierung
* **Kotlin 2.3.20:** Alle Module wurden auf Kotlin 2.3.20 migriert. Deprecation-Warnungen für `Clock` und `Instant`
wurden durch Standardisierung auf `kotlin.time.*` behoben.
* **Zentralisierte Serialisierung:** Erstellung der `Serializers.kt` im `core-domain` Modul für `Uuid`, `Instant`,
`LocalDate`, `LocalDateTime` und `LocalTime`.
* **Exposed Framework:** Fixierung der Exposed-Version auf `1.1.1` für alle Module, um eine stabile Persistenzschicht zu
gewährleisten.
* **Infrastruktur-Refactoring:** Umzug der `DatabaseFactory` nach `core-utils` (jvmMain) als wiederverwendbare
Komponente.
### 🔵 DDD-Konsolidierung: `master-data-context`
* **Context-Merge:** Die separaten Services (`clubs`, `persons`, `horses`, `officials`) wurden aufgelöst und im
zentralen `master-data-context` vereint.
* **ZNS-Importer Verifizierung:** Erfolgreicher Testlauf mit der offiziellen `ZNS.zip`. Ca. 70.000 Datensätze wurden
korrekt in die neue Struktur importiert.
* **Library of Truth:** Etablierung des `master-data-context` als schreibgeschützte (für Enduser) "Single Source of
Truth" für Verbandsdaten.
### 🟡 Identity Integration
* **ZNS-Identity Link:** Technische Grundlage im `identity`-Service geschaffen, um System-User (Keycloak) mit
offiziellen ZNS-Satznummern zu verknüpfen.
* **Profil-Erweiterungen:** Implementierung von `DomProfil` für angereicherte Daten (Logos, Bios), ohne die
ZNS-Integrität zu gefährden.
---
## 3. Detaillierter Fahrplan (Aktuelle & Nächste Schritte)
### Phase A: Fundament finalisieren (Status: In Arbeit)
* [ ] **Repository-Vervollständigung:** Finalisierung der Persistenzmethoden in `masterdata-infrastructure` unter
Nutzung der neuen Tabellen.
* [ ] **API-Refinement:** Abschluss der REST-Endpunkte für den konsolidierten Master-Data-Context (Länder,
Bundesländer, Altersklassen, Plätze).
* [ ] **Validierungs-Logik:** Implementierung der Matrizen für Startberechtigungen (Altersklassen/Lizenz-Prüfungen) im
Master-Data-Kern.
### Phase B: Identity & Profil-Erfahrung
* [ ] **ZNS Link UI:** Erstellung des Frontend-Screens in `meldestelle-desktop`, auf dem User ihre offizielle
Satznummer suchen und verknüpfen können.
* [ ] **Profil-Verwaltung:** Implementierung der UI-Features zur Pflege der erweiterten Profildaten (Logo-Upload,
Kontaktinfo).
### Phase C: Competition-Context Refinement (§ 39 ÖTO)
* **Atomarität:** Ausrichtung der Logik auf die **"Abteilung"** als kleinste operative Einheit.
* **Automatische Trennung:** Implementierung von Warnungen bei Überschreitung der Starter-Schwellenwerte (z.B. 80
Starter Fallback).
* **Listen-Generierung:** Umstellung der Tabs 7-8 im Frontend auf Abteilungs-basierte Selektion für Start- und
Ergebnislisten.
### Phase D: Vision_03 Evolution
* **Integration:** Ersetzen der alten administrativen Screens durch die neuen `v2`-Screens (`VeranstalterAuswahlV2`,
`TurnierWizardV2`).
* **Billing-Sync:** Portierung der Gebühren-Logik (Nenngebühren, Tierwohl-Euro, Sportförderung) vom Figma React-Prototyp
in das KMP `billing-feature`.
---
## 4. Bounded Context Map (Konsolidiert)
| Bounded Context | Verantwortung | Source of Truth |
|:----------------|:---------------------------------------------------|:------------------------|
| `master-data` | SSOT für Personen, Pferde, Vereine, Regelwerk | ZNS Import / Admin |
| `identity` | Auth, Profile, ZNS-Links | Keycloak / Link-Tabelle |
| `registration` | Nennungs-Management, Validierung gegen Master-Data | System-Nennungen |
| `competition` | Live-Scoring, Abteilungen, Start-/Ergebnislisten | Live-Eingabe |
| `billing` | Konten, Gebühren, Kassa | Finanz-Transaktionen |
| `event-mgmt` | Turnierstruktur, Konfiguration, Zeitplan | User-Konfiguration |
---
## 5. Sofort-Maßnahmen
1. **Backend:** Letzte Kompilierfehler in `masterdata-infrastructure` beheben.
2. **Backend:** ZNS-Linking Endpunkte über die Identity-API bereitstellen.
3. **Frontend:** `NennungsMaske` auf die neuen, konsolidierten Masterdata-Endpunkte umstellen.
@@ -0,0 +1,58 @@
# Nightly Roadmap 30.03.2026
🏗️ [Lead Architect] & 🧹 [Curator]
Ziel der Nacht: Vorbereitung „Reporting & Output“ und finale Aufstellung für Neumarkt (Events/Turniere), ohne
Cups/Serien.
---
## 1) Fokus-Themen und Deliverables (heute Nacht)
1. Reporting & Output (Vorbereitung)
- [Owner] Vorlagen sammeln/übermitteln: Startlisten, Ergebnislisten (PDF/Scan/Excel)
- [Owner] Spring-Protokolle: Inhalte/Felder definieren (Fehler, Zeit, Stechen)
- [Owner] Dressur-Protokolle: Vorlage für personalisierten Ausdruck (Kopfzeile Reiter/Pferd)
- [Arch/BE] Technik-Entscheidung PDF: KMP-Library vs. Server-Side Rendering (ADR-Entwurf)
- [FE] UI-Draft „Druckvorschau“ in V2-Screens: Platzhalter mit Beispiel-Daten
2. Events/Turniere (Backend-Readiness für Neumarkt)
- [BE] DB-Migrationen finalisieren: `turniere`, `ausschreibungen` (Flyway)
- [BE] Seed-Datensatz „Veranstaltung Neumarkt 2026“ (+ 12 Turniere)
- [BE] Repositories prüfen und Test-Cases anlegen (Roundtrip CRUD)
3. Identity & Profil (Verifikation)
- [QA] E2E-Check „ZNS-Link“: Login → Profile → Satznummer verknüpfen → Refresh
- [FE] Validation/UX-Polish im `profile-feature`
4. Live-Ergebnisse Vision (Input sammeln)
- [Owner] Skizze/Mock für mobile Web-Ansicht (Zuschauer): Bewerb → Abteilungen → Live-Board
---
## 2) Abhängigkeiten & Risiken (heute Nacht)
- Abhängigkeiten: Vorlagen/Mockups vom Owner; stabile API-Basis für Events/Turniere
- Risiken: Fehlende Layout-Vorlagen verzögern PDF-Struktur; Workaround: neutrale Standard-Layouts
---
## 3) Definition of Done (heute Nacht)
- Neue Migrationen für `events`-Schema committed; Test-Seeds lauffähig
- ADR-Entwurf für PDF-Rendering erstellt
- FE-Placeholder für Druckvorschau eingebaut (abschaltbar/Feature-Flag)
- Session-Log (Curator) mit Status/Nächste Schritte aktualisiert
---
## 4) Nächste Schritte danach (D+1)
- PDF-Layouts nach Vorlagen umsetzen; Binding der Daten-Modelle (Start-/Ergebnislisten)
- Spring-Protokolle Eingabe-UI + Export
- Dressur-Protokolle personalisiert (Kopf- & Fußzeilen-Generator)
- Erste öffentliche Live-Ansicht (Read-Only, Cachebusting, Paging)
@@ -0,0 +1,11 @@
---
type: Roadmap
status: ARCHIVED
owner: Lead Architect
last_update: 2026-01-15
---
# Roadmap Q1 2026: "Operation Tracer Bullet"
**MOVED:** This file has been archived to `_archive/2026-01-15_Roadmap_2026_Q1.md`.
Please use `MASTER_ROADMAP_2026_Q1.md` as the Single Source of Truth.