From 8030d3d0ec9b8bd469a9921b992086be728f091c Mon Sep 17 00:00:00 2001 From: s4luorth Date: Fri, 11 Sep 2026 13:58:06 +0200 Subject: [PATCH] =?UTF-8?q?Postkarten-Layout:=20Text=20links,=20Absender+E?= =?UTF-8?q?mpf=C3=A4nger=20rechts,=20Briefmarkenfeld=20frei?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 --- src/api/controllers/directus-controller.js | 19 ++++ src/api/controllers/order-controller.js | 10 +- src/api/controllers/preview-controller.js | 16 ++- src/lib/page-layout.js | 12 +++ src/lib/svg-generator.js | 109 +++++++++++++++++++++ src/services/directus-service.js | 2 +- 6 files changed, 164 insertions(+), 4 deletions(-) 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 = ` + + ${pathElements} +`; + + // Ü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', ); }