Kubernetes/OpenShift Manifeste, Helm/Kustomize Beispiel und Runbook.

Build erzeugt Images, Deployment rollt Services aus.

Wichtige Klassen

• DeployOpenshiftComponent: kompakter Fach-/Adapterbaustein mit Pattern-Kommentaren.

• DeployOpenshiftRepository: austauschbare Speicherabstraktion.

Infrastructure as Code, Blue-Green

Lokale Lernaufgabe

Lies zuerst die README, dann die Klassen, dann die Pattern-Kommentare. Ergänze danach einen Test, der eine fachliche Regel oder eine Adaptergrenze absichert.

Stand 2026-07-07

Import/Export Jobs, Reconciliation und Recovery-Läufe.

Periodischer Job liest offene Outbox/Saga Fälle.

Wichtige Klassen

• AdapterBatchComponent: kompakter Fach-/Adapterbaustein mit Pattern-Kommentaren.

• AdapterBatchRepository: austauschbare Speicherabstraktion.

Template Method, Chunk Processor

Lokale Lernaufgabe

Lies zuerst die README, dann die Klassen, dann die Pattern-Kommentare. Ergänze danach einen Test, der eine fachliche Regel oder eine Adaptergrenze absichert.

Stand 2026-07-07

Anti-Corruption Layer für alte SOAP Partner oder ERP Services.

DTO wird in Legacy Request übersetzt, Fehler werden normalisiert.

Wichtige Klassen

• AdapterLegacySoapComponent: kompakter Fach-/Adapterbaustein mit Pattern-Kommentaren.

• AdapterLegacySoapRepository: austauschbare Speicherabstraktion.

Anti-Corruption Layer, Adapter

Lokale Lernaufgabe

Lies zuerst die README, dann die Klassen, dann die Pattern-Kommentare. Ergänze danach einen Test, der eine fachliche Regel oder eine Adaptergrenze absichert.

Stand 2026-07-07

Event Publishing und Event Listener für Integrationsereignisse.

Outbox Publisher sendet Events idempotent an Kafka.

Wichtige Klassen

• AdapterMessagingKafkaComponent: kompakter Fach-/Adapterbaustein mit Pattern-Kommentaren.

• AdapterMessagingKafkaRepository: austauschbare Speicherabstraktion.

Publisher, Consumer, Idempotent Receiver

Lokale Lernaufgabe

Lies zuerst die README, dann die Klassen, dann die Pattern-Kommentare. Ergänze danach einen Test, der eine fachliche Regel oder eine Adaptergrenze absichert.

Stand 2026-07-07

Repository-Implementierungen, Entity Mapping, Outbox Tabelle.

Speichert Aggregates und Outbox in derselben Transaktion.

Wichtige Klassen

• AdapterPersistenceJpaComponent: kompakter Fach-/Adapterbaustein mit Pattern-Kommentaren.

• AdapterPersistenceJpaRepository: austauschbare Speicherabstraktion.

Repository, Data Mapper, Unit of Work

Lokale Lernaufgabe

Lies zuerst die README, dann die Klassen, dann die Pattern-Kommentare. Ergänze danach einen Test, der eine fachliche Regel oder eine Adaptergrenze absichert.

Stand 2026-07-07

HTTP API, DTO Mapping, Controller, Fehlerantworten.

Nimmt Request an, validiert oberflächlich, ruft Use Case Port auf.

Wichtige Klassen

• AdapterRestComponent: kompakter Fach-/Adapterbaustein mit Pattern-Kommentaren.

• AdapterRestRepository: austauschbare Speicherabstraktion.

Adapter, DTO, Mapper

Lokale Lernaufgabe

Lies zuerst die README, dann die Klassen, dann die Pattern-Kommentare. Ergänze danach einen Test, der eine fachliche Regel oder eine Adaptergrenze absichert.

Stand 2026-07-07

Zusammengesetzte API für Web/Mobile Clients.

Ruft mehrere Use Cases/Read Models zusammen.

Wichtige Klassen

• ApiGatewayBffComponent: kompakter Fach-/Adapterbaustein mit Pattern-Kommentaren.

• ApiGatewayBffRepository: austauschbare Speicherabstraktion.

Facade, API Gateway

Lokale Lernaufgabe

Lies zuerst die README, dann die Klassen, dann die Pattern-Kommentare. Ergänze danach einen Test, der eine fachliche Regel oder eine Adaptergrenze absichert.

Stand 2026-07-07

