---
type: Reference
status: ACTIVE
owner: Lead Architect
---
# 01 - Core Domain Entities

Dieses Dokument definiert die zentralen fachlichen Entitäten (Kern-Entitäten) des "Meldestelle"-Projekts. Diese Entitäten bilden das Fundament des Datenmodells und der gesamten Anwendungslogik.

> **Hinweis:** Dieses Modell wurde basierend auf der Analyse des OEPS-Pflichtenhefts 2021 V2.4 verfeinert.

## Die 6 Kern-Entitäten

1.  **Event**: Der organisatorische Rahmen.
2.  **Turnier**: Die administrative, regelbasierte Einheit.
3.  **Bewerb**: Die einzelne sportliche Prüfung.
4.  **Wertungsserie**: Der übergeordnete Cup oder die Meisterschaft.
5.  **Akteur**: Personen und Organisationen.
6.  **Pferd**: Die Pferde als eigenständige Entität.

---

### 1. Entität: `Veranstaltung` (Event)

**Zweck:** Der übergeordnete organisatorische Container für eine Veranstaltung an einem bestimmten Ort und zu einer bestimmten Zeit. Eine Veranstaltung kann ein oder mehrere Turniere umfassen.

**Beispiele:** "Apropos Pferd 2026", "Vereinsturnier Reitclub XY".

**Attribute:**
*   `Veranstaltung-ID` (PK): Eindeutiger technischer Schlüssel (UUID).
*   `Name`: Offizieller Name der Veranstaltung.
*   `Veranstaltungsort`: Adresse und Name der Anlage.
*   `Datum_Von`: Startdatum des Events.
*   `Datum_Bis`: Enddatum des Events.
*   `Veranstalter_ID` (FK): Verweis auf den `Akteur`, der die Veranstaltung ausrichtet.
*   `Sparten`: Liste der angebotenen Sparten.
*   `Austragungsplätze`: Liste der Austragungsplätze (`austragungsplaetze`).
*   `Artikel-Preisliste`: Liste der Zusatzartikel inkl. Preise (`artikelPreisliste`).
*   `Status`: Grober Zustand des Events (z.B. `In Planung`, `Laufend`, `Abgeschlossen`).

---

### 2. Entität: `Turnier`

**Zweck:** Definiert eine administrative Einheit innerhalb eines Events, die unter einem einheitlichen Regelwerk stattfindet. Hier werden Nennungen, Starter- und Ergebnislisten verwaltet.

**Beispiele:** "CSN-A im Rahmen der Apropos Pferd", "CSI2* im Rahmen der Apropos Pferd".

**Attribute:**
*   `Turnier-ID` (PK): Eindeutiger technischer Schlüssel (UUID).
*   `Veranstaltung_ID` (FK): Verweis auf die übergeordnete `Veranstaltung`.
*   `Turniernummer_OEPS`: 5-stellige Nummer (z.B. `21001`) für den Datenaustausch.
*   `Reglement`: Entscheidende Weiche für die Anwendungslogik (Enum: `OETO`, `FEI`).
*   `Kategorie`: Offizielle Turnierkategorie (z.B. "CSN-A", "CSI2*", "CDI-W").
*   `Sparte`: Sparte des Turniers (z.B. `Springen`, `Dressur`).
*   `Turnierbeauftragter_ID` (FK): Referenz auf den Turnierbeauftragten (TB).
*   `Ausschreibung_Text`: Der vollständige Text der Ausschreibung.
*   `Nennschluss`: Datum und Uhrzeit.
*   `NachnenngebuehrVerlangt`: Flag, ob Nachnenngebühr erhoben wird.
*   `NenntauschboerseAktiv`: Flag, ob Nenntauschbörse aktiv ist.
*   `Status`: Detaillierter Zustand des Turniers (z.B. `Genehmigt`, `Nennschluss`, `Ergebnisse final`).

---

### 3. Entität: `Bewerb`

**Zweck:** Die einzelne sportliche Prüfung innerhalb eines Turniers. Ein Bewerb ist die kleinste Einheit, für die eine Nennung möglich ist und eine Ergebnisliste erstellt wird.

**Beispiele:** "Standardspringprüfung Kl. L", "Dressurprüfung Kl. M - Aufgabe M5".

