mocode-software/meldestelle
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
f8662e973e
meldestelle/CHANGELOG.md

16 KiB
Raw Blame History

Changelog — Meldestelle

Alle wesentlichen Änderungen an diesem Projekt werden in dieser Datei dokumentiert.

Format basiert auf Keep a Changelog. Versionierung folgt Semantic Versioning.

Versionsschema: MAJOR.MINOR.PATCH[-QUALIFIER]

  • MAJOR — Breaking Changes / inkompatible API-Änderungen
  • MINOR — Neue Features (abwärtskompatibel)
  • PATCH — Bugfixes (abwärtskompatibel)
  • QUALIFIER — SNAPSHOT (Entwicklung), beta.N (Vorversion), leer = Release

Unreleased

Geändert

  • Masterdata/Domain: Umbenennungen zur Vereinheitlichung der Terminologie (DE):
    • MasterdataLicenseRepository → LizenzRepository
    • LicenseMatrixService → LizenzMatrixService
    • LicenseMatrixServiceImpl → LizenzMatrixServiceImpl
    • Test: LicenseMatrixServiceTest → LiznezMatrixServiceTest (exakt nach Vorgabe)
    • Infrastructure (Exposed): LicenseTable → LizenzTable
  • Docs: Begriff „reit_lizenzen“ → „reiterlizenzen“ in Glossar/UL konsolidiert.

Hinzugefügt

  • Events-Service Bundle: Vollständige Stabilisierung der events Services (Domain, Infrastructure, API, Service).

    • Domain: Umstellung auf kotlin.time.Instant zur Vermeidung von Deprecation-Warnungen (Kotlin 2.1.20+) und Harmonisierung mit dem Rulebook-Expert.
    • Infrastructure: Anpassung an den org.jetbrains.exposed.v1 Namespace und Implementierung von UUID-Konvertierungen zwischen kotlin.uuid.Uuid (Domain) und java.util.UUID (DB).
    • API: Refactoring des VeranstaltungController zur direkten Repository-Nutzung (Alignment mit entries Service).
    • Service-Config: Umstellung auf Flyway-basiertes Tenant-Schema-Management in EventsDatabaseConfiguration.
    • Build: Behebung des shadowJar Fehlers in events-infrastructure durch Entfernen des unnötigen ktor Plugins in der Library-Schicht.

  • Masterdata: Automatisches Seeding aller Reiterlizenzen (license_matrix) beim Start des masterdata-service via ReiterlizenzenSeeder (idempotent; SPRINGEN: LIZENZFREI,R1–R4; DRESSUR: LIZENZFREI,RD1–RD3).

  • ZNS-Import (LIZENZ01.dat): Robuster Lizenz-Tokenizer und Normalizer implementiert.

    • Erkennung: RD1..RD4, R1..R4, S1..S4, D2..D4, Kombis R{n}D{m}, R{n}S{k}, RDS4 (rechts-/letztes Vorkommen gewinnt).
    • Normalisierung: S*→R*, D*→RD*, RD4→RD3 (bis Enum verfügbar), R{n}S{k}→Rmax(n,k), R{n}D{m}→R{n}+RD{m}.
    • Integration: ZnsReiterParser füllt lizenzen-Liste (1:n) entsprechend und leitet lizenzKlasse bei fehlendem 4‑Spalten‑Code aus Token ab.
    • QA: Neue Unit-Tests (Tokenizer) für Beispiele R2S3, R2D4, RD2 u. a.; alle Parser-Tests grün.

  • Core: Modularisierte ZNS-Parser eingeführt (ZnsVereinParser, ZnsReiterParser, ZnsPferdParser, ZnsFunktionaerParser) zur Verbesserung der Wartbarkeit und Unterstützung von Einzelimporten.

  • Fix: SQL-Migrationsfehler in V010 behoben, indem die Umbenennung der Spalte name in verein_name durch einen idempotenten DO-Block abgesichert wurde (behebt "Unable to resolve column 'name'").

  • Infrastructure: Datenbank-Migration V010 hinzugefügt, um das Schema final mit den Exposed-Modellen zu synchronisieren.

  • Infrastructure: Datei-Archivierung für hochgeladene ZNS-ZIP-Dateien im ZnsImportOrchestrator implementiert.

  • Infrastructure: ZnsImportService vollständig auf die neuen spezialisierten Parser umgestellt und als Spring-Bean im Backend registriert.

  • QA: Umfassende Test-Suite ZnsParserTest.kt mit realen ZNS-Daten (Hämmerle, Neuwirth, etc.) erstellt; Korrektur der Extraktions-Logik für Mitgliedsnummern (Position 147) und Funktionär-Daten (RICHT01).

  • QA: Neue Betriebsanleitung für ZNS-Importer Tests erstellt: docs/07_Infrastructure/runbooks/ZNS_Importer_Test_Manual.md.

  • Infrastructure: MasterdataDatabaseConfiguration korrigiert: Expliziter Aufruf von Database.connect() hinzugefügt, um Abstürze beim Anwendungsstart ("No database specified") zu beheben.

  • Infrastructure: application.yml im masterdata-service vervollständigt (DataSource-Konfiguration mit pg-user/pg-password und Flyway-Aktivierung).

  • Domain: Legacy-Spezifikationen für ZNS-Schnittstellen (Import/Export) formalisiert:

    • docs/03_Domain/02_Reference/Legacy_Specs/OETO-2026_Meldestelle_Pflichtenheft_V2.4.md (Basis-Satzarten A-N)
    • docs/03_Domain/02_Reference/Legacy_Specs/OETO-2026_Meldestelle_Erweiterung-Schnittstelle_2014.md (XML-Erweiterung, LinkID-Logik)

  • QA B-2: OnboardingValidator-Objekt extrahiert; OnboardingValidatorTest.kt (17 Unit-Tests: Pflichtfeld-Guard, Doppelklick-Schutz, Abbrechen-Reset, rememberSaveable-Regression)

  • QA B-3: AbteilungsRegelServiceTest.kt um 14 Tests erweitert: CSN-C-NEU ≤95 cm / ≥100 cm Pflicht-Teilung, ORGANISATORISCH, SEPARATE_SIEGEREHRUNG, Caprilli-Regression, Grenzfälle 90/110 cm

  • Domain: AbteilungsTeilungsTypE um ORGANISATORISCH und SEPARATE_SIEGEREHRUNG erweitert

