docs(adr): ZNS-First Enrollment Pattern und ZNS-Light Strategie dokumentiert

Signed-off-by: Stefan Mogeritsch <stefan.mo.co@gmail.com>
2026-04-16 12:40:51 +02:00
parent eb0fac5989
commit 10f9e82718
2 changed files with 81 additions and 0 deletions
@@ -0,0 +1,49 @@
+# Journal-Eintrag: 2026-04-16 - ZNS-First Wizard & ZNS-Light Strategie
+
+## 🏗️ [Lead Architect] & 👷 [Backend Developer] & 🖌️ [UI/UX Designer]
+
+### 🎯 Zielsetzung
+
+Lösung des Henne-Ei-Problems bei der Veranstaltungs-Anlage durch Invertierung des Workflows. Sicherstellung einer hohen
+Performance (Speed over Animation) durch selektiven ZNS-Import.
+
+### 🛠️ Getroffene Entscheidungen
+
+#### 1. Der "ZNS-First Enrollment" Workflow (3-Schritt-Wizard)
+
+Der Wizard für eine neue Veranstaltung wird radikal umgebaut, um die Datenintegrität von Anfang an sicherzustellen:
+
+* **Schritt 1: ZNS-Basis & Veranstalter**
+  * Upload der `ZNS.zip`.
+  * Sofortiger Import der `VEREIN01.dat` (Vereine) und `LIZENZ01.dat` (Personen).
+  * Auswahl des Veranstalters aus den importierten Daten (oder manuelle Neuanlage).
+* **Schritt 2: Meta-Daten & DB-Initialisierung**
+  * Eingabe von Titel, Datum (von-bis) und Ort.
+  * Nach Validierung: Generierung der `veranstaltungId` (UUID).
+  * Provisionierung der spezifischen Veranstaltungs-Datenbank und Transfer der ZNS-Light-Daten aus dem Staging-Buffer.
+* **Schritt 3: Fachlicher Typ**
+  * Wahl der Veranstaltungsart (derzeit "Turnier").
+  * Weiterleitung zum Turnier-Cockpit.
+
+#### 2. "ZNS-Light" Performance-Strategie
+
+Um die Wartezeit beim ersten Import von ~20 Minuten auf wenige Sekunden/Minuten zu reduzieren:
+
+* **Light-Modus:** Nur `VEREIN01` und `LIZENZ01` werden im Wizard geladen.
+* **Lazy-Modus:** Die massiven Datenmengen von `PFERDE01` und `RICHT01` werden erst im Turnier-Setup oder bei Bedarf im
+  Hintergrund geladen.
+
+#### 3. Frontend-Konsolidierung (Single Source of Truth)
+
+* Alle Entwürfe (V1/V2) werden im `VeranstaltungNeuScreen.kt` zusammengeführt.
+* Redundante Screens wie der separate `StammdatenImportScreen` werden als Komponente in den Wizard integriert.
+
+### 🚀 Nächste Schritte (für die neue Session)
+
+1. **Backend-Staging-Buffer:** Implementierung der temporären Speicherung der ZNS-Light-Daten während des Wizards.
+2. **Wizard-Implementation:** Umsetzung des 3-Schritt-Flows im `VeranstaltungNeuScreen.kt`.
+3. **API-Erweiterung:** `ZnsImportService` um den `mode=LIGHT` Parameter erweitern.
+
+---
+🧹 **[Curator]**: Dieses Dokument dient als Übergabeprotokoll für die nächste Session. Alle fachlichen und technischen
+Parameter sind hiermit fixiert.