HandyCafe Docs
owner cashier

Bestellungen

Der Bestellungen-Tab ist das Live-Dashboard für jede Cafeteria-Bestellung, die Ihre Kunden aufgeben. Es fragt die Cloud alle 3 Sekunden ab und zeigt neue Aktivitäten mit einer Desktop-Benachrichtigung, einem Signalton und einem Badge mit der Anzahl offener Bestellungen im Tabkopf an.

Aufbau

Die Bestellseite hat zwei Bereiche:

Bereich Zweck
Status-Tabs Filtern nach Bestellstatus: alle, aufgegeben, bestätigt, in Vorbereitung, bereit, serviert. Stornierte und erstattete Bestellungen werden standardmäßig ausgefiltert.
Bestellliste Eine Karte pro Bestellung, nach neuester zuerst gruppiert. Jede Karte zeigt Tischcode, Kundentelefon, falls vorhanden, Artikel, Summen und Aktionsschaltflächen.

Live-Abfrage

Das Bestell-Dashboard fragt /v1/cafeteria/admin/orders/poll alle 3 Sekunden ab. Jede neue Bestellung löst Folgendes aus:

  1. Eine Desktop-Benachrichtigung mit Tischcode und Artikelanzahl.
  2. Einen Signalton über die Serverlautsprecher, wenn Tonbenachrichtigungen unter Einstellungen > Cafeteria aktiviert sind.
  3. Eine Erhöhung des Badges mit der Anzahl offener Bestellungen im Bestellungen-Tab.
  4. Einen automatischen Belegdruck, wenn der Drucker mit „Automatisch bei neuer Bestellung drucken“ konfiguriert ist.

Das Badge bleibt sichtbar, bis jede Bestellung mit dem Status placed oder confirmed in einen späteren Status versetzt oder verworfen wurde. Das Badge ist global im Cafeteria-Bereich der Seitenleiste sichtbar; Sie müssen den Bestellungen-Tab nicht geöffnet halten, um es zu sehen.

Bestelllebenszyklus

Jede Bestellung durchläuft eine definierte Abfolge von Status.

Status Bedeutung
placed Der Kunde hat die Bestellung aufgegeben. Noch keine Aktion durch das Personal.
confirmed Das Personal hat die Bestellung bestätigt.
preparing Die Küche bearbeitet die Bestellung.
ready Die Bestellung ist zur Ausgabe oder Abholung bereit.
served Die Bestellung wurde an den Kunden geliefert.
cancelled Die Bestellung wurde vom Personal storniert. Sie wird aus den Live-Ansichten entfernt, bleibt aber in der Historie erhalten.
refunded Eine Rückerstattung nach der Zahlung wurde ausgeführt.

Die Aktionsleiste auf jeder Bestellkarte zeigt den nächsten verfügbaren Status. Das Weiterschalten erfolgt mit einem Klick. Die Oberfläche verwendet ein optimistisches Aktualisierungsmuster: Der neue Status wird sofort angezeigt. Wenn der Server die Änderung ablehnt, wird der Status zurückgesetzt und eine Fehlermeldung erscheint.

Status Pro Artikel

Manche Bestellungen enthalten mehrere Artikel, die zu unterschiedlichen Zeiten fertig werden. Zum Beispiel ist ein Burger vor einer Pizza fertig. Mit dem Status pro Artikel können Sie jede Position unabhängig verfolgen.

Jeder Artikel hat ein eigenes Dropdown mit fünf Optionen: aufgegeben, in Vorbereitung, bereit, serviert, storniert. Jeder Artikel enthält außerdem drei Zeitstempel:

  • created_at wird gesetzt, wenn die Bestellung eingeht.
  • ready_at wird gesetzt, wenn der Artikel zum ersten Mal in den Status ready wechselt.
  • served_at wird gesetzt, wenn der Artikel in den Status served wechselt.

Das Kundenmenü zeigt neben jeder Position ein Badge an, damit der Kunde sehen kann, welche Artikel fertig sind oder unterwegs sind.

Eine Bestellung Stornieren

  1. Öffnen Sie die Bestellkarte.
  2. Klicken Sie auf Stornieren.
  3. Bestätigen Sie im angezeigten Dialog.
  4. Die Bestellung wechselt zu cancelled. Sie bleibt in der Historie, verschwindet aber aus der Standard-Liveansicht.

Das Stornieren gilt immer für die gesamte Bestellung. Um nur eine einzelne Position zu stornieren, ändern Sie stattdessen den Status dieses Artikels auf cancelled.

