# `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`

```xml
<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>
```