docs: add core domain SQL schema draft and enhance domain glossary

Introduced an initial SQL schema draft for the core domain, focusing on offline-first architecture and aligning with OEPS legacy specifications. Expanded the domain glossary to include critical terms for improved clarity and domain understanding. Added session notes and user stories to document analysis outcomes and requirements.
2026-01-16 11:32:53 +01:00
parent 2dc3c4154b
commit 39ba21fd77
9 changed files with 975 additions and 28 deletions
@@ -0,0 +1,109 @@
+# User Stories Draft - Phase 1 (Core Domain)
+
+*   **Status:** Draft
+*   **Fokus:** Nationale Turniere (OEPS), Offline-Betrieb, Basis-Verwaltung
+
+---
+
+## Epic 1: Stammdaten & Offline-Vorbereitung
+
+### US-001: Import der Verbands-Stammdaten (ZNS)
+**Als** Meldestellen-Leiter  
+**möchte ich** die offizielle `zns.zip` Datei (Pferde, Reiter, Vereine, Richter) in das System importieren,  
+**damit** ich auch ohne Internetverbindung Zugriff auf alle validen Lizenz- und Pferdedaten habe.
+
+*   **Akzeptanzkriterien:**
+    *   System akzeptiert `zns.zip` oder entpackte `.dat` Dateien (Codepage 850).
+    *   Importiert `PFERDE01.dat` (inkl. Mapping der 10-stelligen Satznummer).
+    *   Importiert `LIZENZ01.dat` (inkl. Startkarten-Status und Sperrvermerke).
+    *   Der Import ist performant genug, um am Turniermorgen aktualisiert zu werden (< 5 Min).
+    *   Fehlerhafte Datensätze werden protokolliert, brechen den Import aber nicht ab.
+
+### US-002: Intelligente Akteur-Suche
+**Als** Meldestellen-Mitarbeiter  
+**möchte ich** Reiter und Pferde über eine fehlertolerante Suche finden (Name, Kopfnummer, Lizenznummer),  
+**damit** ich Nennungen schnell erfassen kann, auch wenn der Reiter seine genaue Nummer nicht weiß.
+
+*   **Akzeptanzkriterien:**
+    *   Suche nach Pferdenamen (Teilübereinstimmung).
+    *   Suche nach Kopfnummer (z.B. "A123").
+    *   Anzeige von Warnhinweisen direkt im Suchergebnis (z.B. "Sperrliste", "Keine Startkarte").
+    *   Unterscheidung bei Namensgleichheit durch Anzeige von Verein/Jahrgang/Abstammung.
+
+---
+
+## Epic 2: Nennung & Check-in
+
+### US-003: Validierung der Startberechtigung (Startkarte)
+**Als** Meldestellen-Leiter  
+**möchte ich**, dass das System mich warnt, wenn ein Reiter für einen Bewerb nennt, aber keine aktive Startkarte (Jahresgebühr) hat,  
+**damit** ich ihn zur Nachzahlung auffordern kann.
+
+*   **Akzeptanzkriterien:**
+    *   Prüfung des Flags `STARTKARTE` aus den Stammdaten.
+    *   Prüfung der Lizenzklasse (z.B. darf "R1" nicht in Klasse S starten).
+    *   **Wichtig:** Das System darf die Nennung *nicht* blockieren (Soft-Validation), sondern muss einen "Override" ermöglichen (z.B. "Zahlung vor Ort erfolgt").
+    *   Visuelle Hervorhebung in der Starterliste (z.B. roter Status).
+
+### US-004: Manuelle Nachnennung vor Ort
+**Als** Meldestellen-Mitarbeiter  
+**möchte ich** ein Pferd-Reiter-Paar kurzfristig zu einem Bewerb hinzufügen,  
+**damit** Teilnehmer, die die Online-Nennfrist verpasst haben, gegen Gebühr noch starten können.
+
+*   **Akzeptanzkriterien:**
+    *   Auswahl von Bewerb, Reiter und Pferd.
+    *   Automatische Berechnung der erhöhten Nenngebühr (Nachnenngebühr).
+    *   Vergabe einer Startnummer (fortlaufend oder manuell).
+    *   Eintrag in die `KKARTEI` (Nennliste) und `BBEWERBE` (Starterliste).
+
+---
+
+## Epic 3: Bewerbs-Abwicklung
+
+### US-005: Verwaltung von Abteilungen
+**Als** Meldestellen-Leiter  
+**möchte ich** einen Bewerb mit vielen Startern in mehrere Abteilungen (z.B. R1-Reiter vs. R2-Reiter) unterteilen,  
+**damit** ich getrennte Ergebnislisten und Platzierungen erstellen kann, wie es die ÖTO verlangt.
+
+*   **Akzeptanzkriterien:**
+    *   Ein Bewerb kann in n Abteilungen gesplittet werden.
+    *   Starter können per Drag&Drop oder Regel (z.B. "Alle R1 in Abt. 1") zugewiesen werden.
+    *   Jede Abteilung hat eine eigene Platzierung, aber sie teilen sich die gleichen Prüfungsparameter (Parcours).
+    *   Export berücksichtigt das Feld `ABTEILUNG` im B-Satz.
+
+### US-006: Ergebniserfassung & Platzierung
+**Als** Richter oder Schreiber  
+**möchte ich** Ergebnisse (Zeit, Fehler, Wertnote) für einen Starter eingeben,  
+**damit** die Rangierung automatisch berechnet wird.
+
+*   **Akzeptanzkriterien:**
+    *   Eingabemaske optimiert für schnelle Nummernblock-Eingabe.
+    *   Automatische Berechnung der Rangfolge basierend auf dem Regelwerk (Fehler/Zeit vs. Wertnote).
+    *   Handling von Spezialfällen: Ausschluss (EL), Aufgabe (RET), Disqualifikation (DQ), Nicht angetreten (DNS).
+    *   Sofortige Aktualisierung der "Live-Ergebnisse".
+
+---
+
+## Epic 4: Abschluss & Export
+
+### US-007: OEPS-Konformer Ergebnis-Export
+**Als** Meldestellen-Leiter  
+**möchte ich** die Ergebnisse des Turniers in das definierte Format (ASCII, Codepage 850) exportieren,  
+**damit** ich meiner Meldepflicht gegenüber dem Verband nachkommen kann.
+
+*   **Akzeptanzkriterien:**
+    *   Erstellung der `XXXXX.ERG` Datei.
+    *   Strikte Einhaltung der Spaltenbreiten und Formate (siehe Legacy Spec Analyse).
+    *   Validierung vor Export: Warnung bei fehlenden Satznummern oder ungültigen Codes.
+    *   Korrekte Zuordnung der Nation (Gast vs. Inländer).
+
+### US-008: Kassenabschluss & Abrechnung
+**Als** Veranstalter  
+**möchte ich** eine Liste aller offenen Posten (Nenngelder, Boxen, Nachnenngebühren) pro Reiter/Verein sehen,  
+**damit** ich vor der Ausgabe der Pferdepässe kassieren kann.
+
+*   **Akzeptanzkriterien:**
+    *   Aggregierte Ansicht pro "Verantwortlicher Person" (Zahler).
+    *   Auflistung aller Posten (Nennung, Startgeld, Gebühren).
+    *   Verrechnung von gewonnenen Geldpreisen (Gutschrift).
+    *   Druckfunktion für Rechnung/Quittung.