Master 13 - Logistics / Supply Chain System

Fertiges runnable Enterprise-Demo-System mit Beschreibung, Ablauf, SVG und Java-Code.

README

Überblick

Runnable

Start und Smoke Flow

Ablauf und Funktion

Textuelle Beschreibung

Projektbeschreibungen

Module und Abläufe

Entwurfsmuster

Pattern pro Modul

SVG Galerie

Kompakte Erklärbilder

Prüfbericht

Qualität und ZIP

Produktionsreferenz: Shipment & Tracking

Lehrbuch und Praxis

Was lerne ich hier?

◎

Fachlicher Kern

Logistik

⚙

Technischer Fokus

Wie Statusketten, Events und externe Adapter zusammenkommen.

★

Warum wichtig?

Auftrag, Lagerreservierung, Versand, Tracking, Retouren und Carrier-Integration.

✓

Lernziel

Du erkennst Zweck, Ablauf, Modulgrenzen und Betriebsbezug dieses Masters.

Fachliches Mini-Szenario

Szenario: Ein Auftrag reserviert Bestand, Pick & Pack bereitet Lieferung vor, ein Carrier übernimmt Versand, Tracking meldet Status und Retouren werden kontrolliert abgewickelt.
?

Fachliche Frage

Welche Geschäftsentscheidung wird hier unterstützt und welche Daten müssen nachvollziehbar bleiben?

?

Technische Frage

Welche Module sind wirklich Fachkern und welche sind nur Adapter, Runtime oder Infrastruktur?

Fachliches und technisches SVG

Fachlicher AblaufAuftragReservierungVersandTrackingRetoure
Technischer AblaufREST/APIUse CaseDomainRepositoryOutbox/EventAdapter

Die zwei SVGs trennen bewusst Fachlichkeit und Technik. Dadurch sieht man, ob ein Thema wirklich fachlich ist oder nur eine technische Umsetzungsschicht darstellt.

Modulkarte

Domain / Fachmodell
Application / Use Cases
Adapter / Infrastruktur
Runtime / Start
Qualität / Betrieb
Dokumentation / Lernen
Leseregel: Starte immer beim Fachmodell und gehe erst danach in Adapter, Runtime und Plattform. So bleibt die Architektur verständlich.

Start, Runtime und praktische Nutzung

▶

Schnellstart

Öffne RUNNABLE.html oder nutze den Smoke-Start im jeweiligen Workspace.

☕

Spring/Jakarta

Wo vorhanden, ergänzen Spring Boot oder Jakarta eine echte Runtime. Smoke bleibt der robuste Minimalstart.

▣

Container

Bei Container-Mastern helfen Compose, Kubernetes und OpenShift-Profile beim Betriebsverständnis.

mvn -q -pl runnable-smoke -am package exec:java

Was ist Demo, was wäre Produktion?

  • Demo: lokale Startbarkeit, vereinfachte Adapter, nachvollziehbare Abläufe.
  • Produktionsnah: klare Modulgrenzen, dokumentierte Patterns, Container-/Runtime-Profile und Betriebsdenken.
  • Noch zu ergänzen für echte Produktion: echte Secrets, echte Infrastruktur, Security-Härtung, Lasttests und verbindliche Compliance-Vorgaben.

Weiter im Projekt

Diese Links führen aus dem Lehrbuch in die eigentliche Projektstruktur.

README RUNNABLE Projektbeschreibungen Design Patterns
Final UI & Lehrbuch Upgrade · Kacheln, zwei SVG-Perspektiven, Mini-Szenario und bessere Leseführung.

Module und Quellcode

Du bist hierIMPL SCM LogistikModule
37 Module11 KategorienInhalte vollständig übernommen

API & Application 7

jakarta-rest-apiAPI & Application
Codepfad: mvn-ws-impl-scm/jakarta-rest-api
Verantwortung

Dieses Modul ist Teil von Master 13 - Logistics / Supply Chain System und kapselt die Verantwortung jakarta-rest-api.

Architekturbausteine
  • Adapter: fachliche Grenze.
  • Anti-Corruption Layer: stabile Fachwerte.
  • Facade: pruefbare Entscheidung.
  • Repository: entkoppelte Weitergabe.
order-applicationAPI & Application
Codepfad: mvn-ws-impl-scm/order-application
Verantwortung

Dieses Modul ist Teil von Master 13 - Logistics / Supply Chain System und kapselt die Verantwortung order-application.