Behoben

  • Masterdata/Infrastructure: Kompilierfehler in AltersklasseRepositoryImpl durch Vereinheitlichung der Exposed-Tabellendefinition behoben:

    • AltersklassenTable → AltersklasseTable
    • Spalte altersklassen_code → altersklasse_code
    • Tabellenname altersklassen → altersklasse

  • Masterdata/API: Fehlendes Interface-Mapping ergänzt: RegulationRepository enthält nun findAllTurnierklassen(); ExposedRegulationRepository implementiert die Methode und RegulationController kompiliert wieder.

  • ZNS-Import: AltersklassenExposedRepository korrigiert (richtiger Domain-Typ AltersklasseDefinition, Mapping von SparteE und Zeitstempeln).

  • Migration V013: Idempotent und robust gemacht. Alle ALTER TABLE ... RENAME-Operationen laufen nun nur, wenn die Quell-Tabelle existiert (Fix für "Unable to resolve table 'bundesland'/'turnierklasse'").

  • Lizenz-Validierung: LicenseMatrixServiceImpl um Cross-Discipline-Mapping R↔RD (ÖTO-Äquivalenzen) erweitert. Damit funktionieren Fälle wie Dressur-Starts mit Spring-Lizenz (R1→RD1, R2→RD2, R3/R4→RD3) bzw. umgekehrt konsistent.

  • Domain: Striktere Spartenlizenz-Prüfung in Reiter.hasLizenzForSparte implementiert (RD1..RD3 nur DRESSUR; R1..R4 nur SPRINGEN). Behebt Testfehler „isEligible verweigert Start ohne passende Spartenlizenz“ im LicenseMatrixServiceTest.

