V01 Order Application

Kurzbeschreibung

Modultyp: Use-Case-Modul

Definiert den einfachen Bestell-Use-Case und die Ports, ueber die Domain und Adapter verbunden werden.

Was macht das Modul?

• definiert PlaceOrderCommand und PlaceOrderUseCase
• enthaelt OrderRepository als Port
• enthaelt PricingPolicy als austauschbare Preisregel

Ablauf im Gesamtsystem

1. Controller erstellt ein PlaceOrderCommand.
2. Use Case erzeugt Domain-Objekte und nutzt PricingPolicy.
3. OrderRepository-Port wird vom Memory Adapter umgesetzt.

Wichtige Klassen und Dateien

• PlaceOrderCommand
• PlaceOrderUseCase
• OrderRepository
• PricingPolicy
• DefaultPricingPolicy

Verwendete Entwurfsmuster

• Application Service
• Command Pattern
• Repository Port
• Strategy Pattern

Typischer Einstieg beim Lesen

1. Zuerst dieses README lesen.
2. Dann pom.xml ansehen.
3. Danach die genannten Klassen oeffnen.
4. Am Ende ../../../docs/design-patterns.md lesen und die // PATTERN:-Marker im Code vergleichen.

V02 Order Application

Kurzbeschreibung

Modultyp: Use-Case- und Port-Schicht

Zeigt Clean Architecture mit Commands, Use Cases und Repository-Port.

Was macht das Modul?

• definiert CreateOrderCommand
• definiert CreateOrderUseCase und ApproveOrderUseCase
• haelt OrderRepository als Port in der Application-Schicht

Ablauf im Gesamtsystem

1. Inbound Adapter uebergibt Command.
2. Use Case steuert fachlichen Ablauf.
3. Repository-Port isoliert Persistenz.

Wichtige Klassen und Dateien

• CreateOrderCommand
• CreateOrderUseCase
• ApproveOrderUseCase
• OrderRepository

Verwendete Entwurfsmuster

• Use Case Interface
• Command Pattern
• Port Pattern

Typischer Einstieg beim Lesen

1. Zuerst dieses README lesen.
2. Dann pom.xml ansehen.
3. Danach die genannten Klassen oeffnen.
4. Am Ende ../../../docs/design-patterns.md lesen und die // PATTERN:-Marker im Code vergleichen.

V01 Memory Adapter

Kurzbeschreibung

Modultyp: Outbound Adapter

Stellt eine einfache In-Memory-Persistenz bereit, damit die Modulgrenzen ohne echte Datenbank sichtbar werden.

Was macht das Modul?

• implementiert OrderRepository
• speichert Orders in einer Map
• zeigt Adapterprinzip ohne Infrastrukturkomplexitaet

Ablauf im Gesamtsystem

1. Use Case ruft OrderRepository.save.
2. InMemoryOrderRepository speichert die Order im Speicher.
3. Tests oder Demo-Aufrufe koennen ohne Datenbank laufen.

Wichtige Klassen und Dateien

• InMemoryOrderRepository

Verwendete Entwurfsmuster

• Adapter Pattern
• Repository Adapter
• Fake Adapter for Learning

Typischer Einstieg beim Lesen

1. Zuerst dieses README lesen.
2. Dann pom.xml ansehen.
3. Danach die genannten Klassen oeffnen.
4. Am Ende ../../../docs/design-patterns.md lesen und die // PATTERN:-Marker im Code vergleichen.

V02 Order Adapters

Kurzbeschreibung

Modultyp: Inbound/Outbound Adapter

Kapselt REST, DTO-Mapping, Facade und In-Memory-Persistenz als technische Raender.

Was macht das Modul?

• stellt REST Controller und DTO bereit
• uebersetzt DTOs ueber Mapper
• stellt OrderFacade als vereinfachte API-Grenze bereit

Ablauf im Gesamtsystem

1. REST empfaengt Request.
2. DTO Mapper uebersetzt in Command.
3. Facade ruft Use Case und Repository Adapter.

Wichtige Klassen und Dateien

• OrderController
• OrderDto
• OrderDtoMapper
• OrderFacade
• InMemoryOrderRepository