Architekturbausteine
  • Application Service: fachliche Grenze.
  • Command Handler: stabile Fachwerte.
  • Pipeline: pruefbare Entscheidung.
  • Result Object: entkoppelte Weitergabe.
rest-api-springAPI & Application
Codepfad: mvn-ws-impl-scm/rest-api-spring
Verantwortung

Dieses Modul ist Teil von Master 13 - Logistics / Supply Chain System und kapselt die Verantwortung rest-api-spring.

Architekturbausteine
  • Adapter: fachliche Grenze.
  • Anti-Corruption Layer: stabile Fachwerte.
  • Facade: pruefbare Entscheidung.
  • Repository: entkoppelte Weitergabe.
returns-applicationAPI & Application
Codepfad: mvn-ws-impl-scm/returns-application
Verantwortung

Dieses Modul ist Teil von Master 13 - Logistics / Supply Chain System und kapselt die Verantwortung returns-application.

Architekturbausteine
  • Application Service: fachliche Grenze.
  • Command Handler: stabile Fachwerte.
  • Pipeline: pruefbare Entscheidung.
  • Result Object: entkoppelte Weitergabe.
shipment-applicationAPI & Application
Codepfad: mvn-ws-impl-scm/shipment-application
Verantwortung

Dieses Modul ist Teil von Master 13 - Logistics / Supply Chain System und kapselt die Verantwortung shipment-application.

Architekturbausteine
  • Application Service: fachliche Grenze.
  • Command Handler: stabile Fachwerte.
  • Pipeline: pruefbare Entscheidung.
  • Result Object: entkoppelte Weitergabe.
tracking-applicationAPI & Application
Codepfad: mvn-ws-impl-scm/tracking-application
Verantwortung

Dieses Modul ist Teil von Master 13 - Logistics / Supply Chain System und kapselt die Verantwortung tracking-application.

Architekturbausteine
  • Application Service: fachliche Grenze.
  • Command Handler: stabile Fachwerte.
  • Pipeline: pruefbare Entscheidung.
  • Result Object: entkoppelte Weitergabe.
warehouse-applicationAPI & Application
Codepfad: mvn-ws-impl-scm/warehouse-application
Verantwortung

Dieses Modul ist Teil von Master 13 - Logistics / Supply Chain System und kapselt die Verantwortung warehouse-application.

Architekturbausteine
  • Application Service: fachliche Grenze.
  • Command Handler: stabile Fachwerte.
  • Pipeline: pruefbare Entscheidung.
  • Result Object: entkoppelte Weitergabe.

Adapter & Integration 4

carrier-adapterAdapter & Integration
Codepfad: mvn-ws-impl-scm/carrier-adapter
Verantwortung

Dieses Modul ist Teil von Master 13 - Logistics / Supply Chain System und kapselt die Verantwortung carrier-adapter.

Architekturbausteine
  • Adapter: fachliche Grenze.
  • Anti-Corruption Layer: stabile Fachwerte.
  • Facade: pruefbare Entscheidung.
  • Repository: entkoppelte Weitergabe.
sftp-partner-adapterAdapter & Integration
Codepfad: mvn-ws-impl-scm/sftp-partner-adapter
Verantwortung

Dieses Modul ist Teil von Master 13 - Logistics / Supply Chain System und kapselt die Verantwortung sftp-partner-adapter.

Architekturbausteine
  • Adapter: fachliche Grenze.
  • Anti-Corruption Layer: stabile Fachwerte.
  • Facade: pruefbare Entscheidung.
  • Repository: entkoppelte Weitergabe.
tracking-adapterAdapter & Integration
Codepfad: mvn-ws-impl-scm/tracking-adapter
Verantwortung

Dieses Modul ist Teil von Master 13 - Logistics / Supply Chain System und kapselt die Verantwortung tracking-adapter.

Architekturbausteine
  • Adapter: fachliche Grenze.
  • Anti-Corruption Layer: stabile Fachwerte.
  • Facade: pruefbare Entscheidung.
  • Repository: entkoppelte Weitergabe.
warehouse-adapterAdapter & Integration
Codepfad: mvn-ws-impl-scm/warehouse-adapter
Verantwortung

Dieses Modul ist Teil von Master 13 - Logistics / Supply Chain System und kapselt die Verantwortung warehouse-adapter.

Architekturbausteine
  • Adapter: fachliche Grenze.
  • Anti-Corruption Layer: stabile Fachwerte.
  • Facade: pruefbare Entscheidung.
  • Repository: entkoppelte Weitergabe.

