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,96 @@
+# 🧐 Qualifikationen: Richter & Parcoursbauer (Funktionäre)
+
+Diese Dokumentation beschreibt die Qualifikationsstufen und technischen Anforderungen für Funktionäre (Richter,
+Parcoursbauer, Stewards) basierend auf der ÖTO 2026 und dem ZNS-Pflichtenheft v2.4.
+
+---
+
+## 1. Fachliche Qualifikationsstufen
+
+Die Befugnisse der Funktionäre richten sich nach der offiziellen Richterliste des OEPS (§ 48 A-Teil).
+
+### 1.1 Richter (Sparte Dressur & Springen)
+
+Richter werden in unterschiedliche Klassen eingeteilt, die festlegen, bis zu welcher Kategorie und Klasse sie richten
+dürfen.
+
+| Kürzel  | Bezeichnung   | Befugnis (Beispiel)                         |
+|:--------|:--------------|:--------------------------------------------|
+| **D**   | Dressur       | Allgemeine Dressurbewerbe                   |
+| **S**   | Springen      | Allgemeine Springbewerbe                    |
+| **DPF** | Dressurpferde | Zusatzqualifikation für Jungpferdeprüfungen |
+| **SPF** | Springpferde  | Zusatzqualifikation für Jungpferdeprüfungen |
+| **G**   | Gelände       | Vielseitigkeit (CCN)                        |
+| **STW** | Steward       | Aufsicht am Abreiteplatz                    |
+
+### 1.2 Parcoursbauer (Sparte Springen)
+
+Die Qualifikation der Parcoursbauer wird in Level (P) angegeben (§ 1965 B-Teil).
+
+| Level  | Bezeichnung     | Einsatzbereich                                |
+|:-------|:----------------|:----------------------------------------------|
+| **P1** | Einsteiger      | Verpflichtend für CSN-C-NEU Turniere          |
+| **P2** | Fortgeschritten | Turniere der Kategorie C und B                |
+| **P3** | National        | Turniere der Kategorie B* und A               |
+| **P4** | Grand Prix      | Turniere der Kategorie A* und Meisterschaften |
+
+---
+
+## 2. Einsatzvorgaben (Regelwerk)
+
+### 2.1 Mindestbesetzung (§ 50 A-Teil)
+
+* **Standard:** Mindestens zwei Richter pro Bewerb.
+* **Ausnahme (CDN Kl. A / CSN bis 120 cm):** Ein Richter zulässig (bei Kat. B/C).
+* **CSN-C-NEU:**
+  * Mindestens zwei Richter.
+  * Mindestens ein Parcoursbauer Level **P1**.
+* **Pferdeprüfungen:** Mindestens ein Richter der Gruppe muss die Zusatzqualifikation **SPF** (Springen) oder **DPF** (
+  Dressur) besitzen.
+
+### 2.2 Zeitlimits (§ 50 Abs. 7 A-Teil)
+
+* Maximal **10 Stunden** Einsatz pro Tag.
+* Nach 4 Stunden: Mindestens **45 Minuten Pause**.
+* Bei beurteilendem Richtverfahren (Dressur): Maximal **7 Stunden** reine Richtzeit.
+
+---
+
+## 3. Technische Umsetzung (ZNS-Schnittstelle)
+
+Die Daten werden über die Datei `RICHT01.dat` (Teil der `ZNS.zip`) importiert.
+
+### 3.1 Dateistruktur (RICHT01.dat)
+
+#### Richter (X-Satz)
+
+| Feld                | Stelle | Länge | Typ   | Beschreibung                           |
+|:--------------------|:-------|:------|:------|:---------------------------------------|
+| **ID**              | 1      | 1     | Alpha | Wert "X"                               |
+| **SATZNUMMER**      | 2      | 6     | Num   | Eindeutige OEPS-ID (000000)            |
+| **NAME**            | 8      | 75    | Alpha | Familienname, Vorname                  |
+| **QUALIFIKATIONEN** | 83     | 30    | Alpha | Komma-getrennte Codes (z.B. "D,S,SPF") |
+
+#### Parcoursbauer (Y-Satz)
+
+| Feld                | Stelle | Länge | Typ   | Beschreibung                         |
+|:--------------------|:-------|:------|:------|:-------------------------------------|
+| **ID**              | 1      | 1     | Alpha | Wert "Y"                             |
+| **SATZNUMMER**      | 2      | 6     | Num   | Eindeutige OEPS-ID (000000)          |
+| **NAME**            | 8      | 75    | Alpha | Familienname, Vorname                |
+| **QUALIFIKATIONEN** | 83     | 30    | Alpha | Komma-getrennte Codes (z.B. "P1,P2") |
+
+---
+
+## 4. Validierungs-Logik im System
+
+Der `masterdata` Service muss beim Import und bei der Turnierplanung folgende Prüfungen ermöglichen:
+
+1. **Existenzprüfung:** Ist die Satznummer in der aktuellen ZNS-Liste vorhanden?
+2. **Qualifikations-Check:** Verfügt der Richter über die für den Bewerb erforderliche Kennung (z.B. SPF für
+   Springpferdeprüfungen)?
+3. **Level-Check:** Erfüllt der Parcoursbauer das Mindestlevel (P1) für C-NEU Turniere?
+
+---
+> 📜 **Rulebook Expert Hinweis:** Die Qualifikations-Codes in `RICHT01.dat` sind der Primärschlüssel für die
+> automatisierte Prüfung der Richtereinteilung in der Ausschreibung.