Kapitel 1 — Küchendisplay (KDS)

Das Küchendisplay ist eine Seite im Browser, die auf einem Bildschirm in der Küche oder an der Bar geöffnet wird und Auftragsbons live anzeigt. Das Küchenpersonal bewegt damit die Bestellungen von „Neu" bis „Fertig". Es ist mit dem Internet verbunden und empfängt Bestellungen in Echtzeit.

⚠️ Sprache der App: Diese App öffnet sich standardmäßig auf Deutsch. Die persische Übersetzung der Küche ist unvollständig — einzelne Bezeichnungen (etwa Done, Preparing, Refresh) bleiben Englisch, unabhängig von der eingestellten Sprache. Die in diesem Kapitel in Klammern angegebenen Bezeichnungen entsprechen genau dem, was Sie tatsächlich auf dem Bildschirm sehen.

1.1. Anmeldung

• Melden Sie sich mit E-Mail und Passwort an (dasselbe Konto wie an der Kasse). Die Anmeldung hat auch einen Reiter Telefon, und wenn die Zwei-Faktor-Authentifizierung aktiv ist, kommt ein zusätzlicher Schritt für den Code hinzu; außerdem gibt es Optionen für Social Login sowie Seiten für Registrierung/Passwort vergessen.
• Sperrbildschirm / Schnell-PIN: Wie an der Kasse kann ein Benutzer, der eine PIN hat, das Display sperren und mit der PIN wieder entsperren (ohne sich vollständig abzumelden); über die Liste lässt sich der Benutzer wechseln oder ein weiterer Kassierer hinzufügen.

1.2. Standort und Station wählen (vor dem Board)

Nach der Anmeldung werden Sie auf einer eigenen Seite gebeten, Standort (Location) und Station dieses Displays auszuwählen:

• Jede Station, die bereits von einem anderen Benutzer belegt ist, wird als deaktiviert angezeigt.
• Nach der Auswahl lädt ein prozentualer Fortschrittsbalken die Ausgangsdaten, danach gelangen Sie auf das Board. Falls ein Teil der Daten nicht zwischengespeichert werden konnte, erscheint die Meldung „Das Board wird geöffnet, aber …" mit der Schaltfläche Erneut versuchen.
• Bei Problemen: „Küchen-Sitzung konnte nicht geladen werden" (→ zur Anmeldung) oder „Standorte konnten nicht geladen werden" (→ erneut versuchen).

Dieser Schritt unterscheidet sich von der Zielauswahl (Destination) innerhalb des Boards; diese wird in Abschnitt 1.3 erläutert.

1.3. Das Auftrags-Board

Die Hauptseite ist ein Board mit Statusspalten, die jeweils separat scrollen:

• Neu (New): neu eingegangene Bestellungen.
• In Zubereitung (Preparing): Aufgaben, die begonnen wurden.
• Fertig/Abgeschlossen (Completed): erledigte Aufgaben.
• Storniert (Cancelled): stornierte Bestellungen (rot).

Am Kopf jeder Spalte werden die Anzahl der Bons und die Anzahl der Positionen angezeigt; eine leere Spalte hat ihre eigene Meldung („No new work", „Nothing preparing", „No completed work", „Nothing cancelled").

Leiste am oberen Rand des Boards

• Zielauswahl (Destination): Auswahl, welchen Küchenmonitor / welche Küchenstation dieses Display anzeigt (etwa „Warme Küche" oder „Bar"). Gibt es nur ein Ziel, wird es automatisch ausgewählt, und Ihre letzte Auswahl wird gespeichert. Ist kein Ziel verfügbar, erscheint ein Hinweis, und Sie müssen vor dem Laden ein Ziel wählen.
• Schaltfläche Aktualisieren (Refresh), die Kennzeichnung „Refreshing" während der Aktualisierung, der Zeitpunkt der letzten Prüfung, die Anzahl der Bons/Positionen sowie das letzte Live-Ereignis.
• Hinweis zur Seitenaufteilung: Wenn der Server mehr Daten hat, als geladen wurden, wird „Showing X of Y backend orders" angezeigt — das heißt, nach einer Filter-/Seitenänderung auf Serverseite sollten Sie Aktualisieren drücken.

Was Sie auf jedem Bon sehen