Use Cases für Kundenprüfung und Segmentierung.

REST oder Saga fragt CustomerDecision ab.

Wichtige Klassen

• ApplicationCustomerComponent: kompakter Fach-/Adapterbaustein mit Pattern-Kommentaren.

• ApplicationCustomerRepository: austauschbare Speicherabstraktion.

Facade, Policy

Lokale Lernaufgabe

Lies zuerst die README, dann die Klassen, dann die Pattern-Kommentare. Ergänze danach einen Test, der eine fachliche Regel oder eine Adaptergrenze absichert.

Stand 2026-07-07

Use Cases für Inventory Reservation und Release.

Verarbeitet Events und ruft Domain-Service auf.

Wichtige Klassen

• ApplicationInventoryComponent: kompakter Fach-/Adapterbaustein mit Pattern-Kommentaren.

• ApplicationInventoryRepository: austauschbare Speicherabstraktion.

Application Service, Transaction Script bewusst begrenzt

Lokale Lernaufgabe

Lies zuerst die README, dann die Klassen, dann die Pattern-Kommentare. Ergänze danach einen Test, der eine fachliche Regel oder eine Adaptergrenze absichert.

Stand 2026-07-07

Use Cases für OrderPlacement, Confirmation und Cancellation.

Koordiniert Ports, startet Domainlogik, schreibt Outbox.

Wichtige Klassen

• ApplicationOrderComponent: kompakter Fach-/Adapterbaustein mit Pattern-Kommentaren.

• ApplicationOrderRepository: austauschbare Speicherabstraktion.

Use Case, Port, Command Handler

Lokale Lernaufgabe

Lies zuerst die README, dann die Klassen, dann die Pattern-Kommentare. Ergänze danach einen Test, der eine fachliche Regel oder eine Adaptergrenze absichert.

Stand 2026-07-07

Use Cases für Payment Authorization und Capture.

Wird durch Saga oder REST Adapter aufgerufen.

Wichtige Klassen

• ApplicationPaymentComponent: kompakter Fach-/Adapterbaustein mit Pattern-Kommentaren.

• ApplicationPaymentRepository: austauschbare Speicherabstraktion.

Command Handler, Adapter

Lokale Lernaufgabe

Lies zuerst die README, dann die Klassen, dann die Pattern-Kommentare. Ergänze danach einen Test, der eine fachliche Regel oder eine Adaptergrenze absichert.

Stand 2026-07-07

Versionen und DependencyManagement, damit alle Module konsistente Abhängigkeiten nutzen.

Wird von allen fachlichen Modulen importiert.

Wichtige Klassen

• ArchitectureBomComponent: kompakter Fach-/Adapterbaustein mit Pattern-Kommentaren.

• ArchitectureBomRepository: austauschbare Speicherabstraktion.

Facade, Dependency Management

Lokale Lernaufgabe

Lies zuerst die README, dann die Klassen, dann die Pattern-Kommentare. Ergänze danach einen Test, der eine fachliche Regel oder eine Adaptergrenze absichert.

Stand 2026-07-07

Produktkatalog, Preislisten, Produktverfügbarkeit.

Order Use Case prüft Artikel und Preise.

Wichtige Klassen

• DomainCatalogComponent: kompakter Fach-/Adapterbaustein mit Pattern-Kommentaren.

• DomainCatalogRepository: austauschbare Speicherabstraktion.

Read Model, Adapter

Lokale Lernaufgabe

Lies zuerst die README, dann die Klassen, dann die Pattern-Kommentare. Ergänze danach einen Test, der eine fachliche Regel oder eine Adaptergrenze absichert.

Stand 2026-07-07

Kundenprofil, Kreditlimit und Risikoindikator.

Use Case fragt Kreditlimit ab, bevor Bestellung bestätigt wird.

Wichtige Klassen

• DomainCustomerComponent: kompakter Fach-/Adapterbaustein mit Pattern-Kommentaren.

• DomainCustomerRepository: austauschbare Speicherabstraktion.

Policy, Specification

Lokale Lernaufgabe

Lies zuerst die README, dann die Klassen, dann die Pattern-Kommentare. Ergänze danach einen Test, der eine fachliche Regel oder eine Adaptergrenze absichert.

Stand 2026-07-07

Reservierung, Freigabe und Bestandsbuchung.

OrderCreated reserviert Bestand; bei Fehler Compensation.

Wichtige Klassen

• DomainInventoryComponent: kompakter Fach-/Adapterbaustein mit Pattern-Kommentaren.