Verwendete Entwurfsmuster

• Adapter Pattern
• DTO
• Mapper
• Facade

Typischer Einstieg beim Lesen

1. Zuerst dieses README lesen.
2. Dann pom.xml ansehen.
3. Danach die genannten Klassen oeffnen.
4. Am Ende ../../../docs/design-patterns.md lesen und die // PATTERN:-Marker im Code vergleichen.

V05 Order Integration

Kurzbeschreibung

Modultyp: Legacy/Process Integration

Kapselt Billing-Anbindung und Fulfillment-Prozess als Gateway, ACL und Saga.

Was macht das Modul?

• definiert BillingGateway
• implementiert LegacyBillingClientAdapter
• koordiniert OrderFulfillmentSaga

Ablauf im Gesamtsystem

1. Command-Seite loest Integration aus.
2. Saga ruft BillingGateway.
3. LegacyBillingClientAdapter uebersetzt zur alten Billing-Welt.

Wichtige Klassen und Dateien

• BillingGateway
• LegacyBillingClientAdapter
• OrderFulfillmentSaga

Verwendete Entwurfsmuster

• Saga
• Gateway
• Anti-Corruption Layer
• Adapter Pattern

Typischer Einstieg beim Lesen

1. Zuerst dieses README lesen.
2. Dann pom.xml ansehen.
3. Danach die genannten Klassen oeffnen.
4. Am Ende ../../../docs/design-patterns.md lesen und die // PATTERN:-Marker im Code vergleichen.

V01 Order Domain

Kurzbeschreibung

Modultyp: Domain-Modul

Enthaelt das einfache Bestellmodell mit Wertobjekten, Status und grundlegenden Invarianten.

Was macht das Modul?

• modelliert Order, OrderLine, OrderId, Money und OrderStatus
• erzwingt Mindestregeln wie Positionen vor Submit
• bleibt frei von Spring, Web und Persistenz

Ablauf im Gesamtsystem

1. Application erzeugt eine Order ueber fachliche Methoden.
2. Order prueft Invarianten und wechselt den Status.
3. Repository-Port speichert das Aggregate ueber einen Adapter.

Wichtige Klassen und Dateien

• Order
• OrderLine
• OrderId
• Money
• OrderStatus
• OrderTest

Verwendete Entwurfsmuster

• Aggregate Root
• Value Object
• Entity
• Domain Model

Typischer Einstieg beim Lesen

1. Zuerst dieses README lesen.
2. Dann pom.xml ansehen.
3. Danach die genannten Klassen oeffnen.
4. Am Ende ../../../docs/design-patterns.md lesen und die // PATTERN:-Marker im Code vergleichen.

V02 Order Domain

Kurzbeschreibung

Modultyp: Clean-Domain

Vertieft die Domain mit sauberer Trennung von CustomerId, OrderId und Order-Aggregate.

Was macht das Modul?

• zeigt Domain ohne Framework-Abhaengigkeit
• trennt IDs als fachliche Typen
• bereitet Use Cases und Adaptergrenzen vor

Ablauf im Gesamtsystem

1. Use Case erstellt Domain-Objekte.
2. Domain enthaelt nur Regeln und Zustandswechsel.
3. Adapter greifen nicht direkt in Domain-Interna ein.

Wichtige Klassen und Dateien

• Order
• OrderId
• CustomerId

Verwendete Entwurfsmuster

• Aggregate Root
• Value Object
• Clean Domain Model

Typischer Einstieg beim Lesen

1. Zuerst dieses README lesen.
2. Dann pom.xml ansehen.
3. Danach die genannten Klassen oeffnen.
4. Am Ende ../../../docs/design-patterns.md lesen und die // PATTERN:-Marker im Code vergleichen.

V05 Order Runtime

Kurzbeschreibung

Modultyp: Cloud-Native Runtime

Stellt API und Startklasse fuer die cloud-native Variante bereit.

Was macht das Modul?

• enthaelt V05Application
• stellt OrderApi bereit
• verbindet Command, Query und Integration

Ablauf im Gesamtsystem

1. Container startet Runtime.
2. OrderApi nimmt Requests an.
3. Commands, Queries und Integration laufen ueber getrennte Bausteine.

