Drucker wird in der App gewaehlt, nicht auf dem Pi

Das Einrichtungsskript fragte bisher am Pi, welcher Drucker bedient werden
soll. Damit stand die Einstellung an einem Ort, an den man nur mit einem
Terminal kommt - und ein zweiter Drucker am Pi bedeutete: Skript nochmal.

Jetzt fragt die App den Pi, was angeschlossen ist, und der Bediener waehlt in
den Einstellungen. Die Bruecke bekam dafuer /devices; sie liest die
Klartextnamen aus dem sysfs, damit dort "EPSON TM-T88IV" steht und nicht
"lp0" - bei zwei Druckern der Unterschied zwischen Wissen und Raten.

Der gewaehlte Pfad geht bei jedem Auftrag im Kopf X-Print-Device mit. Die
Bruecke haelt dazu bewusst keinen Zustand und das Skript schreibt kein
PRINT_DEVICE mehr: es soll genau eine Stelle geben, die weiss, welcher Drucker
gemeint ist, naemlich die, an der es bedient wird. Leer bleibt "automatisch" -
das erste gefundene Geraet, zugleich der Rueckfall, wenn aus lp0 nach dem
Umstecken ein lp1 geworden ist.

Der Pfad kommt damit von aussen und wird an beiden Enden geprueft, in
PUT /api/settings und noch einmal in der Bruecke. Eine Schranke, die nur an
einem Ende steht, ist keine: ohne die Pruefung auf dem Pi liesse sich der
Dienst dazu bringen, in eine beliebige Datei zu schreiben.

Nebenbei: ein nicht bereiter Drucker meldete sich in der Oberflaeche als
"HTTP 503". Das verriet niemandem, dass nur ein Stecker lose ist. Die 503 der
Bruecke ist kein Protokollfehler, und ihr Rumpf sagt, was fehlt - der wird
jetzt ausgewertet.

Geprueft am echten Pi (Debian 13, TM-T88IV): Einrichtung ohne Rueckfrage,
Geraeteliste mit Namen, ausdrueckliche Wahl, Druck darauf, Rueckkehr auf
automatisch, Druck darauf. Dazu die Abweise: /etc/passwd und ein Pfad mit
angehaengtem Befehl werden zurueckgewiesen, ein erlaubtes aber fehlendes
/dev/usb/lp7 ergibt eine Meldung im Klartext.

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

backend/.env.example

@@ -80,6 +80,12 @@ PRINTER_TOKEN=
 # Zeichen je Zeile. 42 = 80-mm-Papier (Standard), 32 = 58-mm-Papier.
 PRINTER_WIDTH=42
 
+# Welcher Drucker am Pi bedient wird, z. B. /dev/usb/lp0. LEER lassen: dann
+# nimmt die Bruecke das erste gefundene Geraet. Ausgewaehlt wird das ohnehin in
+# den Einstellungen - dort zeigt "Drucker am Pi" alles an, was angeschlossen
+# ist, mit Klartextnamen.
+PRINTER_DEVICE=
+
 # Abbruch, wenn der Pi nicht antwortet. Lieber kurz: ein haengender Drucker
 # darf das Beenden eines Timers nicht blockieren.
 PRINTER_TIMEOUT_MS=6000

backend/printer.js

@@ -25,6 +25,10 @@ let cfg = {
     port: 9100,
     token: '',
     width: 42,
+    // Welcher Drucker am Pi bedient wird. Leer = die Bruecke sucht sich selbst
+    // einen. Die Wahl lebt hier und nicht auf dem Pi, damit sie dort bedient
+    // werden kann, wo auch alles andere eingestellt wird.
+    device: '',
     timeoutMs: parseInt(process.env.PRINTER_TIMEOUT_MS) || 6000
 };
 
@@ -40,7 +44,8 @@ function setConfig(next = {}) {
         host: String(next.host == null ? cfg.host : next.host).trim(),
         port: Number.isInteger(port) && port > 0 && port < 65536 ? port : cfg.port,
         token: next.token == null ? cfg.token : String(next.token).trim(),
-        width: Number.isInteger(width) && width >= 24 && width <= 96 ? width : cfg.width
+        width: Number.isInteger(width) && width >= 24 && width <= 96 ? width : cfg.width,
+        device: next.device == null ? cfg.device : String(next.device).trim()
     };
     return cfg;
 }