• DomainInventoryRepository: austauschbare Speicherabstraktion.

Repository, Aggregate Root

Lokale Lernaufgabe

Lies zuerst die README, dann die Klassen, dann die Pattern-Kommentare. Ergänze danach einen Test, der eine fachliche Regel oder eine Adaptergrenze absichert.

Stand 2026-07-07

Bestellung als Aggregate Root mit OrderLine, Pricing-Regeln und Statusübergängen.

Use Case legt Bestellung an, Domain prüft Invarianten, Event wird erzeugt.

Wichtige Klassen

• DomainOrderComponent: kompakter Fach-/Adapterbaustein mit Pattern-Kommentaren.

• DomainOrderRepository: austauschbare Speicherabstraktion.

Aggregate Root, Specification, Factory

Lokale Lernaufgabe

Lies zuerst die README, dann die Klassen, dann die Pattern-Kommentare. Ergänze danach einen Test, der eine fachliche Regel oder eine Adaptergrenze absichert.

Stand 2026-07-07

Zahlungsautorisierung, Capture, Refund und Zahlungsstatus.

Saga startet Autorisierung und kompensiert bei Lieferproblem.

Wichtige Klassen

• DomainPaymentComponent: kompakter Fach-/Adapterbaustein mit Pattern-Kommentaren.

• DomainPaymentRepository: austauschbare Speicherabstraktion.

State, Strategy, Domain Service

Lokale Lernaufgabe

Lies zuerst die README, dann die Klassen, dann die Pattern-Kommentare. Ergänze danach einen Test, der eine fachliche Regel oder eine Adaptergrenze absichert.

Stand 2026-07-07

Komplexer Enterprise-Lernworkspace mit 28 konzeptionellen Modulen. Ziel ist nicht nur lauffähiger Beispielcode, sondern Architekturverständnis: Modulgrenzen, Abhängigkeitsrichtung, Entwurfsmuster, Teststrategie und Betriebsfähigkeit.

1. Parent und BOM prüfen.
2. Shared Kernel verstehen.
3. Domain-Module lesen: Order, Payment, Inventory, Customer, Catalog.
4. Application-Use-Cases lesen.
5. Adapter betrachten: REST, JPA, Kafka, SOAP, Batch.
6. Outbox, Saga und CQRS als Deep Dive nachvollziehen.
7. Security, Observability und OpenShift Deployment ergänzen.
8. Architekturtests und Contract Tests ausführen.

mvn -q -DskipTests package
mvn -q test

Codex / Claude Code Phasenaufbau

Dieses Projekt enthält jetzt einen eigenen Bereich, der beschreibt, wie Codex oder Claude Code den Workspace phasenweise aufbauen würde: AI_BUILD_PHASES.html.

Langlaufende Order-to-Cash Prozesssteuerung mit Compensation.

OrderPlaced -> Reserve -> Authorize -> Confirm oder kompensieren.

Wichtige Klassen

• OrchestrationSagaComponent: kompakter Fach-/Adapterbaustein mit Pattern-Kommentaren.

• OrchestrationSagaRepository: austauschbare Speicherabstraktion.

Saga, Process Manager, State Machine

Lokale Lernaufgabe

Lies zuerst die README, dann die Klassen, dann die Pattern-Kommentare. Ergänze danach einen Test, der eine fachliche Regel oder eine Adaptergrenze absichert.

Stand 2026-07-07

Transaktionaler Outbox Publisher mit Retry, Locking und Idempotenz.

Liest Pending Events, published, markiert abgeschlossen.

Wichtige Klassen

• OutboxEngineComponent: kompakter Fach-/Adapterbaustein mit Pattern-Kommentaren.

• OutboxEngineRepository: austauschbare Speicherabstraktion.

Transactional Outbox, Retry, Idempotency

Lokale Lernaufgabe

Lies zuerst die README, dann die Klassen, dann die Pattern-Kommentare. Ergänze danach einen Test, der eine fachliche Regel oder eine Adaptergrenze absichert.

Stand 2026-07-07

Projektierte Lesemodelle für UI und Reporting.

Events aktualisieren optimierte Tabellen oder Views.

Wichtige Klassen

• QueryCqrsReadmodelComponent: kompakter Fach-/Adapterbaustein mit Pattern-Kommentaren.

• QueryCqrsReadmodelRepository: austauschbare Speicherabstraktion.

CQRS, Projection

Lokale Lernaufgabe

