feat(docs): document Reiter-Lizenzen and integrate into masterdata service

- Added `REITER_LIZENZEN.md` with detailed descriptions of OEPS license levels, start permissions, and special rules for Haflinger, Noriker, and Pony competitions. - Updated `masterdata/README.md` to reference the new documentation. - Logged analysis, mapping logic, and next steps in `2026-03-30_Session_Log_Masterdata_Reiter_Lizenzen.md`. Signed-off-by: Stefan Mogeritsch <stefan.mo.co@gmail.com>
2026-03-30 13:22:42 +02:00
parent 0c870ba2e3
commit 21a1598fae
3 changed files with 143 additions and 0 deletions
@@ -60,6 +60,7 @@ Sämtliche Stammdaten (insbesondere Altersklassen und Sparten) sind strikt nach
 Turnierordnung)** Regelwerk modelliert. Detaillierte Aufstellungen der verwendeten Definitionen finden sich hier:

 * [ÖTO-Stammdaten Dokumentation](docs/OETO_STAMMDATEN.md) (Fachliche Logik)
+* [Reiter-Lizenzen & Startberechtigungen](docs/REITER_LIZENZEN.md) (Lizenzstufen & Sportliche Relevanz)
 * [ZNS-Schnittstellen Spezifikation](docs/ZNS_SCHNITTSTELLE.md) (Technisches Transfer-Format)

 Änderungen am Regelwerk müssen hier zentral eingepflegt werden, damit sie
