Der Audit erkennt fehlende javax→jakarta-Migrationen (Imports in Quellcode) datei- und zeilengenau als Upgrade-Blocker.
Produkt spring-boot-upgrade-audit · Version 0.1.0
Spring Boot 2.x→3.x Migration Readiness Audit
Standardisierter, deterministischer Migrations-Readiness-Audit für Spring-Boot-2.x-Projekte. Das Produkt prüft einen synthetischen Projekt-Snapshot statisch auf die wichtigsten Blocker und Risiken beim Wechsel auf Spring Boot 3.x / Java 17: javax→jakarta-Imports, entfernte Spring-Security-APIs, veraltete Properties und Hibernate-Dialekte, Actuator-Endpunktänderungen, spring.factories, JUnit-4-Teststack, EOL-Abhängigkeiten und Java-11-Containerimages. Es liefert datei- und zeilengenaue Befunde mit konkreten Fix-Anweisungen und einen transparent dokumentierten Readiness-Score. Jeder Lauf wird unabhängig re-validiert und ist über einen hash-verketteten Evidence-Record reproduzierbar; Claims werden nur mit verifizierter Evidenz veröffentlicht.
Zielkunde (ICP)
Java-/Spring-Teams in mittelständischen und Enterprise-Unternehmen (10–200 Entwickler), die eine Spring-Boot-2.x-Anwendung auf Boot 3.x und Java 17 heben müssen und vor dem Upgrade eine schnelle, reproduzierbare Liste der wichtigsten Blocker, Risiken und Fix-Aufträge benötigen, ohne externes Migrations-Consulting zu binden.
Problem
Der Wechsel von Spring Boot 2.x auf 3.x bricht Quellcode und Konfiguration an vielen Stellen gleichzeitig: Jakarta-Namespaces, entfernte Security-APIs, umbenannte Properties, Hibernate-6-Dialekte und geänderte Actuator-Endpunkte. Manuelle Checklisten sind uneinheitlich und werden bei jedem Projekt neu erstellt; echte Upgrades sind teuer und liefern erst spät Rückmeldung. Teams benötigen eine deterministische, evidenzbasierte Vorprüfung mit datei- und zeilengenauen Fix-Aufträgen, die den Migrationsaufwand früh sichtbar macht.
Liefermodelle
- Audit as a Service
Service-Level (SLA)
| Feld | Wert |
|---|---|
delivery_time_hours | 48 |
max_findings_per_audit | 200 |
max_runtime_seconds | 120 |
Grenzen des Produkts
- Rein statischer Checklist-Audit; es wird kein Code kompiliert, gestartet oder gegen echte Repositories ausgeführt. Ein erfolgreicher Upgrade-Abschluss kann nicht garantiert werden; echte Testläufe bleiben erforderlich.
- Der Readiness-Score ist eine transparente Checklist-Heuristik und keine Prognose über Aufwand, Dauer oder Erfolg der Migration.
- Laufzeit-/Klassenpfad-Konflikte, dynamische Reflection-Nutzungen, Provider-spezifische APIs und Datenbankmigrationen werden nicht erkannt.
- Die aktuelle Evidenz basiert ausschließlich auf dem synthetischen Lab-Target legacy-spring-boot-2, nicht auf einem Kundenprojekt.
- Es werden keine echten Repositories, Kundendaten oder Zugangsdaten verarbeitet.
- Preis und Kostenmodell sind Startwerte; die gemessene Marge wird aus dem Evidence-Record übernommen und nicht geschätzt.
- Rein statischer Checklist-Audit; es wird nichts kompiliert, gestartet oder gegen echte Repositories/Netzwerke ausgeführt.
- Der Readiness-Score ist eine transparente Heuristik über statische Signale und keine Garantie, dass ein Upgrade erfolgreich ist oder alle Kompatibilitätsprobleme abdeckt.
- Keine Erkennung von Laufzeit-/Klassenpfad-Konflikten, dynamischen Reflection-Nutzungen, Provider-spezifischen APIs oder Datenbankmigrationen.
- Die Regeln decken die im Lab-Target codifizierten Migrationsmuster ab; weitere Spring-Boot-3-Änderungen können ungemeldet bleiben.
- Die aktuelle Evidenz basiert ausschließlich auf dem synthetischen Lab-Target legacy-spring-boot-2, nicht auf einem echten Kundenprojekt.
- Alle Dateien, Klassen und Konfigurationen sind fiktiv; es werden keine echten Repositories, Kundendaten oder Zugangsdaten verarbeitet.
Verträge: Eingabe und Ausgabe
Ein Claim erscheint nur, wenn die Evidenz zur exakten Version passt. Contract-Felder werden aus dem veröffentlichten Datenvertrag gerendert.
JSON-Schema (input_contract) aus dem veröffentlichten Datenvertrag. Der Runner validiert Ein- und Ausgaben gegen dieses Schema.
{
"properties": {
"repository_snapshot": {
"description": "Read-only Snapshot des Spring-Boot-2.x-Projekts (pom.xml, Java-Quellen, YAML-Konfiguration, spring.factories, Dockerfiles); keine Credentials, keine Änderung am Zielsystem, keine Ausführung von Zielcode.",
"type": "object"
}
},
"required": [
"repository_snapshot"
],
"type": "object"
}| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
repository_snapshot | object | ja | Read-only Snapshot des Spring-Boot-2.x-Projekts (pom.xml, Java-Quellen, YAML-Konfiguration, spring.factories, Dockerfiles); keine Credentials, keine Änderung am Zielsystem, keine Ausführung von Zielcode. |
JSON-Schema (output_contract) aus dem veröffentlichten Datenvertrag. Der Runner validiert Ein- und Ausgaben gegen dieses Schema.
{
"properties": {
"findings": {
"description": "Maschinenlesbare Findings als JSON inkl. Summary mit transparentem Readiness-Score, Score-Formel, Kategorie-Scores und ausgewiesenen Heuristik-Regeln.",
"type": "object"
},
"report": {
"description": "Kundenbericht (Markdown) mit Zusammenfassung, Methodik, priorisierten Migrationsbefunden inkl. Datei, Zeile, Schweregrad, Fix-Anweisung, Qualitätsmetriken, Reproduzierbarkeitsdaten und Grenzen.",
"type": "object"
}
},
"required": [
"report",
"findings"
],
"type": "object"
}| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
findings | object | ja | Maschinenlesbare Findings als JSON inkl. Summary mit transparentem Readiness-Score, Score-Formel, Kategorie-Scores und ausgewiesenen Heuristik-Regeln. |
report | object | ja | Kundenbericht (Markdown) mit Zusammenfassung, Methodik, priorisierten Migrationsbefunden inkl. Datei, Zeile, Schweregrad, Fix-Anweisung, Qualitätsmetriken, Reproduzierbarkeitsdaten und Grenzen. |
Veröffentlichte Claims (gate-geprüft)
Jeder folgende Claim ist an mindestens einen PASSED-Evidenz-Record gebunden. Die SHA-256-Hashwerte der Records sind direkt an jedem Claim sichtbar; nicht freigegebene Claims werden nicht gerendert.
Der Audit erkennt entfernte/veraltete Spring-Security-APIs, PathMatcher- APIs, Hibernate-5-Dialekte, umbenannte Properties und geänderte Actuator-Endpunkte als Migrationsrisiken mit konkreten Fix-Anweisungen.
Der Audit erkennt Boot-3-inkompatible oder EOL-Abhängigkeiten, spring.factories-Auto-Konfigurationen, JUnit-4-Teststacks und Java-11-Containerimages als Build-/Runtime-Risiken.
Jeder Audit-Lauf ist deterministisch, wird unabhängig re-validiert und ist über einen hash-verketteten Evidence-Record mit Artefakt-Hashes reproduzierbar.
Es sind keine unterdrückten Claims für dieses Produkt im Gatekeeper-Status enthalten.
Workflow
Ausführungsschritte laut Manifest; jeder Schritt referenziert einen geprüften Skill.
| Schritt | Skill | Beschreibung | Abhängig von |
|---|---|---|---|
audit | spring_boot_upgrade_audit | Statischen Migrations-Readiness-Audit des Projekt-Snapshots mit dem Skill spring_boot_upgrade_audit ausführen und Findings deterministisch erzeugen. | — |
Skills in diesem Produkt
Versionen, Schwellenwerte und Evidenzstand je Skill. Details in der Skill-Registry.
| Skill | Version | Reife | Recall / Precision | Evidenz | Letzte Evidenz |
|---|---|---|---|---|---|
| Spring Boot 2.x→3.x Migration Readiness Audit | 0.1.0 | VALIDATED | 1,000 / 0,900 | 1 | f949d297e6984c1ba14e8bf88ea665dd |
Evidenz für dieses Produkt
Ausschließlich verifizierte Records. Hashes und Artefaktpfade sind im Evidenz-Detail einsehbar.
record_sha256: cb3918bd097c5fe3fb0ed10e1a9755dea963564bf2b529b19185e35cf14ba203
- Rein statischer Checklist-Audit; es wird kein Code kompiliert, gestartet oder gegen echte Repositories ausgeführt. Ein erfolgreicher Upgrade-Abschluss kann nicht garantiert werden; echte Testläufe bleiben erforderlich.
- Der Readiness-Score ist eine transparente Checklist-Heuristik und keine Prognose über Aufwand, Dauer oder Erfolg der Migration.
- Laufzeit-/Klassenpfad-Konflikte, dynamische Reflection-Nutzungen, Provider-spezifische APIs und Datenbankmigrationen werden nicht erkannt.
- … 9 weitere
Bericht: evidence/artifacts/f949d297e6984c1ba14e8bf88ea665dd/report.md
Weitere Dokumentation
Kein Dokumentationspfad veröffentlicht.