Wichtige Klassen und Dateien

• V05Application
• OrderApi

Verwendete Entwurfsmuster

• API Adapter
• Composition Root
• Modular Runtime

Typischer Einstieg beim Lesen

1. Zuerst dieses README lesen.
2. Dann pom.xml ansehen.
3. Danach die genannten Klassen oeffnen.
4. Am Ende ../../../docs/design-patterns.md lesen und die // PATTERN:-Marker im Code vergleichen.

v03-event-driven-outbox-parent

Eigener Maven-Multi-Module-Workspace.

Start

cd versions/v03-event-driven-outbox-deep-dive
mvn test
mvn package

Modulrichtung

adapters / app -> application -> domain

Muster sind im Code mit // PATTERN: kommentiert und zentral in ../../docs/design-patterns.md dokumentiert.

Projektbeschreibung und Modulablauf

Diese Version enthaelt jetzt eine direkte Ablaufbeschreibung:

• PROJECTS.md / PROJECTS.html: Gesamtuebersicht der Module dieser Version.
• Jedes Maven-Modul besitzt ein eigenes README.md und README.html mit Zweck, Ablauf, wichtigen Klassen und Entwurfsmustern.

V03 Outbox Application

Kurzbeschreibung

Modultyp: Use Case + Outbox Port

Verbindet Bestellablauf mit Outbox-Records, Publisher-Template und Ports fuer robuste Event-Auslieferung.

Was macht das Modul?

• definiert OutboxRecord und OutboxRepository
• definiert MessagePublisher als Port
• stellt OutboxPublisherTemplate bereit

Ablauf im Gesamtsystem

1. PlaceOrderUseCase speichert Order.
2. OutboxRecord wird erzeugt.
3. Template publiziert ueber MessagePublisher.

Wichtige Klassen und Dateien

• PlaceOrderUseCase
• OutboxRecord
• OutboxRepository
• MessagePublisher
• OutboxPublisherTemplate
• OrderRepository

Verwendete Entwurfsmuster

• Transactional Outbox
• Template Method
• Publisher Port
• Application Service

Typischer Einstieg beim Lesen

1. Zuerst dieses README lesen.
2. Dann pom.xml ansehen.
3. Danach die genannten Klassen oeffnen.
4. Am Ende ../../../docs/design-patterns.md lesen und die // PATTERN:-Marker im Code vergleichen.

V03 Order Bootstrap

Kurzbeschreibung

Modultyp: Runtime Composition

Startet die V03-Variante mit Domain Events und Outbox-Fluss.

Was macht das Modul?

• enthaelt V03Application
• verdrahtet Outbox-Anwendung und Adapter
• macht Event-Fluss ausfuehrbar nachvollziehbar

Ablauf im Gesamtsystem

1. Runtime startet V03.
2. Use Case erzeugt Bestellung und Outbox.
3. Publisher wird ueber Adapter eingebunden.

Wichtige Klassen und Dateien

• V03Application

Verwendete Entwurfsmuster

• Composition Root
• Event-Driven Runtime

Typischer Einstieg beim Lesen

1. Zuerst dieses README lesen.
2. Dann pom.xml ansehen.
3. Danach die genannten Klassen oeffnen.
4. Am Ende ../../../docs/design-patterns.md lesen und die // PATTERN:-Marker im Code vergleichen.

V03 Event Domain

Kurzbeschreibung

Modultyp: Event-faehige Domain

Erweitert die Bestellung um Domain Events und OrderPlaced als fachliches Ereignis.

Was macht das Modul?

• definiert DomainEvent
• erzeugt OrderPlaced
• macht Event-Sprache fachlich sichtbar

Ablauf im Gesamtsystem

1. Order wird platziert.
2. Domain erzeugt OrderPlaced.
3. Application uebernimmt Event fuer Outbox-Verarbeitung.

Wichtige Klassen und Dateien

• DomainEvent
• Order
• OrderPlaced

Verwendete Entwurfsmuster

• Domain Event
• Aggregate Root
• Event Modeling

Typischer Einstieg beim Lesen

