# Java Modernization Deep Dive

Dieses Java-21-/Maven-Lab stellt 34 Themen als ausführbare Legacy-/Modern-Vergleichspaare bereit. Die 68 Code-Module zeigen jeweils einen älteren Ansatz und eine modernisierte Alternative; die begleitende Lernstrecke erklärt Migration, Risiken, Tests, Abnahme und Rollback.

## Einstieg

1. `lernweg.html` für die empfohlene Reihenfolge öffnen.
2. `index.html` für die Themenlandkarte verwenden.
3. `VERGLEICHE.html` oder `projects/<thema>/comparison.html` für Codevergleiche öffnen.
4. `docs/migration/index.html` für den vertieften Migrationspfad verwenden.

## Bauen und testen

Voraussetzungen: JDK 21 und Maven 3.9 oder der mitgelieferte Maven-Bootstrap.

```powershell
mvn -B test
powershell -NoProfile -ExecutionPolicy Bypass -File scripts/validate-structure.ps1
```

Für einen sauberen vollständigen Durchlauf:

```powershell
mvn -B clean verify
```

Die Tests und ihre Vorbereitung gehören bewusst zum Repository. Abhängige Laufzeitdienste wie Datenbanken, Broker, Mailserver oder Application Server sind durch den normalen Maven-Testlauf nicht automatisch abgedeckt.

## Struktur

- `projects/`: 34 Themenordner mit je `legacy/` und `modern/`
- `docs/`: Architektur-, Vergleichs- und Migrationswissen
- `assets/`: gemeinsame Website-Assets
- `tools/`: reproduzierbarer Generator für Codevergleiche
- `scripts/validate-structure.ps1`: Struktur- und Linkprüfung
- `project.yaml`: maschinenlesbare Quelle für Cockpit und Governance

Erzeugte Prüfberichte, Statusprotokolle, PDFs und mobile HTML-Duplikate sind nicht Teil der kanonischen Quellen. Git dokumentiert die Entwicklung; zentrale KI-Konventionen und Review-Prompts werden über `nursude/ai-governance` synchronisiert.