CAFE
Dokumentation
CAFE
Mit CAFE betreiben Sie eine kleine Kasse / Bestellverwaltung, z.B. für ein Vereinscafé, einen Festival-Stand oder eine Theke:
- Produkte (Getränke, Snacks)
- Kategorien (Heißgetränke, Kaltgetränke, Speisen …)
- Tische (mehrere parallele Bestellungen)
- Bestellungen mit Mengen und Status (offen, erledigt, bezahlt)
- Tagesbericht
Die Kassen-Oberfläche ist auf Touch-Bedienung ausgelegt: Tisch wählen → Produkte antippen → Bestellung speichern → später als bezahlt/erledigt markieren.
- Tisch auswählen / wechseln
- Produkte zur Bestellung hinzufügen, Menge anpassen
- Bestellung „abgeben“ (Place)
- In der Bestellansicht: einzelne Positionen abhaken, Bestellung als bezahlt / erledigt markieren
- Am Tagesende: Tagesbericht ansehen
Im Admin / Backoffice:
- Kategorien & Produkte pflegen
- Preise anpassen
1) Tisch wählen (Bediener-Workflow)
/cafe/select-tableöffnen.- Tisch auswählen oder neu eingeben.
- Sie landen im Bestell-Modus für diesen Tisch (
/cafe/order).
2) Bestellung erfassen
- Produkt antippen → es wird der aktuellen Bestellung hinzugefügt (
POST /cafe/order/add). - Menge ändern →
POST /cafe/order/qty. - Bestellung leeren →
POST /cafe/order/clear. - Bearbeiten abbrechen →
POST /cafe/order/cancel-edit. - Bestellung speichern / abgeben →
POST /cafe/order/place.
3) Bestellungen verwalten
- Bestellungen öffnen (
/cafe/orders). - Sie sehen offene / abgeschlossene Bestellungen, ggf. nach Tisch sortiert.
- Aktionen pro Bestellung:
- Position abhaken („Item ausgegeben") →
POST /cafe/orders/toggle-item-checked - Bestellung als erledigt markieren →
POST /cafe/orders/toggle-done - Bestellung als bezahlt markieren →
POST /cafe/orders/toggle-paid - Kassenzettel drucken (M35-04) →
GET /dokumente/kassenzettel/{uuid}(Issue #798; alter PfadGET /cafe/orders/{uuid}/kassenzettelleitet per 307 um) (Drucker-Icon in der Spalte „Aktion", öffnet das PDF im Browser; idempotent: ein Dokument pro Bestellung)
- Position abhaken („Item ausgegeben") →
- Aktualisierte Teilansicht laden:
GET /cafe/orders/partial(z.B. zur Selbstaktualisierung des Bildschirms).
4) Tagesbericht
/cafe/daily-reportzeigt Umsätze, Mengen und Verteilung des Tages.
5) Produkte verwalten (Admin)
/cafe/productsöffnen.- „Neu“ → Produkt anlegen (
POST /cafe/products/create). - Aktualisieren:
POST /cafe/products/{id}/update. - Löschen:
POST /cafe/products/{id}/delete.
Felder typischerweise: Name, Kategorie, Preis, ggf. Sortierung / Sichtbarkeit.
6) Kategorien verwalten (Admin)
/cafe/categoriesöffnen.- Neu:
POST /cafe/categories/create. - Aktualisieren:
POST /cafe/categories/{id}/update. - Löschen:
POST /cafe/categories/{id}/delete.
> Eine Kategorie löschen geht nur, wenn keine Produkte mehr darauf verweisen.
„Bestellung lässt sich nicht abgeben“
- Tisch ausgewählt?
- Mindestens ein Produkt drin?
- Berechtigungen prüfen.
„Produkt erscheint nicht“
- Sichtbar geschaltet?
- Kategorie zugeordnet?
- Browser neu laden – CAFE arbeitet stark mit zwischengespeicherten Ansichten.
„Tagesbericht stimmt nicht“
- Bezahlt-/Erledigt-Status korrekt gesetzt?
- Storno-Bestellungen können je nach Konfiguration anders zählen.
Bedienung (/cafe):
GET /cafe/select-table– Tisch wählenPOST /cafe/select-table– Tisch festlegen
Bestell-Eingabe (/cafe/order):
GET /cafe/order– BestellansichtPOST /cafe/order/add– Position hinzufügenPOST /cafe/order/qty– Menge ändernPOST /cafe/order/clear– Bestellung leerenPOST /cafe/order/cancel-editPOST /cafe/order/place– Bestellung abgeben
Bestellliste (/cafe/orders):
GET /cafe/ordersGET /cafe/orders/partialGET /dokumente/kassenzettel/{uuid}- Kassenzettel als PDF (M35-04, Issue #798; Legacy:GET /cafe/orders/{uuid}/kassenzettelleitet per 307 um)POST /cafe/orders/toggle-donePOST /cafe/orders/toggle-paidPOST /cafe/orders/toggle-item-checked
Produkte (/cafe/products):
GET /cafe/productsPOST /cafe/products/createPOST /cafe/products/{id}/updatePOST /cafe/products/{id}/delete
Kategorien (/cafe/categories):
GET /cafe/categoriesPOST /cafe/categories/createPOST /cafe/categories/{id}/updatePOST /cafe/categories/{id}/delete
Tagesbericht:
GET /cafe/daily-report
- CAFE ist auf einfache, schnelle Bedienung optimiert. Es ersetzt keine vollwertige Kassen-Software (z.B. Steuerschnittstelle, KassenSichV).
- Empfehlenswert: jede Schicht startet mit klarem Tisch- und Bestellzustand und endet mit dem Tagesbericht.
- Short-IDs: UUIDs werden in Listen und Detailansichten als Kurzform angezeigt (z. B. #123e4567). Die volle UUID sehen Sie im Tooltip (auf Mobilgeräten per Antippen) und können sie mit dem Copy-Button neben der Kurzform kopieren. Links und URLs nutzen weiterhin die volle UUID.