Add documentation and templates for Start-/Ergebnislisten v07: Introduce foundational templates, print styles and partials, and consolidate related session notes.

This commit is contained in:
2026-03-30 22:55:33 +02:00
parent 3f09cf7006
commit 8f5df00a98
29 changed files with 2499 additions and 0 deletions
@@ -0,0 +1,161 @@
---
type: Reference
status: DRAFT
owner: Rulebook Expert
updated: 2026-03-30
---
# Checkliste: Pflicht-/Sollangaben für Start- und Ergebnislisten (Dressur & Springen)
Quelle/Bezug:
- ÖTO Update „Genaue Definition des Feldes NATION im Ergebnisfile“, März 2011 → `OETO-2026_Meldestelle_Update-Ergebnisfile.md` (Z. 920)
- Legacy-Erweiterung Ergebnisschnittstelle (XML), 2014 → `Legacy_Specs/OETO-2026_Meldestelle_Erweiterung-Schnittstelle_2014.md` (u. a. Z. 6872, 7599)
- FEI Jumping Rules (für Richtverfahren 238/239/269/274) TODO: exakte Artikelzitate ins Repo referenzieren
Hinweis: Diese Checkliste fokussiert auf Sichtbarkeits- und Datenpflichten für Ausdrucke/Exports. Felder mit „Intern“ sind nicht zwingend auf dem Ausdruck, aber in Daten/Schnittstellen zu führen.
## 1) Gemeinsame Kopf-/Eventdaten
- Turniernummer (XXXXX) — Typ: string(5), Sichtbar: Ja
- Turniername — Typ: string, Sichtbar: Ja
- Datum(e) — Typ: date/date-range, Sichtbar: Ja
- Ort/Adresse, Bundesland, Land (ISO-3) — Typ: string, Sichtbar: Ja
- Veranstalter/OC — Typ: string, Sichtbar: Ja
- Meldestelle (Kontakt intern) — Typ: string, Sichtbar: Optional, Intern: Ja
- Reglementversion (ÖTO/FEI) — Typ: string, Sichtbar: Optional
## 2) Gemeinsame Bewerbsdaten
- Bewerb-Nr. (dreistellig) — Typ: string(3), Sichtbar: Ja (Kopf/Zeile)
- Bewerbsname — Typ: string, Sichtbar: Ja
- Sparte — Werte: Dressur|Springen, Sichtbar: Ja
- Klasse/Level — Typ: string (z. B. A,L,M,S bzw. „1.10 m“), Sichtbar: Ja
- Kategorie (Allg., Jugend, Pony, …) — Typ: string, Sichtbar: Ja
- Startzeit(en) — Typ: time, Sichtbar: Optional
- Offizielle: Richter/Jury (mit Funktion), Parcourschef, TD, Tierarzt, Hufschmied — Typ: Liste, Sichtbar: Ja (mind. Richter/Parcourschef)
## 3) Teilnehmer-/Pferdestammdaten (gemeinsam)
- Startnummer — Typ: int, Sichtbar: Ja
- Reiter: Nachname, Vorname — Typ: string, Sichtbar: Ja
- Reiter: Jahrgang/Altersklasse — Typ: year/string, Sichtbar: Optional
- Reiter: Lizenznummer + Lizenzstufe — Typ: string, Sichtbar: Optional/Ja
- Verein/Klub — Typ: string, Sichtbar: Ja
- Nation (Anzeige) — Typ: string(3), Sichtbar: Ja
- Regel: Wenn Start für AUTKlub → `NATION=AUT`, sonst Staatsbürgerschaft lt. `lizenz01.dat`
- Quelle: ÖTO-Update 2011 (Z. 1620)
- NATIONALITÄT (Staatsbürgerschaft) — Typ: string(3), Sichtbar: Optional, Intern: Ja
- Pferd: Name — Typ: string, Sichtbar: Ja
- Pferd: UELN/Registriernr. — Typ: string, Sichtbar: Optional, Intern: Ja
- Pferd: Geschlecht/Jahrgang/Rasse — Typ: string/int, Sichtbar: Optional
- Pferd: Besitzer — Typ: string, Sichtbar: Optional (Datenschutz)
- Pony-Status (A/B/C/D) — Typ: enum, Sichtbar: falls relevant
- Startstatus — Werte: gemeldet/zurückgezogen/gestrichen/OK — Sichtbar: Ja
---
# STARTLISTEN
## 4) Startlisten Pflichtfelder (alle Sparten)
- Kopf: Abschnitte 12
- Pro Startzeile:
- Startnummer
- Reiter (Name), Lizenz (optional), Verein/Klub, Nation (per Anzeige-Regel)
- Pferd (Name)
- Geplante Startzeit (falls festgelegt)
- Bemerkung (z. B. „außer Konkurrenz“ sofern zulässig)
## 5) Startlisten Dressur Zusatz
- Aufgabe/Test (z. B. FEI/ÖTO Bezeichnung) — Sichtbar: Ja
- Vierecksgröße (20×60 / 20×40) — Sichtbar: Optional
- Richterpositionen (C, M, B, E, H) — Sichtbar: Ja (Kopf)
## 6) Startlisten Springen Zusatz
- Richtverfahren/Art — Sichtbar: Ja (Kopf)
- Beispiele: FEI Art. 238.2.1/.2.2 (Table A), 274 (2Phasen), 269 (Accumulator), 239 (Table C)
- TODO: Exakte FEI-Artikel mit Wortlaut verlinken
- Parcoursdaten: Höhe/Weite, Hindernisanzahl, Baugeschw., erlaubte Zeit (TA), Zeitlimit (TL) — Sichtbar: Optional/Kopf
---
# ERGEBNISLISTEN
## 7) Ergebnislisten Pflichtfelder (gemeinsam)
- Kopf: Abschnitte 12
- Pro Start:
- Rang/Platz — Typ: int|string (mit „ex aequo“ möglich), Sichtbar: Ja
- Statuscode — Werte: CR/DNS/RET/EL/DSQ/WO … — Sichtbar: Ja
- TODO: ÖTO/FEI-Statuscodetabelle im Repo referenzieren/vereinheitlichen
- Nation (Anzeige-Regel, s. 3) — Sichtbar: Ja
- NATIONALITÄT (Staatsbürgerschaft) — Sichtbar: Optional, Intern: Ja
- Preisgeld/Punkte/Qualistatus — Sichtbar: Optional
## 8) Ergebnislisten Dressur
- Richtereinzelwerte je Position (E,H,C,M,B):
- Prozent je Richter — Typ: decimal(5,2), Dezimaltrennzeichen „,“ (Textformat lt. Legacy) — Sichtbar: Optional/Detail
- Platzziffer „PZ“ je Richter — Typ: int — Sichtbar: Optional/Detail
- Hinweis: Umbenennung EFS/HFS … sowie Attribut „Prozent“/„PZ“ (Legacy 2014)
- Endergebnis:
- Gesamtpunkte/Endprozent — Typ: decimal(5,2) — Sichtbar: Ja
- Rundung/Arithmetik — TODO: Exakte Regel je Prüfungsart (getrennt gerichtet/Kür) verlinken
- Fehler/Strafen:
- Fehler des Weges/Verstöße — Sichtbar: Optional; Status ggf. EL/DSQ/RET
- Rangbildung/Ties — TODO: Exakte Paragraphenreferenz (z. B. Richter C Priorität?)
## 9) Ergebnislisten Springen (je Richtverfahren)
Gemeinsame Felder pro Umlauf/Phase/Stechen:
- Fehler (Stangen/Wasser/Weigerung) — Typ: int — Sichtbar: Ja
- Zeit — Typ: decimal mit 12 Nachkommastellen — Sichtbar: Ja
- Strafpunkte gesamt — Typ: decimal — Sichtbar: Ja (wo anwendbar)
Spezifika:
- Table A gegen die Zeit (z. B. FEI Art. 238.2.1):
- Ausweisen: Fehler, Zeit, Strafpunkte gesamt, Endrang
- Table A mit Stechen (FEI Art. 238.2.2/.2.3):
- Grundumlauf: Fehler/Zeit; Stechen: Fehler/Zeit; Qualifikation fürs Stechen; Endrang
- ZweiPhasen (FEI Art. 274):
- Phase 1 Fehler/Zeit; Quali in Phase 2 (je Variante); Phase 2 Fehler/Zeit; Endrang
- Accumulator (FEI Art. 269):
- Punkte je Sprung, Jokerpunkte, Gesamtpunkte; Zeit als TieBreak; Rang
- Table C (FEI Art. 239):
- Zeit + Fehlerkorrektur → Endzeit; Rang
- Ties/Exaequo — TODO: Exakte FEI-Artikel/Wortlaut verlinken
---
## 10) Format-/Schnittstellenvorgaben (Legacy)
- LinkID eindeutig zwischen A-/B-/DSätzen und XML-Detailteil (2014, Z. 7599)
- Bewerbsnummer dreistellig verpflichtend bei XMLVerlinkung (2014, Z. 8392)
- Numerik als Text mit Dezimaltrennzeichen „,“; keine Tausenderpunkte (2014, Z. 6872)
---
## 11) Compliance & Datenschutz
- Öffentliche Ausgaben minimieren personenbezogene Daten (z. B. Besitzer optional)
- Nation vs. Staatsbürgerschaft strikt gemäß ÖTOUpdate 2011 führen
---
## 12) Offene Punkte / TODO
1. FEI-Artikel exakte Paragraphenzitate (Art. 238/239/269/274) im Repo verlinken und in diese Checkliste integrieren.
2. Dressur: Aggregations-/Rundungsregeln pro Prüfungsart verorten und zitieren.
3. Statuscode-Norm (DNS/RET/EL/DSQ/WO/…): Referenzdatei anlegen und hier verlinken.
4. Sichtbarkeitsmatrix „Öffentlicher Ausdruck vs. nur Datei“ final beschließen (Besitzer, UELN etc.).
## Implementierungsstand v07 (2026-03-30)
- Vorlagen/Entwürfe (Frontend):
- DruckTemplates und Partials unter `docs/06_Frontend/StartErgListen/templates/` (v07Stand):
- `Ergebnisliste_v07.html` (derzeit inhaltlich Startliste)
- `print.css`
- Partials: `partials/header.html`, `partials/footer.html`, `partials/table_head_common.html`, `partials/dressur_row.html`
- Überblick & Howto: `docs/06_Frontend/StartErgListen/README.md` und `docs/06_Frontend/StartErgListen/examples/README.md`
- Abweichungen ggü. Checkliste (bekannt, in Arbeit):
- Spaltenbeschriftung „Land“ → fachlich „Nation“ gemäß ÖTOUpdate 2011.
- Ergebnislistenspezifische Felder (Rang, Statuscodes, Variantenfelder Dressur/Springen) werden in separaten Partials ergänzt.
- TODOs aus dieser Checkliste (offen):
1. Exakte FEIArtikelzitate/Varianten für Springen: Art. 238 (2.1/2.2/2.3), 239, 269, 274 — im Repo derzeit nicht im Volltext hinterlegt. Bitte Referenzen nachpflegen.
2. Dressur: Rundungs-/Aggregationsregeln (Endprozent; getrennt gerichtet/Kür) mit Rechenbeispielen verifizieren und dokumentieren.
3. Einheitliche Statuscodetabelle (CR/DNS/RET/EL/DSQ/WO …) festlegen und in Templates/DTOs verwenden.
4. Sichtbarkeitsmatrix (Druck vs. Datei) finalisieren, insbesondere für `UELN`, Besitzer.
Hinweis: NumerikFormat (Text, DezimalKomma, keine Tausenderpunkte) und `LinkID`/dreistellige Bewerbsnummer gemäß LegacySpezifikation 2014 sind in Backend/Exporter zu erzwingen.