Public-API, mehrseitige Schriftstücke, manuelle Aufträge & Mailer

Public-API (neu, directus-extension-skrift-api):
- Versionierter /v1-Namespace: POST /v1/orders, GET /v1/orders/:nr (Status
  pending/processing/shipped/cancelled), POST /v1/files (nur PDF, ≤80 MB).
- Auth über X-Api-Key (Authorization ist von Directus reserviert), SHA-256-Hash.
- Produkt-gebunden; Kuvert-only-Produkttyp; Kuvertformat automatisch (A4→DIN Lang, sonst C6);
  kein Platzhalter, kein Kunden-multipage/font_scale; Versandart englisch (single/bulk).
- Selbst gehostete Swagger-UI-Doku (/docs) + OpenAPI (/v1/openapi.json), englisch/technisch.
- Key-Hook (directus-extension-skrift-apikey): erzeugt Key automatisch, zeigt ihn
  einmalig in key_plain.

Mehrseitige Schriftstücke:
- generateLetterPages (Auto-Fluss, [[seitenumbruch]], Leerseiten-Filter).
- Preview/Order-Generierung schreiben letter_NNN_pM.svg; Seiten-Übersicht im Neuauftrag.
- Agent (skrift-agent): Seiten je Brief absteigend an den Plotter (Stapel-Reihenfolge).
- countLetterPages + /api/order/pagecount für die Seiten-Vorschau.

Manuelle Aufträge:
- Schriftgröße (Brief/Kuvert), Signatur auf dem Brief mit X/Y/Größe-Feinjustierung,
  realistische Handschrift bis in den finalen Druck durchgereicht.
- Spalten-Einfügen in der Empfängertabelle (Excel-Spalte je Zelle).

Mailer: Text-Alternative + Reply-To (Zustellbarkeit).

App: Freitext in Musteranfrage, Konfigurator-Reset, Lightbox-Seitenverhältnis +
Bild-Download, Sticky-Vorschau-Fix, Tab-Eingabe + Rechtsbündigkeit, Leerzeilen-Trim.

Bootstrap: neue Felder (font_scale_*, signatures_manual, multi_page, page_count,
realistic, shipping_day, api_client) + Collections api_clients, Produkttyp envelope.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Docker/skrift-backend/src/api/controllers/directus-controller.js

@@ -11,6 +11,8 @@
 
 const { runGeneration } = require('./order-controller');
 const directus = require('../../services/directus-service');
+const { countLetterPages } = require('../../lib/svg-generator');
+const { replacePlaceholders } = require('../../services/placeholder-service');
 
 // Directus-Formatschlüssel → Backend-Formate
 const LETTER_FORMAT = { a4: 'a4', a6_hoch: 'a6p', a6_quer: 'a6l' };
@@ -53,6 +55,20 @@ function buildDocuments(order, entries) {
   // Datei-Produkte (z. B. Unterschriftenservice): das „Schriftstück" ist das vom
   // Kunden hochgeladene Dokument – es wird NICHT generiert. Kuverts hingegen schon.
   const istDatei = order.product?.input_mode === 'datei';
+  // Kuvert-only-Produkt: es wird KEIN Schriftstück generiert, nur die (adressierten)
+  // Kuverts. Etwaige hochgeladene PDF-Briefe liegen als source_files am Auftrag.
+  const istKuvertOnly = order.product?.type === 'envelope';
+  // Natürliche Handschrift-Variation (Default an), am Auftrag gespeichert.
+  const realistisch = order.realistic !== false;
+  // Relative Schriftgröße (getrennt Brief/Kuvert), aus dem Auftrag. 1 = Standard.
+  const fontScaleLetter = Number(order.font_scale_letter) || 1;
+  const fontScaleEnv = Number(order.font_scale_envelope) || 1;
+  // Signatur(en) auf dem Brief (manuelle Aufträge): SVG je [[signaturN]] + Feinjustierung.
+  const sigManual = order.signatures_manual && typeof order.signatures_manual === 'object' ? order.signatures_manual : null;
+  const sigMap = sigManual?.signatures || {};
+  const sigOff = sigManual?.offsets || {};
+  // Mehrseitiges Schriftstück (Auto-Fluss über N Seiten) – nur wenn am Auftrag gesetzt.
+  const istMehrseitig = !!order.multi_page;
 
   const documents = [];
 
@@ -62,7 +78,7 @@ function buildDocuments(order, entries) {
     // Briefnummer 1 gehört. Vorschau nummeriert identisch (siehe skrift-orders).
     const nr = Number(entry.letter_number) || (i + 1);
 
-    if (!istDatei) {
+    if (!istDatei && !istKuvertOnly) {
       // Abweichender Text je Schriftstück (#5) hat Vorrang; sonst Standardtext.
       const briefText = (entry.text && String(entry.text).trim()) ? entry.text : (order.text_template || '');
       documents.push({
@@ -72,6 +88,11 @@ function buildDocuments(order, entries) {
         format: letterFormat,
         font,
         placeholders,
+        fontScale: fontScaleLetter,
+        signatures: sigMap,
+        signatureOffsets: sigOff,
+        multiPage: istMehrseitig,
+        realisticHandwriting: realistisch,
       });
     }
 
@@ -84,6 +105,8 @@ function buildDocuments(order, entries) {
         format: envFormat,
         font,
         placeholders,
+        fontScale: fontScaleEnv,
+        realisticHandwriting: realistisch,
       });
     }
   });
@@ -176,4 +199,27 @@ async function generateFromDirectus(req, res, next) {
   }
 }
 
-module.exports = { generateFromDirectus };
+/**
+ * POST /api/order/pagecount
+ * Body: { text, format, fontScale, entries: [{ placeholders }] }
+ * Liefert je Dokument die Seitenzahl (nur Umbruch-Zählung, kein Scriptalizer/SVG).
+ */
+function pageCounts(req, res) {
+  const { text, format, fontScale, entries } = req.body || {};
+  if (!text || !String(text).trim()) {
+    return res.status(400).json({ error: 'Invalid request', message: 'text is required' });
+  }
+  const fmt = format || 'a4';
+  const scale = Number(fontScale) || 1;
+  const list = Array.isArray(entries) && entries.length ? entries : [{}];
+  const counts = list.map((e, i) => {
+    const ph = { ...(e && typeof e.placeholders === 'object' ? e.placeholders : {}), Briefnummer: String(i + 1) };
+    let pages = 1;
+    try { pages = countLetterPages(replacePlaceholders(String(text), ph), fmt, { fontScale: scale }); }
+    catch { pages = 1; }
+    return { index: i + 1, pages };
+  });
+  return res.json({ counts });
+}
+
+module.exports = { generateFromDirectus, pageCounts };