asv-format-validator/docs/arbeitspakete/m1/AP11-m1-abnahme.md

model

model
sonnet

AP11 – M1-Abnahme

Meilenstein: M1 Vorgänger: AP01–AP10 alle ✅ erforderlich Nachfolger: M2 Grundlage: docs/specs/meilensteine.md v3, M1-Abnahmekriterien

Ziel

M1 wird formal abgenommen. Alle Abnahmekriterien aus meilensteine.md sind erfüllt und nachweisbar. Das Projekt ist bereit für M2.

Voraussetzungen

• AP01–AP10 abgeschlossen und grün
• Alle AP-Berichte liegen in docs/arbeitspakete/m1/berichte/ vor

Scope IN

1. Test-Artefakt anlegen

test-artefakte/m1/minimal.txt anlegen — eine einfache ISO-8859-15-kompatible Textdatei mit 3–5 Zeilen Dummy-Inhalt. Keine echten ASV-Daten, kein gültiges EDIFACT — reiner Lauftest.

2. End-to-End-Läufe durchführen

mvn clean package ausführen, dann alle fünf Läufe:

Lauf	Befehl	Erwarteter Exit-Code	Erwartetes Verhalten
1	java -jar target/asv-format-validator-*.jar test-artefakte/m1/minimal.txt	0	.txt und .log entstehen im Verzeichnis
2	identischer Aufruf wie Lauf 1	0	_v1.txt und _v1.log entstehen
3	java -jar ... nicht-vorhanden.txt	2	Minimalbericht auf Konsole
4	java -jar ... (ohne Argument)	2	Minimalbericht nur auf Konsole
5	java -jar ... datei1.txt datei2.txt	2	Minimalbericht nur auf Konsole

Alle fünf Läufe werden im M1-Abschlussbericht dokumentiert (Befehl, tatsächlicher Exit-Code, relevante Ausgabe).

3. Meilenstein-Abnahmeprüfung

Jeden Punkt aus docs/specs/meilensteine.md v3 §„Abnahme von M1" mit konkretem Nachweis verknüpfen:

Kriterium	Nachweis	Status
Anwendung als JAR unter Windows mit Java 21 startbar	Lauf 1
Fehlendes/falsches Argument → Exit-Code 2 mit Minimalbericht	Lauf 3, 4, 5
Bericht- und Log-Datei im Eingabeverzeichnis mit korrekter Suffix-Logik	Lauf 1 + 2
Log4j2-Bindung außerhalb Bootstrap/Logging-Adapter nicht sichtbar	Architekturtest AP10 Regel A
Befundmodell trennt Spec-Urteil und diagnostische Weiteranalyse	Unit-Test AP05
Build und Tests grün	mvn clean verify

4. Konsolidierter M1-Abschlussbericht

Datei: docs/arbeitspakete/m1/berichte/M1-abschlussbericht.md

Pflichtabschnitte:

• Zusammenfassung — Was ist M1 geworden (max. zwei Absätze)
• AP-Übersicht — Tabelle mit allen 11 APs, Status, letzter Commit
• Meilenstein-Abnahmetabelle (siehe oben, vollständig ausgefüllt)
• End-to-End-Protokoll — alle fünf Läufe mit Befehl, Exit-Code, Ausgabe-Zusammenfassung
• Quality-Metriken — Testanzahl, Coverage-Wert (informativ, keine Gate-Prüfung in M1)
• Rest-Risiken — konsolidiert aus allen AP-Berichten
• Empfehlungen für M2 — was M2 beachten sollte
• Freigabe-Vermerk — „M1 ist abnahmebereit" oder „M1 ist mit folgenden Einschränkungen abnahmebereit: ..."

5. Git-Tag setzen

git tag -a m1-done -m "Meilenstein 1 abgeschlossen, siehe docs/arbeitspakete/m1/berichte/M1-abschlussbericht.md"

Scope OUT

• Vorgriffe auf M2-Themen
• Release-Builds, Signierung, Publizierung
• Inhaltliche Berichtsvertiefung über M1-Minimum hinaus

Schritte

1. test-artefakte/m1/minimal.txt anlegen
2. mvn clean package
3. Alle fünf Läufe durchführen und protokollieren
4. mvn clean verify ein letztes Mal
5. Konsolidierten M1-Abschlussbericht schreiben
6. Git-Tag m1-done setzen

Abnahmekriterien

• test-artefakte/m1/minimal.txt existiert
• Alle fünf Läufe sind protokolliert
• M1-abschlussbericht.md existiert mit allen Pflichtabschnitten
• Meilenstein-Abnahmetabelle vollständig, jede Zeile mit konkretem Nachweis
• Kein Exit-Code 3 mehr erreichbar
• mvn clean verify grün
• Git-Tag m1-done gesetzt
• Freigabe-Vermerk ist explizit
• Abschlussbericht unter docs/arbeitspakete/m1/berichte/AP11-bericht.md

Rest-Risiken und offene Punkte

• Wenn hier Abnahmekriterien nicht erfüllt sind, zeigt das, dass ein früheres AP unvollständig war. In dem Fall: zurück zum betroffenen AP, nachbessern, dann AP11 wiederholen. Keine Abkürzungen.

Bericht

docs/arbeitspakete/m1/berichte/AP11-bericht.md nach docs/arbeitspakete/m1/templates/ap-bericht.md.
Zusätzlich konsolidierter docs/arbeitspakete/m1/berichte/M1-abschlussbericht.md.