Dokumentation

  • Masterdata/Docs: REITER_LIZENZEN.md überarbeitet:
    • Strikte Sparten-Trennung dokumentiert (RD1..RD3 nur Dressur; R1..R4 nur Springen).
    • Dressur-Tabelle korrigiert (R-Lizenzen entfernen; RD-Pflicht je Klasse).
    • Validierungslogik ergänzt (2-stufig: Spartenlizenz → Max-Turnierklasse; R↔RD Mapping nur zur Kappung, nicht zur Eligibility).
    • Vielseitigkeit (CCN/CCI) ergänzt: kumulative Anforderungen (Dressur RD* UND Springen R* je Klasse); Startkartenregel für Einsteiger.
    • Fahren (CAN/CAI) ergänzt: aktueller Systemzustand ohne F*‑Lizenzen dokumentiert; Teilnahme über Startkarte/Ausschreibung, geplante Enum‑Erweiterung vermerkt.
    • §15‑Tabelle (kompakt) integriert und auf ÖTO‑Referenz verlinkt; Bedeutungen „B,C“ und „LP“ erläutert. Hinweis aufgenommen, dass RD4 derzeit nicht als Enum vorhanden ist und wie RD3 behandelt wird.
    • Kombinationsreihen gemäß §15 ergänzt: R1S2, R1S3, R1S4, R2S3, R2S4, R3S4 (neuer Unterabschnitt 2.6 mit Tabelle, identische Spalten wie 2.5).

Behoben

  • Masterdata: Qualifikations-Management für Funktionäre (Richter/Parcoursbauer) professionalisiert: Umstellung von unstrukturiertem Text auf offizielle ÖTO/FEI Master-Daten Referenzen (QualifikationMasterTable).

  • Masterdata: Fehlende Tabelle funktionaer_qualifikation in der Initialisierung beider Services (masterdata und zns-import) ergänzt, um PSQLException während des ZNS-Imports zu beheben.

  • Infrastructure: Start-Probleme des masterdata-service endgültig behoben: Port-Konflikt zwischen Spring Boot (Management/Actuator) und dem Gateway (8081) durch Umzug auf Port 8086 (gemäß Infrastruktur-Vorgaben) gelöst.

  • Infrastructure: Port-Konflikt im masterdata-service durch Trennung der Bind-Adressen (Spring: 127.0.0.1, Ktor: 0.0.0.0) und Bereinigung verwaister Prozesse stabilisiert.

  • Core: Veraltete ZnsLegacyParsersTest.kt entfernt; alle Tests sind nun in ZnsParserTest.kt konsolidiert.

  • Domain: Fehlschlagenden LicenseMatrixServiceTest behoben; fehlende reiterLizenz-Daten in Test-Reitern ergänzt und Fallback-Logik in LicenseMatrixServiceImpl für spartenübergreifende Lizenzen (z.B. Springlizenz für Dressur-Basis) stabilisiert.

  • Infrastructure: Fehlschlagenden RegulationSeedVerificationTest behoben; Testdaten an das neue Modell (reiterLizenz Feld) angepasst.

  • Infrastructure: Kompilierfehler 'Unresolved reference lizenzKlasse' in ReiterExposedRepository behoben; fehlendes Feld lizenzKlasse zu ReiterTable und Datenbank-Migration V010 hinzugefügt.

  • Onboarding: remember → rememberSaveable für geraetName, sharedKey, znsStatus in OnboardingScreen.kt ( Felder gingen bei Zurück-Navigation verloren)

  • AbteilungsRegelService: CSN-C-NEU Pflicht-Teilungslogik implementiert (≤95 cm: ohne/mit Lizenz; ≥100 cm: R1/R2+); SparteE-Import ergänzt

  • Desktop-Packaging konfiguriert: .deb (Linux), .msi (Windows), .dmg (macOS)

  • Zentrale Versionsdatei version.properties (Single Source of Truth für SemVer)

  • Automatisches Git-Tagging via CI/CD (release.yml Gitea Actions Workflow)

  • CHANGELOG.md eingeführt (dieses Dokument)