Daten & Storage 1

postgres-adapterDaten & Storage
Codepfad: mvn-ws-impl-scm/postgres-adapter
Verantwortung

Dieses Modul ist Teil von Master 13 - Logistics / Supply Chain System und kapselt die Verantwortung postgres-adapter.

Architekturbausteine
  • Adapter: fachliche Grenze.
  • Anti-Corruption Layer: stabile Fachwerte.
  • Facade: pruefbare Entscheidung.
  • Repository: entkoppelte Weitergabe.

Deployment 1

devops-openshiftDeployment
Codepfad: mvn-ws-impl-scm/devops-openshift
Verantwortung

Dieses Modul ist Teil von Master 13 - Logistics / Supply Chain System und kapselt die Verantwortung devops-openshift.

Architekturbausteine
  • Outbox: fachliche Grenze.
  • Saga: stabile Fachwerte.
  • CQRS Projection: pruefbare Entscheidung.
  • Health Check: entkoppelte Weitergabe.

Domain 15

billing-domainDomain
Codepfad: mvn-ws-impl-scm/billing-domain
Verantwortung

Dieses Modul ist Teil von Master 13 - Logistics / Supply Chain System und kapselt die Verantwortung billing-domain.

Architekturbausteine
  • Aggregate Root: fachliche Grenze.
  • Value Object: stabile Fachwerte.
  • Specification: pruefbare Entscheidung.
  • Domain Event: entkoppelte Weitergabe.
carrier-domainDomain
Codepfad: mvn-ws-impl-scm/carrier-domain
Verantwortung

Dieses Modul ist Teil von Master 13 - Logistics / Supply Chain System und kapselt die Verantwortung carrier-domain.

Architekturbausteine
  • Aggregate Root: fachliche Grenze.
  • Value Object: stabile Fachwerte.
  • Specification: pruefbare Entscheidung.
  • Domain Event: entkoppelte Weitergabe.
cqrs-readmodelDomain
Codepfad: mvn-ws-impl-scm/cqrs-readmodel
Verantwortung

Dieses Modul ist Teil von Master 13 - Logistics / Supply Chain System und kapselt die Verantwortung cqrs-readmodel.

Architekturbausteine
  • Aggregate Root: fachliche Grenze.
  • Value Object: stabile Fachwerte.
  • Specification: pruefbare Entscheidung.
  • Domain Event: entkoppelte Weitergabe.
customs-domainDomain
Codepfad: mvn-ws-impl-scm/customs-domain
Verantwortung

Dieses Modul ist Teil von Master 13 - Logistics / Supply Chain System und kapselt die Verantwortung customs-domain.

Architekturbausteine
  • Aggregate Root: fachliche Grenze.
  • Value Object: stabile Fachwerte.
  • Specification: pruefbare Entscheidung.
  • Domain Event: entkoppelte Weitergabe.
inventory-domainDomain
Codepfad: mvn-ws-impl-scm/inventory-domain
Verantwortung

Dieses Modul ist Teil von Master 13 - Logistics / Supply Chain System und kapselt die Verantwortung inventory-domain.

Architekturbausteine
  • Aggregate Root: fachliche Grenze.
  • Value Object: stabile Fachwerte.
  • Specification: pruefbare Entscheidung.
  • Domain Event: entkoppelte Weitergabe.
order-domainDomain
Codepfad: mvn-ws-impl-scm/order-domain
Verantwortung

Dieses Modul ist Teil von Master 13 - Logistics / Supply Chain System und kapselt die Verantwortung order-domain.

Architekturbausteine
  • Aggregate Root: fachliche Grenze.
  • Value Object: stabile Fachwerte.
  • Specification: pruefbare Entscheidung.
  • Domain Event: entkoppelte Weitergabe.
packing-domainDomain
Codepfad: mvn-ws-impl-scm/packing-domain
Verantwortung

Dieses Modul ist Teil von Master 13 - Logistics / Supply Chain System und kapselt die Verantwortung packing-domain.

Architekturbausteine
  • Aggregate Root: fachliche Grenze.
  • Value Object: stabile Fachwerte.
  • Specification: pruefbare Entscheidung.
  • Domain Event: entkoppelte Weitergabe.
picking-domainDomain
Codepfad: mvn-ws-impl-scm/picking-domain
Verantwortung

Dieses Modul ist Teil von Master 13 - Logistics / Supply Chain System und kapselt die Verantwortung picking-domain.