Lies zuerst die README, dann die Klassen, dann die Pattern-Kommentare. Ergänze danach einen Test, der eine fachliche Regel oder eine Adaptergrenze absichert.

Stand 2026-07-07

Gemeinsame fachliche Wertobjekte, IDs, Domain Events und Fehlerklassen.

Alle Domains hängen nur kontrolliert davon ab.

Wichtige Klassen

• SharedKernelComponent: kompakter Fach-/Adapterbaustein mit Pattern-Kommentaren.

• SharedKernelRepository: austauschbare Speicherabstraktion.

Value Object, Domain Event

Lokale Lernaufgabe

Lies zuerst die README, dann die Klassen, dann die Pattern-Kommentare. Ergänze danach einen Test, der eine fachliche Regel oder eine Adaptergrenze absichert.

Stand 2026-07-07

Tracing, strukturierte Logs, Metriken und Audit Events.

Jeder Use Case erzeugt Correlation-ID und Business Audit.

Wichtige Klassen

• ObservabilityModuleComponent: kompakter Fach-/Adapterbaustein mit Pattern-Kommentaren.

• ObservabilityModuleRepository: austauschbare Speicherabstraktion.

Observer, Decorator

Lokale Lernaufgabe

Lies zuerst die README, dann die Klassen, dann die Pattern-Kommentare. Ergänze danach einen Test, der eine fachliche Regel oder eine Adaptergrenze absichert.

Stand 2026-07-07

Rollen, Berechtigungen, Token Claims, Method Policies.

REST Adapter prüft Claims; Use Case prüft fachliche Rechte.

Wichtige Klassen

• SecurityModuleComponent: kompakter Fach-/Adapterbaustein mit Pattern-Kommentaren.

• SecurityModuleRepository: austauschbare Speicherabstraktion.

Policy, Guard, Chain of Responsibility

Lokale Lernaufgabe

Lies zuerst die README, dann die Klassen, dann die Pattern-Kommentare. Ergänze danach einen Test, der eine fachliche Regel oder eine Adaptergrenze absichert.

Stand 2026-07-07

ArchUnit-Regeln für Layering, Dependency Direction und Naming.

Build bricht bei verbotenen Abhängigkeiten.

Wichtige Klassen

• ArchitectureTestsComponent: kompakter Fach-/Adapterbaustein mit Pattern-Kommentaren.

• ArchitectureTestsRepository: austauschbare Speicherabstraktion.

Architecture Fitness Function

Lokale Lernaufgabe

Lies zuerst die README, dann die Klassen, dann die Pattern-Kommentare. Ergänze danach einen Test, der eine fachliche Regel oder eine Adaptergrenze absichert.

Stand 2026-07-07

Testdatenbauer, Contract-Test-Basis, Assert-Helfer.

Wird nur im Test-Scope verwendet.

Wichtige Klassen

• CommonTestComponent: kompakter Fach-/Adapterbaustein mit Pattern-Kommentaren.

• CommonTestRepository: austauschbare Speicherabstraktion.

Test Data Builder, Object Mother

Lokale Lernaufgabe

Lies zuerst die README, dann die Klassen, dann die Pattern-Kommentare. Ergänze danach einen Test, der eine fachliche Regel oder eine Adaptergrenze absichert.

Stand 2026-07-07

Consumer/Provider Verträge für REST und Events.

Sichert Adapter-Kompatibilität zwischen Modulen.

Wichtige Klassen

• ContractTestsComponent: kompakter Fach-/Adapterbaustein mit Pattern-Kommentaren.

• ContractTestsRepository: austauschbare Speicherabstraktion.

Contract Test, Test Pyramid

Lokale Lernaufgabe

Lies zuerst die README, dann die Klassen, dann die Pattern-Kommentare. Ergänze danach einen Test, der eine fachliche Regel oder eine Adaptergrenze absichert.

Stand 2026-07-07

Testcontainers-orientierte End-to-End-Flows.

Startet Adapter und prüft Order-to-Cash.

Wichtige Klassen

• IntegrationTestsComponent: kompakter Fach-/Adapterbaustein mit Pattern-Kommentaren.

• IntegrationTestsRepository: austauschbare Speicherabstraktion.

Test Harness, Fixture

Lokale Lernaufgabe

Lies zuerst die README, dann die Klassen, dann die Pattern-Kommentare. Ergänze danach einen Test, der eine fachliche Regel oder eine Adaptergrenze absichert.

Stand 2026-07-07