[1.0.5-SNAPSHOT] — 2026-04-06

Geändert

  • Masterdata: Bereinigung und Standardisierung von Masterdaten-Tabellen (Mehrzahl-Konvention):
    • bundesland -> bundeslaender
    • qualifikation_master -> funktionaers_qualifikationen
    • reiter_lizenz -> reit_lizenzen
    • turnierklasse -> turnier_klassen
  • Seeding: Umfassende Erweiterung der Seeder für Funktionärs-Qualifikationen, Turnierklassen und Turnier-Sparten gemäß ÖTO.
  • Data Modeling: Einführung der Tabelle turnier_sparten und Entfernung der redundanten reiter_sparte.
  • Infrastructure: Datenbank-Migration V013 implementiert alle Schema-Änderungen und Umbenennungen.

[1.0.4-SNAPSHOT] — 2026-04-06

Hinzugefügt

  • Reiter-Lizenzen: Strukturierte Speicherung von Lizenzen (STARTKARTE, REITERLIZENZ, FAHRLIZENZ) in einer 1:n Relation (ReiterLizenzTable).
  • Altersklassen: Einführung von Enums (ReiterAltersKlasseE) für präzise Filterung und Validierung im Domain-Modell und Parser.
  • Mitgliedsnummer: Validierungs-Logik gemäß ÖTO-Spezifikation (Bundesland-Präfix 1-9) in Reiter.kt implementiert.
  • ZNS-Import: ZnsReiterParser erweitert, um Lizenzen und Altersklassen-Enums direkt aus LIZENZ01.DAT zu extrahieren.
  • Persistenz: ReiterExposedRepository unterstützt nun das transaktionale Speichern und Laden der 1:n Lizenzen.

[1.0.3-SNAPSHOT] — 2026-04-06

Hinzugefügt

  • Masterdata: Refactoring der Reiter-Stammdaten (LIZENZ01.DAT). Bundesland, Verein und Nation werden nun über Master-Tabellen referenziert.
  • Domain: Validierungslogik für die 8-stellige OEPS-Mitgliedsnummer im Reiter-Modell implementiert.
  • Infrastructure: Neue Tabellen reiter_lizenz (1:n Beziehung) und Migration V012 zur Schemaanpassung und Datenbereinigung eingeführt.
  • ZNS-Import: Automatisches Auflösen von Relationen (Verein nach Name, Bundesland nach Nummer, Nation nach ISO-Code) während des Reiter-Imports.

Behoben

  • Infrastruktur: Consul Health-Check für masterdata-service korrigiert (Port 8086 für Actuator).
  • Masterdaten: MasterdataSeeder für Nationen und Bundesländer hinzugefügt, um Datenvollständigkeit nach Volume-Cleanup sicherzustellen.
  • Datenintegrität: Heilungs-Logik (fixReiterForeignKeys) implementiert, die Reiter-Datensätze nachträglich mit Masterdaten verknüpft.
  • Code-Qualität: Redundante BundeslandTable Definition in ReiterTable.kt entfernt.
  • Infrastruktur: BeanDefinitionOverrideException im zns-import-service durch Konsolidierung der Repositories in RepositoryConfiguration behoben.
  • Service-Discovery: Fehlende Consul-Registrierung des masterdata-service durch Hinzufügen der Discovery-Dependency und Konfiguration behoben.
  • Build: Kompilierfehler in BundeslandExposedRepository.kt behoben (inkonsistente Rückgabetypen im BundeslandRepository-Interface).
  • Infrastruktur: Fehlendes Autowiring im zns-import-service durch explizite Bean-Definitionen für alle Repositories in ZnsImportServiceApplication.kt behoben.
  • Domain: Kompilierfehler in Bundesland.kt behoben (uninitialisierte Eigenschaft bundeslandId entfernt).
  • Migration: SQL-Syntaxfehler in V012 behoben (korrekter Fremdschlüssel-Constraint für reiter_lizenz und Wiederherstellung des DO $$-Blocks).

