mocode-software/meldestelle
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
6e484ee9a1
meldestelle/docs/03_Domain/03_Analysis/Use_Cases_Draft.md
Stefan Mogeritsch 09b0b1a462 infra: clean up Keycloak configuration, enforce consistency in .env, and improve health checks 
Streamlined Keycloak configurations with defaults for development and production in `.env`. Added health checks and improved environment variable documentation with comments to differentiate local and server deployments. Ensured compatibility with pre-built registry images.
2026-03-06 11:23:24 +01:00

4.7 KiB
Raw Blame History

type status owner
ADR DRAFT Lead Architect

Use Cases Draft - Phase 1 (Core Domain)

  • Status: Draft
  • Fokus: High-Level Prozessflüsse und Systemgrenzen

Cluster 1: Turnier-Initialisierung & Datenbasis

UC-01: Turnier-Stammdaten importieren

  • Akteur: Meldestellen-Leiter
  • Auslöser: Vorbereitung eines neuen Turniers oder Update am Turniermorgen.
  • Vorbedingung: zns.zip (oder äquivalente OEPS-Daten) liegt vor.
  • Ablauf:
    1. System liest die Datensätze für Pferde, Reiter, Vereine und Funktionäre.
    2. System aktualisiert die lokale Datenbank (Insert/Update).
    3. System markiert Datensätze mit Sperrvermerken oder fehlenden Lizenzen.
  • Nachbedingung: Die lokale Datenbank ist die "Single Source of Truth" für Validierungen.

UC-02: Turnier-Konfiguration anlegen

  • Akteur: Meldestellen-Leiter
  • Auslöser: Erstellung eines neuen Events.
  • Vorbedingung: Ausschreibung liegt vor.
  • Ablauf:
    1. Akteur definiert Stammdaten (Ort, Datum, Veranstalter).
    2. Akteur legt Bewerbe an (Nummer, Klasse, Richtverfahren).
    3. Akteur definiert Gebühren (Nenngeld, Startgeld, Boxenpreise).
  • Nachbedingung: Das Turniergerüst steht bereit für Nennungen.

Cluster 2: Nennungs-Management (Pre-Competition)

UC-03: Nennung erfassen & validieren

  • Akteur: Meldestellen-Mitarbeiter
  • Auslöser: Import von Online-Nennungen oder manuelle Eingabe.
  • Ablauf:
    1. System prüft Existenz von Reiter und Pferd (via Satznummer).
    2. Validierung:
      • Ist die Startkarte bezahlt?
      • Ist die Lizenz ausreichend für die Klasse?
      • Liegt eine Sperre vor?
      • Ist das Pferd geimpft/registriert?
    3. Bei Validierungsfehler: System zeigt Warnung, erlaubt aber "Override" durch Akteur (z.B. "Zahlung erfolgt").
    4. System verknüpft Paar mit Bewerb.
  • Nachbedingung: Das Paar ist auf der "Nennliste" (noch nicht Starterliste).

UC-04: Pferd/Reiter tauschen

  • Akteur: Meldestellen-Mitarbeiter
  • Auslöser: Reiter fällt aus oder Pferd ist lahm.
  • Ablauf:
    1. Akteur wählt bestehende Nennung.
    2. Akteur tauscht Reiter ODER Pferd aus.
    3. System führt Validierung (UC-03) für die neue Kombination durch.
    4. System protokolliert den Tausch (relevant für T-Satz im Export).
  • Nachbedingung: Nennung ist aktualisiert, Historie ist gewahrt.

Cluster 3: Durchführung & Sport (Competition)

UC-05: Startliste erstellen

  • Akteur: Meldestellen-Leiter
  • Auslöser: Nennschluss für einen Bewerb ist erreicht.
  • Ablauf:
    1. Akteur definiert Startreihenfolge (z.B. "Alphabetisch", "Gelost", "Nach Lizenz").
    2. System generiert die Reihenfolge.
    3. System weist Kopfnummern zu (falls noch nicht geschehen).
    4. System teilt bei Bedarf in Abteilungen (siehe US-005).
  • Nachbedingung: Die Startliste ist fixiert und kann gedruckt/publiziert werden.

UC-06: Ergebnis erfassen

  • Akteur: Richter / Schreiber / Zeitnehmung
  • Auslöser: Ein Ritt ist beendet.
  • Ablauf:
    1. Akteur wählt Starter.
    2. Akteur gibt Rohdaten ein (Zeit, Fehlerpunkte, Wertnote).
    3. System berechnet sofort den Score und den vorläufigen Rang.
    4. System prüft auf Spezialfälle (Ausschluss, Aufgabe).
  • Nachbedingung: Ergebnis ist gespeichert, Live-Ranking ist aktualisiert.

UC-07: Bewerb abschließen

  • Akteur: Meldestellen-Leiter / Hauptrichter
  • Auslöser: Letzter Reiter ist fertig, Einspruchsfrist abgelaufen.
  • Ablauf:
    1. System finalisiert die Rangierung (inkl. Ex-Aequo Regeln).
    2. System berechnet Geldpreise gemäß Ausschreibung und Teilnehmerzahl.
    3. System sperrt den Bewerb für Änderungen.
  • Nachbedingung: Ergebnisse sind "amtlich", Geldpreise sind den Konten gutgeschrieben.

Cluster 4: Abschluss & Finanzen

UC-08: Konto abrechnen (Kassieren)

  • Akteur: Kassen-Mitarbeiter
  • Auslöser: Teilnehmer will abreisen/bezahlen.
  • Ablauf:
    1. System aggregiert alle Kosten (Nenngelder, Boxen, Gebühren) pro "Verantwortlicher Person".
    2. System zieht gewonnene Geldpreise ab.
    3. System erstellt Saldo.
    4. Akteur verbucht Zahlungseingang.
  • Nachbedingung: Konto ist ausgeglichen, "Horse Pass" kann ausgegeben werden.

UC-09: OEPS-Export durchführen

  • Akteur: Meldestellen-Leiter
  • Auslöser: Turnierende.
  • Ablauf:
    1. System prüft Datenintegrität (Alle Pflichtfelder für Export vorhanden?).
    2. System generiert XXXXX.ERG Datei gemäß Spezifikation V2.4.
    3. System erstellt Protokoll über eventuelle Warnungen/Abweichungen.
  • Nachbedingung: Export-Datei liegt bereit zur Übermittlung.