Architekturbausteine
  • Aggregate Root: fachliche Grenze.
  • Value Object: stabile Fachwerte.
  • Specification: pruefbare Entscheidung.
  • Domain Event: entkoppelte Weitergabe.
reporting-domainDomain
Codepfad: mvn-ws-impl-scm/reporting-domain
Verantwortung

Dieses Modul ist Teil von Master 13 - Logistics / Supply Chain System und kapselt die Verantwortung reporting-domain.

Architekturbausteine
  • Aggregate Root: fachliche Grenze.
  • Value Object: stabile Fachwerte.
  • Specification: pruefbare Entscheidung.
  • Domain Event: entkoppelte Weitergabe.
returns-domainDomain
Codepfad: mvn-ws-impl-scm/returns-domain
Verantwortung

Dieses Modul ist Teil von Master 13 - Logistics / Supply Chain System und kapselt die Verantwortung returns-domain.

Architekturbausteine
  • Aggregate Root: fachliche Grenze.
  • Value Object: stabile Fachwerte.
  • Specification: pruefbare Entscheidung.
  • Domain Event: entkoppelte Weitergabe.
shipment-domainDomain
Codepfad: mvn-ws-impl-scm/shipment-domain
Verantwortung

Dieses Modul ist Teil von Master 13 - Logistics / Supply Chain System und kapselt die Verantwortung shipment-domain.

Architekturbausteine
  • Aggregate Root: fachliche Grenze.
  • Value Object: stabile Fachwerte.
  • Specification: pruefbare Entscheidung.
  • Domain Event: entkoppelte Weitergabe.
supplier-domainDomain
Codepfad: mvn-ws-impl-scm/supplier-domain
Verantwortung

Dieses Modul ist Teil von Master 13 - Logistics / Supply Chain System und kapselt die Verantwortung supplier-domain.

Architekturbausteine
  • Aggregate Root: fachliche Grenze.
  • Value Object: stabile Fachwerte.
  • Specification: pruefbare Entscheidung.
  • Domain Event: entkoppelte Weitergabe.
tracking-domainDomain
Codepfad: mvn-ws-impl-scm/tracking-domain
Verantwortung

Dieses Modul ist Teil von Master 13 - Logistics / Supply Chain System und kapselt die Verantwortung tracking-domain.

Architekturbausteine
  • Aggregate Root: fachliche Grenze.
  • Value Object: stabile Fachwerte.
  • Specification: pruefbare Entscheidung.
  • Domain Event: entkoppelte Weitergabe.
transport-domainDomain
Codepfad: mvn-ws-impl-scm/transport-domain
Verantwortung

Dieses Modul ist Teil von Master 13 - Logistics / Supply Chain System und kapselt die Verantwortung transport-domain.

Architekturbausteine
  • Aggregate Root: fachliche Grenze.
  • Value Object: stabile Fachwerte.
  • Specification: pruefbare Entscheidung.
  • Domain Event: entkoppelte Weitergabe.
warehouse-domainDomain
Codepfad: mvn-ws-impl-scm/warehouse-domain
Verantwortung

Dieses Modul ist Teil von Master 13 - Logistics / Supply Chain System und kapselt die Verantwortung warehouse-domain.

Architekturbausteine
  • Aggregate Root: fachliche Grenze.
  • Value Object: stabile Fachwerte.
  • Specification: pruefbare Entscheidung.
  • Domain Event: entkoppelte Weitergabe.

Infrastructure 2

state-machine-platformInfrastructure
Codepfad: mvn-ws-impl-scm/state-machine-platform
Verantwortung

Dieses Modul ist Teil von Master 13 - Logistics / Supply Chain System und kapselt die Verantwortung state-machine-platform.

Architekturbausteine
  • Outbox: fachliche Grenze.
  • Saga: stabile Fachwerte.
  • CQRS Projection: pruefbare Entscheidung.
  • Health Check: entkoppelte Weitergabe.
workflow-platformInfrastructure
Codepfad: mvn-ws-impl-scm/workflow-platform
Verantwortung

Dieses Modul ist Teil von Master 13 - Logistics / Supply Chain System und kapselt die Verantwortung workflow-platform.

Architekturbausteine
  • Outbox: fachliche Grenze.
  • Saga: stabile Fachwerte.
  • CQRS Projection: pruefbare Entscheidung.
  • Health Check: entkoppelte Weitergabe.

Messaging 1

