Drucker-Pi aus der Oberflaeche heraus einrichten

Die Einrichtung war Handarbeit: Dateien per scp auf den Pi, dort install.sh
mit sudo starten, Token abschreiben, in die .env eintragen, Dienst neu
starten. Das ist genau die Sorte Arbeit, die beim naechsten Geraetetausch
niemand mehr weiss. Jetzt macht das ein Knopf unter "Einstellungen":
Adresse, Benutzer und Passwort eintragen, und die App meldet sich per SSH an,
prueft Python/systemd/Druckergeraet, uebertraegt deploy/bondrucker/, startet
install.sh mit einem selbst erzeugten Token, raeumt auf und prueft von aussen
nach. Jeder Schritt steht mit Ergebnis im Protokoll.

Damit das ueberhaupt Sinn ergibt, liegt der Druckerzugang jetzt in der
Datenbank statt in der .env - sonst muesste hinterher doch wieder jemand auf
den Server. Die PRINTER_*-Werte in der .env sind nur noch Startwerte beim
allerersten Start, wie RATE_PER_10MIN auch.

Zwei Fehler, die beim Testen der Einrichtung auffielen:

install.sh startete den Dienst nicht neu, sondern nur "enable --now". Bei
einer erneuten Einrichtung lief die Bruecke deshalb mit dem ALTEN Token
weiter und lehnte jeden Bon mit HTTP 403 ab. Jetzt: restart.

Die Gegenprobe fragte nur /status ab - und /status prueft kein Token. Ein
Dienst mit altem Token galt damit faelschlich als bereit. Die Bruecke meldet
in /status jetzt zusaetzlich, ob das mitgeschickte Token passt (Version 1.1),
und die Einrichtung prueft das mit.

Zugangsdaten werden einmal benutzt und danach vergessen; das erzeugte Token
wird aus dem Protokoll entfernt, bevor es in den Browser oder ins Journal
geht. Neu dabei: ssh2, reines JavaScript.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

frontend/app.js

@@ -82,8 +82,13 @@ async function api(url, options = {}) {
     }
     if (!response.ok) {
         let msg = 'Serverfehler';
-        try { msg = (await response.json()).error || msg; } catch (e) { /* egal */ }
-        throw new Error(msg);
+        let daten = null;
+        try { daten = await response.json(); msg = daten.error || msg; } catch (e) { /* egal */ }
+        const fehler = new Error(msg);
+        // Manche Endpunkte liefern im Fehlerfall Zusatzinfos mit (etwa das
+        // Protokoll der Druckereinrichtung). Die waeren sonst verloren.
+        if (daten && daten.steps) fehler.steps = daten.steps;
+        throw fehler;
     }
     return response.status === 204 ? null : response.json();
 }
@@ -658,6 +663,91 @@ async function testPrint() {
     }
 }
 
+// ---------------------------------------------------------------------------
+// Einrichtung eines Drucker-Pi
+// ---------------------------------------------------------------------------
+
+function toggleSetup() {
+    const box = document.getElementById('setupBox');
+    const offen = box.style.display !== 'none';
+    box.style.display = offen ? 'none' : 'block';
+    document.getElementById('setupToggleBtn').textContent =
+        offen ? '🔧 Drucker einrichten' : '✕ Einrichtung schließen';
+    if (!offen) document.getElementById('setupHost').focus();
+}
+
+/** Protokoll der Einrichtung anzeigen - ein Kasten je Schritt. */
+function renderSetupLog(steps, laufend) {
+    const el = document.getElementById('setupLog');
+    el.classList.add('show');
+
+    const zeilen = (steps || []).map(s => `
+        <div class="setup-step ${s.ok ? '' : 'fail'}">
+            <span class="setup-step-icon">${s.ok ? '✅' : '❌'}</span>
+            <div>
+                <div class="setup-step-name">${escapeHtml(s.name)}</div>
+                ${s.detail ? `<div class="setup-step-detail">${escapeHtml(s.detail)}</div>` : ''}
+            </div>
+        </div>`).join('');
+
+    el.innerHTML = zeilen + (laufend
+        ? `<div class="setup-step"><span class="setup-step-icon">⏳</span>
+               <div><div class="setup-step-name">läuft …</div></div></div>`
+        : '');
+}
+
+async function startProvision() {
+    const host = document.getElementById('setupHost').value.trim();
+    const port = document.getElementById('setupPort').value;
+    const username = document.getElementById('setupUser').value.trim();
+    const passwordEl = document.getElementById('setupPassword');
+    const password = passwordEl.value;
+
+    if (!host) return toast('Bitte die Adresse des Pi eintragen.', 'error');
+    if (!username) return toast('Bitte den Benutzernamen eintragen.', 'error');
+    if (!password) return toast('Bitte das Passwort eintragen.', 'error');
+
+    if (state.printerConfigured && !confirm(
+        'Es ist bereits ein Drucker eingerichtet.\n\n' +
+        `Nach der Einrichtung druckt die App auf ${host}. Fortfahren?`
+    )) return;
+
+    const btn = document.getElementById('setupStartBtn');
+    btn.disabled = true;
+    btn.textContent = '⏳ Wird eingerichtet …';
+    renderSetupLog([], true);
+
+    try {
+        const res = await api('/api/printer/provision', {
+            method: 'POST',
+            body: JSON.stringify({ host, port, username, password })
+        });
+
+        // Das Passwort hat seinen Zweck erfuellt und hat im Formular nichts
+        // mehr verloren.
+        passwordEl.value = '';
+
+        renderSetupLog(res.steps, false);
+        state.printerConfigured = true;
+
+        if (res.ready) {
+            toast('Drucker eingerichtet und erreichbar. Ein Probedruck zeigt, ob Papier drin ist.', 'success');
+        } else {
+            toast('Einrichtung durchgelaufen, der Drucker antwortet aber noch nicht – siehe Protokoll.', 'error');
+        }
+        await refreshPrinterStatus();
+        await syncTimers().catch(() => {});
+    } catch (e) {
+        // Die Schritte bis zum Abbruch stecken in der Fehlerantwort und sind
+        // das Wertvollste am ganzen Vorgang - deshalb trotzdem anzeigen.
+        renderSetupLog(e.steps, false);
+        toast('Einrichtung fehlgeschlagen: ' + e.message, 'error');
+    } finally {
+        btn.disabled = false;
+        btn.textContent = '🚀 Jetzt einrichten';
+    }
+}
+
 function updateSettingsPreview() {
     const amount = parseFloat(document.getElementById('rateAmount').value) || 0;
     const interval = parseInt(document.getElementById('rateInterval').value) || 1;