Abrechnung (Abrechnung Abschließen)

Die Abrechnung schließt jede offene Bestellung an einem Tisch in einem Schritt. Verwenden Sie dies, wenn der Kunde geht und die gesamte Rechnung bezahlen möchte.

  1. Öffnen Sie den Tisch auf der Tische-Seite oder über das Aktionsmenü im Grundriss.
  2. Klicken Sie auf Abrechnung abschließen.
  3. Das Modal listet jede Bestellung an diesem Tisch auf, die noch nicht served ist.
  4. Wählen Sie eine Zahlungsmethode. Verfügbar sind: Bar, Karte, Online, Sonstiges.
  5. Bestätigen Sie.

Der Server führt die folgenden Aktionen atomar aus:

  • Jede offene Bestellung an diesem Tisch wechselt zu served mit payment_status=paid.
  • Ein Datensatz in cafeteria_settlements wird mit Gesamtbetrag, Zahlungsmethode und Erstellungszeit angelegt.
  • Eine Audit-Spur für Abrechnungs-Bestellungen protokolliert, welche Bestellungen zu dieser Abrechnung gehören.
  • Der Sicherheitscode des Tisches läuft ab, sodass der QR ungültig wird.
  • Der Tisch wechselt zurück zu idle.

Wenn Sie Online als Zahlungsmethode wählen, wird der Abrechnungsdatensatz als online bezahlt markiert. Diese Aktion löst keine Stripe-Belastung aus. Die Online-Zahlung auf Kundenseite wird bereits bei der Bestellaufgabe abgewickelt; die Abrechnungsaktion erfasst lediglich den Geldfluss für Ihre Buchhaltung.

Timer Seit Öffnen

Jeder Tisch hat einen opened_at-Zeitstempel, der gesetzt wird, wenn der Kunde platziert wird. Die Seiten Grundriss und Tische zeigen seit diesem Moment einen Live-Timer an. So erkennt das Personal Tische, die schon lange aktiv sind, ohne zu bestellen, oder Tische, die sich dem Sitzungsende nähern.

Der Timer wird bei Tisch schließen oder Abrechnung abschließen auf null zurückgesetzt.

Anzeige Der Dynamischen Zubereitungszeit

Wenn für ein Produkt die dynamische Zubereitungszeit aktiv ist, zeigt die Bestellkarte die Schätzung neben dem Artikelnamen an. Das Personal sieht die Schätzung auch dann, wenn der Schalter „Zubereitungszeit im Menü anzeigen“ für Kunden deaktiviert ist.

Die Schätzung wird jedes Mal aktualisiert, wenn eine neue Bestellung aufgegeben oder eine Bestellung abgeschlossen wird. Das System lernt aus dem tatsächlichen Tempo Ihrer Küche.

Verhalten Bei Neuen Bestellungen

Benachrichtigungen werden app-weit ausgelöst, nicht pro Tab. Das bedeutet, Sie erhalten Hinweise auch dann, wenn Sie einen anderen Bereich des HandyCafe-Servers ansehen, zum Beispiel das Admin-Panel oder die Einstellungen. Die Tonbenachrichtigung wird unter Einstellungen > Cafeteria > Tonbenachrichtigung ein- oder ausgeschaltet.

Desktop-Benachrichtigungen setzen voraus, dass das Betriebssystem HandyCafe die Berechtigung dafür erteilt hat. Wenn nach einer neuen Bestellung keine Benachrichtigung erscheint, prüfen Sie die Benachrichtigungseinstellungen Ihres Betriebssystems.

Tipps

  • Verwenden Sie die Status-Tabs, um die Arbeit aufzuteilen. Ein Bildschirm mit dem Filter preparing zeigt die Küchenwarteschlange. Ein anderer Bildschirm mit ready zeigt, was ausgeliefert werden muss.
  • Abrechnung abschließen ist der schnellste Weg, einen Tisch zu beenden. Verwenden Sie Stornieren bei einzelnen Bestellungen nur bei klaren Fehlern.
  • Schulen Sie das Personal darauf, Status konsequent weiterzuschalten. Der dynamische Schätzer für die Zubereitungszeit lernt aus diesen Signalen; das Überspringen von Status verringert seine Genauigkeit.
  • Prüfen Sie stornierte und erstattete Bestellungen regelmäßig über den Admin-Endpunkt, um Muster von Bedienfehlern zu erkennen.