Dokumentation und Arbeitspakete angelegt

docs/arbeitspakete/m1/templates/ap-bericht.md

@@ -0,0 +1,66 @@
+# Abschlussbericht Arbeitspaket AP-XX-<Titel>
+
+> **Bezug:** `docs/arbeitspakete/m1/APxx-<slug>.md`
+> **Bearbeiter:** <Name / KI-Agent / Mensch>
+> **Datum:** <YYYY-MM-DD>
+> **Commit(s):** <Hash(es)>
+> **Status:** ✅ abgeschlossen / ⚠️ abgeschlossen mit Einschränkungen / 🔴 abgebrochen
+
+## 1. Zusammenfassung
+
+Ein bis zwei Sätze: Was wurde gemacht?
+
+## 2. Umgesetzte Änderungen
+
+Konkrete Aufzählung der tatsächlich durchgeführten Änderungen. Wenn möglich mit Dateipfaden und kurzer Begründung.
+
+- `pfad/zur/datei` – was geändert wurde und warum
+- …
+
+## 3. Scope-Treue
+
+| Scope-Punkt aus dem Arbeitspaket | Erfüllt? | Bemerkung |
+|---|---|---|
+| Punkt 1 | ✅ / ⚠️ / ❌ | … |
+| Punkt 2 | ✅ / ⚠️ / ❌ | … |
+
+**Wurde der Scope eingehalten?** Ja / Nein / teilweise (begründen)
+
+**Wurden Dinge außerhalb des Scopes gemacht?** Falls ja, welche und warum?
+
+## 4. Abnahmekriterien
+
+| Abnahmekriterium aus dem Arbeitspaket | Erfüllt? | Nachweis |
+|---|---|---|
+| Kriterium 1 | ✅ / ⚠️ / ❌ | z.B. Testname, Commit-Hash, Log-Ausschnitt |
+| … | | |
+
+## 5. Build- und Teststatus
+
+- `mvn clean verify`: ✅ grün / 🔴 rot
+- Anzahl Tests: N (davon M neu hinzugefügt)
+- Coverage (falls bereits messbar): domain = X %, application = Y %, …
+- Warnungen beim Build: keine / siehe unten
+
+## 6. Rest-Risiken und offene Punkte
+
+Was kann noch schiefgehen? Was wurde bewusst nicht gelöst und in ein späteres Arbeitspaket geschoben?
+
+- Risiko 1: …
+- Offener Punkt 1: …
+
+## 7. Empfehlungen für Folge-Arbeitspakete
+
+Was sollte das nächste AP beachten? Gibt es Lessons Learned?
+
+## 8. Reviewer-Checkliste
+
+Der Rezensent prüft damit die korrekte Umsetzung:
+
+- [ ] Alle im Arbeitspaket genannten Scope-IN-Punkte sind nachweislich umgesetzt
+- [ ] Keine Scope-OUT-Punkte wurden angefasst
+- [ ] Abnahmekriterien sind mit konkreten Nachweisen belegt (Tests, Dateipfade, Commits)
+- [ ] `mvn clean verify` ist grün
+- [ ] Der Commit für dieses AP hat eine sprechende Message (`M1-APxx: ...`)
+- [ ] Keine Regeln der Grunddokumente (Spec, Fachliche, Technik) wurden verletzt
+- [ ] Rest-Risiken sind ehrlich dokumentiert