Postkarten-Layout: Text links, Absender+Empfänger rechts, Briefmarkenfeld frei

Neues render_format-kind 'postkarte'. generatePostcardSVG setzt den Text auf die
linke Kartenhälfte, Absender (klein, oben) und Empfänger (Anschriftzone unten) auf
die rechte Hälfte; oben rechts bleibt das Briefmarkenfeld frei. Ein SVG je Karte
(ein Plotter-Durchlauf), geschrieben als letter_NNN.svg.

- page-layout: kind je Format mitführen + getFormatKind().
- svg-generator: generatePostcardSVG (Body/Absender/Empfänger über Marker
  [[pk_abs]]/[[pk_adr]] getrennt, damit alle Teile scriptalisiert werden).
- order-/preview-/directus-controller: type 'postcard' dispatchen, Marker in der
  Scriptalisierung erhalten, Postkarten-Dokument aus render_format-kind bauen.
- directus-service: kind aus render_formats mitladen.

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

src/api/controllers/directus-controller.js

@@ -12,6 +12,7 @@
 const { runGeneration } = require('./order-controller');
 const directus = require('../../services/directus-service');
 const { countLetterPages } = require('../../lib/svg-generator');
+const { getFormatKind } = require('../../lib/page-layout');
 const { replacePlaceholders } = require('../../services/placeholder-service');
 
 // Directus-Formatschlüssel → Backend-Formate
@@ -55,6 +56,9 @@ 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';
+  // Postkarte: Text links, Absender+Empfänger rechts, Briefmarkenfeld frei – ein SVG
+  // je Karte (kein separater Umschlag). Erkennung über die render_format-Art.
+  const istPostkarte = getFormatKind(letterFormat) === 'postkarte';
   // 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';
