diff --git a/src/api/controllers/directus-controller.js b/src/api/controllers/directus-controller.js
index 08004ea..63bc7ea 100644
--- a/src/api/controllers/directus-controller.js
+++ b/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({
diff --git a/src/api/controllers/order-controller.js b/src/api/controllers/order-controller.js
index 2f11c17..67fe62b 100644
--- a/src/api/controllers/order-controller.js
+++ b/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,
diff --git a/src/api/controllers/preview-controller.js b/src/api/controllers/preview-controller.js
index 912401c..1c3be95 100644
--- a/src/api/controllers/preview-controller.js
+++ b/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, {
diff --git a/src/lib/page-layout.js b/src/lib/page-layout.js
index e31d050..c307afc 100644
--- a/src/lib/page-layout.js
+++ b/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,
diff --git a/src/lib/svg-generator.js b/src/lib/svg-generator.js
index 7eb7975..ae05810 100644
--- a/src/lib/svg-generator.js
+++ b/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) => ``)
+ .join('\n ');
+
+ const 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
};
diff --git a/src/services/directus-service.js b/src/services/directus-service.js
index ce81afd..8e5e146 100644
--- a/src/services/directus-service.js
+++ b/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',
);
}