Kerim (portable/claudecode)andClaude Opus 5
70756f3762
Der Kunde soll mit einem Zettel zur Kasse gehen koennen, auf dem steht, was er zahlen muss. Drei Wege fuehren jetzt zu einem Bon: der Knopf "Bon" auf der Timer-Karte druckt den Zwischenstand und laesst den Timer weiterlaufen, "Beenden" druckt den Endbeleg, und in der Historie laesst sich jeder Beleg nachdrucken. Der Drucker haengt per USB an einem Raspberry Pi und ist damit vom Timer-Server aus nicht direkt erreichbar. Auf dem Pi laeuft deshalb eine kleine Bruecke (deploy/bondrucker/, nur Python-Standardbibliothek), die fertige ESC/POS-Daten per HTTP annimmt. Das Bon-Layout bleibt bewusst hier im Repo, damit Aenderungen daran nicht auf dem Pi angefasst werden muessen. Beim Beenden wird erst gespeichert und dann gedruckt. Eine leere Papierrolle ist damit ein Papierproblem und kein Datenproblem - der Vorgang steht in der Historie, die Oberflaeche sagt ausdruecklich, dass der Bon nicht gedruckt wurde, und nennt den Grund. Ohne PRINTER_HOST in der .env ist die Druckfunktion aus und die App verhaelt sich unveraendert. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
108 lines
4.4 KiB
Markdown
108 lines
4.4 KiB
Markdown
# Timer — Zeiterfassung
|
|
|
|
Zeiterfassung mit automatischer Kostenberechnung für den Einsatz im Laden.
|
|
|
|
> **Installation und Technik:** siehe [DEPLOY.md](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.
|
|
|
|
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.
|