@@ -55,7 +60,10 @@ function width() {
 
 /** Konfiguration OHNE das Token - dieser Wert verlaesst den Server nie. */
 function config() {
-    return { host: cfg.host, port: cfg.port, width: cfg.width, timeoutMs: cfg.timeoutMs, tokenSet: !!cfg.token };
+    return {
+        host: cfg.host, port: cfg.port, width: cfg.width, device: cfg.device,
+        timeoutMs: cfg.timeoutMs, tokenSet: !!cfg.token
+    };
 }
 
 function state() {
@@ -64,6 +72,7 @@ function state() {
         host: cfg.host || null,
         port: isConfigured() ? cfg.port : null,
         width: cfg.width,
+        device: cfg.device || null,
         lastError,
         lastPrintAt
     };
@@ -83,6 +92,9 @@ function request(pfad, method, body) {
             headers['Content-Length'] = body.length;
         }
         if (cfg.token) headers['X-Print-Token'] = cfg.token;
+        // Ohne diesen Kopf sucht sich die Bruecke selbst ein Geraet. Mit ihm
+        // gilt genau das, was in den Einstellungen steht.
+        if (cfg.device) headers['X-Print-Device'] = cfg.device;
 
         const req = http.request(
             { host: cfg.host, port: cfg.port, path: pfad, method, headers },
@@ -125,6 +137,22 @@ function request(pfad, method, body) {
 /** Zustand der Bruecke abfragen (Geraet da? beschreibbar?). */
 async function status() {
     const res = await request('/status', 'GET');
+
+    // Die Bruecke antwortet mit 503, wenn sie zwar laeuft, der Drucker aber
+    // nicht bereit ist: Kabel ab, falsches Geraet gewaehlt, kein Schreibrecht.
+    // Das ist kein Protokollfehler - und der Rumpf sagt, was genau fehlt.
+    // Ohne diese Auswertung stuende in der Oberflaeche "HTTP 503", was niemandem
+    // verraet, dass nur ein USB-Stecker lose ist.
+    const p = res.data;
+    if (!res.ok && p && p.version) {
+        lastError = !p.deviceExists
+            ? `Gerät ${p.device} ist am Pi nicht vorhanden. Kabel prüfen oder einen anderen Drucker wählen.`
+            : !p.writable
+            ? `Auf ${p.device} darf der Druckdienst nicht schreiben.`
+            : p.lastError || 'Drucker nicht bereit.';
+        return { ok: false, error: lastError, printer: p, ...state() };
+    }
+
     if (!res.ok) {
         lastError = res.error;
         return { ok: false, error: res.error, ...state() };
@@ -132,6 +160,16 @@ async function status() {
     return { ok: true, printer: res.data, ...state() };
 }
 
+/** Welche Drucker am Pi haengen - die Auswahl fuer die Einstellungen. */
+async function devices() {
+    const res = await request('/devices', 'GET');
+    if (!res.ok) {
+        lastError = res.error;
+        return { ok: false, error: res.error };
+    }
+    return { ok: true, devices: (res.data && res.data.devices) || [], fallback: res.data && res.data.fallback };
+}
+
 /** Rohe ESC/POS-Daten an den Drucker geben. */
 async function print(buffer) {
     const res = await request('/print', 'POST', buffer);
@@ -145,4 +183,4 @@ async function print(buffer) {
     return res;
 }
 
-module.exports = { setConfig, isConfigured, width, config, state, status, print };
+module.exports = { setConfig, isConfigured, width, config, state, status, devices, print };

backend/server.js

@@ -170,6 +170,10 @@ async function initDatabase() {
             [(process.env.PRINTER_TOKEN || '').trim()]);
         await dbRun(`INSERT OR IGNORE INTO settings (key,value) VALUES ('printer_width',?)`,
             [String(parseInt(process.env.PRINTER_WIDTH) || 42)]);
+        // Leer heisst: die Bruecke auf dem Pi sucht sich selbst ein Geraet.
+        // Sobald in den Einstellungen einer gewaehlt wurde, gilt der.
+        await dbRun(`INSERT OR IGNORE INTO settings (key,value) VALUES ('printer_device',?)`,
+            [(process.env.PRINTER_DEVICE || '').trim()]);
 
         await refreshPrinterConfig();
 
@@ -212,10 +216,12 @@ async function refreshPrinterConfig() {
         host: map.printer_host || '',
         port: map.printer_port,
         token: map.printer_token || '',
-        width: map.printer_width
+        width: map.printer_width,
+        device: map.printer_device || ''
     });
     console.log(cfg.host
-        ? `Bondrucker: ${cfg.host}:${cfg.port}, ${cfg.width} Zeichen je Zeile`
+        ? `Bondrucker: ${cfg.host}:${cfg.port}, ${cfg.width} Zeichen je Zeile, ` +
+          `Geraet ${cfg.device || 'automatisch'}`
         : 'Bondrucker: nicht eingerichtet');
     return cfg;
 }
@@ -732,6 +738,16 @@ app.put('/api/settings', requireAuth, wrap(async (req, res) => {
         await setSetting('printer_width', String(w));
         druckerGeaendert = true;
     }
+    if (typeof b.printerDevice === 'string') {
+        const geraet = b.printerDevice.trim();
+        // Derselbe Rahmen wie auf dem Pi. Der Wert wird dort noch einmal
+        // geprueft - eine Schranke, die nur an einem Ende steht, ist keine.
+        if (geraet && !/^\/dev\/(usb\/)?lp[0-9]{1,3}$/.test(geraet)) {
+            return res.status(400).json({ error: 'Das ist kein Druckergerät (erwartet: /dev/usb/lp0).' });
+        }
+        await setSetting('printer_device', geraet);
+        druckerGeaendert = true;
+    }
     // Das Token kommt nur herein, nie heraus. Ein leerer Wert wird ignoriert,
     // damit ein Speichern ohne Eingabe das vorhandene Token nicht loescht.
     if (typeof b.printerToken === 'string' && b.printerToken.trim()) {
@@ -755,6 +771,21 @@ app.get('/api/printer/status', requireAuth, wrap(async (req, res) => {
     res.json({ configured: true, ...await printer.status(), config: printer.config() });
 }));
 
+/**
+ * Welche Drucker am Pi haengen.
+ *
+ * Die Liste kommt frisch vom Pi und wird nicht zwischengespeichert: wer sie
+ * aufruft, hat gerade ein Kabel umgesteckt und will genau das sehen.
+ */
+app.get('/api/printer/devices', requireAuth, wrap(async (req, res) => {
+    if (!printer.isConfigured()) {
+        return res.status(503).json({ error: 'Kein Bondrucker eingerichtet.' });
+    }
+    const liste = await printer.devices();
+    if (!liste.ok) return res.status(502).json({ error: liste.error });
+    res.json({ devices: liste.devices, fallback: liste.fallback, selected: printer.config().device });
+}));
+
 // Einrichtung beruehrt ein fremdes Geraet und ist von aussen erreichbar -
 // hier deutlich enger begrenzt als beim Drucken.
 const setupLimiter = rateLimit({