PDF-Templates

PDF-Templates bestimmen Aufbau und Markup der exportierten Berichte. Mobile App und Server nutzen dieselbe Template-Engine — Entwurf und Archiv sehen strukturell gleich aus (Unterschied: Integritätsseite / Signaturmetadaten beim Archiv). Sichtbarkeit und Format stellen Sie pro Template ein; die Bildqualität für Download und Archiv gilt organisationsweit — siehe PDF-Einstellungen.

Built-in vs. Custom

	Built-in	Custom (Tenant)
Herkunft	mitgeliefert (classic, minimal, bold, …)	im PDF-Editor der Web-App gepflegt
Technik	Handlebars + CSS im Shared Package	Handlebars-Quellen + CSS je Organisation
Typische Seiten	Cover, Canvas/Kartierung, Annotationen, Formulare (formHbs), Signatur	dieselben Slots, überschreibbar
Wann	Standard und schnelle Varianten	instituts-spezifisches Layout

Der Resolver wählt: Tenant-Custom → Built-in → Fallback.

Formulare im PDF

Formulare, die einem Berichtstyp zugeordnet sind, erscheinen im PDF über den Slot formHbs. Feld-Sichtbarkeit steuern Sie im Form Builder (pdfVisible); die Darstellung im PDF über Template und CSS. Details zum Formularmodell: siehe Form-Builder-Dokumentation im Projekt.

Cursor-Skill für Templates

Für die Arbeit an PDF-Templates (Slots, Handlebars-Helpers, CSS, formHbs, Render-Optionen) können wir einen Cursor-Skill bereitstellen — analog zum Form-Builder-Skill. Damit können Agenten und Entwickler Templates konsistent gegen die Shared-Package-Konventionen (@documentr/pdf-templates) anpassen, ohne Layout-Verträge zu brechen.

Der Skill liegt im Repo unter .cursor/skills/pdf-templates/ und verweist auf die maßgeblichen Pakete und Admin-Editor-Pfade.

Empfohlener Einstieg

1. Mit Built-in-Template und PDF-Einstellungen starten
2. Entwurf-PDF prüfen
3. Nur bei Bedarf Custom-Template oder formHbs vertiefen
4. Zustandsbericht abschließen und Archiv-PDF gegenlesen

Siehe auch: PDF-Export, Export-Überblick.