[1.0.2-SNAPSHOT] — 2026-04-06

Geändert

  • ZNS-Import: ZnsImportService stabilisiert (ZipInputStream-Management korrigiert), um sequentielle Imports in Tests zu ermöglichen.
  • Test-Vollständigkeit: ZnsImportServiceTest korrigiert (Mocking für Reiter-Suche ergänzt, Testdaten für Funktionäre an Int-Parser angepasst). Alle 9 Tests nun grün.
  • Data Modeling: Redundante Kontakt- und Adressdaten aus FunktionaerTable entfernt; stattdessen Verknüpfung zu ReiterTable via reiter_id hinzugefügt. (Bereinigung der Felder erfolgte in V010).
  • Import: ZNS-Importer verknüpft nun Funktionäre automatisch mit vorhandenen Reitern anhand des Namens (Nachname, Vorname).
  • Infrastructure: findByName in ReiterRepository implementiert für effiziente Suche während des Imports.
  • Datenbank: Migration V011 hinzugefügt, um die Fremdschlüsselbeziehung zu etablieren.

[1.0.1-SNAPSHOT] — 2026-04-05

Geändert

  • Masterdata: Funktionär-Datenmodell und API bereinigt und vollständig dokumentiert. Konsistente Verwendung von satzId (statt satzID) in allen Schichten (Domain, Infrastructure, API).
  • Refactoring: DomVerein zu Verein, DomReiter zu Reiter, DomPferd zu Pferd und DomFunktionaer zu Funktionaer umbenannt (Domain, Infrastructure, API, Core).
  • Domain: personId ist nun optional (nullable) bei Verein, Reiter, Pferd und Funktionaer, um ZNS-Initialimporte zu unterstützen.
  • Infrastructure: VereinTable, ReiterTable, HorseTable und FunktionaerTable synchronisiert; personId ist nun optional.
  • API: VereinController, ReiterController, HorseController und FunktionaerController (DTOs/Requests) an die neuen Modelle angepasst.
  • Doku: Ubiquitous_Language.md und MASTER_ROADMAP.md an das neue Namensschema (Reiter, Pferd, Funktionaer) angepasst.

Behoben

  • ZNS-Import: Kompatibilitätsprobleme in ZnsLegacyParsers und ZnsImportService nach Domain-Refactorings behoben (UUID-Person-Referenzen und Enum-Synchronisation).
  • Domain: Felder kurzname und oepsRegionNummer bei Verein entfernt (nicht in VEREIN01.DAT vorhanden).

1.0.0-SNAPSHOT — 2026-04-03

Hinzugefügt

  • Sprint A: Docker-Compose-Setup, Healthchecks für alle Services
  • Sprint B: CI/CD Pipeline für Compose Desktop Tests (headless, Xvfb)
  • Sprint B: Gradle-Build-Optimierungen (Cache, Parallel, Wrapper 9.4.0)
  • Sprint B: Onboarding-Wizard (Veranstalter, Verein, Turnier, Bewerb, Abteilung)
  • Sprint B: BewerbRepository, AbteilungRepository, DefaultTurnierRepository
  • Sprint B: ReiterProfilEditDialog, PferdProfilEditDialog mit MsValidationWrapper
  • Sprint B: ÖTO-Regelwerk als Regulation-as-Data (Lizenz-/Altersmatrix, V008/V009 Migrations)
  • Sprint B: Tenant-Isolation Grundstruktur (Multi-Tenant Postgres-Schemas)
  • Sprint B: Architektur-Tests (:platform:architecture-tests)

Geändert

  • Gradle Wrapper auf 9.3.1 aktualisiert
  • JVM-Toolchain auf Java 25 angehoben