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,92 @@
+# 🐴 Pferdeprüfungen & Stilspringen: Bewertungssystem (ÖTO 2026)
+
+Dieses Dokument beschreibt das spezifische Bewertungssystem für **Pferdeprüfungen** (Jungpferde) und *
+*Stilspringprüfungen**, da diese über die einfache Ergebniserfassung hinausgehen und automatisierte Berechnungslogik im
+System erfordern.
+
+---
+
+## 1. Dressurpferdeprüfungen (§ 103 & § 104 B-Teil)
+
+Dressurpferdeprüfungen dienen der Beurteilung der Ausbildung und Qualität junger Pferde. Anstelle von Einzelnoten pro
+Lektion werden qualitative Merkmale bewertet.
+
+### 1.1 Bewertungsskala (0 – 10)
+
+Es werden Noten in Zehntelschritten (z.B. 7,4) für folgende fünf Kriterien vergeben:
+
+1. **Schritt:** Takt, Fleiß und Raumgriff.
+2. **Trab:** Schwung, Elastizität und Ausdruck.
+3. **Galopp:** Durchsprung, Bergauftendenz und Balance.
+4. **Durchlässigkeit:** Rittigkeit, Gehorsam und Akzeptanz der Hilfen.
+5. **Gesamteindruck:** Perspektive des Pferdes als Dressurpferd.
+
+### 1.2 Ergebniserfassung & Berechnung
+
+* **Gemeinsames Richten (RV A):** Die Richtergruppe vergibt eine gemeinsame Note pro Kriterium. Die Endnote ist das
+  arithmetische Mittel dieser fünf Noten.
+* **Abzüge für Verreiten:**
+  *
+    1. Mal: - 0,1 Punkte vom Gesamtergebnis.
+  *
+    2. Mal: - 0,2 Punkte vom Gesamtergebnis.
+  *
+    3. Mal: Ausschluss.
+
+---
+
+## 2. Springpferdeprüfungen (§ 203 & § 204 B-Teil)
+
+Hier steht die Springmanier und Rittigkeit im Vordergrund. Das Ergebnis basiert auf einer Grundnote, von der Fehler
+abgezogen werden.
+
+### 2.1 Grundnote (0 – 10)
+
+Die Richter vergeben eine Wertnote für:
+
+* Springmanier (Beintechnik, Bascule).
+* Rittigkeit und Einhalten des korrekten Tempos.
+
+### 2.2 Abzugslogik (Punkteabzug von der Grundnote)
+
+| Fehlerart                          | Abzug (Punkte)                              |
+|:-----------------------------------|:--------------------------------------------|
+| **Hindernisfehler (Abwurf)**       | - 0,5                                       |
+| **Erster Ungehorsam (Verweigern)** | - 0,5                                       |
+| **Zweiter Ungehorsam**             | - 1,0                                       |
+| **Dritter Ungehorsam**             | Ausschluss                                  |
+| **Zeitfehler**                     | - 0,1 pro angef. Sekunde Zeitüberschreitung |
+| **Sturz (Reiter/Pferd)**           | Ausschluss                                  |
+
+### 2.3 Besonderheit: „Ohne Bewertung“ (§ 204 Abs. 4.2)
+
+* Beträgt die **Endnote 4,9 oder weniger** (nach Abzügen), wird das Pferd als **„ohne Bewertung“** (o.B.) geführt.
+* **Reihung:** Diese Teilnehmer werden in der Ergebnisliste hinter den platzierten/bewerteten Reitern, aber vor den
+  Ausgeschiedenen gereiht.
+
+---
+
+## 3. Stilspringprüfungen (§ 204 Abs. 4)
+
+Stilspringprüfungen bewerten primär den Reiter (Sitz, Einwirkung, Wegführung).
+
+### 3.1 Kriterien
+
+* Sitz und Einwirkung des Reiters.
+* Wahl des korrekten Tempos und harmonische Bewältigung der Aufgabe.
+
+### 3.2 Abzüge & Idealzeit
+
+* Die **Abzugslogik** ist identisch zu den Springpferdeprüfungen (siehe 2.2).
+* **Idealzeit (§ 204 Abs. 4.3):** Bei Punktegleichheit entscheidet die geringere Zeitdifferenz zur Idealzeit.
+* **Berechnung Idealzeit:** Erlaubte Zeit (EZ) minus 10%.
+
+---
+
+## 4. System-Anforderungen (Meldestelle)
+
+1. **Eingabemaske:** Das UI muss für diese Prüfungsarten dedizierte Felder für die Kriterien (Dressur) bzw. die
+   Grundnote und die Fehler (Springen) bieten.
+2. **Echtzeit-Berechnung:** Die Endnote muss während der Eingabe automatisch berechnet werden.
+3. **Validierung:** Warnung, wenn eine Note > 10 eingegeben wird.
+4. **Ergebnisliste:** Korrekte Kennzeichnung von „o.B.“ Ergebnissen und deren spezifische Reihung gemäß ÖTO.