--- type: Reference status: ACTIVE owner: Lead Architect & ÖTO/FEI Rulebook Expert last_update: 2026-03-24 sources: - ÖTO 2026, Abschnitt A I, § 2 & § 3 & § 4 - Domain Workshop 2026-03-17 - Session 2026-03-24 (Architektur-Diskussion) --- # Ubiquitous Language – Offizielle Domänen-Terminologie Dieses Dokument ist die **Single Source of Truth** für alle Begriffe im Projekt. Alle Begriffe sind exakt so zu verwenden – im Code, in der Dokumentation und in der Kommunikation. Bei Widersprüchen gilt: **ÖTO-Regelwerk → dieses Dokument → alle anderen Quellen**. --- ## 1. Hierarchie der Veranstaltungs-Struktur ``` Veranstalter (OEPS-Mitgliedsverein) └── Veranstaltung (interne ID, selbst vergeben) ├── Typ: Turnier | Reitertreffen | Sonderprüfung | PS&S | Turnierartig │ ├── [wenn Typ = Turnier] │ ├── Turniernummer (OEPS-vergeben, eindeutig) │ ├── Turnierkategorie (C-NEU, C, B, A, ...) │ ├── Sparte(n) (CDN, CSN, ...) │ └── Bewerb / Prüfung (Bewerbsnummer, fortlaufend) │ └── Abteilung (mindestens 1) │ ├── Teilnehmerkreis (Lizenz, Pferdealter, ...) │ └── Eigene Platzierung / Siegerehrung │ ├── [wenn Typ = Reitertreffen] │ └── Bewerbe (ohne offizielle Turniernummer) │ └── [Cup / Serie / Meisterschaft → Querverweis auf mehrere Veranstaltungen] └── eigenes Reglement (siehe Abschnitt 4) ``` --- ## 2. Kern-Begriffe (Alphabetisch) ### A | Begriff | Definition | ÖTO-Referenz | |-------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------| | **Abteilung** | **Kleinste Einheit für Nennungen, Startlisten und Ergebnisse.** Untereinheit eines Bewerbs mit eigenem Teilnehmerkreis (Lizenz, Pferdealter etc.) und eigener Platzierung/Siegerehrung. Erhält eine fortlaufende **Abteilungsnummer** (1, 2, ...) innerhalb des Bewerbs. Referenz auf Startliste/Ergebnisliste: `BW: 9 Abt: 1` bzw. `9-1`. Die ÖTO definiert sparten- und klassenabhängige Schwellenwerte, ab wievielen Startern eine Abteilung **verpflichtend** getrennt werden muss. Bei Überschreitung gibt das System eine **WARNUNG** (kein harter Fehler) – der TBA hat das letzte Wort (→ *Override-Event*). | ÖTO § 2 Abs. 7 | | **Akteur** | Oberbegriff für alle Personen (Reiter, Richter, Funktionäre, Besitzer) und Organisationen (Vereine), die im System interagieren. | – | | **Ausschreibung** | Das offizielle Dokument, das alle Bedingungen eines Turniers festlegt. Pflichtfelder gemäß ÖTO (A-Satz der ZNS-Schnittstelle). | ÖTO Ausschreibungs-Struktur | ### B | Begriff | Definition | ÖTO-Referenz | |------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------| | **Bewerb** | Synonym: „Prüfung". Die einzelne sportliche Prüfung innerhalb eines Turniers (z.B. „Prüfung Nr. 9: Standardspringprüfung 95 cm"). Erhält eine fortlaufende **Bewerbsnummer** (01, 02, ...). Ein Bewerb besteht aus **mindestens einer Abteilung**. Die → *Abteilung* ist die kleinste Einheit für Nennungen, Startlisten und Ergebnisse. | ÖTO § 2 Abs. 7 | ### C | Begriff | Definition | ÖTO-Referenz | |---------|------------------|----------------| | **Cup** | Siehe → *Serie*. | ÖTO § 2 Abs. 8 | ### F | Begriff | Definition | ÖTO-Referenz | |----------------|------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------| | **FEI-ID** | Eindeutige Identifikationsnummer der Internationalen Reiterlichen Vereinigung (FEI) für Reiter und Pferde. | FEI General Regulations | | **Funktionär** | Person mit einer definierten Rolle bei einem Turnier (Richter, Parcoursbauer, TBA, ...). Qualifikation wird gegen `RICHT01.DAT` geprüft. | ÖTO Funktionärs-Qualifikation | ### G | Begriff | Definition | ÖTO-Referenz | |-----------------------|------------------------------------------------------------------------------------------------------------------|---------------------------| | **Gastreiter** | Reiter mit ausländischer Staatsbürgerschaft, der nicht für einen österreichischen Verein startet. | ÖTO Teilnahmeberechtigung | | **Gebühren-Verzicht** | Der Veranstalter kann die Nachnenngebühr für einzelne Nennungen erlassen. Wird als explizites Event gespeichert. | ÖTO Gebührenstruktur | ### K | Begriff | Definition | ÖTO-Referenz | |-------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------| | **Kategorie** | Das Niveau eines Turniers und/oder seiner Bewerbe bzw. die Teilnahmeberechtigung daran. Nationale Kategorien: `C-NEU`, `C`, `B*`, `B`, `A`, `A*`. | ÖTO § 3 Abs. 4 | | **Klasse / Höhe** | Schwierigkeitsgrad eines Bewerbs. Springen: E0 (60–90 cm), A (105–110 cm), L, M, S. Dressur: E, A, L, M, S (nach Aufgabe). | ÖTO B-Teil | | **Kombination** | Zwei oder mehr Turniere (ggf. unterschiedlicher Sparten) die am selben Ort/Datum stattfinden. Jedes Turnier behält seine eigene Turniernummer. Genehmigung durch LFV/OEPS erforderlich. | ÖTO § 4 | | **Kopfnummer** | *National (OEPS):* 4-stellige Registrierungsnummer eines Pferdes beim OEPS. **Nicht als eindeutige ID geeignet** – kann sich ändern. Dient zur schnellen Suche/Eingabe in der Meldestelle (Autocomplete), aber nicht als Datenbankschlüssel. *Turnier:* Temporäre Startnummer für das spezifische Turnier (ebenfalls nicht persistent). | – | | **Konto** | Kontobasierte Abrechnung pro Zahler (nicht nur pro Reiter). Basis für das „Hansi-Szenario" (Guthaben bei Transfer). | Billing Context | ### L | Begriff | Definition | ÖTO-Referenz | |------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------| | **Lebensnummer** | 9-stellige (national) bzw. 15-stellige (international, UELN) Nummer, die ein Pferd bei der Geburt vom Zuchtverband erhält. Bei ausländischen Pferden im OEPS oft **generiert** → **nicht zur Suche geeignet**. Die ZNS-Daten zu Lebensnummern sind erfahrungsgemäß inkonsistent und widersprüchlich (z.B. Farbe `"Braun"` vs. `"Brauner"` für dasselbe Pferd). Primärer Schlüssel für den Datenaustausch bleibt die → *Satznummer*. | – | | **Lizenz** | Qualifikationsstufe eines Reiters (z.B. `R1`, `RD3`). Bestimmt Startberechtigung in bestimmten Klassen. | ÖTO Teilnahmeberechtigung | ### M | Begriff | Definition | ÖTO-Referenz | |-------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------| | **Meisterschaft** | Übergeordneter Wettbewerb, der Ergebnisse aus Bewerben bei **mindestens zwei Turnieren** aggregiert und zu einem Endklassement führt. Darf nur auf Turnieren der Kategorie A* und A veranstaltet werden (außer Sonderregelungen der Sparte). Besitzt ein **eigenes Reglement** (siehe Abschnitt 4). | ÖTO § 2 Abs. 8, § 3 Abs. 4 | ### N | Begriff | Definition | ÖTO-Referenz | |-----------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------| | **Nennung** | Die verbindliche Anmeldung eines Paares (Reiter & Pferd) zu einem Bewerb. | Registration Context | | **Nennschluss** | Frist, bis zu der Nennungen ohne Nachnenngebühr eingereicht werden können. | ÖTO Nennschluss | | **Nennungs-Transfer** | Tausch von Reiter und/oder Pferd innerhalb einer bestehenden Nennung. **Kein Storno + Neu**, sondern eine Transfer-Operation. Bereits bezahltes Nenngeld wird als Guthaben geführt. | Registration Context | | **Nachnenngebühr** | Zusatzgebühr für Nennungen nach dem Nennschluss. Kann vom Veranstalter erlassen werden (→ *Gebühren-Verzicht*). | ÖTO Gebührenstruktur | ### O | Begriff | Definition | ÖTO-Referenz | |--------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------| | **OEPS** | Österreichischer Pferdesportverband. Übergeordnete Organisation, vergibt Turniernummern und führt das ZNS. | – | | **Override-Event** | Explizit gespeichertes Ereignis, wenn der TBA oder die Meldestelle eine Regelwerk-Warnung bewusst überschreibt. Das System gibt **niemals** einen harten Fehler bei Regelkonflikten – immer nur eine Warnung + Override-Möglichkeit. | Domain Workshop 2026-03-17 | ### P | Begriff | Definition | ÖTO-Referenz | |------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------| | **Pferdesportliche Veranstaltung** | Oberbegriff laut ÖTO für alle Arten von Veranstaltungen: Turniere, Reitertreffen, Sonderprüfungen, PS&S, Turnierartige Veranstaltungen. In unserer Software entspricht dies dem Begriff → *Veranstaltung*. | ÖTO § 2 Abs. 1 | | **Prüfung** | Synonym für → *Bewerb*. In der ÖTO-Ausschreibung wird der Begriff „Prüfung" verwendet. | ÖTO § 2 Abs. 7 | ### R | Begriff | Definition | ÖTO-Referenz | |--------------------|------------------------------------------------------------------------------------------------------------------------------|--------------| | **Richtverfahren** | Das Bewertungsverfahren eines Bewerbs (z.B. § 204/4 Stilspringen, § 218 Einlauf). Bestimmt, wie Ergebnisse berechnet werden. | ÖTO B-Teil | ### S | Begriff | Definition | ÖTO-Referenz | |------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------| | **Satznummer** | *Pferd:* 10-stellige, rein numerische ID (`0000123456`). **Primärer Schlüssel für den Datenaustausch.** *Reiter:* 6-stellige, rein numerische ID. | ZNS-Schnittstelle | | **Serie** | Synonym für → *Cup*. Übergeordneter Wettbewerb, der Ergebnisse aus Bewerben bei **mindestens zwei Turnieren** aggregiert. Besitzt ein **eigenes Reglement** (siehe Abschnitt 4). | ÖTO § 2 Abs. 8 | | **Sparte** | Die unterschiedlichen Arten von Turnieren oder Bewerben (z.B. Dressur = CDN, Springen = CSN). | ÖTO § 2 Abs. 9, § 3 Abs. 2 | | **Sperrliste** | Vom Verband geführte Liste von Personen oder Pferden, die aktuell nicht startberechtigt sind (meist wegen offener Zahlungen). | – | | **Sportförderbeitrag** | Gebühr, die **pro Start** anfällt (nicht pro Nennung!). Relevant bei Mehrfach-Starts. | ÖTO Gebührenordnung | | **Startkarte** | Nachweis, dass die Jahresgebühr für die Lizenz bezahlt wurde. Ohne aktive Startkarte ist national kein Start möglich. | ÖTO Teilnahmeberechtigung | | **Startwunsch** | Präferenz eines Reiters bezüglich seiner Position in der Startliste (vorne/hinten). | Registration Context | ### T | Begriff | Definition | ÖTO-Referenz | |----------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------| | **TBA** | Turnierbeauftragter. Hat bei Regelkonflikten immer das letzte Wort. Jede Überschreibung wird als → *Override-Event* gespeichert. | ÖTO § 24/§ 25 | | **Tierwohl-Euro** | Gebühr, die **pro Start** anfällt (nicht pro Nennung!). | ÖTO Gebührenordnung | | **Turnier** | In unserer Software: Eine pferdesportliche Veranstaltung mit einer offiziellen **Ausschreibung** und einer vom OEPS/LFV vergebenen, eindeutigen **Turniernummer**. Entspricht ÖTO § 2 Abs. 2. Ist eine Spezialisierung von → *Veranstaltung*. | ÖTO § 2 Abs. 2, § 5, § 24 | | **Turniernummer** | Vom OEPS vergebene, eindeutige Kennung eines Turniers (z.B. `25123`). Ohne diese Nummer darf keine offizielle Ausschreibung veröffentlicht werden. | ZNS A-Satz | | **Turnierkategorie** | Siehe → *Kategorie*. | ÖTO § 3 Abs. 4 | ### V | Begriff | Definition | ÖTO-Referenz | |-------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------| | **Veranstaltung** | In unserer Software: Der Oberbegriff für jede Art von pferdesportlicher Veranstaltung, die von einem Verein durchgeführt wird. Erhält eine **intern vergebene ID**. Entspricht dem ÖTO-Oberbegriff „Pferdesportliche Veranstaltung" (§ 2 Abs. 1). Kann vom Typ Turnier, Reitertreffen, Sonderprüfung, PS&S oder Turnierartig sein. | ÖTO § 2 Abs. 1 | | **Veranstalter** | OEPS-Mitgliedsverein (über LFV angeschlossen), der eine Veranstaltung ausrichtet. Besitzt eine **Vereinsnummer**. | ÖTO § 2 Abs. 12 | ### Z | Begriff | Definition | ÖTO-Referenz | |---------|--------------------------------------------------------------------------------------------------------------------------------------------|-------------------| | **ZNS** | Zentrales Nennsystem des OEPS. Datenaustausch-Format für Stammdaten (Reiter, Pferde) und Nennungen. Quelle der Wahrheit für Akteurs-Daten. | ZNS-Schnittstelle | --- ## 3. Bounded Contexts & Zuordnung | Begriff | Primärer Bounded Context | |-------------------------------------------------------------|-------------------------------| | Veranstaltung, Turnier, Ausschreibung, Veranstalter | `event-management-context` | | Bewerb, Abteilung, Startliste, Ergebnis, Richtverfahren | `competition-context` | | Nennung, Nennungs-Transfer, Startwunsch, ZNS-Import | `registration-context` | | Reiter, Pferd, Lizenz, Funktionär, Kopfnummer, Satznummer | `actor-context` | | Nenngeld, Startgeld, Konto, Transaktion, Sportförderbeitrag | `billing-context` | | Cup, Serie, Meisterschaft, Reglement, Endklassement | `series-context` *(Phase 2+)* | | Login, Rolle, Berechtigung | `identity-context` | --- ## 4. Meisterschaften, Cups & Serien – Eigene Reglements > ⚠️ **Wichtiger Hinweis für zukünftige Entwicklungsphasen** Jede Meisterschaft, jeder Cup und jede Serie besitzt ein **eigenes, individuelles Reglement**. Dieses Reglement ist **nicht** durch die ÖTO allein abgedeckt, sondern wird vom jeweiligen Veranstalter (LFV, OEPS-Referat, Verein) separat erlassen. Ein Reglement definiert typischerweise: | Abschnitt | Inhalt | Relevanter Context | |---------------------------------------|-------------------------------------------------------------------------------------------------------------|----------------------------------------------| | **Präambel & Geltungsbereich** | Name, Träger, Verweis auf ÖTO + Sonderbestimmungen des LFV | `series-context` | | **Teilnahmeberechtigung** | Lizenzklasse, Altersklasse, Vereinsmitgliedschaft, Pferdealter, Paar-Bindung (Reiter+Pferd oder nur Reiter) | `registration-context` (Filterlogik) | | **Qualifikation & Wertungsprüfungen** | Welche Turniere/Bewerbe zählen, Pflichtteilnahme vs. Mindestanzahl | `event-management-context` | | **Punktesystem & Berechnungsmodus** | Addition der Ergebnisse, Fixpunkte nach Platzierung, Faktoren (Finale 1,5-fach), Streichresultate | `competition-context` (Ergebnis-Aggregation) | | **Ex-aequo-Regelung** | Tiebreaker-Regeln bei Punktgleichheit | `competition-context` | | **Das Finale** | Teilnahmevoraussetzung (z.B. Top 15), Startreihenfolge (umgekehrter Zwischenstand) | `competition-context` | | **Preise & Ehrungen** | Titel, Ehrengaben, Preisgeld-Verteilungsschlüssel | `billing-context` | | **Proteste & Sonderfälle** | Einspruchsfristen, Regelung bei Turnierabsagen / Höherer Gewalt | `series-context` | **Konsequenz für die Architektur:** - Der `series-context` muss das Reglement als **konfigurierbare Entität** abbilden (kein Hard-Coding). - Verschiedene Cups/Serien können **unterschiedliche Punktesysteme** haben → das Berechnungsmodell muss pluggable sein. - Die **Paar-Bindung** (Punkte an Reiter+Pferd vs. nur Reiter) ist eine kritische Designentscheidung pro Reglement. - Referenz-Dokument: [ `docs/03_Domain/02_Reference/OETO_Regelwerk/Struktur-Meisterschafts-Cup-Reglements_OETO.md`](../02_Reference/OETO_Regelwerk/Struktur-Meisterschafts-Cup-Reglements_OETO.md) --- ## 5. MVP-Scope (Phase 1) – In Scope / Out of Scope | Begriff / Feature | Phase 1 | Begründung | |----------------------------------------|-------------|----------------------------------------------------| | Turnier (Typ = Turnier) | ✅ In Scope | Kern des Systems | | Kategorie C und C-NEU | ✅ In Scope | MVP-Entscheidung | | Sparten CDN (Dressur) + CSN (Springen) | ✅ In Scope | MVP-Entscheidung | | Reitertreffen, Sonderprüfung, PS&S | 🔜 Phase 2 | Architektur lässt es zu | | Cup / Serie / Meisterschaft | 🔜 Phase 2+ | Eigenes Reglement erforderlich (siehe Abschnitt 4) | | Kombination von Turnieren (§ 4) | 🔜 Phase 2 | Datenmodell ist vorbereitet | | Kategorie A, B (Meisterschaften) | 🔜 Phase 2+ | Nur auf A*/A erlaubt | --- *Erstellt: 2026-03-24 | Autoren: Lead Architect, ÖTO/FEI Rulebook Expert, Curator* *Basiert auf: ÖTO 2026 § 2, § 3, § 4 | Domain Workshop 2026-03-17 | Session 2026-03-24*