Build · Prüfung · Fehlerdiagnose

Maven-Projekt-Runbook

Präzise Anleitung für den tatsächlichen Projektstand - ohne eine nicht vorhandene Runtime oder einen nicht geprüften Maven-Build zu behaupten.

ProjektübersichtRoot-POMPDF öffnen
Place-Order-Kernfluss

1. Voraussetzungen

  • ZIP vollständig entpackt.
  • JDK 21 mit java und javac im PATH.
  • Maven 3.9.x optional für POM-Validierung und spätere Ausbaustufen.
  • Arbeitsordner: 06_MAVEN_CAPSTONE_PROJEKT/order-platform-enterprise-final/.

2. Schnellprüfung

Shell
java -version
javac -version
mvn -version

mvn -version darf fehlen, wenn nur die frameworkarmen Kernklassen geprüft werden sollen.

3. Manuelle Java-21-Kompilierung

Linux/macOS

Shell
mkdir -p target/manual-classes
find . -path '*/src/main/java/*' -name '*.java' -print0 \
  | xargs -0 javac --release 21 -d target/manual-classes

Windows PowerShell

PowerShell
New-Item -ItemType Directory -Force target/manual-classes | Out-Null
$files = Get-ChildItem -Recurse -Filter *.java |
  Where-Object { $_.FullName -match '[\/]src[\/]main[\/]java[\/]' } |
  ForEach-Object FullName
javac --release 21 -d target/manual-classes $files
Erwartung: Die sieben Java-Quelldateien werden gemeinsam kompiliert. Die Klassen liegen anschließend unter target/manual-classes/at/aydinsude/enterprise/v6/.

4. Maven-Prüfungen

Shell
mvn -N validate

Dieser Befehl validiert nur das Parent-POM. Ein vollständiges mvn clean verify ist im aktuellen Stand nicht als erfolgreicher Build garantiert, weil die Child-POMs keine Abhängigkeiten zwischen den Java-Modulen deklarieren und kein Test-/Runtime-Setup enthalten.

5. Nicht vorhandene Startbefehle

Folgende Laufzeitwege existieren derzeit nicht:

Keine Runtime

Keine main-Klasse und kein Spring-Boot-/Jakarta-Startmodul.

Keine Infrastruktur

Kein Docker Compose, keine Datenbankmigrationen und kein Broker-Setup.

Keine externe API

REST- und JPA-Module sind Strukturmarker, keine implementierten Adapter.

Keine Test-Engine

Kein JUnit-/ArchUnit-Setup; nur ein Architekturregel-Katalog.

6. Typische Fehler

SymptomUrsacheVorgehen
invalid target release: 21älteres JDK aktivjava -version und javac -version prüfen
Klassen nicht gefundenDateien einzeln kompiliertalle Java-Quelldateien gemeinsam an javac übergeben
Maven-Modul kompiliert nichtfehlende Modulabhängigkeitenals dokumentierte Projektgrenze behandeln, nicht als reinen Umgebungsfehler
kein ausführbares ArtefaktParent-Packaging pom, keine Runtimenur Lernkern kompilieren; keine Startbarkeit behaupten
Architekturtests laufen nichtkein Test-FrameworkArchitectureRuleCatalog als Regelkatalog lesen

7. Ausbaupfad für eine lauffähige Version

  1. ModulgrenzenPakete und erlaubte Abhängigkeiten festlegen.
  2. POM-GraphAbhängigkeiten zwischen Kernel, Domain, Application und Adaptern deklarieren.
  3. AdapterREST, JPA und Messaging tatsächlich implementieren.
  4. RuntimeStartmodul mit main-Klasse ergänzen.
  5. TestsUnit-, Integrations- und Architekturtests einführen.
  6. InfrastrukturDatenbank, Broker, Konfiguration und Container konkretisieren.
  7. RunbookBefehle nur anhand real ausgeführter Ergebnisse aktualisieren.