meldestelle/backend/services/masterdata/docs/FUNKTIONAERE_QUALIFIKATIONEN.md
Stefan Mogeritsch e8757c5c32 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:58 +02:00

97 lines
4.3 KiB
Markdown

# 🧐 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.