Dokumentation & Ablaufpläne — Überblick

Neben Code (siehe Generieren) erzeugt FinDSL aus derselben Quelle zwei Artefakte, die für beide Zielgruppen wertvoll sind — Fachabteilung wie Prüfer:innen: Dokumentation und Programmablaufpläne.

Beide entstehen aus dem geprüften Modul, sind also immer synchron zur Logik — kein Drift zwischen Gesetz, Code und Dokument.

Was entsteht

Dokumentation Markdown, HTML und PDF aus den Doc-Kommentaren — im Bundessteuerblatt-Stil, mit §-Verlinkung und Formeln.

Ablaufpläne (PAP) DIN-66001-nahe Programmablaufpläne als Mermaid oder HTML — eine Funktion, ein Diagramm.

Warum das zählt

Audit-tauglich. Prüfer:innen erhalten lesbare Dokumentation und Ablaufpläne, die nachweislich zum ausgeführten Code passen — nicht ein separat gepflegtes Dokument, das veralten kann.
Vertraute Form. Der Programmablaufplan (PAP) ist genau das Artefakt, das die Finanzverwaltung heute von Hand pflegt. FinDSL erzeugt ihn automatisch aus der Quelle.
Quellbezug erhalten. Die @Quelle-Annotationen werden zu §-Verweisen in der Dokumentation — der Bezug zum Gesetz bleibt sichtbar.