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
2025-11-07 12:26:33 +01:00
parent 6850cd92d4
commit b35c4087a2
129 changed files with 4016 additions and 7131 deletions
@@ -20,59 +20,57 @@ Das Modul implementiert moderne **Domain-Driven Design (DDD)** Prinzipien mit ex

 Das Modul ist in zwei spezialisierte Komponenten aufgeteilt, um Konfiguration von der Client-Logik zu trennen:

-
 infrastructure/messaging/
 ├── messaging-config/   # Stellt die zentrale Kafka-Konfiguration bereit
 └── messaging-client/   # Stellt wiederverwendbare, reaktive Clients bereit

-
 ### `messaging-config`

 Dieses Modul zentralisiert die grundlegende Kafka-Konfiguration für das gesamte Projekt.

-* **Zweck:** Definiert Spring-Beans für die `ProducerFactory` (Basis für Producer) und eine `Map` mit Standard-Konfigurationen für Consumer (z.B. `bootstrap-servers`, `group-id`, Serializer).
-* **Vorteil:** Stellt Konsistenz sicher und vereinfacht die Einrichtung neuer Producer oder Consumer in den Services.
+- **Zweck:** Definiert Spring-Beans für die `ProducerFactory` (Basis für Producer) und eine `Map` mit Standard-Konfigurationen für Consumer (z.B. `bootstrap-servers`, `group-id`, Serializer).
+- **Vorteil:** Stellt Konsistenz sicher und vereinfacht die Einrichtung neuer Producer oder Consumer in den Services.

 ### `messaging-client`

 Dieses Modul baut auf der Konfiguration auf und stellt wiederverwendbare High-Level-Komponenten für die Interaktion mit Kafka bereit.

-#### Kern-Komponenten:
+#### Kern-Komponenten

-* **`EventPublisher` Interface**: Definiert moderne APIs für das Publizieren von Domain Events
-    * **Moderne APIs**: `publishEvent()` und `publishEvents()` mit Result Pattern
-    * **Legacy APIs**: `publishEventReactive()` und `publishEventsReactive()` (deprecated)
+- **`EventPublisher` Interface**: Definiert moderne APIs für das Publizieren von Domain Events
+  - **Moderne APIs**: `publishEvent()` und `publishEvents()` mit Result Pattern
+  - **Legacy APIs**: `publishEventReactive()` und `publishEventsReactive()` (deprecated)

-* **`EventConsumer` Interface**: Definiert APIs für das Empfangen von Domain Events
-    * **Moderne APIs**: `receiveEventsWithResult()` mit Flow<Result<T>> für typsichere Fehlerbehandlung
-    * **Legacy APIs**: `receiveEvents()` mit Flux<T> (deprecated)
+- **`EventConsumer` Interface**: Definiert APIs für das Empfangen von Domain Events
+  - **Moderne APIs**: `receiveEventsWithResult()` mit Flow<Result<T>> für typsichere Fehlerbehandlung
+  - **Legacy APIs**: `receiveEvents()` mit Flux<T> (deprecated)

-* **`KafkaEventPublisher`**: Implementierung des EventPublisher mit umfassendem Feature-Set
-    * Reaktive, nicht-blockierende Kafka-Integration mit `ReactiveKafkaProducerTemplate`
-    * Intelligente Retry-Logic mit exponential backoff
-    * Optimierte Batch-Verarbeitung mit kontrollierbarer Parallelität (10 concurrent operations)
-    * Comprehensive Logging und Progress-Tracking
+- **`KafkaEventPublisher`**: Implementierung des EventPublisher mit umfassendem Feature-Set
+  - Reaktive, nicht-blockierende Kafka-Integration mit `ReactiveKafkaProducerTemplate`
+  - Intelligente Retry-Logic mit exponential backoff
+  - Optimierte Batch-Verarbeitung mit kontrollierbarer Parallelität (10 concurrent operations)
+  - Comprehensive Logging und Progress-Tracking