1. Zuerst dieses README lesen.
2. Dann pom.xml ansehen.
3. Danach die genannten Klassen oeffnen.
4. Am Ende ../../../docs/design-patterns.md lesen und die // PATTERN:-Marker im Code vergleichen.

V03 Outbox Adapter

Kurzbeschreibung

Modultyp: Messaging/Outbox Adapter

Implementiert Outbox-Repository und idempotente Nachrichtenverarbeitung als lernbare Infrastrukturgrenze.

Was macht das Modul?

• stellt InMemoryOutboxRepository bereit
• publiziert Events ueber DefaultOutboxPublisher
• verhindert Doppelverarbeitung mit IdempotentMessagePublisher

Ablauf im Gesamtsystem

1. Application speichert OutboxRecord.
2. DefaultOutboxPublisher liest und publiziert.
3. IdempotentMessagePublisher schuetzt gegen doppelte Messages.

Wichtige Klassen und Dateien

• DefaultOutboxPublisher
• IdempotentMessagePublisher
• InMemoryOutboxRepository

Verwendete Entwurfsmuster

• Outbox Relay
• Idempotent Consumer
• Adapter Pattern

Typischer Einstieg beim Lesen

1. Zuerst dieses README lesen.
2. Dann pom.xml ansehen.
3. Danach die genannten Klassen oeffnen.
4. Am Ende ../../../docs/design-patterns.md lesen und die // PATTERN:-Marker im Code vergleichen.

v04-security-observability-parent

Eigener Maven-Multi-Module-Workspace.

Start

cd versions/v04-security-observability-deep-dive
mvn test
mvn package

Modulrichtung

adapters / app -> application -> domain

Muster sind im Code mit // PATTERN: kommentiert und zentral in ../../docs/design-patterns.md dokumentiert.

Projektbeschreibung und Modulablauf

Diese Version enthaelt jetzt eine direkte Ablaufbeschreibung:

• PROJECTS.md / PROJECTS.html: Gesamtuebersicht der Module dieser Version.
• Jedes Maven-Modul besitzt ein eigenes README.md und README.html mit Zweck, Ablauf, wichtigen Klassen und Entwurfsmustern.

V04 Order Bootstrap

Kurzbeschreibung

Modultyp: Runtime Composition

Verdrahtet Core, Security und Observability zu einer nachvollziehbaren Laufzeitvariante.

Was macht das Modul?

• enthaelt V04Application
• kombiniert Proxy, Policies und Decorators
• zeigt Reihenfolge von Security vor Observability oder umgekehrt

Ablauf im Gesamtsystem

1. Runtime startet V04.
2. Services werden mit Proxy und Decorator verbunden.
3. Aufruf laeuft kontrolliert und beobachtbar durch die Kette.

Wichtige Klassen und Dateien

• V04Application

Verwendete Entwurfsmuster

• Composition Root
• Decorator Chain

Typischer Einstieg beim Lesen

1. Zuerst dieses README lesen.
2. Dann pom.xml ansehen.
3. Danach die genannten Klassen oeffnen.
4. Am Ende ../../../docs/design-patterns.md lesen und die // PATTERN:-Marker im Code vergleichen.

V04 Order Core

Kurzbeschreibung

Modultyp: Core Query/Rules

Buendelt Query-Service und Spezifikationen als fachlichen Kern fuer Security- und Observability-Dekorationen.

Was macht das Modul?

• stellt OrderQueryService bereit
• implementiert DefaultOrderQueryService
• definiert HighValueOrderSpecification

Ablauf im Gesamtsystem

1. Query wird angefordert.
2. Security Proxy prueft Zugriff.
3. Core Service liefert Daten und Specification bewertet Risiko.

Wichtige Klassen und Dateien

• OrderQueryService
• DefaultOrderQueryService
• HighValueOrderSpecification

Verwendete Entwurfsmuster

• Specification
• Service Interface
• Core Domain Service

Typischer Einstieg beim Lesen

1. Zuerst dieses README lesen.
2. Dann pom.xml ansehen.
3. Danach die genannten Klassen oeffnen.
4. Am Ende ../../../docs/design-patterns.md lesen und die // PATTERN:-Marker im Code vergleichen.

V04 Order Observability

Kurzbeschreibung

