Docs

CAFE

Dokumentation
Zurück

CAFE

Wofür ist das?

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.


Typische Aufgaben (Alltag)

  • 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

Schritt-für-Schritt

1) Tisch wählen (Bediener-Workflow)

1. /cafe/select-table öffnen.
2. Tisch auswählen oder neu eingeben.
3. Sie landen im Bestell-Modus für diesen Tisch (/cafe/order).

2) Bestellung erfassen

1. Produkt antippen → es wird der aktuellen Bestellung hinzugefügt (POST /cafe/order/add).
2. Menge ändern → POST /cafe/order/qty.
3. Bestellung leeren → POST /cafe/order/clear.
4. Bearbeiten abbrechen → POST /cafe/order/cancel-edit.
5. Bestellung speichern / abgeben → POST /cafe/order/place.

3) Bestellungen verwalten

1. Bestellungen öffnen (/cafe/orders).
2. Sie sehen offene / abgeschlossene Bestellungen, ggf. nach Tisch sortiert.
3. 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

4. Aktualisierte Teilansicht laden: GET /cafe/orders/partial (z.B. zur Selbstaktualisierung des Bildschirms).

4) Tagesbericht

  • /cafe/daily-report zeigt Umsätze, Mengen und Verteilung des Tages.

5) Produkte verwalten (Admin)

1. /cafe/products öffnen.
2. „Neu“ → Produkt anlegen (POST /cafe/products/create).
3. Aktualisieren: POST /cafe/products/{id}/update.
4. Löschen: POST /cafe/products/{id}/delete.

Felder typischerweise: Name, Kategorie, Preis, ggf. Sortierung / Sichtbarkeit.

6) Kategorien verwalten (Admin)

1. /cafe/categories öffnen.
2. Neu: POST /cafe/categories/create.
3. Aktualisieren: POST /cafe/categories/{id}/update.
4. Löschen: POST /cafe/categories/{id}/delete.

> Eine Kategorie löschen geht nur, wenn keine Produkte mehr darauf verweisen.


Häufige Fragen / Probleme

„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.

Technische URLs (Kurzreferenz)

Bedienung (/cafe):

  • GET /cafe/select-table – Tisch wählen
  • POST /cafe/select-table – Tisch festlegen

Bestell-Eingabe (/cafe/order):

  • GET /cafe/order – Bestellansicht
  • POST /cafe/order/add – Position hinzufügen
  • POST /cafe/order/qty – Menge ändern
  • POST /cafe/order/clear – Bestellung leeren
  • POST /cafe/order/cancel-edit
  • POST /cafe/order/place – Bestellung abgeben

Bestellliste (/cafe/orders):

  • GET /cafe/orders
  • GET /cafe/orders/partial
  • POST /cafe/orders/toggle-done
  • POST /cafe/orders/toggle-paid
  • POST /cafe/orders/toggle-item-checked

Produkte (/cafe/products):

  • GET /cafe/products
  • POST /cafe/products/create
  • POST /cafe/products/{id}/update
  • POST /cafe/products/{id}/delete

Kategorien (/cafe/categories):

  • GET /cafe/categories
  • POST /cafe/categories/create
  • POST /cafe/categories/{id}/update
  • POST /cafe/categories/{id}/delete

Tagesbericht:

  • GET /cafe/daily-report

Hinweise

  • 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.