Fix: Test-Commit für VCS-Integration (MP-8) (#15)

* MP-8 OTHER Implementiere JWT-Authentifizierungs-Filter im Gateway

* Fix(ci): Update upload-artifact action to v4

* Fix(ci): Add start command for Keycloak and failure logs

* Fix(ci): Remove invalid 'command' property from Keycloak service

* Fix(ci): Use KC_DEV_MODE env var to start Keycloak

* Fix(ci): Keycloak service was removed from GitHub Actions services and replaced with a manual docker run step that starts Keycloak with the start-dev command.

* dev(ci): vereinheitliche Keycloak auf 26.4.2; aktiviere Health im CI (MP-8)

* Fix(ci): Stabilize Keycloak startup in integration tests via matrix

- Add `dev-file` Keycloak variant to matrix for stability fallback.
- Improve wait logic and health checks for Keycloak and Postgres.
- Unify Keycloak version to 26.4.2 across codebase.
- Add log dumps on failure.

* Fix(ci): Die betroffene Datei docs/Visionen-Ideen/Infrastruktur-Strategie_DSGVO-Konformität.md endet aktuell mit genau einer leeren Zeile (Zeile 87). Das entspricht der Regel MD047 („Files should end with a single newline character“). Damit ist deine Korrektur korrekt.

* Fix(ci): Repository-wide auto-fix for Markdown files was implemented with a GitHub Actions workflow and a local helper script. EditorConfig and markdownlint ignore files were added to ensure consistent formatting. Instructions for using the auto-fix both via GitHub Actions and locally were provided.

* fix(gradle): build.gradle.kts jsBrowser testTask disabled

* fix(gradle): build.gradle.kts jsBrowser testTask disabled

* Fix(ci): Stabilize integration tests with Keycloak matrix build (MP-8)

Introduces a matrix strategy (`keycloak_db: [postgres, dev-file]`)
in the integration-tests workflow to mitigate flaky Keycloak starts
when using the Postgres service container.

- Adds a `dev-file` Keycloak variant for stability fallback.
- Improves wait logic and health checks for Keycloak/Postgres.
- Unifies Keycloak version to 26.4.2 across codebase (Dockerfile, Compose,
  ADR, README, tests).
- Adds log dumps on failure in CI.
- Ensures `KC_HEALTH_ENABLED=true` is set.
- Updates related documentation (README, Schlachtplan).
- Includes broader Docker SSoT cleanup (versions.toml as source,
  script updates, env file cleanup, validator hardening).

This resolves recurring CI failures related to Keycloak startup and
ensures required checks for PRs (#15) are reliable, while also
improving overall Docker build consistency.

* feat(docs, ci): Implement YouTrack SSoT strategy with Dokka sync (MP-8)

- Add Dokka multi-module Gradle configuration and KDoc style guide.
- Add GitHub Actions workflow (docs-kdoc-sync.yml) and Python script
  (youtrack-sync-kb.py) to sync Dokka GFM output to YouTrack KB.
- Extend front-matter schema (bc, doc_type) and update relevant pages/stubs.
- Adapt CI scripts (validate-frontmatter, check-docs-drift, ci-docs link ignore).
- Update README.md to reference YouTrack KB.

* feat(docs, ci): Implement YouTrack SSoT strategy with Dokka sync (MP-8)

- Add Dokka multi-module Gradle configuration and KDoc style guide.
- Add GitHub Actions workflow (docs-kdoc-sync.yml) and Python script
  (youtrack-sync-kb.py) to sync Dokka GFM output to YouTrack KB.
- Extend front-matter schema (bc, doc_type) and update relevant pages/stubs.
- Adapt CI scripts (validate-frontmatter, check-docs-drift, ci-docs link ignore).
- Update README.md to reference YouTrack KB.

* Fix(ci): Replace OpenAPI validator with Spectral

Replaces the deprecated 'char0n/swagger-editor-validate' action,
which failed due to sandbox issues in GitHub Actions, with the
modern '@stoplight/spectral-cli'.

This ensures robust OpenAPI specification validation without
requiring a headless browser environment. The 'generate-api-docs'
job now depends on the successful completion of the Spectral validation.

Part of resolving CI failures for PR #15 (MP-8).

* Fix(ci): Specify spectral:oas ruleset for OpenAPI validation (MP-8)

* Fix(ci): Remove explicit ruleset argument for Spectral validation (MP-8)

* Fix(ci): Added a .spectral.yaml file to fix Spectral linting errors. Corrected markdown lint issues in two documentation files. Updated README.md with a new guidelines section to fix link validation errors.

* Fix(ci): Markdownlint errors were fixed by adding required blank lines. The Guidelines Validation error was resolved by updating the README.md link. The API Documentation Generator workflow was stabilized by updating paths, tasks, and validation steps.

* Fix(ci): Alle vier fehlerhaften GitHub-Action-Prüfungen wurden behoben. Fehler in der OpenAPI-Spezifikation, Probleme mit der Markdown-Linting-Analyse und Validierungsfehler bei Querverweisen wurden korrigiert. Die README.md enthält nun alle erforderlichen Links zu den Richtlinien.

* Fix(ci): Markdown linting errors in docs/api/README.md were fixed by specifying languages in fenced code blocks. OpenAPI specification errors in documentation.yaml were resolved by correcting example property types to strings. Cross-reference validation errors in README.md were fixed by adding the missing link to project-standards/coding-standards.md.

* Fix(ci): Duplicate heading errors in docs/api/members-api.md were fixed. Cross-reference validation errors for docker-architecture.md were resolved. All originally reported issues passed validation successfully.

* Fix(ci): The markdown heading levels in docs/api/members-api.md were corrected from h5 to h4 to fix linting errors. The missing cross-reference link from technology-guides/docker/docker-development.md to docker-overview.md was added. These fixes resolved the original validation and linting errors causing the process to fail.

* Fix(ci): Duplicate heading warnings in docs/api/members-api.md were resolved. Cross-reference validation for docker-development.md to docker-architecture.md was fixed. A new unrelated warning about docker-production.md was identified but not addressed.

* refactor(ci,docs): Simplify CI pipeline and migrate docs to YouTrack SSoT

BREAKING CHANGE: Documentation structure radically simplified

- Consolidate 9 GitHub Actions workflows into 1 main pipeline (ci-main.yml)
- Remove redundant workflows: ci-docs, markdownlint-autofix, guidelines-validation, api-docs
- Delete documentation migrated to YouTrack: api/, BCs/, Visionen-Ideen/, reference/, now/, overview/
- Keep only ADRs, C4 diagrams, and essential dev guides in repo
- Update README.md with YouTrack KB links
- Create new docs/README.md as documentation gateway
- Relax markdown-lint config for pragmatic developer experience

Kept workflows:
- ssot-guard.yml (Docker SSoT validation)
- docs-kdoc-sync.yml (KDoc → YouTrack sync)
- integration-tests.yml (Integration tests)
- deploy-proxmox.yml (Deployment)
- youtrack-sync.yml (YouTrack integration)

Related: MP-DOCS-001

* refactor(ci,docs): Simplify CI pipeline and migrate docs to YouTrack SSoT

BREAKING CHANGE: Documentation structure radically simplified

- Consolidate 9 GitHub Actions workflows into 1 main pipeline (ci-main.yml)
- Remove redundant workflows: ci-docs, markdownlint-autofix, guidelines-validation, api-docs
- Delete documentation migrated to YouTrack: api/, BCs/, Visionen-Ideen/, reference/, now/, overview/
- Keep only ADRs, C4 diagrams, and essential dev guides in repo
- Update README.md with YouTrack KB links
- Create new docs/README.md as documentation gateway
- Relax markdown-lint config for pragmatic developer experience

Kept workflows:
- ssot-guard.yml (Docker SSoT validation)
- docs-kdoc-sync.yml (KDoc → YouTrack sync)
- integration-tests.yml (Integration tests)
- deploy-proxmox.yml (Deployment)
- youtrack-sync.yml (YouTrack integration)

Related: MP-DOCS-001

* refactor(ci,docs): README.md und einige andere Dokumentationen überarbeitet.
ports-and-urls.md hinzugefügt.
Related: MP-DOCS-001

* refactor(ci,docs): Die Markdownlint-Fehler in README.md und docs/README.md wurden behoben, indem die Überschriftenebenen angepasst, überflüssige Satzzeichen am Ende entfernt und die notwendigen Leerzeilen um Überschriften, Listen, Tabellen und Codeblöcke eingefügt wurden. Das problematische Leerzeichen am Ende in docs/README.md wurde ebenfalls entfernt. Die Dateien entsprechen nun den vorgegebenen Markdownlint-Regeln und sollten die CI-Validierung bestehen.
Related: MP-DOCS-001

* refactor(ci,docs): Docker guideline cross-references were fixed and normalized to lowercase labels. Validation scripts confirmed zero cross-reference warnings and consistent metadata. Documentation was updated with a changelog and enhanced README navigation.
Related: MP-DOCS-001

* refactor(ci,docs): Docker guideline cross-references were fixed and normalized to lowercase labels. Validation scripts confirmed zero cross-reference warnings and consistent metadata. Documentation was updated with a changelog and enhanced README navigation.
Related: MP-DOCS-001

* refactor(ci,docs): Dead links in docs/architecture/adr were fixed by updating URLs to stable sources and adding an ignore pattern for a placeholder link. Specific ADR files had their broken links replaced with valid ones. The markdown-link-check GitHub Action is expected to pass with zero dead links now.
Related: MP-DOCS-001

* refactor(ci,docs): Links in ADR checked
Related: MP-DOCS-001

* refactor(ci,docs): Links in ADR checked
Related: MP-DOCS-001

* refactor(ci,docs): Markdown Regeln ausgebessert
Related: MP-DOCS-001

* refactor(ci,docs): Markdown Regeln ausgebessert
Related: MP-DOCS-001

* refactor(ci,docs): Markdown Regeln ausgebessert
Related: MP-DOCS-001

* Chore: Rerun CI checks with updated branch protection rules

services/events/README-EVENTS.md

@@ -9,6 +9,7 @@ Das Events-Modul ist eine umfassende Lösung zur Verwaltung von Pferdesportveran
 ### Verwaltete Entität
 
 #### Veranstaltung (Event)
+
 - **Grundinformationen**: Name, Beschreibung
 - **Terminverwaltung**: Startdatum, Enddatum, Anmeldeschluss
 - **Ort und Organisation**: Veranstaltungsort, Veranstalter-Verein-ID
@@ -21,21 +22,25 @@ Das Events-Modul ist eine umfassende Lösung zur Verwaltung von Pferdesportveran
 Das Modul bietet 10+ spezialisierte Repository-Operationen:
 
 #### Basis-CRUD-Operationen
+
 - `findById(id)` - Veranstaltung nach UUID suchen
 - `save(veranstaltung)` - Veranstaltung speichern (erstellen/aktualisieren)
 - `delete(id)` - Veranstaltung löschen
 
 #### Such-Operationen
+
 - `findByName(searchTerm, limit)` - Nach Namen suchen (Teilübereinstimmung)
 - `findByVeranstalterVereinId(vereinId, activeOnly)` - Veranstaltungen eines Vereins
 - `findAllActive(limit, offset)` - Alle aktiven Veranstaltungen
 - `findPublicEvents(activeOnly)` - Öffentliche Veranstaltungen
 
 #### Datumsbasierte Abfragen
+
 - `findByDateRange(startDate, endDate, activeOnly)` - Veranstaltungen in Datumsbereich
 - `findByStartDate(date, activeOnly)` - Veranstaltungen nach Startdatum
 
 #### Zähl-Operationen
+
 - `countActive()` - Anzahl aktiver Veranstaltungen
 - `countByVeranstalterVereinId(vereinId, activeOnly)` - Anzahl Veranstaltungen pro Verein
 
@@ -69,27 +74,32 @@ events/
 ```
 
 ### Domain Layer
+
 - **1 Domain Model** mit reichhaltiger Geschäftslogik
 - **1 Repository Interface** mit 10+ Geschäftsoperationen
 - **Domain Service** für komplexe Veranstaltungslogik
 - **Keine Abhängigkeiten** zu anderen Layern
 
 ### Application Layer
+
 - **Use Cases** für CRUD-Operationen
 - **Orchestrierung** von Domain-Services
 - **Anwendungslogik** ohne UI-Abhängigkeiten
 
 ### Infrastructure Layer
+
 - **Datenbankzugriff** mit Exposed ORM
 - **Repository-Implementierung** mit PostgreSQL
 - **Datenbankschema** und Migrationen
 
 ### API Layer
+
 - **REST-Controller** für HTTP-Endpunkte
 - **DTO-Mapping** zwischen Domain und API
 - **Validierung** und Fehlerbehandlung
 
 ### Service Layer
+
 - **Spring Boot Anwendung**
 - **Dependency Injection** Konfiguration
 - **Service-Konfiguration**
@@ -138,6 +148,7 @@ data class Veranstaltung(
 ### Enumerationen
 
 #### SparteE (Sportsparten)
+
 - `DRESSUR` - Dressurreiten
 - `SPRINGEN` - Springreiten
 - `VIELSEITIGKEIT` - Vielseitigkeitsreiten
@@ -257,6 +268,7 @@ Das Events-Modul stellt REST-Endpunkte über den VeranstaltungController bereit:
 ### Datenbankschema
 
 Das Modul verwendet eine `events`-Tabelle mit folgenden Spalten:
+
 - `veranstaltung_id` (UUID, Primary Key)
 - `name` (Required)
 - `beschreibung` (Text, Optional)
@@ -416,11 +428,13 @@ spec:
 ### Externe Systeme
 
 #### OEPS-Integration
+
 - Synchronisation mit OEPS-Veranstaltungskalender
 - Automatische Meldung bei OEPS-relevanten Veranstaltungen
 - Import von OEPS-Veranstaltungsdaten
 
 #### FEI-Integration
+
 - Unterstützung für internationale Veranstaltungen
 - FEI-Regularien und -Standards
 - Automatische Klassifizierung
@@ -428,11 +442,13 @@ spec:
 ### Interne Module
 
 #### Members-Modul
+
 - Teilnehmerverwaltung
 - Anmeldestatus-Tracking
 - Mitgliedschaftsvalidierung
 
 #### Horses-Modul
+
 - Pferdeanmeldungen
 - Eignung für Sparten
 - Registrierungsstatus

services/horses/README-HORSES.md

@@ -9,6 +9,7 @@ Das Horses-Modul ist eine umfassende Lösung zur Verwaltung von Pferden für Pfe
 ### Verwaltete Entität
 
 #### Pferd (DomPferd)
+
 - **Grundinformationen**: Name, Geschlecht, Geburtsdatum, Rasse, Farbe
 - **Besitz und Verantwortung**: Besitzer-ID, verantwortliche Person
 - **Zuchtinformationen**: Züchtername, Zuchtbuchnummer
@@ -23,11 +24,13 @@ Das Horses-Modul ist eine umfassende Lösung zur Verwaltung von Pferden für Pfe
 Das Modul bietet 25+ spezialisierte Repository-Operationen:
 
 #### Basis-CRUD-Operationen
+
 - `findById(id)` - Pferd nach UUID suchen
 - `save(horse)` - Pferd speichern (erstellen/aktualisieren)
 - `delete(id)` - Pferd löschen
 
 #### Such-Operationen nach Identifikationsnummern
+
 - `findByLebensnummer(lebensnummer)` - Nach Lebensnummer suchen
 - `findByChipNummer(chipNummer)` - Nach Chipnummer suchen
 - `findByPassNummer(passNummer)` - Nach Passnummer suchen
@@ -35,6 +38,7 @@ Das Modul bietet 25+ spezialisierte Repository-Operationen:
 - `findByFeiNummer(feiNummer)` - Nach FEI-Nummer suchen
 
 #### Such-Operationen nach Eigenschaften
+
 - `findByName(searchTerm, limit)` - Nach Namen suchen (Teilübereinstimmung)
 - `findByOwnerId(ownerId, activeOnly)` - Pferde eines Besitzers
 - `findByResponsiblePersonId(personId, activeOnly)` - Pferde einer verantwortlichen Person
@@ -42,15 +46,18 @@ Das Modul bietet 25+ spezialisierte Repository-Operationen:
 - `findByRasse(rasse, activeOnly, limit)` - Nach Rasse filtern
 
 #### Datumsbasierte Abfragen
+
 - `findByBirthYear(birthYear, activeOnly)` - Pferde nach Geburtsjahr
 - `findByBirthYearRange(fromYear, toYear, activeOnly)` - Pferde nach Geburtsjahr-Bereich
 
 #### Registrierungs-Abfragen
+
 - `findAllActive(limit)` - Alle aktiven Pferde
 - `findOepsRegistered(activeOnly)` - OEPS-registrierte Pferde
 - `findFeiRegistered(activeOnly)` - FEI-registrierte Pferde
 
 #### Validierungs-Operationen
+
 - `existsByLebensnummer(lebensnummer)` - Prüfung auf doppelte Lebensnummer
 - `existsByChipNummer(chipNummer)` - Prüfung auf doppelte Chipnummer
 - `existsByPassNummer(passNummer)` - Prüfung auf doppelte Passnummer
@@ -58,6 +65,7 @@ Das Modul bietet 25+ spezialisierte Repository-Operationen:
 - `existsByFeiNummer(feiNummer)` - Prüfung auf doppelte FEI-Nummer
 
 #### Zähl-Operationen
+
 - `countActive()` - Anzahl aktiver Pferde
 - `countByOwnerId(ownerId, activeOnly)` - Anzahl Pferde pro Besitzer
 - `countOepsRegistered(activeOnly)` - Anzahl OEPS-registrierter Pferde ✨ **NEU**
@@ -94,22 +102,26 @@ horses/
 ```
 
 ### Domain Layer
+
 - **1 Domain Model** mit reichhaltiger Geschäftslogik
 - **1 Repository Interface** mit 25+ Geschäftsoperationen
 - **Geschäftsregeln** für Pferderegistrierung und -validierung
 - **Keine Abhängigkeiten** zu anderen Layern
 
 ### Application Layer
+
 - **Use Cases** für CRUD-Operationen
 - **Orchestrierung** von Domain-Services
 - **Anwendungslogik** ohne UI-Abhängigkeiten
 
 ### Infrastructure Layer
+
 - **Datenbankzugriff** mit Exposed ORM
 - **Repository-Implementierung** mit PostgreSQL
 - **Datenbankschema** und Migrationen
 
 ### API Layer
+
 - **REST-Controller** für HTTP-Endpunkte
 
 ## 🚀 Aktuelle Optimierungen (2025-07-25)
@@ -119,12 +131,15 @@ Das Horses-Modul wurde kürzlich analysiert, vervollständigt und optimiert. Fol
 ### ✨ Neue Funktionalitäten
 
 #### Erweiterte Such-Endpunkte
+
 Neue REST-Endpunkte für vollständige Identifikationsnummer-Suche:
+
 - `GET /api/horses/search/passport/{nummer}` - Suche nach Passnummer
 - `GET /api/horses/search/oeps/{nummer}` - Suche nach OEPS-Nummer
 - `GET /api/horses/search/fei/{nummer}` - Suche nach FEI-Nummer
 
 #### Optimierte Statistik-Operationen
+
 - Neue effiziente Zähl-Methoden für OEPS und FEI registrierte Pferde
 - Performance-Verbesserung von O(n) auf O(1) Komplexität für Statistiken
 - Datenbankoptimierte COUNT-Abfragen statt Laden aller Datensätze
@@ -132,11 +147,13 @@ Neue REST-Endpunkte für vollständige Identifikationsnummer-Suche:
 ### ⚡ Performance-Optimierungen
 
 #### Datenbankeffizienz
+
 - **Vorher**: Statistik-Endpunkt lud alle Pferde und verwendete `.size`
 - **Nachher**: Effiziente COUNT-Abfragen direkt in der Datenbank
 - **Auswirkung**: Drastische Reduzierung der Speichernutzung und Antwortzeiten
 
 #### Architektur-Konsistenz
+
 - Alle API-Endpunkte verwenden jetzt konsistent die Use-Case-Schicht
 - Eliminierung direkter Repository-Aufrufe in der API-Schicht
 - Saubere Trennung der Architektur-Schichten
@@ -144,12 +161,14 @@ Neue REST-Endpunkte für vollständige Identifikationsnummer-Suche:
 ### 🏗️ Architektur-Verbesserungen
 
 #### Clean Architecture Compliance
+
 - **Konsistente Schichtung**: Alle Endpunkte folgen dem Use-Case-Pattern
 - **Fehlerbehandlung**: Einheitliche Fehlerantworten über alle Endpunkte
 - **Validierung**: Umfassende Eingabevalidierung mit geteilten Utilities
 - **HTTP-Standards**: Korrekte Status-Codes und REST-Konventionen
 
 #### Code-Qualität
+
 - Verbesserte Lesbarkeit und Wartbarkeit
 - Konsistente Namenskonventionen
 - Umfassende Dokumentation aller neuen Funktionen
@@ -157,12 +176,14 @@ Neue REST-Endpunkte für vollständige Identifikationsnummer-Suche:
 ### 📊 Qualitätsmetriken
 
 #### Vor der Optimierung
+
 - ❌ Fehlende Such-Endpunkte für 3 Identifikationstypen
 - ❌ Ineffiziente Statistik-Abfragen (O(n) Komplexität)
 - ❌ Inkonsistente Architektur (einige Endpunkte umgingen Use Cases)
 - ❌ Performance-Probleme bei großen Datensätzen
 
 #### Nach der Optimierung
+
 - ✅ Vollständige API-Abdeckung für alle Identifikationstypen
 - ✅ Effiziente Statistik-Abfragen (O(1) Komplexität)
 - ✅ Konsistente Clean Architecture durchgehend
@@ -171,16 +192,19 @@ Neue REST-Endpunkte für vollständige Identifikationsnummer-Suche:
 ### 🔮 Zukünftige Empfehlungen
 
 #### Caching-Schicht
+
 - Implementierung einer Caching-Schicht für häufig abgerufene Daten
 - Individuelle Pferde-Lookups mit angemessener TTL
 - Statistiken und Zählungen mit Cache-Invalidierung
 
 #### Async-Operationen
+
 - Asynchrone Verarbeitung für Batch-Operationen
 - Komplexe Such-Abfragen mit Async-Pattern
 - Statistik-Berechnungen im Hintergrund
 
 #### Monitoring und Logging
+
 - Umfassendes Monitoring für API-Antwortzeiten
 - Datenbank-Query-Performance-Überwachung
 - Fehlerrate-Tracking und -Analyse
@@ -188,6 +212,7 @@ Neue REST-Endpunkte für vollständige Identifikationsnummer-Suche:
 - **Validierung** und Fehlerbehandlung
 
 ### Service Layer
+
 - **Spring Boot Anwendung**
 - **Dependency Injection** Konfiguration
 - **Integrationstests**
@@ -254,11 +279,13 @@ data class DomPferd(
 ### Enumerationen
 
 #### PferdeGeschlechtE
+
 - `HENGST` - Hengst (männlich, nicht kastriert)
 - `STUTE` - Stute (weiblich)
 - `WALLACH` - Wallach (männlich, kastriert)
 
 #### DatenQuelleE
+
 - `MANUELL` - Manuelle Eingabe
 - `IMPORT` - Datenimport
 - `SYNCHRONISATION` - Synchronisation mit externen Systemen
@@ -366,6 +393,7 @@ Das Horses-Modul stellt REST-Endpunkte über den HorseController bereit:
 ### Datenbankschema
 
 Das Modul verwendet eine `horses`-Tabelle mit folgenden Spalten:
+
 - `pferd_id` (UUID, Primary Key)
 - `pferde_name` (Required)
 - `geschlecht` (Enum: HENGST, STUTE, WALLACH)

services/masterdata/README-MASTERDATA.md

@@ -9,18 +9,21 @@ Das Masterdata-Modul ist eine umfassende Lösung zur Verwaltung von Stammdaten f
 ### Verwaltete Entitäten
 
 #### 1. Länder (LandDefinition)
+
 - **ISO-Codes**: Alpha-2, Alpha-3 und numerische Codes nach ISO 3166-1
 - **EU/EWR-Mitgliedschaft**: Tracking der Mitgliedschaft in EU und Europäischem Wirtschaftsraum
 - **Mehrsprachigkeit**: Deutsche und englische Ländernamen
 - **Validierung**: Duplikatsprüfung und ISO-Code-Validierung
 
 #### 2. Bundesländer (BundeslandDefinition)
+
 - **OEPS-Codes**: Spezielle Codes für österreichische Bundesländer
 - **ISO 3166-2 Codes**: Internationale Standardcodes für subnationale Einheiten
 - **Länder-Zuordnung**: Verknüpfung mit übergeordneten Ländern
 - **Flexible Struktur**: Unterstützt Bundesländer, Kantone, Regionen
 
 #### 3. Altersklassen (AltersklasseDefinition)
+
 - **Berechtigung**: Komplexe Regeln für Teilnahmeberechtigung
 - **Sparten-Filter**: Disziplinspezifische Altersklassen (Dressur, Springen, etc.)
 - **Geschlechts-Filter**: Geschlechtsspezifische Kategorien
@@ -28,6 +31,7 @@ Das Masterdata-Modul ist eine umfassende Lösung zur Verwaltung von Stammdaten f
 - **OETO-Integration**: Verknüpfung mit österreichischen Turnierordnungsregeln
 
 #### 4. Turnierplätze (Platz)
+
 - **Platztypen**: Dressurplatz, Springplatz, Geländestrecke, etc.
 - **Abmessungen**: Standardisierte Platzgrößen (20x60m, 20x40m, etc.)
 - **Bodenarten**: Sand, Gras, Kunststoff, etc.
@@ -55,21 +59,25 @@ masterdata/
 ```
 
 ### Domain Layer
+
 - **4 Domain Models** mit reichhaltiger Geschäftslogik
 - **4 Repository Interfaces** mit 60+ Geschäftsoperationen
 - **Keine Abhängigkeiten** zu anderen Layern
 
 ### Application Layer
+
 - **8 Use Cases** mit umfassender Funktionalität
 - **Validierung**: Eingabevalidierung mit spezifischen Fehlercodes
 - **Geschäftslogik**: Duplikatsprüfung, Berechtigungsvalidierung
 
 ### Infrastructure Layer
+
 - **4 Database Tables** mit Indizes und Constraints
 - **Repository Implementierungen** mit vollständigen CRUD-Operationen
 - **Migration Scripts** mit Beispieldaten
 
 ### API Layer
+
 - **4 REST Controllers** mit 37 Endpunkten
 - **DTO Pattern** für saubere API-Verträge
 - **Fehlerbehandlung** mit strukturierten Antworten
@@ -77,6 +85,7 @@ masterdata/
 ## API Endpunkte
 
 ### Countries (Länder)
+
 ```
 GET    /api/masterdata/countries              # Alle aktiven Länder
 GET    /api/masterdata/countries/{id}         # Land nach ID
@@ -91,6 +100,7 @@ DELETE /api/masterdata/countries/{id}         # Land löschen
 ```
 
 ### Federal States (Bundesländer)
+
 ```
 GET    /api/masterdata/bundeslaender                    # Alle aktiven Bundesländer
 GET    /api/masterdata/bundeslaender/{id}               # Bundesland nach ID
@@ -105,6 +115,7 @@ DELETE /api/masterdata/bundeslaender/{id}               # Bundesland löschen
 ```
 
 ### Age Classes (Altersklassen)
+
 ```
 GET    /api/masterdata/altersklassen              # Alle aktiven Altersklassen
 GET    /api/masterdata/altersklassen/{id}         # Altersklasse nach ID
@@ -119,6 +130,7 @@ DELETE /api/masterdata/altersklassen/{id}         # Altersklasse löschen
 ```
 
 ### Venues (Turnierplätze)
+
 ```
 GET    /api/masterdata/plaetze/{id}                           # Platz nach ID
 GET    /api/masterdata/plaetze/tournament/{turnierId}         # Plätze nach Turnier
@@ -139,6 +151,7 @@ DELETE /api/masterdata/plaetze/{id}                           # Platz löschen
 ## Datenbank Schema
 
 ### Land Tabelle
+
 ```sql
 CREATE TABLE land (
     id UUID PRIMARY KEY,
@@ -158,6 +171,7 @@ CREATE TABLE land (
 ```
 
 ### Bundesland Tabelle
+
 ```sql
 CREATE TABLE bundesland (
     id UUID PRIMARY KEY,
@@ -175,6 +189,7 @@ CREATE TABLE bundesland (
 ```
 
 ### Altersklasse Tabelle
+
 ```sql
 CREATE TABLE altersklasse (
     id UUID PRIMARY KEY,
@@ -193,6 +208,7 @@ CREATE TABLE altersklasse (
 ```
 
 ### Platz Tabelle
+
 ```sql
 CREATE TABLE platz (
     id UUID PRIMARY KEY,
@@ -211,6 +227,7 @@ CREATE TABLE platz (
 ## Verwendung
 
 ### Service starten
+
 ```bash
 # Masterdata Service starten
 ./gradlew :masterdata:masterdata-service:bootRun
@@ -222,6 +239,7 @@ CREATE TABLE platz (
 ### API Beispiele
 
 #### Land erstellen
+
 ```bash
 curl -X POST http://localhost:8080/api/masterdata/countries \
   -H "Content-Type: application/json" \
@@ -237,11 +255,13 @@ curl -X POST http://localhost:8080/api/masterdata/countries \
 ```
 
 #### Altersklassen für 16-jährigen Dressurreiter abrufen
+
 ```bash
 curl "http://localhost:8080/api/masterdata/altersklassen/age/16?sparte=DRESSUR"
 ```
 
 #### Geeignete Dressurplätze finden
+
 ```bash
 curl "http://localhost:8080/api/masterdata/plaetze/suitable?typ=DRESSURPLATZ&dimension=20x60m"
 ```
@@ -249,6 +269,7 @@ curl "http://localhost:8080/api/masterdata/plaetze/suitable?typ=DRESSURPLATZ&dim
 ## Konfiguration
 
 ### Umgebungsvariablen
+
 ```bash
 # Database
 MASTERDATA_DB_URL=jdbc:postgresql://localhost:5432/meldestelle
@@ -264,6 +285,7 @@ MASTERDATA_VALIDATION_STRICT=true
 ```
 
 ### Application Properties
+
 ```yaml
 masterdata:
   validation:
@@ -280,16 +302,19 @@ masterdata:
 ## Tests
 
 ### Unit Tests ausführen
+
 ```bash
 ./gradlew :masterdata:test
 ```
 
 ### Integration Tests ausführen
+
 ```bash
 ./gradlew :masterdata:integrationTest
 ```
 
 ### Spezifische Tests
+
 ```bash
 # Repository Tests
 ./gradlew :masterdata:masterdata-infrastructure:test

services/members/README-MEMBERS.md

@@ -9,6 +9,7 @@ Das Members-Modul ist eine umfassende Lösung zur Verwaltung von Mitgliedern fü
 ### Verwaltete Entität
 
 #### Mitglied (Member)
+
 - **Persönliche Informationen**: Vor- und Nachname, E-Mail, Telefon, Geburtsdatum
 - **Mitgliedschaftsinformationen**: Mitgliedsnummer, Start-/Enddatum, Aktivitätsstatus
 - **Zusätzliche Informationen**: Adresse, Notfallkontakt
@@ -20,11 +21,13 @@ Das Members-Modul ist eine umfassende Lösung zur Verwaltung von Mitgliedern fü
 Das Modul bietet 18+ spezialisierte Repository-Operationen:
 
 #### Basis-CRUD-Operationen
+
 - `findById(id)` - Mitglied nach UUID suchen
 - `save(member)` - Mitglied speichern (erstellen/aktualisieren)
 - `delete(id)` - Mitglied löschen
 
 #### Such-Operationen
+
 - `findByMembershipNumber(number)` - Nach Mitgliedsnummer suchen
 - `findByEmail(email)` - Nach E-Mail-Adresse suchen
 - `findByName(searchTerm, limit)` - Nach Namen suchen (Teilübereinstimmung)
@@ -32,15 +35,18 @@ Das Modul bietet 18+ spezialisierte Repository-Operationen:
 - `findAll(limit, offset)` - Alle Mitglieder (aktiv und inaktiv)
 
 #### Datumsbasierte Abfragen
+
 - `findByMembershipStartDateRange(start, end)` - Mitglieder nach Startdatum-Bereich
 - `findByMembershipEndDateRange(start, end)` - Mitglieder nach Enddatum-Bereich
 - `findMembersWithExpiringMembership(daysAhead)` - Mitglieder mit ablaufender Mitgliedschaft
 
 #### Validierungs-Operationen
+
 - `existsByMembershipNumber(number, excludeId)` - Prüfung auf doppelte Mitgliedsnummer
 - `existsByEmail(email, excludeId)` - Prüfung auf doppelte E-Mail-Adresse
 
 #### Zähl-Operationen
+
 - `countActive()` - Anzahl aktiver Mitglieder
 - `countAll()` - Gesamtanzahl aller Mitglieder
 
@@ -76,28 +82,33 @@ members/
 ```
 
 ### Domain Layer
+
 - **1 Domain Model** mit reichhaltiger Geschäftslogik
 - **1 Repository Interface** mit 18+ Geschäftsoperationen
 - **Domain Events** für Mitgliedschaftsänderungen
 - **Keine Abhängigkeiten** zu anderen Layern
 
 ### Application Layer
+
 - **Use Cases** für komplexe Geschäftsoperationen
 - **Orchestrierung** von Domain-Services
 - **Anwendungslogik** ohne UI-Abhängigkeiten
 
 ### Infrastructure Layer
+
 - **Datenbankzugriff** mit Exposed ORM
 - **Repository-Implementierung** mit PostgreSQL
 - **In-Memory-Repository** für Tests
 - **Datenbankschema** und Migrationen
 
 ### API Layer
+
 - **REST-Controller** für HTTP-Endpunkte
 - **DTO-Mapping** zwischen Domain und API
 - **Validierung** und Fehlerbehandlung
 
 ### Service Layer
+
 - **Spring Boot Anwendung**
 - **Dependency Injection** Konfiguration
 - **Integrationstests**
@@ -204,6 +215,7 @@ Das Members-Modul stellt REST-Endpunkte über den MemberController bereit:
 ### Datenbankschema
 
 Das Modul verwendet eine `members`-Tabelle mit folgenden Spalten:
+
 - `member_id` (UUID, Primary Key)
 - `first_name`, `last_name`, `email` (Required)
 - `phone`, `date_of_birth` (Optional)