Workflow/tasks/pdf_stamp_interactive.md

pdf_stamp_interactive — Interaktive Stempelplatzierung

Zweck: Zeigt dem Bearbeiter eine PDF-Vorschau, in der er per Doppelklick (Desktop) bzw. langem Drücken (Tablet) die Stempelposition setzt; ein Schieberegler skaliert den Stempel live (30–300 %). Der Workflow wartet, bis platziert wurde; dann wird das Stempelbild dauerhaft eingebrannt. Keine kryptografische Signatur — dafür ist pdf_sign zuständig.

Parameter

Name	Pflicht?	Default	Beschreibung
file	ja	—	Eingabe-PDF.
vorlage	ja¹	—	Vordefinierter Stempelgenerator: posteingang, postausgang oder bau.
vorlage_params	nein	—	Query-Parameter für den Stempelgenerator (nur mit vorlage).
stempel	ja¹	—	Pfad zu einer fertigen Stempelbild-Datei (PNG/JPG).
stempel_text	ja¹	—	Text, aus dem automatisch ein Stempelbild erzeugt wird (dunkelblau, zentriert).
breite_mm / hoehe_mm	nein	auto	Stempelmaße in mm. auto = aus der Bildgröße abgeleitet; ist nur eine Achse auto, bleibt das Seitenverhältnis erhalten. Text-Stempel ohne Bild: Fallback 60 × 25 mm.
output_var	nein	—	Zusätzlicher Variablenname für den Ergebnispfad (setzt auch <output_var>_url).

¹ Genau eine Stempelquelle angeben; Priorität bei Mehrfachangabe: vorlage → stempel → stempel_text.

Die geklickte Position ist der Mittelpunkt des Stempels; der Task rechnet auf die Seitengröße um und begrenzt den Stempel auf den Seitenrand. Das Ergebnis wird als neue Datei im Arbeitsverzeichnis abgelegt.

Eingangswerte: {{latest_pdf_path}} bzw. PDF-Pfad-Variable; {{temp_dir}}.

Ausgangswerte:

• latest_pdf_path, latest_pdf_url (gestempeltes PDF)
• <task_id>_page, <task_id>_x_mm, <task_id>_y_mm (Position obere linke Ecke in mm), <task_id>_breite, <task_id>_hoehe (finale Maße in mm), <task_id>_scale_pct
• optional <output_var> und <output_var>_url

<task type="pdf_stamp_interactive" id="eingangsstempel">
  <assign_to>{{registratur_mail}}</assign_to>
  <config>
    <file>{{latest_pdf_path}}</file>
    <vorlage>posteingang</vorlage>
    <breite_mm>50</breite_mm>
    <hoehe_mm>auto</hoehe_mm>
  </config>
</task>