feat(docs): expand masterdata documentation with Reiter- and Pferdeprüfungen

- Added `REITER_PRUEFUNGEN.md` and `PFERDEPRUEFUNGEN_BEWERTUNG.md` to document evaluation criteria, scoring logic, and system requirements for dressage and show jumping. - Updated `README.md` with links to new documentation on rider- and horse-specific regulations. - Created database schemas for `TurnierklasseTable`, `RichtverfahrenTable`, `GebuehrTable`, `LicenseTable`, and `RegulationConfigTable`, aligning with ÖTO 2026. - Logged architectural decisions and analysis in `session-logs` and created ADRs `0017-masterdata-importer-worker` and `0019-api-ingestion-layers`. Signed-off-by: Stefan Mogeritsch <stefan.mo.co@gmail.com>
2026-03-30 14:29:55 +02:00
parent 6375ec23c3
commit e8757c5c32
29 changed files with 1663 additions and 18 deletions
@@ -0,0 +1,47 @@
+# Session Log: Einarbeitung C-NEU Bestimmungen & Turnier-Sparten
+
+**Datum:** 2026-03-30  
+**Agent:** 📜 [ÖTO/FEI Rulebook Expert] / 🧹 [Curator]
+
+## Zielsetzung
+
+Integration der spezifischen Bestimmungen für C-NEU Turniere (CDN-C NEU / CSN-C NEU) in die Stammdaten-Dokumentation des
+`masterdata` Services. Aufbereitung einer detaillierten Übersicht über Turnier-Sparten (Dressur & Springen), deren
+Klassen und die korrespondierenden Startberechtigungen (Lizenz-Matrix).
+
+## Durchgeführte Änderungen
+
+### 1. Erweiterung der zentralen Stammdaten (`OETO_STAMMDATEN.md`)
+
+* **Abteilungslogik:** Spezifikation der 3-Abteilungs-Regel für CSN-C NEU bis 95 cm (Abt. 1: ohne Lizenz, Abt. 2: R1,
+  Abt. 3: R2+).
+* **Dressur-Klassen:** Ergänzung der Klasse `LF` (Lizenzfrei) für Reiterpass-/Reiternadel-Aufgaben im C-NEU Bereich.
+* **C-NEU Spezifika:** Dokumentation der Einschränkung, dass Lizenzinhaber in RP/Nadel-Bewerben nicht startberechtigt
+  sind.
+
+### 2. Neue Fachdokumentation (`TURNIER_KLASSEN.md`)
+
+* Erstellung einer detaillierten Übersicht für **Springen (CSN)**:
+  * Höhenstufen (E0 bis S****).
+  * C-NEU Besonderheiten (Registrierungspflicht erst ab 95 cm, Startlimits).
+  * Strukturelle Abteilungs-Vorgaben.
+* Erstellung einer detaillierten Übersicht für **Dressur (CDN)**:
+  * Aufgabenniveau (LF bis S).
+  * Startberechtigungen pro Klasse.
+* **Startberechtigungs-Matrix:** Zentrale Gegenüberstellung von Lizenzstufen (LZF, R1-R4, RD1-RD3) und den maximal
+  zulässigen Klassen in beiden Sparten.
+
+### 3. Service-Integration (`README.md`)
+
+* Verlinkung der neuen `TURNIER_KLASSEN.md` in der zentralen Dokumentations-Übersicht des `masterdata` Services.
+
+## Verifizierung
+
+* Abgleich der Daten mit `Bestimmungen_CSN-C_NEU.md` und `Bestimmungen_CDN-C_NEU.md`.
+* Validierung der Lizenzstufen gegen `REITER_LIZENZEN.md` und die ÖTO 2026.
+* Prüfung der Konsistenz mit den Abteilungs-Schwellenwerten aus der Master-Referenz.
+
+## Nächste Schritte
+
+* Implementierung der `Validation-Engine` Logik basierend auf der erstellten Startberechtigungs-Matrix.
+* Erweiterung des `zns-import` Moduls zur Berücksichtigung der C-NEU Registrierungs-Ausnahmen für Pferde.
@@ -0,0 +1,36 @@
+# Session Log: Masterdata Funktionär-Qualifikationen
+
+**Datum:** 2026-03-30
+**Agent:** 📜 [ÖTO/FEI Rulebook Expert]
+
+## 🎯 Ziel
+
+Aufbereitung der Qualifikationen für Richter und Parcoursbauer basierend auf der ÖTO 2026 und dem ZNS-Pflichtenheft v2.4
+zur Integration in den `masterdata` Service.
+
+## 🛠️ Änderungen
+
+### 1. Neue Dokumentation: `FUNKTIONAERE_QUALIFIKATIONEN.md`
+
+* **Fachlich:** Zusammenfassung der Richtergruppen (Dressur, Springen, Vielseitigkeit) und Zusatzqualifikationen (SPF,
+  DPF).
+* **Level:** Dokumentation der Parcoursbauer-Level (P1-P4) inklusive der spezifischen Anforderung für C-NEU (mind. P1).
+* **Regelwerk:** Integration der Einsatzvorgaben (§ 50 A-Teil) wie Mindestbesetzung und Zeitlimits.
+* **Technisch:** Detaillierung der ZNS-Satzarten (X-Satz für Richter, Y-Satz für Parcoursbauer) mit Felddefinitionen (
+  Stelle/Länge).
+
+### 2. README-Update
+
+* Verlinkung der neuen Dokumentation in der zentralen `README.md` des `masterdata` Services.
+
+## 🔍 Validierung
+
+* Abgleich der Felddefinitionen mit dem Original-Pflichtenheft v2.4.
+* Prüfung der fachlichen Anforderungen gegen die ÖTO 2026 (A- und B-Teil).
+* Verifizierung der Pfade und Verlinkungen innerhalb des Service-Kontexts.
+
+## 📌 Nächste Schritte
+
+* Implementierung der `Funktionaer`-Entity in `masterdata-domain` (erledigt).
+* Ausbau des `ExposedFunktionaerRepository` zur Unterstützung des ZNS-Imports der X- und Y-Sätze.
+* Integration der Qualifikations-Validierung in die Turnier-Ausschreibung (Validation Engine).
@@ -0,0 +1,41 @@
+# Session Log: Masterdata Gebührenordnung (ÖTO 2026)
+
+**Datum:** 2026-03-30
+**Agent:** 🧹 [Curator] & 📜 [ÖTO/FEI Rulebook Expert]
+
+## 🎯 Ziel
+
+Aufbereitung der offiziellen ÖTO-Gebührenordnung 2026 für die Sparten Dressur und Springen zur späteren Implementierung
+in die Berechnungs- und Validierungs-Logik des Masterdata-Services.
+
+## 📝 Durchgeführte Änderungen
+
+### 1. Fachdokumentation erstellt
+
+* **Datei:** `backend/services/masterdata/docs/GEBUEHRENORDNUNG.md`
+* **Inhalt:**
+  * **Nenn- und Startgelder:** Strukturierte Übersicht über Nenngelder nach Kategorie (A/B/C) und
+    Startgeld-Obergrenzen (mit/ohne Geldpreis, C-NEU, getrenntes Richten).
+  * **Zusatzabgaben:** Dokumentation von Tierwohleuro (1,00 €) und Sportförderbeitrag (1,00 €).
+  * **Geldpreise:** Tabellarische Aufbereitung der Mindest-Geldpreise für Dressur (Klassen A bis S) und Springen (
+    Höhenstufen 105 cm bis 160 cm) für alle Turnierkategorien.
+  * **Funktionärsvergütung:** Festhalten der Tagessätze (120 € / 100 €), Kilometergelder (0,50 €) und
+    Unterkunftsvorgaben.
+
+### 2. Integration & Verlinkung
+
+* Aktualisierung der `backend/services/masterdata/README.md`, um die neue Gebührenordnung als Referenz für die
+  ÖTO-Konformität aufzunehmen.
+
+## 🔍 Validierung
+
+* Abgleich der Daten mit dem Originaldokument
+  `docs/03_Domain/02_Reference/OETO_Regelwerk/OETO-2026_E-Teil-Gebuehrenordnung_18-12-2025.md`.
+* Sicherstellung, dass spartenrelevante Ausnahmen (z.B. Tierwohleuro nur bei Springen) korrekt markiert sind.
+
+## 💡 Nächste Schritte
+
+* Überführung der Gebührensätze in Domänen-Konstanten (`masterdata-domain`).
+* Implementierung einer `AccountingEngine` oder eines `FeeCalculator` Services im `competition-context`, der auf diese
+  Stammdaten zugreift.
+* Erweiterung der Ausschreibungs-Validierung um die Prüfung der Mindest-Geldpreis-Summen.
@@ -0,0 +1,29 @@
+### Summary
+
+- Aufbereitung und Dokumentation der spezifischen Anforderungen für Pferdeprüfungen (Jungpferde) in Dressur und Springen
+  gemäß ÖTO 2026.
+- Integration der komplexeren Bewertungslogik (Qualitative Noten, Abzüge bei Springpferdeprüfungen) in den `masterdata`
+  Service-Kontext.
+
+### Changes
+
+- **Neue Fachdokumentation:** `backend/services/masterdata/docs/PFERDEPRUEFUNGEN.md` erstellt, die Altersklassen,
+  Richtverfahren und Bewertungskriterien für Dressur-, Spring- und Reitpferdeprüfungen beschreibt.
+- **Bewertungs-Logik:** Detaillierung der qualitativen Merkmale (Grundgangarten, Rittigkeit, Perspektive) und der
+  spezifischen Abzugs-Regeln für Springpferdeprüfungen.
+- **README-Update:** Die zentrale `README.md` des `masterdata` Services wurde um die Verlinkung der neuen
+  Pferdeprüfungs-Dokumentation ergänzt.
+- **Journaling:** Erstellung eines detaillierten Session Logs zur Dokumentation der Aufbereitung für
+  Jungpferdeprüfungen.
+
+### Verification
+
+- Abgleich der Altersklassen und Richtverfahren mit den ÖTO-Regelwerken 2026 (Abschnitt B I und B II).
+- Validierung der Abzugs-Logik (§ 204 Abs. 4) für Springpferdeprüfungen.
+- Prüfung der internen Verlinkung innerhalb der Service-Struktur.
+
+### Notes
+
+- Die Dokumentation dient als Grundlage für die Implementierung der Notenerfassung im UI (Einzelnoten-Eingabe vs.
+  Gesamtnote).
+- Die Pferdealter-Validierung muss beim Nennungsprozess strikt auf dem Geburtsjahr (Stichtag 1.1.) basieren.
@@ -0,0 +1,24 @@
+### Summary
+
+- Aufbereitung und Dokumentation des spezifischen Bewertungssystems für Pferdeprüfungen (Dressur-/Springpferde) und
+  Stilspringprüfungen gemäß ÖTO 2026.
+- Integration der qualitativen Bewertungskriterien und der automatisierten Abzugslogik in den `masterdata`
+  Service-Kontext.
+
+### Changes
+
+- **Neue Fachdokumentation:** `backend/services/masterdata/docs/PFERDEPRUEFUNGEN_BEWERTUNG.md` erstellt, die
+  Einzelnoten-Kriterien für Dressurpferdeprüfungen (Schritt, Trab, Galopp etc.) und die Abzugslogik für
+  Springpferde/Stilspringen (-0,5/-1,0) detailliert beschreibt.
+- **Spezialregelung:** Dokumentation der „ohne Bewertung“ (o.B.) Logik für Endnoten <= 4,9 inklusive deren spezifischer
+  Reihung in Ergebnislisten.
+- **System-Anforderungen:** Definition der UI- und Berechnungs-Anforderungen für die Meldestellen-Software (
+  Echtzeit-Kalkulation der Endnoten).
+- **README-Update:** Die zentrale `README.md` des `masterdata` Services wurde um die Verlinkung der neuen
+  Bewertungs-Dokumentation erweitert.
+
+### Verification
+
+- Abgleich der Kriterien und Abzugswerte mit den ÖTO-Regelwerken 2026 (Abschnitt B, § 103, § 104, § 203, § 204).
+- Validierung der Konsistenz zwischen fachlichen Anforderungen und den zuvor erstellten allgemeinen
+  Pferdeprüfungs-Stammdaten.
@@ -0,0 +1,27 @@
+# Session Log: Masterdata Reiter-Prüfungen (Dressur & Stilspringen)
+
+## 📋 Zusammenfassung
+
+- Aufbereitung der Stammdaten für Dressurreiter- und Stilspringprüfungen gemäß ÖTO 2026.
+- Fokus auf die spezifische Bewertungslogik (Wertnoten vs. Abzüge) und deren Anforderungen an das System.
+
+## 🛠 Änderungen
+
+- **Neue Fachdokumentation:** `backend/services/masterdata/docs/REITER_PRUEFUNGEN.md` erstellt.
+- **Inhalt:**
+  - Definition Dressurreiterprüfung (Sitz, Einwirkung, Hufschlaglinien).
+  - Detaillierte Abzugslogik für Stilspringprüfungen (Hindernisfehler, Ungehorsam, Sturz).
+  - System-Anforderungen für die UI (Erfassungsmasken) und Validierung (Lizenzprüfung).
+- **README-Update:** Verlinkung der neuen Dokumentation in der zentralen `README.md` des Masterdata-Services.
+
+## ✅ Verifizierung
+
+- Abgleich der Abzugswerte (z.B. -0,5 für Abwurf im Stilspringen) mit der ÖTO 2026.
+- Prüfung der Reihungsregeln bei Punktgleichheit (Stilnote vor Abzügen).
+- Validierung der Konsistenz mit dem bestehenden ZNS-Schnittstellen-Mapping.
+
+## 📝 Notizen
+
+- Diese Daten sind besonders für die Umsetzung von Nachwuchsbewerben und C-NEU Turnieren (lizenzfrei) von hoher
+  Bedeutung.
+- Der `Score-Service` muss im Backend die Logik zur automatischen Berechnung der Endnoten im Stilspringen bereitstellen.