Strichcode mit dem Kassenartikel auf den Bon drucken

Der Kassierer musste den Artikel bisher von Hand in der Kasse suchen. Jetzt
steht er als Strichcode unter dem Betrag und wird gescannt.

CODE128 in Zeichensatz B, nicht das sonst uebliche CODE39: dort sind nur
Grossbuchstaben erlaubt, ein Artikel namens "techniker" waere damit nicht
darstellbar. Die Modulbreite waehlt escpos.js so gross, wie die Papierbreite
zulaesst - breitere Balken liest ein Handscanner zuverlaessiger, gerade auf
Thermopapier, das einen Tag in einer Hosentasche hinter sich hat. Daraus
ergibt sich die Laengengrenze von 17 Zeichen bei 80 mm Papier.

Artikelname und An/Aus liegen in den Einstellungen, nicht im Code: der Name
haengt am Artikelstamm der Kasse und kann sich aendern, ohne dass jemand an
die App muss.

Zwei Faelle, die sonst still danebengingen, melden sich jetzt:
- Umlaute und Sonderzeichen weist das Speichern ab, statt sie zu verschlucken
  und einen Code zu drucken, der einen anderen Artikel bedeutet.
- Passt der Name nicht auf die Papierbreite, druckt receipt.js ihn nur in
  Klarschrift. Ein abgeschnittener Code wird von keinem Scanner gelesen.

Geprueft auf dem Epson TM-T88IV: Zwischenbeleg und Endbeleg, ausgeschalteter
Strichcode, Laengengrenze, geschweifte Klammer im Namen (wird verdoppelt,
sonst liest der Drucker sie als Umschaltbefehl).

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

backend/receipt.js

@@ -10,7 +10,7 @@
  * dem Zielhost gebaut wurde.
  */
 
-const { Bon } = require('./escpos');
+const { Bon, barcodeMaxLength } = require('./escpos');
 
 const p2 = n => String(n).padStart(2, '0');
 
@@ -59,6 +59,7 @@ function unitCount(ms, rateInterval) {
  * @param {boolean} data.stillRunning
  * @param {string} data.header      Kopfzeilen, durch \n getrennt
  * @param {string} data.footer      Fusszeilen, durch \n getrennt
+ * @param {string} data.barcode     Artikelname fuer den Strichcode; leer = keiner
  * @param {number} data.width       Zeichen je Zeile
  * @returns {Buffer}
  */
@@ -117,6 +118,29 @@ function buildReceipt(data) {
     bon.line();
     bon.hr();
 
+    // --- Strichcode fuer die Kasse ------------------------------------------
+    // Der Kassierer soll den Artikel nicht in einer Liste suchen muessen: der
+    // Code enthaelt genau den Namen, unter dem die Kasse die Leistung fuehrt.
+    // Die Klarschrift darunter druckt der Drucker selbst mit - sie rettet den
+    // Vorgang, wenn der Scanner streikt oder das Papier geknickt ist.
+    if (data.barcode) {
+        bon.line();
+        bon.align('center');
+        bon.line('Artikel für die Kasse');
+        if (data.barcode.length <= barcodeMaxLength(width)) {
+            bon.barcode(data.barcode);
+        } else {
+            // Breiter als das Papier. Ein abgeschnittener Code wird von keinem
+            // Scanner gelesen, also lieber gar keiner: der Name allein reicht
+            // zum Eintippen. Passieren kann das nur, wenn die Papierbreite
+            // nachtraeglich kleiner gestellt wurde.
+            bon.bold(true).line(data.barcode).bold(false);
+        }
+        bon.align('left');
+        bon.line();
+        bon.hr();
+    }
+
     // --- Fuss ---------------------------------------------------------------
     bon.align('center');
     if (interim) {
@@ -140,12 +164,40 @@ function buildReceipt(data) {
     return bon.build();
 }
 
+/**
+ * Strichcodes aus der Bytefolge herausloesen und durch ihren Inhalt ersetzen.
+ *
+ * Eigene Schleife statt eines Ausdrucks, weil bei "GS k" die Laenge der Daten
+ * in einem Byte MITTEN in der Sequenz steht - wie weit zu springen ist, weiss
+ * man also erst beim Lesen. Genau das kann ein regulaerer Ausdruck nicht.
+ */
+function stripBarcode(s) {
+    let aus = '';
+    let i = 0;
+    while (i < s.length) {
+        if (s.charCodeAt(i) === 0x1d && s[i + 1] === 'k' &&
+            s.charCodeAt(i + 2) >= 65 && s.charCodeAt(i + 2) <= 73) {
+            const laenge = s.charCodeAt(i + 3);
+            const daten = s.substr(i + 4, laenge)
+                .replace(/^\{[ABC]/, '')        // Wahl des Zeichensatzes
+                .split('{{').join('{');         // verdoppelte Klammer zuruecknehmen
+            aus += `[Strichcode: ${daten}]\n`;
+            i += 4 + laenge;
+            continue;
+        }
+        aus += s[i];
+        i++;
+    }
+    return aus;
+}
+
 /** Bon als reiner Text - fuer Vorschau, Tests und das Journal. */
 function toPlainText(buffer) {
-    return buffer.toString('latin1')
+    return stripBarcode(buffer.toString('latin1'))
         .replace(/\x1b@/g, '')                  // Zuruecksetzen
         .replace(/\x1b[tadEG!-][\s\S]/g, '')    // ESC + Kennbuchstabe + 1 Byte
         .replace(/\x1d![\s\S]/g, '')            // GS !  Zeichengroesse
+        .replace(/\x1d[hwHf][\s\S]/g, '')       // GS h/w/H/f  Masse des Strichcodes
         .replace(/\x1dV[\s\S]{2}/g, '')         // GS V  Schnitt
         .replace(/\x80/g, 'EUR')
         .replace(/\n{3,}/g, '\n\n')