Modultyp: Audit/Metrics Decorator

Fuegt Audit und Metriken hinzu, ohne den Kernservice mit Querschnittslogik zu vermischen.

Was macht das Modul?

• stellt AuditedOrderService bereit
• stellt MeteredOrderService bereit
• zeigt beobachtbare Service-Ketten

Ablauf im Gesamtsystem

1. Service-Aufruf geht durch Decorator.
2. Audit zeichnet fachlichen Zugriff auf.
3. Metering erfasst technische Kennzahlen.

Wichtige Klassen und Dateien

• AuditedOrderService
• MeteredOrderService

Verwendete Entwurfsmuster

• Decorator Pattern
• Audit Trail
• Metrics Wrapper

Typischer Einstieg beim Lesen

1. Zuerst dieses README lesen.
2. Dann pom.xml ansehen.
3. Danach die genannten Klassen oeffnen.
4. Am Ende ../../../docs/design-patterns.md lesen und die // PATTERN:-Marker im Code vergleichen.

V04 Order Security

Kurzbeschreibung

Modultyp: Security Boundary

Zeigt Zugriffskontrolle, Approval Policies und Security Proxy rund um fachliche Services.

Was macht das Modul?

• stellt SecurityContext bereit
• definiert ApprovalPolicy und konkrete Policies
• sichert Query Service ueber SecuredOrderQueryProxy

Ablauf im Gesamtsystem

1. Client ruft Query/Approval an.
2. Security Proxy prueft Context.
3. ApprovalPolicy entscheidet nach Rolle/Risiko.

Wichtige Klassen und Dateien

• SecurityContext
• ApprovalPolicy
• ManagerApprovalPolicy
• RiskOfficerApprovalPolicy
• SecuredOrderQueryProxy

Verwendete Entwurfsmuster

• Proxy Pattern
• Policy Pattern
• Chain of Responsibility

Typischer Einstieg beim Lesen

1. Zuerst dieses README lesen.
2. Dann pom.xml ansehen.
3. Danach die genannten Klassen oeffnen.
4. Am Ende ../../../docs/design-patterns.md lesen und die // PATTERN:-Marker im Code vergleichen.

v01-modular-baseline-parent

Eigener Maven-Multi-Module-Workspace.

Start

cd versions/v01-modular-baseline
mvn test
mvn package

Modulrichtung

adapters / app -> application -> domain

Muster sind im Code mit // PATTERN: kommentiert und zentral in ../../docs/design-patterns.md dokumentiert.

Projektbeschreibung und Modulablauf

Diese Version enthaelt jetzt eine direkte Ablaufbeschreibung:

• PROJECTS.md / PROJECTS.html: Gesamtuebersicht der Module dieser Version.
• Jedes Maven-Modul besitzt ein eigenes README.md und README.html mit Zweck, Ablauf, wichtigen Klassen und Entwurfsmustern.

V01 Order App

Kurzbeschreibung

Modultyp: Bootstrap / Inbound Adapter

Startet die einfache Anwendung und stellt einen REST-nahen Einstieg in den Bestellprozess dar.

Was macht das Modul?

• enthaelt V01Application als Startpunkt
• enthaelt OrderController als Eingangsadapter
• verdrahtet Application und Adapter didaktisch einfach

Ablauf im Gesamtsystem

1. HTTP/Controller-Aufruf kommt herein.
2. Controller baut ein Command.
3. Use Case verarbeitet und speichert ueber den Adapter.

Wichtige Klassen und Dateien

• V01Application
• OrderController

Verwendete Entwurfsmuster

• Controller
• Composition Root
• Dependency Injection

Typischer Einstieg beim Lesen

1. Zuerst dieses README lesen.
2. Dann pom.xml ansehen.
3. Danach die genannten Klassen oeffnen.
4. Am Ende ../../../docs/design-patterns.md lesen und die // PATTERN:-Marker im Code vergleichen.

v02-clean-architecture-parent

Eigener Maven-Multi-Module-Workspace.

Start

cd versions/v02-clean-architecture-deep-dive
mvn test
mvn package

Modulrichtung

adapters / app -> application -> domain

