Ablauf, Vorlagen und Ablage
Vom Datensatz zum geprüften Archiv, welches Werkzeug für welches Dokument, und wie man Daten, Quelle und PDF getrennt ablegt.
English version: Tutorial in English
Ein Dokument entsteht aus Daten und einer Vorlage. Was danach passiert, entscheidet, ob man ihm in acht Jahren noch trauen kann.
Fokus
Quelle: typstgen 0.4 (Stand 11.10.2026)
Diagrammdaten anzeigen
| Schritt | Art | Bahn | Gruppe | Führt zu |
|---|---|---|---|---|
| Daten | Start | Erstellen | Dokument | |
| Dokument | Schritt | Erstellen | check | |
| check | Schritt | Prüfen | auch per MCP (KI-Agent) | Fehlerfrei? |
| Fehlerfrei? | Entscheidung | Prüfen | auch per MCP (KI-Agent) | Dokument (nein), preview (ja) |
| preview | Schritt | Prüfen | auch per MCP (KI-Agent) | compile |
| compile | Schritt | Ablegen | Manifest | |
| Manifest | Schritt | Ablegen | verify (später, in CI) | |
| verify | Ende | Ablegen |
Fokus
Quelle: typstgen 0.4 (Stand 11.10.2026)
Diagrammdaten anzeigen
| Schritt | Art | Bahn | Gruppe | Führt zu |
|---|---|---|---|---|
| Daten | Start | Erstellen | Dokument | |
| Dokument | Schritt | Erstellen | check | |
| check | Schritt | Prüfen | auch per MCP (KI-Agent) | Fehlerfrei? |
| Fehlerfrei? | Entscheidung | Prüfen | auch per MCP (KI-Agent) | Dokument (nein), preview (ja) |
| preview | Schritt | Prüfen | auch per MCP (KI-Agent) | compile |
| compile | Schritt | Ablegen | Manifest | |
| Manifest | Schritt | Ablegen | verify (später, in CI) | |
| verify | Ende | Ablegen |
check meldet Fehler mit Datei, Zeile und Spalte, preview zeigt eine Seite als Bild, compile
schreibt das PDF, auf Wunsch als PDF/A und bei Rechnungen mit eingebettetem ZUGFeRD-XML. Ein
Manifest hält fest, woraus jedes PDF entstanden ist; verify baut es später neu und vergleicht
Byte für Byte. Die drei Prüfschritte stehen auch einem KI-Agenten über MCP zur Verfügung.
Werkzeuge und Vorlagen
Für die meisten Dokumente reicht typstgen mit einer Vorlage. Wer Berichte aus Programmcode erzeugt, nimmt eine Bibliothek.
- typstgen übersetzt beliebige
.typ-Dateien. Vorlagen findet es übertemplate_pathsintypstgen.toml, Typst-Pakete wie@preview/…lädt es aus denselben Ordnern wie die Typst-CLI, oder gar nicht, wenn man es so einstellt. - business-templates bringt 19 Geschäftsdokumente als Typst-Paket mit: Rechnung, Angebot, Gutschrift, Mahnung, Lieferschein, Auftragsbestätigung, Brief, Zugangsdaten, Konzept, Vertrag, Dokumentation, Projektvorschlag, Protokoll, SLA, Spezifikation, Aufgabenliste, Stundenzettel und Handout. Buchhaltungsdokumente nehmen JSON-Daten, die übrigen benannte Parameter und den Text als Inhalt. Das Layout folgt DIN 5008.
- RenderReport ist eine Rust-Bibliothek für datengetriebene Berichte aus Komponenten (Kennzahlen, Befunde, Tabellen, Diagramme), mit Typst als eingebetteter Engine; jedes PDF entsteht als PDF/UA-1.
Nachfolger von docgen
Die Vorlagen stammen aus docgen, das eingestellt ist. typstgen ersetzt dessen PDF-Erzeugung und
übersetzt dieselben Vorlagen und JSON-Dateien; Kunden- und Projektverwaltung, automatische Nummern
und --encrypt gibt es dort nicht.
Drei Dokumente aus business-templates, erzeugt mit typstgen 0.4.1 aus den Beispieldaten im Repository:



Daten, Quelle, PDF: getrennt ablegen
Was sich ändert, sind die Daten. Was gleich bleibt, ist die Vorlage. Das PDF ist nur das Ergebnis.
Bewährt hat sich ein Ordner je Dokumentart und Jahr, der Dateiname ist die Dokumentnummer:
invoices/2026/RE-2026-001.json enthält die Daten, RE-2026-001.typ daneben ist ein dünner
Wrapper, der Vorlage und Daten zusammenführt. Stammdaten wie company.json liegen einmal zentral.
Daten, Wrapper und Manifest sind kleine Textdateien und gehören in die Versionsverwaltung; die Historie zeigt, wer was wann geändert hat. Die PDFs gehören ins Archiv, nicht ins Git. Das Manifest verbindet beide.
Wer eine Wissensbasis für KI-Systeme pflegt, hält dort eine kompakte Zusammenfassung jedes Vorgangs
und verweist mit document_id und typst_source auf die Quelle. Das System liest den Eintrag, der
Kunde bekommt das PDF; PDFs gehören nicht in den Suchindex.
Nummernkreise
Ein festes Schema wie RE-JJJJ-NNN (Rechnung) oder AN-JJJJ-NNN (Angebot) macht Dateien, Daten
und Wissenseinträge ohne Datenbank auffindbar.