**Attribute:**
*   `Bewerb-ID` (PK): Eindeutiger technischer Schlüssel (UUID).
*   `Turnier_ID` (FK): Verweis auf das zugehörige `Turnier`.
*   `Nummer_Intern`: 2-stellige Nummer (z.B. `05`).
*   `Nummer_Offiziell`: 3-stellige Nummer (z.B. `005`) für Turniere > 99 Bewerbe.
*   `Abteilung`: Kennzeichen für Unterteilungen (z.B. `1`, `2`). Default `0`.
*   `Titel`: Der offizielle Titel des Bewerbs.
*   `Startgeld`: Das für diesen Bewerb zu entrichtende Startgeld (in EUR).
*   `Startberechtigung_Text`: Textuelle Beschreibung der Teilnahmevoraussetzungen.
*   `Besondere_Bestimmungen`: Spezielle Regeln nur für diesen Bewerb.

---

### 4. Entität: `Wertungsserie`

**Zweck:** Definiert eine übergeordnete Wertung (Cup, Meisterschaft), die Ergebnisse aus spezifischen Bewerben über mehrere Turniere hinweg sammelt und nach einem eigenen Regelwerk auswertet.

**Beispiele:** "Casino Grand Prix 2026", "OÖ Landesmeisterschaft Dressur Allgemeine Klasse".

**Attribute:**
*   `Serie-ID` (PK): Eindeutiger technischer Schlüssel (UUID).
*   `Name`: Offizieller Name der Serie.
*   `Saison`: Das Jahr, in dem die Serie stattfindet.
*   `Reglement_Text`: Die spezifischen Regeln für die Wertung (Punktesystem, etc.).
*   `Teilnahmeberechtigung_Text`: Regeln, wer an der Serie teilnehmen darf.
*   `Qualifikationsbewerbe`: Eine Liste von Verweisen auf die `Bewerb-IDs`, deren Ergebnisse für diese Serie gewertet werden.

---

### 5. Entität: `Akteur`

**Zweck:** Zentrale, widerspruchsfreie Verwaltung aller beteiligten Personen und Organisationen.

**Beispiele:** Ein Reiter, ein Pferdebesitzer, ein Züchter, ein Richter, ein Reitverein.

**Attribute:**
*   `Akteur-ID` (PK): Eindeutiger technischer Schlüssel (UUID).
*   `Typ`: `PERSON` oder `ORGANISATION`.
*   `Name`: Vollständiger Name der Person oder Organisation.
*   `Kontakt`: Adress- und Kontaktdaten.
*   `Rollen`: Liste der Rollen (z.B. `REITER`, `RICHTER`).
*   **OEPS-Daten (für Personen):**
    *   `Satznummer`: 6-stellig, numerisch (Primärschlüssel OEPS).
    *   `Lizenz`: Aktueller Lizenzcode (z.B. "R1").
    *   `Startkarte`: Boolean/Status (Jahresgebühr bezahlt?).
    *   `Verein_ID`: Verweis auf den Stammverein.
*   **Identifikatoren (Sonstige):**
    *   `FEI-ID`
    *   `Mitgliedsnummer_Zuchtverband`

---

### 6. Entität: `Pferd`

**Zweck:** Zentrale Verwaltung aller Pferde, egal ob im Sport oder in der Zucht.

**Beispiele:** Ein international erfolgreiches Sportpferd, eine Zuchtstute.

**Attribute:**
*   `Pferd-ID` (PK): Eindeutiger technischer Schlüssel (UUID).
*   `Name`: Offizieller Name des Pferdes.
*   `Abstammung_Vater_ID` (FK): Verweis auf ein anderes `Pferd` (Vater).
*   `Abstammung_Mutter_ID` (FK): Verweis auf ein anderes `Pferd` (Mutter).
*   `Besitzer_ID` (FK): Verweis auf den `Akteur`, dem das Pferd gehört.
*   **OEPS-Daten:**
    *   `Satznummer`: 10-stellig, numerisch (Primärschlüssel OEPS).
    *   `Kopfnummer`: 4-stellig, alphanumerisch (Permanente ID).
    *   `Lebensnummer`: 9-stellig (Zuchtnummer).
*   **FEI-Daten:**
    *   `FEI-ID`: Eindeutige FEI-Nummer.
    *   `FEI-Pass`: Passnummer (kann abweichen).
