◎
Fachlicher Kern
Legacy
Master 14 - Legacy Refactoring and Migration 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
Lehrbuch und Praxis
Was lerne ich hier?
⚙
Technischer Fokus
Wie alte Systeme verstanden, stabilisiert, refactored und migriert werden.
★
Warum wichtig?
Altcode, Monster Methods, Anti-Corruption Layer, Strangler und Migration Report.
✓
Lernziel
Du erkennst Zweck, Ablauf, Modulgrenzen und Betriebsbezug dieses Masters.
Fachliches Mini-Szenario
Szenario: Ein Legacy-Datensatz wird gelesen, im Anti-Corruption Layer übersetzt, im modernen Modell validiert und als Migration Report nachvollziehbar dokumentiert.
?
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
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.
Module und Quellcode
33 Module10 KategorienInhalte vollständig übernommen
API & Application 2
jakarta-modern-apiAPI & Application
Codepfad:
mvn-ws-acl-strangler/jakarta-modern-apiVerantwortung
Dieses Modul ist Teil von Master 14 - Legacy Refactoring and Migration System und kapselt die Verantwortung jakarta-modern-api.
Architekturbausteine
- Adapter: fachliche Grenze.
- Anti-Corruption Layer: stabile Fachwerte.
- Facade: pruefbare Entscheidung.
- Repository: entkoppelte Weitergabe.
modern-rest-api-springAPI & Application
Verantwortung
Dieses Modul ist Teil von Master 14 - Legacy Refactoring and Migration System und kapselt die Verantwortung modern-rest-api-spring.
Architekturbausteine
- Adapter: fachliche Grenze.
- Anti-Corruption Layer: stabile Fachwerte.
- Facade: pruefbare Entscheidung.
- Repository: entkoppelte Weitergabe.
Adapter & Integration 1
legacy-soap-simulationAdapter & Integration
Verantwortung
Dieses Modul ist Teil von Master 14 - Legacy Refactoring and Migration System und kapselt die Verantwortung legacy-soap-simulation.
Architekturbausteine
- Aggregate Root: fachliche Grenze.
- Value Object: stabile Fachwerte.
- Specification: pruefbare Entscheidung.
- Domain Event: entkoppelte Weitergabe.
Daten & Storage 2
legacy-oracle-proceduresDaten & Storage
Verantwortung
Dieses Modul ist Teil von Master 14 - Legacy Refactoring and Migration System und kapselt die Verantwortung legacy-oracle-procedures.
Architekturbausteine
- Aggregate Root: fachliche Grenze.
- Value Object: stabile Fachwerte.
- Specification: pruefbare Entscheidung.
- Domain Event: entkoppelte Weitergabe.
oracle-to-postgres-adapterDaten & Storage
Verantwortung
Dieses Modul ist Teil von Master 14 - Legacy Refactoring and Migration System und kapselt die Verantwortung oracle-to-postgres-adapter.
Architekturbausteine
- Adapter: fachliche Grenze.
- Anti-Corruption Layer: stabile Fachwerte.
- Facade: pruefbare Entscheidung.
- Repository: entkoppelte Weitergabe.
Deployment 1
devops-openshiftDeployment
Codepfad:
mvn-ws-acl-strangler/devops-openshiftVerantwortung
Dieses Modul ist Teil von Master 14 - Legacy Refactoring and Migration System und kapselt die Verantwortung devops-openshift.
Architekturbausteine
- Outbox: fachliche Grenze.
- Saga: stabile Fachwerte.
- CQRS Projection: pruefbare Entscheidung.
- Health Check: entkoppelte Weitergabe.
Domain 4
domain-extractionDomain
Codepfad:
mvn-ws-acl-strangler/domain-extractionVerantwortung
Dieses Modul ist Teil von Master 14 - Legacy Refactoring and Migration System und kapselt die Verantwortung domain-extraction.
Architekturbausteine
- Aggregate Root: fachliche Grenze.
- Value Object: stabile Fachwerte.
- Specification: pruefbare Entscheidung.
- Domain Event: entkoppelte Weitergabe.
refactored-billing-domainDomain
Verantwortung
Dieses Modul ist Teil von Master 14 - Legacy Refactoring and Migration System und kapselt die Verantwortung refactored-billing-domain.
Architekturbausteine
- Aggregate Root: fachliche Grenze.
- Value Object: stabile Fachwerte.
- Specification: pruefbare Entscheidung.
- Domain Event: entkoppelte Weitergabe.
refactored-customer-domainDomain
Verantwortung
Dieses Modul ist Teil von Master 14 - Legacy Refactoring and Migration System und kapselt die Verantwortung refactored-customer-domain.
Architekturbausteine
- Aggregate Root: fachliche Grenze.
- Value Object: stabile Fachwerte.
- Specification: pruefbare Entscheidung.
- Domain Event: entkoppelte Weitergabe.
refactored-order-domainDomain
Verantwortung
Dieses Modul ist Teil von Master 14 - Legacy Refactoring and Migration System und kapselt die Verantwortung refactored-order-domain.
Architekturbausteine
- Aggregate Root: fachliche Grenze.
- Value Object: stabile Fachwerte.
- Specification: pruefbare Entscheidung.
- Domain Event: entkoppelte Weitergabe.
Messaging 2
legacy-jms-simulationMessaging
Verantwortung
Dieses Modul ist Teil von Master 14 - Legacy Refactoring and Migration System und kapselt die Verantwortung legacy-jms-simulation.
Architekturbausteine
- Aggregate Root: fachliche Grenze.
- Value Object: stabile Fachwerte.
- Specification: pruefbare Entscheidung.
- Domain Event: entkoppelte Weitergabe.
outbox-bridgeMessaging
Codepfad:
mvn-ws-acl-strangler/outbox-bridgeVerantwortung
Dieses Modul ist Teil von Master 14 - Legacy Refactoring and Migration System und kapselt die Verantwortung outbox-bridge.
Architekturbausteine
- Adapter: fachliche Grenze.
- Anti-Corruption Layer: stabile Fachwerte.
- Facade: pruefbare Entscheidung.
- Repository: entkoppelte Weitergabe.
Observability 1
observability-modernizationObservability
Verantwortung
Dieses Modul ist Teil von Master 14 - Legacy Refactoring and Migration System und kapselt die Verantwortung observability-modernization.
Architekturbausteine
- Outbox: fachliche Grenze.
- Saga: stabile Fachwerte.
- CQRS Projection: pruefbare Entscheidung.
- Health Check: entkoppelte Weitergabe.
Security 1
security-modernizationSecurity
Verantwortung
Dieses Modul ist Teil von Master 14 - Legacy Refactoring and Migration System und kapselt die Verantwortung security-modernization.
Architekturbausteine
- Outbox: fachliche Grenze.
- Saga: stabile Fachwerte.
- CQRS Projection: pruefbare Entscheidung.
- Health Check: entkoppelte Weitergabe.
Testing 5
architecture-testsTesting
Codepfad:
mvn-ws-acl-strangler/architecture-testsVerantwortung
Dieses Modul ist Teil von Master 14 - Legacy Refactoring and Migration System und kapselt die Verantwortung architecture-tests.
Architekturbausteine
- Golden Master: fachliche Grenze.
- Contract Test: stabile Fachwerte.
- Architecture Rule: pruefbare Entscheidung.
- Fixture Builder: entkoppelte Weitergabe.
characterization-regression-testsTesting
Verantwortung
Dieses Modul ist Teil von Master 14 - Legacy Refactoring and Migration System und kapselt die Verantwortung characterization-regression-tests.
Architekturbausteine
- Golden Master: fachliche Grenze.
- Contract Test: stabile Fachwerte.
- Architecture Rule: pruefbare Entscheidung.
- Fixture Builder: entkoppelte Weitergabe.
characterization-testsTesting
Verantwortung
Dieses Modul ist Teil von Master 14 - Legacy Refactoring and Migration System und kapselt die Verantwortung characterization-tests.
Architekturbausteine
- Golden Master: fachliche Grenze.
- Contract Test: stabile Fachwerte.
- Architecture Rule: pruefbare Entscheidung.
- Fixture Builder: entkoppelte Weitergabe.
contract-testsTesting
Codepfad:
mvn-ws-acl-strangler/contract-testsVerantwortung
Dieses Modul ist Teil von Master 14 - Legacy Refactoring and Migration 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-acl-strangler/runnable-smokeVerantwortung
Dieses Modul ist Teil von Master 14 - Legacy Refactoring and Migration 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 14
anti-corruption-layerWeitere Module
Verantwortung
Dieses Modul ist Teil von Master 14 - Legacy Refactoring and Migration System und kapselt die Verantwortung anti-corruption-layer.
Architekturbausteine
- Aggregate Root: fachliche Grenze.
- Value Object: stabile Fachwerte.
- Specification: pruefbare Entscheidung.
- Domain Event: entkoppelte Weitergabe.
batch-migration-toolsWeitere Module
Verantwortung
Dieses Modul ist Teil von Master 14 - Legacy Refactoring and Migration System und kapselt die Verantwortung batch-migration-tools.
Architekturbausteine
- Application Service: fachliche Grenze.
- Command Handler: stabile Fachwerte.
- Pipeline: pruefbare Entscheidung.
- Result Object: entkoppelte Weitergabe.
cutover-controlWeitere Module
Codepfad:
mvn-ws-acl-strangler/cutover-controlVerantwortung
Dieses Modul ist Teil von Master 14 - Legacy Refactoring and Migration System und kapselt die Verantwortung cutover-control.
Architekturbausteine
- Application Service: fachliche Grenze.
- Command Handler: stabile Fachwerte.
- Pipeline: pruefbare Entscheidung.
- Result Object: entkoppelte Weitergabe.
data-reconciliationWeitere Module
Codepfad:
mvn-ws-acl-strangler/data-reconciliationVerantwortung
Dieses Modul ist Teil von Master 14 - Legacy Refactoring and Migration System und kapselt die Verantwortung data-reconciliation.
Architekturbausteine
- Aggregate Root: fachliche Grenze.
- Value Object: stabile Fachwerte.
- Specification: pruefbare Entscheidung.
- Domain Event: entkoppelte Weitergabe.
devops-vmWeitere Module
Codepfad:
mvn-ws-acl-strangler/devops-vmVerantwortung
Dieses Modul ist Teil von Master 14 - Legacy Refactoring and Migration System und kapselt die Verantwortung devops-vm.
Architekturbausteine
- Outbox: fachliche Grenze.
- Saga: stabile Fachwerte.
- CQRS Projection: pruefbare Entscheidung.
- Health Check: entkoppelte Weitergabe.
legacy-ear-simulationWeitere Module
Verantwortung
Dieses Modul ist Teil von Master 14 - Legacy Refactoring and Migration System und kapselt die Verantwortung legacy-ear-simulation.
Architekturbausteine
- Aggregate Root: fachliche Grenze.
- Value Object: stabile Fachwerte.
- Specification: pruefbare Entscheidung.
- Domain Event: entkoppelte Weitergabe.
legacy-ejb-simulationWeitere Module
Verantwortung
Dieses Modul ist Teil von Master 14 - Legacy Refactoring and Migration System und kapselt die Verantwortung legacy-ejb-simulation.
Architekturbausteine
- Aggregate Root: fachliche Grenze.
- Value Object: stabile Fachwerte.
- Specification: pruefbare Entscheidung.
- Domain Event: entkoppelte Weitergabe.
legacy-jsp-servlet-simulationWeitere Module
Verantwortung
Dieses Modul ist Teil von Master 14 - Legacy Refactoring and Migration System und kapselt die Verantwortung legacy-jsp-servlet-simulation.
Architekturbausteine
- Aggregate Root: fachliche Grenze.
- Value Object: stabile Fachwerte.
- Specification: pruefbare Entscheidung.
- Domain Event: entkoppelte Weitergabe.
legacy-message-bridgeWeitere Module
Verantwortung
Dieses Modul ist Teil von Master 14 - Legacy Refactoring and Migration System und kapselt die Verantwortung legacy-message-bridge.
Architekturbausteine
- Adapter: fachliche Grenze.
- Anti-Corruption Layer: stabile Fachwerte.
- Facade: pruefbare Entscheidung.
- Repository: entkoppelte Weitergabe.
migration-mappingWeitere Module
Codepfad:
mvn-ws-acl-strangler/migration-mappingVerantwortung
Dieses Modul ist Teil von Master 14 - Legacy Refactoring and Migration System und kapselt die Verantwortung migration-mapping.
Architekturbausteine
- Application Service: fachliche Grenze.
- Command Handler: stabile Fachwerte.
- Pipeline: pruefbare Entscheidung.
- Result Object: entkoppelte Weitergabe.
parallel-runWeitere Module
Codepfad:
mvn-ws-acl-strangler/parallel-runVerantwortung
Dieses Modul ist Teil von Master 14 - Legacy Refactoring and Migration System und kapselt die Verantwortung parallel-run.
Architekturbausteine
- Aggregate Root: fachliche Grenze.
- Value Object: stabile Fachwerte.
- Specification: pruefbare Entscheidung.
- Domain Event: entkoppelte Weitergabe.
reporting-comparisonWeitere Module
Verantwortung
Dieses Modul ist Teil von Master 14 - Legacy Refactoring and Migration System und kapselt die Verantwortung reporting-comparison.
Architekturbausteine
- Aggregate Root: fachliche Grenze.
- Value Object: stabile Fachwerte.
- Specification: pruefbare Entscheidung.
- Domain Event: entkoppelte Weitergabe.
rollback-controlWeitere Module
Codepfad:
mvn-ws-acl-strangler/rollback-controlVerantwortung
Dieses Modul ist Teil von Master 14 - Legacy Refactoring and Migration System und kapselt die Verantwortung rollback-control.
Architekturbausteine
- Aggregate Root: fachliche Grenze.
- Value Object: stabile Fachwerte.
- Specification: pruefbare Entscheidung.
- Domain Event: entkoppelte Weitergabe.
strangler-facadeWeitere Module
Codepfad:
mvn-ws-acl-strangler/strangler-facadeVerantwortung
Dieses Modul ist Teil von Master 14 - Legacy Refactoring and Migration System und kapselt die Verantwortung strangler-facade.
Architekturbausteine
- Aggregate Root: fachliche Grenze.
- Value Object: stabile Fachwerte.
- Specification: pruefbare Entscheidung.
- Domain Event: entkoppelte Weitergabe.