Zum Hauptinhalt springen

Doku- & Doku-Vorgaben-Review (Stand v0.116.1, 2026-07-26)

Zielgruppen: Business/Management (Kernaussage + Maßnahmenplan) · IT-Dev/Doku-Pfleger (Befunde mit Datei:Zeile/Beleg). Gegenstand: Nicht die App, sondern die Dokumentation selbst — Inhalt, Struktur und die Doku-Vorgaben (CLAUDE.md-Leitprinzip „Dokumentation als Meisterwerk": pyramidal · zielgruppen-gerecht · visuell · konsistent). Schwester-Review zur App: UX-Prozess-Review-2026-07.md (parallel auf v0.116.1 aufgefrischt). Methode: Re-Audit über 17 Minor-Versionen (v0.99.12 → v0.116.1). Zwei Achsen: (1) Doku↔Doku-Konsistenz (Stand-Stempel-/Testzahl-Sweep über alle Einstiegs-Docs, ID-System, MED-OP-Status, Landkarte) inkl. scripts/check-doc-consistency.sh; (2) Doku↔Code-Abdeckung — stimmen Feldnamen/Enums/Routen und ist das seit v0.99.12 Gebaute (DocuSign-HTTP-Adapter · Fremdformulare Weg A/B + AD-009 · Hausformular-Auto- Routing MED-D-256/257/258 · Cockpit-Fokus · Mandate-Overlay) dokumentiert und nichts Totes beschrieben. Bezugspunkt & Gültigkeit (MED-D-97): v0.116.1 · Commit 5031530 · 2026-07-26. Löst das v0.99.12-Audit (MED-D-217) ab. Neu abgeleitet: B49–B52 → MED-OP-DOKU-9 (Doku-Welle 7). Nächster Doku-Audit gemäß Stale-Regel (agents.md §6.7).

1. Kernaussage​

Die Doku hält ihre mechanische Disziplin über 17 Minor-Versionen makellos — alle Einstiegs-Docs tragen 0.116.1, alle Testzahlen 642/55, alle IDs sind geloggt —, aber die langsamen Architektur-Docs sind hinter den schnellen Log-Docs zurückgeblieben: die maßgebliche Fremdformulare.md beschreibt ein bereits gebautes Feature noch als „nicht bauen". Das ist exakt die Wurzelursache (schnelle Logs aktuell, langsame Rahmen-Docs veralten), die die Doku-Audits wiederkehrend flaggen — diesmal am Fremdformular-Track.

Doku↔Doku (stark): Der Stand-Stempel-Sweep ist sauber — README · HANDOFF §2 · MVP-Scope · Feature-Liste · Lastenheft · Management-Summary · Sanity-Checkliste · Test-Übersicht · CLAUDE.md nennen alle 0.116.1; die Testzahl 642/55 rekonziliert an allen fünf Pflichtstellen (inkl. der „Was läuft wo?"-Tabellenzeile); die Decision-IDs MED-D-218…258 sind lückenlos in CHANGELOG/Decision-Log/ Feature-Liste geführt; MED-OP-UX-11 steht korrekt als offener Backlog. check-doc-consistency.sh meldet nur die zwei erwarteten „Audit veraltet"-Warnungen — genau die, die dieser Refresh auflöst.

Doku↔Code (die Drift): Die Architektur-Doku ist dem Feature-Churn hinterher:

  • Fremdformulare.md beschreibt MED-OP-FORM-6 noch als „zurückgestellt / jetzt nicht bauen" (§7/§8) und führt FremdformularVorlage ohne das neue dokumenttyp-Feld — obwohl MED-D-256/257/258 genau das gebaut haben (Hausformular-Auto-Routing + eIDAS-Guard). Ein Entwickler, der die kanonische Architektur-Doku liest, zöge den falschen Schluss, das Feature existiere nicht (B49, hoch).
  • HANDOFF §4 listet MED-OP-FORM-6 im Offene-Punkte-Block noch als offen, während §2 + Feature-Liste es als ✅ gebaut führen (B50, mittel-hoch — interner Widerspruch).
  • Unterschriften.md nennt den DocuSign-Adapter „gebaut, aber nicht live verifiziert", obwohl MED-D-238/239 den Kern live gegen Demo + Prod-Webhook belegt haben (B51, mittel).
  • Ein veralteter Stand-Stempel in einem Nicht-Einstiegs-Doc (Design-Entscheidungen-Akte.md = 0.99.12, B52).

Bewertung je Dimension (10 = Meisterwerk; ↑/↓ ggü. v0.99.12):

Dimensionv0.99.12v0.116.1Begründung
Doku↔Doku-Konsistenz (Stempel, IDs, Zahlen)9,59Stempel/Testzahlen/IDs makellos rekonziliert (0.116.1, 642/55 überall); aber: HANDOFF §4↔§2-Widerspruch zu MED-OP-FORM-6 (B50) + 1 stale Nicht-Einstiegs-Stempel (B52)
Doku↔Code-Abdeckung98Regress: die maßgebliche Fremdformulare.md beschreibt ein gebautes Feature (MED-D-256/257/258) als „nicht bauen" + führt FremdformularVorlage ohne dokumenttyp (B49); Unterschriften.md nennt den Adapter „nicht live verifiziert" trotz MED-D-238/239 (B51)
Pyramidal / Zielgruppen99unverändert stark (BLUF durchgängig, Lesepfade gepflegt)
Visualisierung (Mermaid/Tabellen)99unverändert (Hash-Ketten-/Bankkonto-/Vor-Ort-/Weltmodell-Diagramme stehen)

2. Was gehalten wurde (bewahren)​

  • Stand-Stempel-Disziplin über 17 Minor makellos: alle 9 Einstiegs-Docs auf 0.116.1 (README:31 · HANDOFF:17 · MVP-Scope:26 · Feature-Liste:4 · Lastenheft:9 · Management-Summary:5 · Sanity-Checkliste:1 · Test-Übersicht:3 · CLAUDE.md:183).
  • Testzahl 642/55 an allen fünf Pflichtstellen rekonziliert — inkl. der „Was läuft wo?"-Tabellenzeile (Test-Uebersicht.md:66), die im Vor-Vor-Audit noch nachhing.
  • ID-Abdeckung lückenlos: MED-D-218…258 durchgängig in CHANGELOG/Decision-Log/Feature-Liste; MED-D-257/258 in Decision-Log:273-274, Test-Übersicht:4, Feature-Liste:17, HANDOFF §2.
  • Doku↔Code an den schnellen Stellen sauber: DocuSign-HTTP-Adapter (Unterschriften.md:166-192: JWT/ Envelope/Webhook, Secret-Namen deckungsgleich), Fremdformulare Weg A/B + AD-009 (Fremdformulare.md §4/§6/§8: WELTMODELL_ATTRIBUTE/anfordernAusTemplate/baueTabWerte/Routen stimmen), Cockpit-Fokus (MED-D-252) und Mandate-Overlay (MED-D-200) dokumentiert.
  • Mechanischer Check grün außer den zwei erwarteten Audit-Staleness-Warnungen (kein toter Link, kein version.ts↔Doku-Mismatch, keine Log-Hygiene-Flags).

3. Befunde (der nächste Backlog → MED-OP-DOKU-9, Doku-Welle 7)​

Die Nummerierung setzt die Doku-Spur fort (letzter Doku-Audit schloss B41–B48; der App/UX-Track läuft getrennt bis B43). Neu: B49–B52. Alle niedrig–hoch, kein Blocker.

B49 — Fremdformulare.md bildet MED-D-256/257/258 nicht ab (gebautes Feature als zurückgestellt beschrieben) (hoch; echter Doku↔Code-Widerspruch)​

docs/architektur/Fremdformulare.md ist die maßgebliche Architektur-Doku des Fremd-/Hausformular-Workflows, endet aber bei Weg B / MED-D-250 (v47) und beschreibt das danach Gebaute als nicht zu bauen: :141-143 (§8) „MED-OP-FORM-6 (zurückgestellt): … Jetzt nicht bauen"; :97 (§7) wiederholt das; :92 (§6-Fahrplan) endet bei Slice 3 (kein Baustein 1/2); :120,:133 führen FremdformularVorlage als {name, templateId, attribute[], eIDAS-Niveau} — ohne das neue dokumenttyp-Feld (Code: schema.ts:429), ohne die Hausformular-Verknüpfung, ohne Migration v48/v49. Fix: §6/§7/§8 auf v0.116.1 nachziehen (Baustein 1/2 MED-D-256/257 + eIDAS-Guard MED-D-258 + dokumenttyp + v48/v49), Wortlaut „zurückgestellt" → „gebaut".

B50 — HANDOFF §4-Offener-Punkt (MED-OP-FORM-5/6) widerspricht HANDOFF §2 + Feature-Liste (mittel-hoch; Doku↔Doku)​

HANDOFF.md:636 (§4) listet „MED-OP-FORM-6 (Eigen-Formulare ebenfalls als Templates)" noch als offen und nennt nur MED-D-235/247/248/250/251 — ohne MED-D-256 (Baustein 1) / MED-D-257 (Baustein 2), obwohl §2:27-38 und Feature-Liste:17-18 diese als ✅ führen. Fix: §4-Punkt auf „Baustein 1+2 gebaut (MED-D-256/257); Rest = Eigen-Formular-Katalog-Vereinheitlichung" nachziehen.

B51 — Unterschriften.md-„Offene Punkte" nennt den DocuSign-Adapter noch nicht live verifiziert (mittel; Doku↔Doku)​

docs/architektur/Unterschriften.md:199-200 „gilt der Adapter als gebaut, aber nicht live verifiziert"; :194-197 rahmt OP-SIGN-1-Rest als „Live-Verifikation des DocuSign-Adapters". Widerspricht dem kanonischen Stand (CLAUDE.md:196-199 / HANDOFF, MED-D-238/239: Kern live gegen Demo-E2E + Prod-Webhook-Write-back). Fix: OP-SIGN-1-Rest auf Prod-QES/AVV/PandaDoc verengen, nicht „ist der Adapter überhaupt live".

B52 — Design-Entscheidungen-Akte.md mit stalem Stand-Stempel 0.99.12 (niedrig-mittel; Doku↔Doku)​

docs/produkt/Design-Entscheidungen-Akte.md:6 „Stand: Version 0.99.12" — ein lebendes AD-Entscheidungs-Doc ~17 Minor zurück; post-0.99-AD-Entscheidungen (MED-D-241/243 AD-006, MED-D-242 AD-014, MED-D-246 AD-005) sind vermutlich nicht reflektiert. Kein Pflicht-Einstiegs-Doc (daher geringer), aber Stempel + Inhalt beim Nachziehen prüfen.

4. Maßnahmenplan​

Doku-Welle 7 (MED-OP-DOKU-9) — die Architektur-Doku hinter den Log-Docs nachziehen. Reihenfolge nach Wirkung: B49 (Fremdformulare.md auf v0.116.1 — höchster, echter Doku↔Code-Widerspruch) → B50 (HANDOFF §4↔§2 rekonzilieren) → B51 (Unterschriften.md OP-SIGN-1-Rest verengen) → B52 (Design-Entscheidungen-Akte.md re-stempeln nach Inhalts-Stichprobe). Danach ist die Doku↔Code-Achse wieder deckungsgleich mit dem Live-Stand. Die mechanische Achse (Stempel/Zahlen/IDs) ist bereits sauber und braucht nur die laufende Je-PR-Pflege. Nächster Doku-Audit gemäß Stale-Regel.

Dieses Audit ist ein Zeitdokument (MED-OP-REVIEW-1 / agents.md §6.7): Bezugspunkt v0.116.1 · Commit 5031530 · 2026-07-26. Befunde werden als MED-OP-DOKU-9 (B49–B52) in den Backlog überführt, nicht im Audit abgearbeitet. Keine Versionsänderung durch diesen Refresh.