event-outboxMessaging
Codepfad: mvn-ws-impl-scm/event-outbox
Verantwortung

Dieses Modul ist Teil von Master 13 - Logistics / Supply Chain System und kapselt die Verantwortung event-outbox.

Architekturbausteine
  • Outbox: fachliche Grenze.
  • Saga: stabile Fachwerte.
  • CQRS Projection: pruefbare Entscheidung.
  • Health Check: entkoppelte Weitergabe.

Observability 1

observability-platformObservability
Codepfad: mvn-ws-impl-scm/observability-platform
Verantwortung

Dieses Modul ist Teil von Master 13 - Logistics / Supply Chain System und kapselt die Verantwortung observability-platform.

Architekturbausteine
  • Outbox: fachliche Grenze.
  • Saga: stabile Fachwerte.
  • CQRS Projection: pruefbare Entscheidung.
  • Health Check: entkoppelte Weitergabe.

Security 1

security-platformSecurity
Codepfad: mvn-ws-impl-scm/security-platform
Verantwortung

Dieses Modul ist Teil von Master 13 - Logistics / Supply Chain System und kapselt die Verantwortung security-platform.

Architekturbausteine
  • Outbox: fachliche Grenze.
  • Saga: stabile Fachwerte.
  • CQRS Projection: pruefbare Entscheidung.
  • Health Check: entkoppelte Weitergabe.

Testing 3

architecture-testsTesting
Codepfad: mvn-ws-impl-scm/architecture-tests
Verantwortung

Dieses Modul ist Teil von Master 13 - Logistics / Supply Chain System und kapselt die Verantwortung architecture-tests.

Architekturbausteine
  • Golden Master: fachliche Grenze.
  • Contract Test: stabile Fachwerte.
  • Architecture Rule: pruefbare Entscheidung.
  • Fixture Builder: entkoppelte Weitergabe.
contract-testsTesting
Codepfad: mvn-ws-impl-scm/contract-tests
Verantwortung

Dieses Modul ist Teil von Master 13 - Logistics / Supply Chain System und kapselt die Verantwortung contract-tests.

Architekturbausteine
  • Golden Master: fachliche Grenze.
  • Contract Test: stabile Fachwerte.
  • Architecture Rule: pruefbare Entscheidung.
  • Fixture Builder: entkoppelte Weitergabe.
runnable-smokeTesting
Codepfad: mvn-ws-impl-scm/runnable-smoke
Verantwortung

Dieses Modul ist Teil von Master 13 - Logistics / Supply Chain System und kapselt die Verantwortung runnable-smoke.

Architekturbausteine
  • Aggregate Root: fachliche Grenze.
  • Value Object: stabile Fachwerte.
  • Specification: pruefbare Entscheidung.
  • Domain Event: entkoppelte Weitergabe.

Weitere Module 1

migration-toolsWeitere Module
Codepfad: mvn-ws-impl-scm/migration-tools
Verantwortung

Dieses Modul ist Teil von Master 13 - Logistics / Supply Chain System und kapselt die Verantwortung migration-tools.

Architekturbausteine
  • Application Service: fachliche Grenze.
  • Command Handler: stabile Fachwerte.
  • Pipeline: pruefbare Entscheidung.
  • Result Object: entkoppelte Weitergabe.

SCM Reference Application

Shipment, Tracking, Transport Order, Proof of Delivery, Persistenz und Tests.

Maven-Modul · Dokumentation

Projektübersicht · Master 13 README

Master 13 README

Logistics / Supply Chain System

ZielStartInhalt

Master 13 - Logistics / Supply Chain System

Ziel

Komplexes fertiges Demo-System mit Java-Code, Maven-Modulen, Ablaufbeschreibung, SVGs, Pattern-Dokumentation und runnable Smoke Flow.

Start

cd mvn-ws-impl-scm
mvn -q -pl runnable-smoke -am package exec:java

Inhalt

Start und Runtime · Master 13 Runnable

Master 13 Runnable

Logistics / Supply Chain System

StartErwarteter Smoke FlowHinweis

RUNNABLE Master 13

Start

cd mvn-ws-impl-scm
mvn -q -pl runnable-smoke -am package exec:java

Erwarteter Smoke Flow

Order Intake, Inventory Reservation, Pick Pack, Carrier Booking, Shipment Tracking, Customs Check, Return Handling, Service Report

Hinweis

Der Smoke Flow ist bewusst ohne externe Infrastruktur lauffaehig.

⌂ Cockpit