• Art der Quelle: Open cart, Finalized order oder Kitchen dispatch; die Versionsnummer („Rev N").
• Bestelltitel, Quellzeile, Erstellungs- und Aktualisierungszeitpunkt sowie die Statuskennzeichnung.
• Positionszeile: Menge in der Form xN (bei Retouren eine negative Zahl), Artikelname, „Note:" für Notizen, Extras sowie verschachtelte Zusatzartikel mit der Kennzeichnung „Cross-sell for …"; sofern eingerichtet, eine farbige Hintergrundfarbe je Artikel.

1.4. Bestellung weiterbewegen (Bump)

Auf jedem Bon werden nur die für den jeweiligen Status zulässigen Schaltflächen angezeigt:

• Zubereitung starten (Start preparing) → nur aus dem Status „Neu" → wechselt zu „In Zubereitung".
• Fertig (Done) → nur aus dem Status „In Zubereitung" → wechselt zu „Fertig/Abgeschlossen".
• Abbrechen (Cancel) → aus „Neu" oder „In Zubereitung" → wechselt zu „Storniert" (Schaltfläche rot).

Jede Aktion wird auf dem Server gespeichert und die Seite aktualisiert sich; während eine Aktion gespeichert wird, werden die übrigen Schaltflächen desselben Bons ausgeblendet. Unzulässige Aktionen haben gar keine Schaltfläche (sie sind ausgeblendet, nicht deaktiviert). Schlägt das Speichern des Status fehl, wird eine eigene rote Leiste angezeigt („Kitchen status could not be updated").

Bon drucken (Print)

• Nur auf druckbaren Bons gibt es die Schaltfläche zum Drucken.
• Erfolg: „Kitchen ticket sent to …".
• Ist keine Druckvorlage eingerichtet: Warnung „No kitchen print template is configured …".
• Fehler werden nach Ursache unterschieden: ein Problem mit der Vorlage („… template could not be prepared …") gegenüber einem Problem mit der Hardware („… could not be printed … Check the printer connection").

1.5. Signalton

• Bei neuer Arbeit oder einer Änderung wird ein Signalton/Alarm abgespielt, damit Sie es auch ohne Blick auf den Bildschirm bemerken.
• Der Ton wird erst nach einer echten Bestätigung durch den Server abgespielt (neue Arbeit, neuere Version oder Statusänderung) — nicht beim ersten Öffnen der Seite und nicht bei der Aktualisierung nach einer erneuten Verbindung. Mehrere Töne stapeln sich auch nicht (Mindestabstand 1,5 Sekunden).
• Leiste für die Tonberechtigung: Solange der Browser die Tonwiedergabe nicht erlaubt hat, wird am unteren Bildschirmrand eine gelbe Leiste („Kitchen alerts need sound permission") mit der Schaltfläche „Enable kitchen sound" angezeigt.

💡 Wenn kein Ton abgespielt wird, behebt dieselbe Schaltfläche „Enable kitchen sound" oder eine Berührung des Bildschirms das Problem.

1.6. Verbindungsstatus und Wiederherstellung

Am oberen Rand befindet sich eine Anzeige Live / Stale / Offline („Stale" bedeutet langsame Verbindung / erneuter Verbindungsaufbau). Wenn die Live-Verbindung gestört ist, erscheint eine auffällige Leiste:

• „Live order updates are offline" (getrennt)
• „Reconnecting to live order updates …" (Verbindungsaufbau läuft)
• „Live updates may be behind" (eine Aktualisierung ging verloren; das Board aktualisiert sich selbst automatisch)

Wenn die Live-Verbindung getrennt ist, ist der sichere Weg die manuelle Schaltfläche Aktualisieren (Refresh) am oberen Rand. Das Board behält die vorhandenen Bons zwischen den Aktualisierungen und zeigt nur den neuen Status an.

• Der Zustand „Standort wird ermittelt" hat seine eigene Schaltfläche („Retry location"); wenn das Board gar nicht geladen wurde, erscheint die Wiederherstellungsseite „Refresh board".
• Anfragen haben ein Zeitlimit (bei Verzögerung die Meldung „request timed out — use Refresh").

1.7. Einstellungen

Über das Benutzermenü erreichen Sie die Kontoeinstellungen mit den Reitern Profil, Sicherheit, Erscheinungsbild (Theme), Benachrichtigungen und Verbindung — sowie die Abmeldung. ⚠️ Der Reiter Verbindung (Integration) ist deaktiviert und lässt sich nicht öffnen.

Die Systemeinstellungen haben nur zwei Reiter: Katalog und Verkauf (der Link „general" führt ebenfalls zum Katalog). Ohne Schreibberechtigung öffnen sie sich mit einer Nur-Lesen-Leiste; ohne Anzeigeberechtigung öffnen sie sich gar nicht.