Doku restrukturiert: README als Index, je Task eigene Datei unter tasks/

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

tasks/pdf_stamp_interactive.md

@@ -0,0 +1,38 @@
+# `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>
+```