meldestelle/docs/03_Domain/01_Glossary/Ubiquitous_Language.md
Stefan Mogeritsch c806660685 chore: remove deprecated horses, clubs, officials, and persons services
- Deleted obsolete modules related to horses, clubs, officials, and persons services, including their configurations, build files, and database provisioning scripts.
- Cleaned up associated references in the project structure (e.g., `settings.gradle.kts`).
- Removed unused database tables and Spring beans related to these domains.

Signed-off-by: Stefan Mogeritsch <stefan.mo.co@gmail.com>
2026-03-28 16:51:08 +01:00

30 KiB
Raw Blame History

type status owner last_update sources
Reference ACTIVE Lead Architect & ÖTO/FEI Rulebook Expert 2026-03-28
Ö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 Atomare operative Einheit für 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 Historischer Begriff (siehe → Stammdaten). 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 (6090 cm), A (105110 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 generiertnicht 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). Bestimmt das anzuwendende Richtverfahren und das Regelwerk. Ö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
Stammdaten (Früher: Akteur-Context). Die zentrale Library of Truth (master-data-context) für alle statischen Informationen: Personen, Pferde, Vereine, sowie das ÖTO-Regelwerk (Richtverfahren, Paragraphen, Gebührensätze).
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:


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