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

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

tasks/email.md

@@ -0,0 +1,34 @@
+# `email` — E-Mail versenden
+
+**Zweck:** Versendet eine E-Mail (ohne Benutzerinteraktion) mit Betreff, Text und optionalen Anhängen. Der Versand erfolgt über den Mail-Spooler des Systems; Empfänger, Betreff, Text und Anhänge unterstützen Platzhalter. Im Testmodus (`test_modus_mail` gesetzt) wird der Empfänger umgeleitet und CC/BCC unterdrückt.
+
+**Parameter**
+
+| Name | Pflicht? | Default | Beschreibung |
+|---|---|---|---|
+| `an` | **ja** | — | Empfängeradresse(n) |
+| `titel` | **ja** | — | Betreff |
+| `text` | **ja** | — | Mailtext (HTML erlaubt, CDATA empfohlen) |
+| `cc` | nein | — | CC-Empfänger, kommagetrennt |
+| `bcc` | nein | — | BCC-Empfänger, kommagetrennt |
+| `attachments/file` | nein | — | Ein `<file>`-Element je Anhang (Pfad); optionales Attribut `name="…"` setzt einen sprechenden Anzeigenamen (ebenfalls mit Platzhaltern), sonst wird der Dateiname des Pfads verwendet |
+
+**Eingangswerte:** Beliebige Kontextvariablen in allen Feldern. Zwei Komfort-Anreicherungen (nur für das Rendern dieser Mail):
+- Jede Variable mit Suffix `_json`, die gültiges JSON enthält, steht zusätzlich ohne Suffix als Liste zur Verfügung — nutzbar als Template-Section: `{{#mkz_auswahl}}<li>{{mkz}} — {{name}}</li>{{/mkz_auswahl}}`
+- Ist `{{vkz}}` gesetzt, werden `{{tg_name}}` und `{{tg_kurzname}}` automatisch nachgeschlagen, sofern noch nicht vorhanden.
+
+**Ausgangswerte:** keine.
+
+```xml
+<task type="email" id="info_mail">
+  <config>
+    <an>{{gewaehlte_person_mail}}</an>
+    <cc>info@example.org</cc>
+    <titel>Neuer Vorgang {{WORKFLOW_ID}}</titel>
+    <text><![CDATA[Sehr geehrte Damen und Herren, ...]]></text>
+    <attachments>
+      <file name="Antrag_{{vkz}}.pdf">{{latest_pdf_path}}</file>
+    </attachments>
+  </config>
+</task>
+```