From 21a1598fae5a34074b174f1ef404d17331999e98 Mon Sep 17 00:00:00 2001 From: Stefan Mogeritsch Date: Mon, 30 Mar 2026 13:22:42 +0200 Subject: [PATCH] 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 --- backend/services/masterdata/README.md | 1 + .../masterdata/docs/REITER_LIZENZEN.md | 87 +++++++++++++++++++ ..._Session_Log_Masterdata_Reiter_Lizenzen.md | 55 ++++++++++++ 3 files changed, 143 insertions(+) create mode 100644 backend/services/masterdata/docs/REITER_LIZENZEN.md create mode 100644 docs/99_Journal/2026-03-30_Session_Log_Masterdata_Reiter_Lizenzen.md diff --git a/backend/services/masterdata/README.md b/backend/services/masterdata/README.md index 2476c6b9..39001f12 100644 --- a/backend/services/masterdata/README.md +++ b/backend/services/masterdata/README.md @@ -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 diff --git a/backend/services/masterdata/docs/REITER_LIZENZEN.md b/backend/services/masterdata/docs/REITER_LIZENZEN.md new file mode 100644 index 00000000..248288cf --- /dev/null +++ b/backend/services/masterdata/docs/REITER_LIZENZEN.md @@ -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. diff --git a/docs/99_Journal/2026-03-30_Session_Log_Masterdata_Reiter_Lizenzen.md b/docs/99_Journal/2026-03-30_Session_Log_Masterdata_Reiter_Lizenzen.md new file mode 100644 index 00000000..d5c37bfc --- /dev/null +++ b/docs/99_Journal/2026-03-30_Session_Log_Masterdata_Reiter_Lizenzen.md @@ -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`