meldestelle/docs/03_Domain/01_Glossary/Ubiquitous_Language.md

type, status, owner, last_update, sources

type	status	owner	last_update	sources
Reference	ACTIVE	Lead Architect & ÖTO/FEI Rulebook Expert	2026-03-24	Ö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). Vollständige Schwellenwert-Tabellen: → Abteilungs-Trennungs-Schwellenwerte.md	ÖTO § 2 Abs. 7, § 39
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

---

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