Nur Kuverts: kein Schriftstueck erzeugen, wenn kein Text hinterlegt ist

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

src/api/controllers/directus-controller.js

@@ -78,9 +78,10 @@ function buildDocuments(order, entries) {
     // Briefnummer 1 gehört. Vorschau nummeriert identisch (siehe skrift-orders).
     const nr = Number(entry.letter_number) || (i + 1);
 
-    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 || '');
+    // Abweichender Text je Schriftstück hat Vorrang; sonst Standardtext.
+    const briefText = (entry.text && String(entry.text).trim()) ? entry.text : (order.text_template || '');
+    // Kein Schriftstück erzeugen, wenn kein Text hinterlegt ist (z. B. „nur Kuverts drucken").
+    if (!istDatei && !istKuvertOnly && String(briefText).trim()) {
       documents.push({
         index: nr,
         type: 'letter',
@@ -167,6 +168,9 @@ async function generateFromDirectus(req, res, next) {
         previewSession: order.preview_session || null,
         // Eingegebener Brieftext → als brieftext.txt im Ausgabeordner ablegen.
         rawText: order.text_template || null,
+        // Absender fürs Kuvert (manuelle Aufträge): oben links, Empfänger unten rechts.
+        envelopeSender: order.envelope_sender || null,
+        envelopeSenderScale: Number(order.envelope_sender_scale) || 1,
       },
     });
 

src/api/controllers/order-controller.js

@@ -311,8 +311,9 @@ async function runGeneration({ orderNumber, letters, metadata }) {
       const filepath = isEnv ? path.join(envelopesDir, filename) : path.join(outputDir, filename);
 
       // 1:1 aus der Vorschau übernehmen, wenn für dieses Dokument eine
-      // Vorschau-Datei existiert.
-      if (previewSession) {
+      // Vorschau-Datei existiert. Ausnahme: Kuvert mit Absender – das wird frisch
+      // gerendert, damit der Absender (oben links) sicher drauf ist.
+      if (previewSession && !(isEnv && metadata.envelopeSender)) {
         const cached = path.join(previewsRoot, previewSession, filename);
         try {
           await fs.access(cached);
@@ -329,7 +330,7 @@ async function runGeneration({ orderNumber, letters, metadata }) {
         if (isEnv) {
           svgResult = generateEnvelopeSVG(
             scriptalizedText, letter.format, letter.envelopeType,
-            { font: letter.font, realisticHandwriting: letter.realisticHandwriting ?? false, fontScale: letter.fontScale }
+            { font: letter.font, realisticHandwriting: letter.realisticHandwriting ?? false, fontScale: letter.fontScale, sender: metadata.envelopeSender || '', senderScale: metadata.envelopeSenderScale || 1 }
           );
         } else {
           svgResult = generateLetterSVG(

src/api/controllers/preview-controller.js

@@ -167,7 +167,7 @@ async function generateBatch(req, res, next) {
         if (letter.type === "envelope") {
           const svgResult = generateEnvelopeSVG(
             scriptalizedText, letter.format, letter.envelopeType,
-            { font: letter.font, realisticHandwriting: letter.realisticHandwriting ?? false, fontScale: letter.fontScale }
+            { font: letter.font, realisticHandwriting: letter.realisticHandwriting ?? false, fontScale: letter.fontScale, sender: letter.sender || '', senderScale: letter.senderScale || 1 }
           );
           if (svgResult.overflow) hasOverflow = true;
           const filename = `envelope_${pad}.svg`;

src/lib/page-layout.js

@@ -57,7 +57,6 @@ function applyRenderFormats(rows) {
   PAGE_FORMATS = pf;
   FORMAT_LAYOUTS = fl;
   LINE_LIMITS = ll;
-  signaledMisses.clear();
 }
 
 // mm in Pixel umrechnen
@@ -72,12 +71,12 @@ function mmToPx(mm) {
 // stündliche Aktualisierung abzuwarten. Für DIESEN Aufruf greift noch der
 // Default – der nächste Aufruf hat das Format.
 let missHandler = null;
-const signaledMisses = new Set();
 function setFormatMissHandler(fn) { missHandler = fn; }
 function signalMiss(key) {
   const k = String(key || '').toLowerCase();
-  if (!missHandler || !k || signaledMisses.has(k)) return;
-  signaledMisses.add(k);
+  if (!missHandler || !k) return;
+  // Kein „schon gemeldet"-Merker mehr: sonst blieb ein Key hängen, wenn die
+  // Nachlade-Drossel gerade griff. Die Drossel im Handler verhindert Dauerfeuer.
   try { missHandler(k); } catch { /* egal */ }
 }
 

src/lib/svg-generator.js

@@ -294,8 +294,10 @@ function generateEnvelopeSVG(text, format, type, options = {}) {
     startX = 0; // Dummy-Wert, wird für jede Zeile überschrieben
 
   } else {
-    // type === 'recipient' / 'free': Links, max. 60% der Umschlagsbreite
-    const maxWidthPx = Math.min(widthPx - marginLeftPx - 20, widthPx * 0.6);
+    // type === 'recipient' / 'free'. Ist ein Absender gesetzt, sitzt der
+    // Empfänger UNTEN RECHTS (klassisches Kuvert), sonst wie bisher oben links.
+    const hatAbsender = !!String(options.sender || '').trim();
+    const maxWidthPx = Math.min(widthPx - marginLeftPx - 20, widthPx * (hatAbsender ? 0.36 : 0.6));
 
     lines = wrapTextToLinesByWidth({
       text: String(text || ''),
@@ -304,8 +306,16 @@ function generateEnvelopeSVG(text, format, type, options = {}) {
       fontSizePx,
     });
 
-    startX = marginLeftPx;
-    startY = marginTopPx + fontSizePx;
+    if (hatAbsender) {
+      // Empfänger unten rechts – bewusst über Höhen-/Breiten-Anteile, damit der
+      // große Kuvert-Rand (marginTop bis ~50 % der Höhe) nicht alles nach oben zieht.
+      startX = Math.round(widthPx * 0.60);
+      const untenBaseline = heightPx * 0.80; // unterste Zeile ~20 % über der Unterkante
+      startY = Math.round(untenBaseline - Math.max(0, lines.length - 1) * lineHeightPx);
+    } else {
+      startX = marginLeftPx;
+      startY = marginTopPx + fontSizePx;
+    }
   }
 
   let paths = [];
@@ -347,6 +357,28 @@ function generateEnvelopeSVG(text, format, type, options = {}) {
     });
   }
 
+  // Absender oben links – nur wenn gesetzt und kein zentrierter Freitext.
+  const absender = String(options.sender || '').trim();
+  if (absender && type !== 'custom') {
+    // Eigene Absender-Größe (Prozent, 1 = 100%). Grundgröße = Empfänger-Grundschrift
+    // (früher fix 0.62 → zu klein). Über options.senderScale prozentual einstellbar.
+    const senderScale = Math.max(0.5, Math.min(2, Number(options.senderScale) || 1));
+    const absSize = FONT_SIZE_PX * senderScale;
+    const absLH = lineHeightPx * (absSize / fontSizePx);
+    const absLines = absender.split('\n').map((l) => l.replace(/\s+$/, ''));
+    const absPaths = layoutTextToPaths({
+      lines: absLines,
+      fontFileName: fontConfig.file,
+      fontSizePx: absSize,
+      // Echt oben links – unabhängig vom großen Kuvert-Rand.
+      startX: Math.round(widthPx * 0.06),
+      startY: Math.round(heightPx * 0.14),
+      lineHeightPx: absLH,
+      realisticHandwriting: options.realisticHandwriting ?? false,
+    });
+    paths = [...paths, ...absPaths];
+  }
+
   const pathElements = paths
     .map(
       (p) => `<path d="${escapeXml(p.d)}"

src/server.js

@@ -27,10 +27,11 @@ async function refreshRenderFormats() {
   }
 }
 
-// Unbekanntes Format angefragt → sofort nachladen (max. alle 30 s, damit ein
-// dauerhaft unbekanntes Format kein Dauerfeuer auslöst).
+// Unbekanntes Format angefragt → sofort nachladen (max. alle 5 s, damit ein
+// dauerhaft unbekanntes Format kein Dauerfeuer auslöst). Neu in Directus angelegte
+// Formate sind damit ohne Backend-Neustart binnen weniger Sekunden aktiv.
 setFormatMissHandler((key) => {
-  if (Date.now() - lastFormatRefresh < 30 * 1000) return;
+  if (Date.now() - lastFormatRefresh < 5 * 1000) return;
   console.log(`[Formate] Unbekanntes Format "${key}" angefragt – lade Formate nach.`);
   refreshRenderFormats();
 });

src/services/directus-service.js

@@ -41,7 +41,7 @@ async function directusFetch(path, options = {}) {
 async function fetchOrder(orderId) {
   const fields = [
     'id', 'order_number', 'customer_email', 'font', 'status',
-    'needs_envelope', 'envelope_labeling', 'envelope_text', 'envelope_format',
+    'needs_envelope', 'envelope_labeling', 'envelope_text', 'envelope_format', 'envelope_sender', 'envelope_sender_scale',
     'text_template', 'motif_mode', 'own_cards', 'entries_count', 'preview_session',
     'source_file', 'product.key', 'product.type', 'product.input_mode', 'format.key',
     'font_scale_letter', 'font_scale_envelope', 'signatures_manual', 'multi_page', 'realistic',