-* **`KafkaEventConsumer`**: Implementierung des EventConsumer mit erweiterten Funktionen
-    * Connection-Pooling zur Wiederverwendung von KafkaReceiver-Instanzen
-    * Sichere Deserialisierung mit Trusted-Package-Validierung
-    * Manual Acknowledgment Control für bessere Kontrolle über Commit-Verhalten
-    * Consumer-Cache-Management für Ressourcenoptimierung
+- **`KafkaEventConsumer`**: Implementierung des EventConsumer mit erweiterten Funktionen
+  - Connection-Pooling zur Wiederverwendung von KafkaReceiver-Instanzen
+  - Sichere Deserialisierung mit Trusted-Package-Validierung
+  - Manual Acknowledgment Control für bessere Kontrolle über Commit-Verhalten
+  - Consumer-Cache-Management für Ressourcenoptimierung

-* **`MessagingError` Hierarchie**: Domain-spezifische Fehlertypen für strukturierte Fehlerbehandlung
-    * `SerializationError`, `DeserializationError`: Serialization-/Deserialization-Probleme
-    * `ConnectionError`: Netzwerk- und Verbindungsfehler
-    * `TimeoutError`: Zeitüberschreitungen
-    * `AuthenticationError`: Authentifizierungs-/Autorisierungsfehler
-    * `TopicConfigurationError`: Topic-Konfigurationsprobleme
-    * `UnexpectedError`: Allgemeine unerwartete Fehler
+- **`MessagingError` Hierarchie**: Domain-spezifische Fehlertypen für strukturierte Fehlerbehandlung
+  - `SerializationError`, `DeserializationError`: Serialization-/Deserialization-Probleme
+  - `ConnectionError`: Netzwerk- und Verbindungsfehler
+  - `TimeoutError`: Zeitüberschreitungen
+  - `AuthenticationError`: Authentifizierungs-/Autorisierungsfehler
+  - `TopicConfigurationError`: Topic-Konfigurationsprobleme
+  - `UnexpectedError`: Allgemeine unerwartete Fehler

-#### Vorteile:
+#### Vorteile

-* **Typsichere Fehlerbehandlung**: Result Pattern eliminiert unerwartete Exceptions
-* **Flexible APIs**: Sowohl moderne Coroutine-basierte als auch Legacy reaktive APIs
-* **Production-Ready**: Umfassendes Retry-Management, Observability und Ressourcenoptimierung
-* **Domain-Driven Design**: Explizite Fehlertypen und saubere Abstraktionen
+- **Typsichere Fehlerbehandlung**: Result Pattern eliminiert unerwartete Exceptions
+- **Flexible APIs**: Sowohl moderne Coroutine-basierte als auch Legacy reaktive APIs
+- **Production-Ready**: Umfassendes Retry-Management, Observability und Ressourcenoptimierung
+- **Domain-Driven Design**: Explizite Fehlertypen und saubere Abstraktionen

 ## Verwendung

@@ -81,6 +79,7 @@ Ein Microservice, der Nachrichten senden oder empfangen möchte, deklariert eine
 ### Moderne API (Result Pattern + Coroutines) - **Empfohlen**

 **Beispiel für das Senden einer Nachricht mit typsicherer Fehlerbehandlung:**
+
 ```kotlin
@Service
 class EventNotificationService(
@@ -113,6 +112,7 @@ class EventNotificationService(
 ```

 **Beispiel für das Empfangen von Nachrichten mit typsicherer Fehlerbehandlung:**
+
 ```kotlin
@Component
 class ModernEventListener(
@@ -175,6 +175,7 @@ class ModernEventListener(
 ```

 **Beispiel für Consumer mit Coroutines und strukturierter Parallelität:**
+
 ```kotlin
@Service
 class BatchEventProcessor(
@@ -215,6 +216,7 @@ class BatchEventProcessor(
 ### Legacy Reactive API - **Wird depreciert**

 **Beispiel für das Senden einer Nachricht (reaktiv, nicht-blockierend):**
+
 ```kotlin
