feat(docs): integrate ÖTO masterdata documentation and update service README

- Added detailed ÖTO-compliant masterdata documentation (`OETO_STAMMDATEN.md`) to the `masterdata` service.
- Updated the `README.md` to reference the new documentation and provide further context.
- Consolidated age group criteria, competition classes, splitting rules, and judging methods for uniform reference.

Signed-off-by: Stefan Mogeritsch <stefan.mo.co@gmail.com>
This commit is contained in:
2026-03-30 12:11:46 +02:00
parent 5c510208d2
commit 7f764915c5
3 changed files with 148 additions and 1 deletions
@@ -0,0 +1,54 @@
---
type: Journal
status: COMPLETED
owner: Curator
last_update: 2026-03-30
---
# Session Log: Konsolidierung der ÖTO-Stammdaten Dokumentation
🧹 **[Curator]** | 30. März 2026
## Kontext
Auf Anweisung des **Rulebook Experts** wurden die fachlichen Definitionen für Stammdaten (Altersklassen, Springklassen,
Dressurniveaus, Teilungsregeln und Richtverfahren) direkt in den Kontext des `masterdata` Services verschoben. Ziel ist
es, alle technischen und fachlichen Informationen zu den Stammdaten an einem Ort zu bündeln.
## Erledigte Aufgaben
### 1. ✅ Strukturierung der Service-Dokumentation
- Erstellung des Verzeichnisses `backend/services/masterdata/docs/`.
- Anlage der Datei `OETO_STAMMDATEN.md` als fachliche Referenz für Entwickler und die Validation-Engine.
### 2. ✅ Integration der Fachdaten
- Übertragung der Altersklassen-Logik (§ 12 A-Teil).
- Dokumentation der Höhenstufen (Springen) und Aufgabenniveaus (Dressur).
- Festschreibung der Abteilungs-Teilungslogik (§ 39 A-Teil) für die spätere Implementierung in der `Validation-Engine`.
- Definition der relevanten Richtverfahren (RV).
### 3. ✅ Verknüpfung mit der Service-README
- Die `README.md` im `masterdata` Service wurde aktualisiert und verweist nun direkt auf die detaillierte
ÖTO-Fachdokumentation.
## Technische Details & Architektur
- **Ablageort:** `backend/services/masterdata/docs/OETO_STAMMDATEN.md`
- **Bezug:** ÖTO 2026 (Dressur & Springen).
- **Nutzen:** Diese Dokumentation dient als Spezifikation für das Mapping im `zns-parser` und die Regeln im
`competition-context`.
## Nächste Schritte
- Implementierung der `AltersklasseRepository` Logik basierend auf den dokumentierten Formeln.
- Vorbereitung der `Validation-Engine` zur automatischen Prüfung der Teilungsgrenzen (> 30 / > 80 Starter).
---
## Referenzen
- `backend/services/masterdata/README.md`
- `docs/03_Domain/02_Reference/OETO_Regelwerk/` (Zentrale Referenz)