Kerim (portable/claudecode)andClaude Opus 5 5e23ccdcbc 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>
2026-09-04 20:59:56 +02:00

Timer — Zeiterfassung

Zeiterfassung mit automatischer Kostenberechnung für den Einsatz im Laden.

Installation und Technik: siehe DEPLOY.md. Diese Datei ist die Kurzanleitung für die tägliche Bedienung.


Anmelden

Seite im Browser öffnen, Passwort eingeben. Die Anmeldung gilt 24 Stunden und verlängert sich bei Benutzung — ein Tablet am Tresen muss also nicht täglich neu angemeldet werden.

Timer starten

Oben optional einen Namen eintippen — zum Beispiel „Tisch 2", „Herr Müller" oder „Reparatur Werkbank" — und auf ▶ Neuer Timer klicken.

Es können beliebig viele Timer gleichzeitig laufen, einer je Platz oder Kunde. Jeder bekommt eine eigene Karte mit Zeit und laufendem Betrag. Der Name lässt sich jederzeit nachträglich ändern, einfach im Feld überschreiben.

Während der Timer läuft

Knopf Wirkung
❚❚ Pause Zeit anhalten, Betrag friert ein
▶ Weiter pausierten Timer fortsetzen
🖨 Bon Zwischenstand ausdrucken — der Timer läuft weiter
✓ Beenden Vorgang abschließen, in der Historie speichern und Bon drucken
✕ Verwerfen Timer wegwerfen, nichts wird gespeichert

Vor dem Beenden und dem Verwerfen kommt eine Rückfrage mit Zeit und Betrag.

Was passiert, wenn …

  • … der Browser geschlossen wird? Nichts. Der Timer läuft auf dem Server weiter und ist beim nächsten Öffnen wieder da.
  • … das Tablet neu startet? Ebenfalls nichts — einfach wieder aufrufen.
  • … ein Kollege am zweiten Gerät nachschaut? Er sieht dieselben Timer live.
  • … über Nacht vergessen wurde zu stoppen? Der Timer zählt weiter, wie eine Wanduhr. Die Karte zeigt, seit wann er läuft. Wer die Zeit korrigieren will, verwirft den Timer und erfasst ihn neu.

Bon für die Kasse

Auf dem Bon steht, was der Kunde zahlen muss — mit Beginn, Ende, Dauer und dem Tarif, damit der Betrag nachvollziehbar ist. Der Betrag selbst steht groß und allein darunter.

Zwei Wege, je nachdem, wie der Kunde geht:

  • Der Platz wird frei. ✓ Beenden drücken. Der Vorgang wandert in die Historie und der Bon kommt aus dem Drucker — damit geht der Kunde zur Kasse.
  • Der Kunde will zwischendurch zahlen, bleibt aber. 🖨 Bon drücken. Der Zettel zeigt den Stand von jetzt und ist als Zwischenstand gekennzeichnet; der Timer läuft unverändert weiter.

Wenn nichts aus dem Drucker kommt

Der Vorgang ist trotzdem gespeichert — die App sagt in dem Fall ausdrücklich, dass der Bon nicht gedruckt wurde, und nennt den Grund. Meist ist die Papierrolle leer oder der Drucker aus. Nach dem Beheben: in der Historie beim Eintrag auf 🖨 tippen, dann kommt derselbe Beleg noch einmal. Genauso, wenn ein Kunde seinen Bon verlegt hat.

Historie

Unter 📊 Historie stehen alle abgeschlossenen Vorgänge mit Datum, Name, Dauer und Betrag. Oben summieren drei Kacheln den gewählten Zeitraum.

  • Filter nach Von/Bis-Datum und nach Name
  • Schnellauswahl Heute und Dieser Monat
  • ⬇ CSV-Export lädt genau die gefilterte Auswahl herunter — die Datei lässt sich direkt in Excel öffnen, Umlaute und Beträge stimmen
  • Das 🗑-Symbol löscht einen Eintrag endgültig (mit Rückfrage)

Einstellungen

Unter ⚙️ Einstellungen wird der Tarif festgelegt: Betrag und Intervall, zum Beispiel „10 € pro 10 Minuten". Die Vorschau rechnet Beispiele durch.

Darunter steht, was auf dem Bon gedruckt wird:

  • Kopfzeilen — Ladenname, Adresse, Telefonnummer. Die erste Zeile wird groß gedruckt.
  • Fußzeilen — der Hinweis unter dem Betrag, etwa „Bitte an der Kasse bezahlen."
  • Bon beim Beenden automatisch drucken — ausgeschaltet kommt ein Bon nur noch über die 🖨-Knöpfe.
  • Probedruck — druckt einen Beispielbon. Beantwortet die Frage, ob der Drucker überhaupt erreichbar ist; darüber steht sein aktueller Zustand.

Einen neuen Drucker anschließen

Wenn der Drucker-Rechner getauscht wird oder ein zweiter Laden dazukommt: 🔧 Drucker einrichten anklicken, Adresse, Benutzer und Passwort des Raspberry Pi eintragen, 🚀 Jetzt einrichten drücken. Nach wenigen Sekunden ist der Drucker eingerichtet und übernommen — es ist nichts weiter zu tun.

Das Protokoll darunter zeigt jeden Schritt. Bleibt einer rot stehen, steht dort auch, woran es lag. Das Passwort wird nur für diesen Vorgang verwendet und danach verworfen.

Voraussetzung: Auf dem Pi läuft ein frisches Raspberry Pi OS (oder Debian), der eingetragene Benutzer darf sudo, und der Bondrucker hängt am USB-Anschluss.

Wichtig zu wissen:

  • Jede angefangene Einheit wird voll berechnet. 10 Minuten und 1 Sekunde kosten bei einem 10-Minuten-Takt bereits zwei Einheiten.
  • Der Tarif und die Bon-Texte gelten für alle Geräte gemeinsam.
  • Eine Änderung wirkt sofort auf laufende und neue Timer. Bereits gespeicherte Einträge in der Historie behalten den Tarif, der beim Beenden galt.

Abmelden

🚪 Abmelden meldet nur dieses Gerät ab. Laufende Timer bleiben davon unberührt und laufen weiter.

S
Description
Timer / Zeiterfassung mit Kostenberechnung (Node/Express, SQLite, Authentik-SSO) - laeuft auf 192.168.1.5:3003
Readme
834 KiB
Languages
JavaScript 69.3%
HTML 24.1%
Python 4.7%
Shell 1.9%