Umfassender Bericht: Strategie, Architektur & Roadmap für Meldestelle_Pro
Datum: 26. Juli 2025
Autoren: Stefan-Mo (Fachlicher Experte), Programmier-Meister (Technischer Experte)
Status: Finalisiert & zur Umsetzung freigegeben

1. Einleitung & Vision
Dieses Dokument ist das Ergebnis einer intensiven Zusammenarbeit, um die Anforderungen an eine moderne Meldestellen-Software zu analysieren und in eine zukunftssichere, technische Strategie zu überführen. Es dient als zentrale Blaupause für die Entwicklung des Projekts "Meldestelle_Pro".

Die Vision: Meldestelle_Pro wird die führende digitale Plattform für die Verwaltung und Durchführung von Pferdesport-Veranstaltungen in Österreich. Das System wird nicht nur die komplexen Regularien der ÖTO und FEI korrekt abbilden, sondern durch intelligente, integrierte Werkzeuge die Arbeit für Veranstalter, Funktionäre und Teilnehmer revolutionieren.

Die Grundlage dafür ist eine moderne Software-Architektur, die auf folgenden, in den initialen Architecture Decision Records (ADRs) festgehaltenen, Prinzipien beruht:

Modulare Microservice-Architektur: Zerlegung des Systems in unabhängige, wartbare Dienste [cite: 0003-microservices-architecture-de.md].

Domain-Driven Design (DDD): Die Fachlichkeit und die Sprache der Experten stehen im Zentrum des Entwurfs [cite: 0002-domain-driven-design-de.md].

Ereignisgesteuerte Kommunikation: Lose Kopplung und hohe Resilienz durch asynchrone Events via Apache Kafka [cite: 0004-event-driven-communication-de.md].

Multiplattform-Client-Strategie: Eine gemeinsame Code-Basis für Web- und Desktop-Anwendungen zur Maximierung der Effizienz und Konsistenz [cite: 0008-multiplatform-client-applications-de.md].

2. Das finale DDD-Zieldomänen-Modell
Unsere Analyse hat zu einer Verfeinerung des ursprünglichen Modells geführt. Das System wird in die folgenden, klar abgegrenzten Bounded Contexts (Domänen) gegliedert, die jeweils als eigenständiger Microservice implementiert werden.

2.1 Fundamentale Domänen (Daten & Regeln)
BC1: OeTO-Verwaltung (Masterdata-Service): Die "Quelle der Wahrheit". Verwaltet alle globalen Regelwerke, Lizenztypen, Turnierkategorien und sportfachlichen Definitionen gemäß ÖTO und FEI.

BC2: ZNS-Import (ACL): Der "Übersetzer". Ein Anti-Corruption Layer, der die OEPS .dat-Dateien einliest und in saubere, systeminterne Domänen-Events transformiert.

BC3: Sportler, Pferde & Vereine (z.B. members- & horses-service): Verwalten die Stammdaten aller Akteure und bilden die Basis für Benutzerkonten und Turnier-Assets.

BC4: Lizenzen & Qualifikationen (licensing-service): Verwaltet die spezifischen sportlichen Berechtigungen einer Person.

BC5: Veranstaltungsplanung (events-service): Modelliert die hierarchische Struktur von Veranstaltungen (Dach-Veranstaltung -> Turnier-Mandat -> Bewerb).

2.2 Prozessorientierte Domänen (Workflows & Logik)
BC6: Mandanten- & Lizenz-Verwaltung (tenancy-service): Steuert das Geschäftsmodell. Verwaltet Kunden (Mandanten), Produkte ("Web" vs. "Pro") und deren Software-Lizenzen.

BC7: Nennungsabwicklung (nennungs-service): Das operative Herzstück. Orchestriert den gesamten Nennprozess, führt die komplexe Zulassungsprüfung durch und erstellt die Startlisten.

BC8: Abrechnung & Finanzen (billing-service): Die zentrale Kasse. Garantiert eine strikt getrennte Kassenführung pro Turnier-Mandat und verwaltet alle Gebühren, Nenngelder und Preisgelder.

BC9: Ergebnisdienst (result-service): Erfasst, berechnet und persistiert die finalen Ergebnisse und ist für den korrekten Export im OEPS-Format zuständig.

BC10: Serien-Verwaltung (championship-service): Verwaltet übergeordnete Cups und Meisterschaften, die sich über mehrere, unabhängige Turniere erstrecken.

3. Strategische Entwicklungs-Roadmap
Wir verfolgen einen agilen, iterativen Ansatz, um schnellstmöglich ein nutzbares Produkt zu schaffen und aus der Praxis zu lernen.

Zyklus 1: MVP für C/C-Neu Turniere (Dressur & Springen)
Ziel: Ein voll funktionsfähiges End-to-End-System für den am weitesten verbreiteten Turniertyp.

Umfang: Implementierung aller Domänen in einer "abgespeckten" Version, die sich auf die Anforderungen von C-Turnieren konzentriert. Dies beinhaltet die manuelle Ergebniserfassung, die grundlegende Nennungs-Validierung und den finalen Ergebnis-Export.

Ergebnis: Ein produktiv nutzbares System für "Feld-Versuche", um wertvolles Feedback zu sammeln.

Zyklus 2: Erweiterung für B/A-Turniere & Professionalisierung
Ziel: Abbildung der komplexeren Regeln höherer Turnierkategorien und Automatisierung.

Umfang: Erweiterung der Masterdata-Domäne um M/S-Regeln. Implementierung des "getrennten Richtens" (Dressur), Anbindung von Zeitmess-Hardware (Springen) und korrekte Preisgeldberechnung. Entwicklung des "Live-Turnier-Cockpits".

Zyklus 3 & darüber hinaus: Ökosystem & Wachstum
Ziel: Das System um strategische Module zur Kundenbindung und -gewinnung erweitern.

Umfang: Implementierung der Serien-Verwaltung für Cups/Meisterschaften. Entwicklung des Parcours-Design-Moduls als "Freemium"-Standalone-Tool, um Parcours-Bauer als Multiplikatoren zu gewinnen.

4. Geplante Optimierungen & nächste Schritte (TODO)
Über die reine Feature-Entwicklung hinaus planen wir folgende Professionalisierungs-Maßnahmen:

Daten-Synchronisation: Entwicklung einer Strategie zur Aktualisierung der Stammdaten bei neuen zns.zip-Lieferungen.

Benutzerverwaltung: Implementierung eines Self-Service-Portals für Veranstalter (Vereine), um ihre eigenen Benutzer zu verwalten.

Funktionärs-Management: Erweiterung des Systems um Funktionen zur Planung und Verwaltung von Funktionärs-Einsätzen.

Reporting & Analysen: Schaffung einer Reporting-Komponente, die Veranstaltern wertvolle Einblicke und finanzielle Abrechnungen liefert.

Betrieb & Performance: Einführung von Contract Testing, Resilience Patterns und proaktiver Performance-Optimierung. Langfristige Migration des Deployments auf Kubernetes.

5. Schlussfolgerung
Das Projekt "Meldestelle_Pro" verfügt nun über eine umfassende, detaillierte und fachlich fundierte Blaupause. Die Kombination aus einer modernen, entkoppelten Microservice-Architektur und einer agilen, praxisorientierten Roadmap stellt sicher, dass wir ein System entwickeln, das nicht nur die heutigen Anforderungen des österreichischen Turniersports erfüllt, sondern auch flexibel genug ist, um zukünftige Herausforderungen und Chancen zu meistern.

Der Plan ist vollständig. Die nächste Phase ist die Umsetzung.