Muster sind im Code mit // PATTERN: kommentiert und zentral in ../../docs/design-patterns.md dokumentiert.

Projektbeschreibung und Modulablauf

Diese Version enthaelt jetzt eine direkte Ablaufbeschreibung:

• PROJECTS.md / PROJECTS.html: Gesamtuebersicht der Module dieser Version.
• Jedes Maven-Modul besitzt ein eigenes README.md und README.html mit Zweck, Ablauf, wichtigen Klassen und Entwurfsmustern.

V02 Order Bootstrap

Kurzbeschreibung

Modultyp: Runtime Composition

Verdrahtet Clean-Architecture-Bausteine in einer lauffaehigen Startkonfiguration.

Was macht das Modul?

• enthaelt Startklasse V02Application
• zeigt Composition Root fuer V02
• haelt technische Verdrahtung ausserhalb der Domain

Ablauf im Gesamtsystem

1. Application startet.
2. Bootstrap erzeugt/verdrahtet Use Cases und Adapter.
3. Requests laufen durch Controller, Use Case und Repository.

Wichtige Klassen und Dateien

• V02Application

Verwendete Entwurfsmuster

• Composition Root
• Dependency Injection

Typischer Einstieg beim Lesen

1. Zuerst dieses README lesen.
2. Dann pom.xml ansehen.
3. Danach die genannten Klassen oeffnen.
4. Am Ende ../../../docs/design-patterns.md lesen und die // PATTERN:-Marker im Code vergleichen.

v05-cloud-native-ops-parent

Eigener Maven-Multi-Module-Workspace.

Start

cd versions/v05-cloud-native-ops-deep-dive
mvn test
mvn package

Modulrichtung

adapters / app -> application -> domain

Muster sind im Code mit // PATTERN: kommentiert und zentral in ../../docs/design-patterns.md dokumentiert.

Projektbeschreibung und Modulablauf

Diese Version enthaelt jetzt eine direkte Ablaufbeschreibung:

• PROJECTS.md / PROJECTS.html: Gesamtuebersicht der Module dieser Version.
• Jedes Maven-Modul besitzt ein eigenes README.md und README.html mit Zweck, Ablauf, wichtigen Klassen und Entwurfsmustern.

V05 Order Command

Kurzbeschreibung

Modultyp: Command/CQRS Write Side

Enthaelt die schreibende Seite fuer Bestellungen mit Command Handler und SubmitOrderCommand.

Was macht das Modul?

• definiert SubmitOrderCommand
• verarbeitet Commands im OrderCommandHandler
• trennt Schreibmodell vom Lesemodell

Ablauf im Gesamtsystem

1. API erzeugt SubmitOrderCommand.
2. Command Handler validiert und verarbeitet.
3. Integration/Saga kann nachgelagert reagieren.

Wichtige Klassen und Dateien

• SubmitOrderCommand
• OrderCommandHandler

Verwendete Entwurfsmuster

• CQRS
• Command Handler
• Command Pattern

Typischer Einstieg beim Lesen

1. Zuerst dieses README lesen.
2. Dann pom.xml ansehen.
3. Danach die genannten Klassen oeffnen.
4. Am Ende ../../../docs/design-patterns.md lesen und die // PATTERN:-Marker im Code vergleichen.

V05 Order Query

Kurzbeschreibung

Modultyp: CQRS Read Side

Zeigt ein separates Lesemodell und Query Handler fuer schnelle fachliche Abfragen.

Was macht das Modul?

• definiert OrderReadModel
• stellt OrderQueryHandler bereit
• trennt Lesen von Schreiben

Ablauf im Gesamtsystem

1. API fragt Query Handler.
2. Read Model liefert optimierte Sicht.
3. Schreibmodell bleibt unabhaengig.

Wichtige Klassen und Dateien

• OrderReadModel
• OrderQueryHandler

Verwendete Entwurfsmuster

• CQRS
• Read Model
• Query Handler

Typischer Einstieg beim Lesen

1. Zuerst dieses README lesen.
2. Dann pom.xml ansehen.
3. Danach die genannten Klassen oeffnen.
4. Am Ende ../../../docs/design-patterns.md lesen und die // PATTERN:-Marker im Code vergleichen.