@@ -80,6 +84,21 @@ function buildDocuments(order, entries) {
 
     // Abweichender Text je Schriftstück hat Vorrang; sonst Standardtext.
     const briefText = (entry.text && String(entry.text).trim()) ? entry.text : (order.text_template || '');
+
+    // Postkarte: EIN Dokument mit Text + Absender + Empfänger (über Marker getrennt).
+    if (istPostkarte) {
+      const recip = addressText(entry);
+      const sender = order.envelope_sender ? String(order.envelope_sender).trim() : '';
+      let combined = String(briefText || '');
+      if (sender) combined += `[[pk_abs]]${sender}`;
+      if (recip) combined += `[[pk_adr]]${recip}`;
+      documents.push({
+        index: nr, type: 'postcard', text: combined, format: letterFormat, font,
+        placeholders, fontScale: fontScaleLetter, realisticHandwriting: realistisch,
+      });
+      return;
+    }
+
     // Kein Schriftstück erzeugen, wenn kein Text hinterlegt ist (z. B. „nur Kuverts drucken").
     if (!istDatei && !istKuvertOnly && String(briefText).trim()) {
       documents.push({

src/api/controllers/order-controller.js

@@ -3,7 +3,7 @@ const fsSync = require('fs');
 const path = require('path');
 const config = require('../../config');
 const { scriptalizeBatch } = require('../../services/scriptalizer-service');
-const { generateLetterSVG, generateEnvelopeSVG, generateLetterPages } = require('../../lib/svg-generator');
+const { generateLetterSVG, generateEnvelopeSVG, generatePostcardSVG, generateLetterPages } = require('../../lib/svg-generator');
 const { replacePlaceholders, generateAllCSVs } = require('../../services/placeholder-service');
 const { TAB_MARKER } = require('../../lib/svg-font-engine');
 
@@ -220,7 +220,7 @@ async function runGeneration({ orderNumber, letters, metadata }) {
 
       for (const letter of fontLetters) {
         const raw = letter.processedText;
-        const parts = raw.split(/(\t|\[\[signatur\d+\]\]|\[\[seitenumbruch\]\]|[&|])/gi);
+        const parts = raw.split(/(\t|\[\[signatur\d+\]\]|\[\[seitenumbruch\]\]|\[\[pk_abs\]\]|\[\[pk_adr\]\]|[&|])/gi);
         const segments = [], markers = [];
         for (let i = 0; i < parts.length; i++) {
           if (i % 2 === 0) segments.push(parts[i]);
@@ -272,6 +272,7 @@ async function runGeneration({ orderNumber, letters, metadata }) {
       const letter = processedLetters[i];
       const absoluteIndex = letter.index !== undefined ? letter.index : i;
       const isEnv = letter.type === 'envelope';
+      const isPostcard = letter.type === 'postcard';
       const pad = String(absoluteIndex).padStart(3, '0');
 
       // Mehrseitiger Brief → N Seiten-Dateien letter_NNN_pM.svg (Seite 1..N).
@@ -332,6 +333,11 @@ async function runGeneration({ orderNumber, letters, metadata }) {
             scriptalizedText, letter.format, letter.envelopeType,
             { font: letter.font, realisticHandwriting: letter.realisticHandwriting ?? false, fontScale: letter.fontScale, sender: metadata.envelopeSender || '', senderScale: metadata.envelopeSenderScale || 1 }
           );
+        } else if (isPostcard) {
+          svgResult = generatePostcardSVG(
+            scriptalizedText, letter.format,
+            { font: letter.font, realisticHandwriting: letter.realisticHandwriting ?? false, fontScale: letter.fontScale, senderScale: metadata.envelopeSenderScale || 1 }
+          );
         } else {
           svgResult = generateLetterSVG(
             scriptalizedText, letter.format,

src/api/controllers/preview-controller.js

@@ -7,6 +7,7 @@ const { scriptalizeBatch } = require("../../services/scriptalizer-service");
 const {
   generateLetterSVG,
   generateEnvelopeSVG,
+  generatePostcardSVG,
   generateLetterPages,
 } = require("../../lib/svg-generator");
 const {
@@ -101,7 +102,7 @@ async function generateBatch(req, res, next) {
     for (const letter of processedLetters) {
       const raw = letter.processedText;
       // Splitten an \t UND [[signaturN]] (mit capture-Gruppe → Marker bleiben erhalten)
-      const parts = raw.split(/(\t|\[\[signatur\d+\]\]|\[\[seitenumbruch\]\]|[&|])/gi);
+      const parts = raw.split(/(\t|\[\[signatur\d+\]\]|\[\[seitenumbruch\]\]|\[\[pk_abs\]\]|\[\[pk_adr\]\]|[&|])/gi);
       const segments = [], markers = [];
       for (let i = 0; i < parts.length; i++) {
         if (i % 2 === 0) segments.push(parts[i]);
@@ -177,6 +178,19 @@ async function generateBatch(req, res, next) {
             lineCount: svgResult.lineCount, lineLimit: svgResult.lineLimit, overflow: svgResult.overflow,
             recipientName: null,
           });
+        } else if (letter.type === "postcard") {
+          const svgResult = generatePostcardSVG(scriptalizedText, letter.format, {
+            font: letter.font, realisticHandwriting: letter.realisticHandwriting ?? false,
+            fontScale: letter.fontScale, senderScale: letter.senderScale || 1,
+          });
+          if (svgResult.overflow) hasOverflow = true;
+          const filename = `letter_${pad}.svg`;
+          await fs.writeFile(path.join(sessionDir, filename), svgResult.svg, "utf8");
+          files.push({
+            index: absoluteIndex, filename, url: `/api/preview/${finalSessionId}/${filename}`,
+            lineCount: svgResult.lineCount, lineLimit: svgResult.lineLimit, overflow: svgResult.overflow,
+            recipientName,
+          });
         } else if (letter.multiPage) {
           // Mehrseitiger Brief: Text fließt über N Seiten – kein Überlauf-Fehler.
           const { pages } = generateLetterPages(scriptalizedText, letter.format, {

src/lib/page-layout.js

@@ -21,11 +21,14 @@ const DEFAULT_PAGE_FORMATS = {
   din_lang: { widthMm: 220, heightMm: 110 },
   c6: { widthMm: 162, heightMm: 114 },
 };
+// Art des Formats (brief/umschlag/postkarte) – steuert, WAS generiert wird.
+const DEFAULT_KINDS = { a4: 'brief', a6p: 'brief', a6l: 'brief', din_lang: 'umschlag', c6: 'umschlag' };
 
 // Live-Cache (wird von applyRenderFormats ersetzt). Start = Defaults.
 let LINE_LIMITS = { ...DEFAULT_LINE_LIMITS };
 let FORMAT_LAYOUTS = { ...DEFAULT_FORMAT_LAYOUTS };
 let PAGE_FORMATS = { ...DEFAULT_PAGE_FORMATS };
+let KINDS = { ...DEFAULT_KINDS };
 
 /**
  * Übernimmt Format-Definitionen aus Directus (render_formats) in den Cache.
@@ -37,9 +40,11 @@ function applyRenderFormats(rows) {
   const pf = { ...DEFAULT_PAGE_FORMATS };
   const fl = { ...DEFAULT_FORMAT_LAYOUTS };
   const ll = { ...DEFAULT_LINE_LIMITS };
+  const kn = { ...DEFAULT_KINDS };
   for (const r of Array.isArray(rows) ? rows : []) {
     const k = String(r.key || '').toLowerCase();
     if (!k) continue;
+    if (r.kind) kn[k] = String(r.kind).toLowerCase();
     if (r.page_width_mm && r.page_height_mm) {
       pf[k] = { widthMm: Number(r.page_width_mm), heightMm: Number(r.page_height_mm) };
     }
@@ -57,6 +62,12 @@ function applyRenderFormats(rows) {
   PAGE_FORMATS = pf;
   FORMAT_LAYOUTS = fl;
   LINE_LIMITS = ll;
+  KINDS = kn;
+}
+
+// Art eines Formats (brief/umschlag/postkarte). Unbekannt → 'brief'.
+function getFormatKind(format) {
+  return KINDS[String(format).toLowerCase()] || 'brief';
 }
 
 // mm in Pixel umrechnen
@@ -139,6 +150,7 @@ module.exports = {
   getLayoutForFormat,
   getPageDimensions,
   getLineLimit,
+  getFormatKind,
   escapeXml,
   applyRenderFormats,
   setFormatMissHandler,

src/lib/svg-generator.js

@@ -412,6 +412,114 @@ function generateEnvelopeSVG(text, format, type, options = {}) {
   return { svg: svg.trim(), overflow: lineCount > lineLimit, lineCount, lineLimit };
 }
 
+// Postkarten-Marker: teilen den (bereits scriptalisierten) Text in Body/Absender/
+// Empfänger. Werden in der Scriptalisierung wie [[signaturN]] als Marker erhalten.
+const PK_ABS = '[[pk_abs]]';
+const PK_ADR = '[[pk_adr]]';
+function splitPostcardText(text) {
+  let rest = String(text || '');
+  let recipient = '';
+  let sender = '';
+  const iAdr = rest.indexOf(PK_ADR);
+  if (iAdr >= 0) { recipient = rest.slice(iAdr + PK_ADR.length); rest = rest.slice(0, iAdr); }
+  const iAbs = rest.indexOf(PK_ABS);
+  if (iAbs >= 0) { sender = rest.slice(iAbs + PK_ABS.length); rest = rest.slice(0, iAbs); }
+  return { body: rest.trim(), sender: sender.trim(), recipient: recipient.trim() };
+}
+
+/**
+ * Postkarte (einseitig): Text auf der LINKEN Hälfte, Absender + Empfänger auf der
+ * RECHTEN Hälfte, Briefmarkenfeld (leerer Bereich) oben rechts. Für A6/DIN-lang-
+ * Postkarten – ein SVG je Karte (ein Plotter-Durchlauf). Der Text kommt bereits
+ * scriptalisiert an und enthält die Marker [[pk_abs]] / [[pk_adr]].
+ */
+function generatePostcardSVG(text, format, options = {}) {
+  const fontKey = normalizeFontKey(options.font);
+  const fontConfig = SVG_FONT_CONFIG[fontKey];
+  const realistic = options.realisticHandwriting ?? false;
+
+  const { widthPx, heightPx, widthMm, heightMm } = getPageDimensions(format);
+  const { marginTopPx, marginLeftPx, lineHeightPx: baseLineHeightPx } = getLayoutForFormat(format);
+
+  const { body, sender, recipient } = splitPostcardText(text);
+
+  const fontScale = Math.max(0.8, Math.min(1.5, Number(options.fontScale) || 1));
+  const fontSizePx = FONT_SIZE_PX * fontScale;
+  const lineHeightPx = baseLineHeightPx * fontScale;
+
+  // Zonen: linke Hälfte Text, rechte Hälfte Adresse; Briefmarke oben rechts frei.
+  const textLeft = marginLeftPx;
+  const textRight = widthPx * 0.48;
+  const textWidth = Math.max(mmToPx(30), textRight - textLeft);
+  const addrLeft = widthPx * 0.52;
+  const addrRight = widthPx - mmToPx(8);
+  const addrWidth = Math.max(mmToPx(30), addrRight - addrLeft);
+  const stampW = mmToPx(25);
+  const stampX = widthPx - mmToPx(6) - stampW;
+
+  const paths = [];
+  let bodyLineCount = 0;
+
+  // Text links.
+  if (body) {
+    const bodyLines = wrapTextToLinesByWidth({ text: body, maxWidthPx: textWidth, fontFileName: fontConfig.file, fontSizePx });
+    bodyLineCount = bodyLines.length;
+    paths.push(...layoutTextToPaths({
+      lines: bodyLines, fontFileName: fontConfig.file, fontSizePx,
+      startX: textLeft, startY: marginTopPx + fontSizePx, lineHeightPx, realisticHandwriting: realistic,
+    }));
+  }
+
+  // Absender klein oben in der Adresszone, links neben dem Briefmarkenfeld.
+  if (sender) {
+    const senderScale = Math.max(0.5, Math.min(2, Number(options.senderScale) || 1));
+    const senderSize = FONT_SIZE_PX * 0.7 * senderScale;
+    const senderLH = lineHeightPx * (senderSize / fontSizePx);
+    const senderWidth = Math.max(mmToPx(30), Math.min(addrWidth, stampX - addrLeft - mmToPx(3)));
+    const senderLines = wrapTextToLinesByWidth({ text: sender, maxWidthPx: senderWidth, fontFileName: fontConfig.file, fontSizePx: senderSize });
+    paths.push(...layoutTextToPaths({
+      lines: senderLines, fontFileName: fontConfig.file, fontSizePx: senderSize,
+      startX: addrLeft, startY: mmToPx(8) + senderSize, lineHeightPx: senderLH, realisticHandwriting: realistic,
+    }));
+  }
+
+  // Empfänger in der unteren Hälfte der Adresszone (klassische Anschriftzone).
+  if (recipient) {
+    const recLines = wrapTextToLinesByWidth({ text: recipient, maxWidthPx: addrWidth, fontFileName: fontConfig.file, fontSizePx });
+    const recBottom = heightPx * 0.90;
+    const recStartY = recBottom - Math.max(0, recLines.length - 1) * lineHeightPx;
+    paths.push(...layoutTextToPaths({
+      lines: recLines, fontFileName: fontConfig.file, fontSizePx,
+      startX: addrLeft, startY: recStartY, lineHeightPx, realisticHandwriting: realistic,
+    }));
+  }
+
+  const pathElements = paths
+    .map((p) => `<path d="${escapeXml(p.d)}"
+        transform="${p.transform}"
+        stroke="#000000"
+        stroke-width="0.6"
+        fill="none"
+        stroke-linecap="round"
+        stroke-linejoin="round"
+        vector-effect="non-scaling-stroke"
+      />`)
+    .join('\n  ');
+
+  const svg = `<svg xmlns="http://www.w3.org/2000/svg"
+     width="${widthMm}mm"
+     height="${heightMm}mm"
+     viewBox="0 0 ${widthPx} ${heightPx}">
+  <rect x="0" y="0" width="${widthPx}" height="${heightPx}" fill="#FFFFFF" />
+  ${pathElements}
+</svg>`;
+
+  // Überlauf: passt der Text in die linke Hälfte (Höhe)?
+  const available = heightPx - (marginTopPx + fontSizePx) - fontSizePx * 0.5;
+  const lineLimit = Math.max(1, Math.floor(available / lineHeightPx) + 1);
+  return { svg: svg.trim(), overflow: bodyLineCount > lineLimit, lineCount: bodyLineCount, lineLimit };
+}
+
 /**
  * Mehrseitiges Schriftstück: Der Text fließt automatisch über so viele Seiten,
  * wie nötig (linesPerPage = Zeilenlimit des Formats). Ein erzwungener Umbruch ist
@@ -507,6 +615,7 @@ function countLetterPages(text, format, options = {}) {
 module.exports = {
   generateLetterSVG,
   generateEnvelopeSVG,
+  generatePostcardSVG,
   generateLetterPages,
   countLetterPages
 };

src/services/directus-service.js

@@ -106,7 +106,7 @@ async function fetchAssetBuffer(fileId) {
 async function fetchRenderFormats() {
   return directusFetch(
     '/items/render_formats?filter[active][_eq]=true&limit=-1' +
-    '&fields=key,page_width_mm,page_height_mm,margin_top_mm,margin_left_mm,margin_right_mm,line_height_factor,line_limit',
+    '&fields=key,kind,page_width_mm,page_height_mm,margin_top_mm,margin_left_mm,margin_right_mm,line_height_factor,line_limit',
   );
 }