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/server.js

@@ -18,6 +18,7 @@ require('dotenv').config();
 const oidc = require('./oidc');
 const printer = require('./printer');
 const { buildReceipt } = require('./receipt');
+const { barcodeMaxLength } = require('./escpos');
 const { provision } = require('./provision');
 
 const app = express();
@@ -152,6 +153,12 @@ async function initDatabase() {
             ['Bitte an der Kasse bezahlen.\nVielen Dank fuer Ihren Besuch!']);
         await dbRun(`INSERT OR IGNORE INTO settings (key,value) VALUES ('print_auto_on_stop','1')`);
 
+        // Strichcode fuer die Kasse: der Kassierer soll den Artikel scannen
+        // koennen, statt ihn zu suchen. Der Name steht hier und nicht im Code,
+        // weil er sich mit dem Artikelstamm der Kasse aendern kann.
+        await dbRun(`INSERT OR IGNORE INTO settings (key,value) VALUES ('receipt_barcode_enabled','1')`);
+        await dbRun(`INSERT OR IGNORE INTO settings (key,value) VALUES ('receipt_barcode_article','techniker')`);
+
         // Druckerzugang: die .env liefert nur die ERSTEN Werte. Danach lebt die
         // Konfiguration in der Datenbank, damit die Oberflaeche einen neuen Pi
         // einrichten kann, ohne dass jemand auf den Server muss.
@@ -213,15 +220,19 @@ async function refreshPrinterConfig() {
     return cfg;
 }
 
-/** Bon-Einstellungen: Kopf-/Fusstext und ob beim Beenden automatisch gedruckt wird. */
+/** Bon-Einstellungen: Kopf-/Fusstext, Strichcode und der Druck beim Beenden. */
 async function getPrintSettings() {
     const rows = await dbAll(
-        `SELECT key, value FROM settings WHERE key IN ('receipt_header','receipt_footer','print_auto_on_stop')`);
+        `SELECT key, value FROM settings WHERE key IN
+         ('receipt_header','receipt_footer','print_auto_on_stop',
+          'receipt_barcode_enabled','receipt_barcode_article')`);
     const map = Object.fromEntries(rows.map(r => [r.key, r.value]));
     return {
         receiptHeader: map.receipt_header || '',
         receiptFooter: map.receipt_footer || '',
-        printAutoOnStop: map.print_auto_on_stop !== '0'
+        printAutoOnStop: map.print_auto_on_stop !== '0',
+        receiptBarcodeEnabled: map.receipt_barcode_enabled !== '0',
+        receiptBarcodeArticle: map.receipt_barcode_article || ''
     };
 }
 
@@ -277,6 +288,7 @@ async function printReceipt(vorgang) {
             ...vorgang,
             header: texte.receiptHeader,
             footer: texte.receiptFooter,
+            barcode: texte.receiptBarcodeEnabled ? texte.receiptBarcodeArticle : '',
             width: printer.width()
         });
         const res = await printer.print(daten);
@@ -673,6 +685,29 @@ app.put('/api/settings', requireAuth, wrap(async (req, res) => {
     if (typeof b.printAutoOnStop === 'boolean') {
         await setSetting('print_auto_on_stop', b.printAutoOnStop ? '1' : '0');
     }
+    if (typeof b.receiptBarcodeEnabled === 'boolean') {
+        await setSetting('receipt_barcode_enabled', b.receiptBarcodeEnabled ? '1' : '0');
+    }
+    if (typeof b.receiptBarcodeArticle === 'string') {
+        const artikel = b.receiptBarcodeArticle.trim();
+        // Ein Strichcode kann nur den druckbaren ASCII-Bereich darstellen. Ein
+        // Umlaut wuerde stillschweigend verschwinden - dann scannt die Kasse
+        // spaeter einen Artikel, den es so nicht gibt. Lieber hier sagen, warum.
+        if (/[^\x20-\x7e]/.test(artikel)) {
+            return res.status(400).json({
+                error: 'Der Artikelname darf keine Umlaute oder Sonderzeichen enthalten - mehr kann ein Strichcode nicht abbilden.'
+            });
+        }
+        // Zu lang heisst: der Code waere breiter als das Papier und damit
+        // abgeschnitten. Ein abgeschnittener Code wird gar nicht erst gelesen.
+        const max = barcodeMaxLength(printer.width());
+        if (artikel.length > max) {
+            return res.status(400).json({
+                error: `Der Artikelname passt nicht auf die Papierbreite: höchstens ${max} Zeichen.`
+            });
+        }
+        await setSetting('receipt_barcode_article', artikel);
+    }
 
     // Druckerzugang von Hand pflegen - fuer einen Pi, der nicht ueber die
     // Einrichtung in dieser Oberflaeche aufgesetzt wurde.