@@ -0,0 +1,87 @@
+# 📜 Reiter-Lizenzen & Startberechtigungen (OEPS)
+
+Diese Dokumentation beschreibt die verschiedenen Lizenzstufen des **OEPS (Österreichischer Pferdesportverband)** und die
+daraus resultierenden Startberechtigungen für die Sparten **Dressur (CDN)** und **Springen (CSN)** gemäß ÖTO 2026.
+
+## 1. Lizenztypen & Klassen
+
+Lizenzen werden vom OEPS pro Kalenderjahr ausgestellt. Sie bestimmen das maximale Niveau, auf dem ein Reiter in
+Prüfungen antreten darf.
+
+| Code    | Bezeichnung      | Beschreibung                                           | ZNS-Mapping  |
+|:--------|:-----------------|:-------------------------------------------------------|:-------------|
+| **LZF** | Lizenzfrei       | Nur Startkarte oder Reiterpass vorhanden.              | `LIZENZFREI` |
+| **R1**  | Reiter-Lizenz 1  | Einstiegslizenz für Springen, Dressur, Vielseitigkeit. | `R1`         |
+| **R2**  | Reiter-Lizenz 2  | Fortgeschrittene (Springen bis LM/130cm).              | `R2`         |
+| **R3**  | Reiter-Lizenz 3  | Schwere Klasse (Springen bis S/145cm).                 | `R3`         |
+| **R4**  | Reiter-Lizenz 4  | Höchste nationale Stufe (alle Klassen).                | `R4`         |
+| **RD1** | Dressur-Lizenz 1 | Speziallizenz nur für Dressur (Kl. A, L).              | `RD1`        |
+| **RD2** | Dressur-Lizenz 2 | Speziallizenz nur für Dressur (Kl. LM, M).             | `RD2`        |
+| **RD3** | Dressur-Lizenz 3 | Speziallizenz nur für Dressur (Kl. S).                 | `RD3`        |
+
+---
+
+## 2. Startberechtigungen nach Sparten
+
+### 2.1 Springen (CSN)
+
+Die Startberechtigung richtet sich nach der Hindernishöhe der jeweiligen Klasse (§ 200 B-Teil).
+
+| Klasse  | Höhe (cm) | Erforderliche Lizenz | Besonderheiten     |
+|:--------|:----------|:---------------------|:-------------------|
+| **E0**  | 60 – 95   | **LZF** (Startkarte) | Einsteiger-Bewerbe |
+| **A**   | 105 – 110 | **R1** oder höher    | -                  |
+| **L**   | 115 – 120 | **R1** oder höher    | -                  |
+| **LM**  | 125 – 130 | **R2** oder höher    | -                  |
+| **M**   | 135       | **R3** oder höher    | -                  |
+| **S***  | 140 – 145 | **R3** oder höher    | -                  |
+| **S**** | 150 – 160 | **R4**               | Grand Prix Niveau  |
+
+### 2.2 Dressur (CDN)
+
+Die Startberechtigung richtet sich nach dem Aufgabenniveau (§ 100 B-Teil).
+
+| Klasse         | Niveau              | Erforderliche Lizenz    | Besonderheiten                           |
+|:---------------|:--------------------|:------------------------|:-----------------------------------------|
+| **lizenzfrei** | -                   | **LZF** (Reiterpass)    | Inkl. First Ridden, Dressurreiterbewerbe |
+| **A**          | Leicht              | **R1 / RD1** oder höher | Grundausbildung                          |
+| **L**          | Mittelleicht        | **R1 / RD1** oder höher | -                                        |
+| **LM**         | Leicht-Mittelschwer | **R2 / RD2** oder höher | Kandare wahlweise                        |
+| **M**          | Mittelschwer        | **R2 / RD2** oder höher | Kandarenpflicht                          |
+| **S**          | Schwer              | **R3 / RD3** oder höher | St. Georg bis Grand Prix                 |
+
+---
+
+## 3. Spezial-Regelungen (§ 1500 ff.)
+
+### 3.1 Haflinger & Noriker
+
+Für Rasse-spezifische Bewerbe gelten oft abweichende (niedrigere) Lizenz-Anforderungen für höhere Klassen.
+
+* **Dressur (Haflinger):**
+  * Klasse L/LM: R(D)1 ausreichend.
+  * Klasse M: R(D)3 erforderlich.
+  * Klasse S: R(D)4 erforderlich.
+* **Springen (Haflinger):**
+  * 95-120cm (bis Klasse M): R1 ausreichend.
+  * 125-135cm (Klasse S): R2 ausreichend.
+
+### 3.2 Pony
+
+* In Pony-Bewerben (bis Kl. L) ist die **Startkarte Allgemein** (Voraussetzung Reiterpass) ausreichend.
+* Ab Klasse LM ist eine entsprechende Lizenz (R1/RD1) erforderlich.
+
+---
+
+## 4. ZNS-Integration (LIZENZ01.dat)
+
+Das System mappt die Felder aus der ZNS-Datei automatisch auf die interne `LizenzKlasseE`.
+
+* **Feld `Reiterlizenz` (Pos 137):** Enthält die Hauptlizenz (z.B. `R1`).
+* **Feld `Lizenz-Details` (Pos 201):** Enthält die Liste aller bezahlten Lizenzen (z.B. `RD1,F1`).
+  * *Logik:* Ein Reiter mit `RD2` darf Dressur LM/M reiten, aber Springen nur lizenzfrei (E0), sofern keine `R1` (oder
+    höher) vorhanden ist.
+
+---
+> 📜 **Rulebook Expert Hinweis:** Die Startberechtigung muss bei jeder Nennung gegen die aktuelle Lizenz des Reiters (
+> Stichtag Nennschluss) geprüft werden. Eine Höherreihung während eines Turniers ist gemäß § 17 Abs. 6 ausgeschlossen.
@@ -0,0 +1,55 @@
+---
+type: Journal
+status: COMPLETED
+owner: RulebookExpert
+last_update: 2026-03-30
+---
+
+# Session Log: Dokumentation der Reiter-Lizenzen & Startberechtigungen
+
+📜 **[ÖTO/FEI Rulebook Expert]** | 30. März 2026
+
+## Kontext
+
+Für die korrekte Durchführung von Turniernennungen und die Validierung der Startberechtigungen wurde eine detaillierte
+Dokumentation der OEPS-Lizenzstufen (R1-R4, RD1-RD3) und deren Einsatzbereiche in Dressur und Springen erstellt.
+
+## Erledigte Aufgaben
+
+### 1. ✅ Analyse der Lizenzstufen
+
+- Definition der Klassen R1 bis R4 (Allgemeine Reiterlizenzen).
+- Definition der Klassen RD1 bis RD3 (Spezifische Dressurlizenzen).
+- Einordnung der lizenzfreien Teilnahme (LZF) via Reiterpass/Startkarte.
+
+### 2. ✅ Erstellung der Startberechtigungs-Matrix
+
+- **Springen (CSN):** Zuordnung der Lizenzen zu den Klassen E0 bis S.
+- **Dressur (CDN):** Zuordnung der Lizenzen zu den Klassen A bis S.
+- Dokumentation der Höhenvorgaben (§ 200) und Aufgabenniveaus (§ 100).
+
+### 3. ✅ Spezial-Regelungen
+
+- Erfassung der abweichenden Anforderungen für **Haflinger, Noriker und Pony-Bewerbe** (§ 1500 ff.).
+
+### 4. ✅ Technisches Mapping
+
+- Definition des Mappings zwischen ZNS-Datei (`LIZENZ01.dat`) und der internen `LizenzKlasseE` im `core-domain` Modul.
+
+## Ergebnisse
+
+- **Neue Datei:** `backend/services/masterdata/docs/REITER_LIZENZEN.md`.
+- **Integration:** Verlinkung in der zentralen `masterdata/README.md`.
+
+## Nächste Schritte
+
+- Implementierung der Validierungs-Logik in der `Nennungsprüfung`, um die erstellten Matrizen automatisiert
+  abzugleichen.
+- Sicherstellung, dass der `zns-import` die Lizenz-Details (Feld 201) korrekt ausliest, um Mehrfach-Lizenzen abzubilden.
+
+---
+
+## Referenzen
+
+- `docs/03_Domain/02_Reference/OETO_Regelwerk/`
+- `core/core-domain/src/commonMain/kotlin/at/mocode/core/domain/model/Enums.kt`