@Service
 class LegacyEventNotificationService(
@@ -235,6 +237,7 @@ class LegacyEventNotificationService(
 ```

 **Beispiel für das Empfangen von Nachrichten (reaktiv):**
+
 ```kotlin
@Component
 class EventListener(
@@ -433,54 +436,54 @@ dependencies {
 Die Zuverlässigkeit des Moduls wird durch eine mehrstufige Teststrategie sichergestellt, die sowohl Unit- als auch Integrationstests umfasst:

 ### Integrationstests (Goldstandard)
-* **Testcontainers**: Der `KafkaIntegrationTest` startet einen echten Apache Kafka Docker-Container, um die Funktionalität unter realen Bedingungen zu validieren
-* **Reaktives Testen**: Nutzt Project Reactor's `StepVerifier` für deterministische Tests der reaktiven Streams ohne unzuverlässige Thread.sleep-Aufrufe
-* **Lifecycle Management**: Saubere Ressourcenverwaltung über @BeforeEach und @AfterEach für korrekte Freigabe von Producer-Threads
-* **End-to-End Validierung**: Vollständige Publish-Subscribe-Zyklen mit echtem Kafka-Cluster
+- **Testcontainers**: Der `KafkaIntegrationTest` startet einen echten Apache Kafka Docker-Container, um die Funktionalität unter realen Bedingungen zu validieren
+- **Reaktives Testen**: Nutzt Project Reactor's `StepVerifier` für deterministische Tests der reaktiven Streams ohne unzuverlässige Thread.sleep-Aufrufe
+- **Lifecycle Management**: Saubere Ressourcenverwaltung über @BeforeEach und @AfterEach für korrekte Freigabe von Producer-Threads
+- **End-to-End Validierung**: Vollständige Publish-Subscribe-Zyklen mit echtem Kafka-Cluster

 ### Unit Tests
-* **`KafkaEventPublisherErrorTest`**: Fokussierte Tests für Fehlerbehandlung mit MockK für isolierte Testszenarien
-* **Fehlerszenarien**: Systematische Tests für Serialization-, Authentication-, Connection- und Timeout-Fehler
-* **Batch-Verarbeitung**: Validierung von Batch-Operationen und Empty-Batch-Handling
-* **Retry-Logic**: Tests für intelligente Retry-Mechanismen und Retry-Exhaustion
+- **`KafkaEventPublisherErrorTest`**: Fokussierte Tests für Fehlerbehandlung mit MockK für isolierte Testszenarien
+- **Fehlerszenarien**: Systematische Tests für Serialization-, Authentication-, Connection- und Timeout-Fehler
+- **Batch-Verarbeitung**: Validierung von Batch-Operationen und Empty-Batch-Handling
+- **Retry-Logic**: Tests für intelligente Retry-Mechanismen und Retry-Exhaustion

 ### Sicherheits- und Konfigurationstests
-* **`KafkaSecurityTest`**: Validierung der Sicherheitskonfigurationen und Trusted-Package-Verwaltung
-* **`KafkaEventConsumerCacheTest`**: Tests für Consumer-Caching und Ressourcenoptimierung
-* **Konfigurationsvalidierung**: Automatische Validierung aller Konfigurationsparameter
+- **`KafkaSecurityTest`**: Validierung der Sicherheitskonfigurationen und Trusted-Package-Verwaltung
+- **`KafkaEventConsumerCacheTest`**: Tests für Consumer-Caching und Ressourcenoptimierung
+- **Konfigurationsvalidierung**: Automatische Validierung aller Konfigurationsparameter

 ## Neue Features und Optimierungen (2025)

 ### Domain-Driven Design (DDD) Integration
-* **Result Pattern APIs**: Neue suspending Coroutine-basierte APIs mit typsicherer Fehlerbehandlung über das Result Pattern
-* **Domain-spezifische Fehlertypen**: Umfassende `MessagingError` Hierarchie (SerializationError, ConnectionError, TimeoutError, AuthenticationError, etc.)
-* **Explizite Fehlerbehandlung**: Eliminiert unerwartete Exceptions durch strukturierte Fehler-Typen
-* **Backward Compatibility**: Legacy-reactive APIs bleiben verfügbar, sind aber als deprecated markiert
+- **Result Pattern APIs**: Neue suspending Coroutine-basierte APIs mit typsicherer Fehlerbehandlung über das Result Pattern
+- **Domain-spezifische Fehlertypen**: Umfassende `MessagingError` Hierarchie (SerializationError, ConnectionError, TimeoutError, AuthenticationError, etc.)
+- **Explizite Fehlerbehandlung**: Eliminiert unerwartete Exceptions durch strukturierte Fehler-Typen
+- **Backward Compatibility**: Legacy-reactive APIs bleiben verfügbar, sind aber als deprecated markiert

 ### Erweiterte Konfigurationsvalidierung
-* **Automatische Validierung**: Alle Konfigurationsparameter werden automatisch bei der Zuweisung validiert
-* **Bootstrap-Server-Format**: Unterstützt sowohl einfache (`host:port`) als auch protokoll-präfixierte Formate (`PLAINTEXT://host:port`)
-* **Sicherheitsfeatures**: Konfigurierbare Sicherheitsfunktionen für Produktionsumgebungen
-* **Connection-Pool-Management**: Konfigurierbare Verbindungspool-Größe für bessere Ressourcenverwaltung
+- **Automatische Validierung**: Alle Konfigurationsparameter werden automatisch bei der Zuweisung validiert
+- **Bootstrap-Server-Format**: Unterstützt sowohl einfache (`host:port`) als auch protokoll-präfixierte Formate (`PLAINTEXT://host:port`)
+- **Sicherheitsfeatures**: Konfigurierbare Sicherheitsfunktionen für Produktionsumgebungen
+- **Connection-Pool-Management**: Konfigurierbare Verbindungspool-Größe für bessere Ressourcenverwaltung

 ### Verbesserte Observability
-* **Strukturierte Logs**: Erweiterte Logging-Informationen mit GroupID, Timestamps und Event-Kontext
-* **Fehlerkontext**: Detaillierte Fehlerinformationen mit Retry-Status und Event-Type-Details
-* **Performance-Tracking**: Bessere Nachvollziehbarkeit von Batch-Operationen und Retry-Versuchen
-* **Batch-Progress-Logging**: Automatisches Progress-Logging bei großen Batch-Operationen (alle 100 Events)
+- **Strukturierte Logs**: Erweiterte Logging-Informationen mit GroupID, Timestamps und Event-Kontext
+- **Fehlerkontext**: Detaillierte Fehlerinformationen mit Retry-Status und Event-Type-Details
+- **Performance-Tracking**: Bessere Nachvollziehbarkeit von Batch-Operationen und Retry-Versuchen
+- **Batch-Progress-Logging**: Automatisches Progress-Logging bei großen Batch-Operationen (alle 100 Events)

 ### Robustheit-Verbesserungen
-* **Intelligente Retry-Logik**: Differenzierte Retry-Strategien basierend auf Fehlertypen (keine Retries für Serialization/Auth-Fehler)
-* **Exponential Backoff**: Konfigurierbare Retry-Delays mit exponential backoff (1s initial, max 10s backoff)
-* **Controlled Batch Concurrency**: Optimierte Batch-Verarbeitung mit konfigurierbarer Parallelität (Standard: 10 concurrent operations)
-* **Testcontainer-Kompatibilität**: Vollständige Kompatibilität mit Docker-basierten Tests
-* **Enhanced Error Handling**: Verbesserte Fehlerbehandlung mit strukturierten Kontext-Informationen
+- **Intelligente Retry-Logik**: Differenzierte Retry-Strategien basierend auf Fehlertypen (keine Retries für Serialization/Auth-Fehler)
+- **Exponential Backoff**: Konfigurierbare Retry-Delays mit exponential backoff (1s initial, max 10s backoff)
+- **Controlled Batch Concurrency**: Optimierte Batch-Verarbeitung mit konfigurierbarer Parallelität (Standard: 10 concurrent operations)
+- **Testcontainer-Kompatibilität**: Vollständige Kompatibilität mit Docker-basierten Tests
+- **Enhanced Error Handling**: Verbesserte Fehlerbehandlung mit strukturierten Kontext-Informationen

 ### Test-Suite Optimierung
-* **Fokussierte Unit Tests**: Bereinigte Test-Suite mit Fokus auf essentielle Funktionalität
-* **MockK Integration**: Moderne Mocking-Frameworks für isolierte Unit Tests
-* **StepVerifier Korrekturen**: Korrigierte reaktive Test-Assertions für `Mono<Unit>` Rückgabetypen
-* **Reduced Test Complexity**: Entfernung unnötiger Performance- und Logging-Tests zugunsten fokussierter Funktionstests
+- **Fokussierte Unit Tests**: Bereinigte Test-Suite mit Fokus auf essentielle Funktionalität
+- **MockK Integration**: Moderne Mocking-Frameworks für isolierte Unit Tests
+- **StepVerifier Korrekturen**: Korrigierte reaktive Test-Assertions für `Mono<Unit>` Rückgabetypen
+- **Reduced Test Complexity**: Entfernung unnötiger Performance- und Logging-Tests zugunsten fokussierter Funktionstests

 ## Troubleshooting

@@ -493,6 +496,7 @@ Die Zuverlässigkeit des Moduls wird durch eine mehrstufige Teststrategie sicher
 **Mögliche Ursachen und Lösungen**:

 1. **Kafka-Cluster-Erreichbarkeit prüfen**:
+
 ```bash
 # Teste Verbindung zu Kafka-Cluster
 telnet kafka-cluster 9092
@@ -502,12 +506,14 @@ nc -zv kafka-cluster 9092
 ```

 2. **Bootstrap-Server-Konfiguration validieren**:
+
 ```kotlin
 // Multiple Broker für High Availability
 kafkaConfig.bootstrapServers = "kafka-01:9092,kafka-02:9092,kafka-03:9092"
 ```

 3. **Netzwerk-Timeouts erhöhen für langsame Verbindungen**:
+
 ```kotlin
 // Producer-Konfiguration erweitern
 override fun producerConfigs(): Map<String, Any> = super.producerConfigs() + mapOf(
@@ -521,6 +527,7 @@ override fun producerConfigs(): Map<String, Any> = super.producerConfigs() + map
 **Problem**: `MessagingError.DeserializationError` beim Empfangen von Nachrichten

 **Lösungsansätze**:
+
 ```kotlin
 // 1. Trusted Packages erweitern
 kafkaConfig.trustedPackages = "at.mocode.*,com.mycompany.*,java.util.*"
@@ -544,6 +551,7 @@ private suspend fun handlePoisonMessage(topic: String, error: MessagingError.Des
 **Problem**: Langsame Message-Verarbeitung oder hohe Latenz

 **Optimierungsstrategien**:
+
 ```kotlin
 // 1. Connection Pool vergrößern
 kafkaConfig.connectionPoolSize = 50
@@ -568,6 +576,7 @@ suspend fun processEventsBatch(events: List<EventDetails>) {
 **Problem**: Speicherverbrauch steigt kontinuierlich

 **Lösungen**:
+
 ```kotlin
 // 1. Consumer-Cache korrekt verwalten
@PreDestroy
@@ -696,6 +705,7 @@ A: Die moderne API nutzt das Result Pattern für explizite Fehlerbehandlung und
 **Q: Wann sollte ich Batch-Verarbeitung verwenden?**

 A: Batch-Verarbeitung ist empfohlen bei:
+
 - Mehr als 10 Events pro Sekunde
 - Hoher Netzwerk-Latenz zum Kafka-Cluster
 - Events, die zusammen verarbeitet werden können
@@ -703,6 +713,7 @@ A: Batch-Verarbeitung ist empfohlen bei:
 **Q: Wie handle ich Backpressure bei hohem Event-Durchsatz?**

 A: Nutzen Sie die eingebauten Flow-Operatoren:
+
 ```kotlin
 eventConsumer.receiveEventsWithResult(topic, EventType::class.java)
    .asFlow()
@@ -715,8 +726,6 @@ eventConsumer.receiveEventsWithResult(topic, EventType::class.java)

 **Letzte Aktualisierung**: 15. August 2025

-
-
 ## Aktualisierungen (September 2025)

 - ReactiveKafkaConfig: Der Bean kafkaConfig() ist jetzt mit @ConditionalOnMissingBean annotiert. Dadurch wird kein zweiter KafkaConfig-Bean erzeugt, wenn bereits extern einer bereitgestellt wird. Dies verhindert Bean-Kollisionen und erleichtert Überschreibungen in Services/Tests.