HandyCafe Docs
owner it-admin

Einrichtung der Cafeteria

Diese Anleitung führt Sie durch die vollständige Ersteinrichtung des Cafeteria-Moduls. Am Ende haben Sie ein veröffentlichtes Kundenmenü unter handy.cafe/{your-slug}, einen Grundriss mit mindestens einem funktionierenden Tisch, ein Menü mit Produkten und eine erfolgreich aufgegebene Testbestellung.

Was Sie benötigen

  • Eine aktive HandyCafe-Lizenz. Die Authentifizierung der Cafeteria verwendet die Lizenz automatisch; Sie müssen keinen Schlüssel manuell eingeben.
  • Internetverbindung auf dem Server. Die Cafeteria ist cloud-orientiert, daher erfordern Bereitstellung, Menüsynchronisation und Bestellabfrage alle ausgehenden Zugriff auf die Cloud-API.
  • Einen Slug, den Sie für die öffentliche Menü-URL verwenden möchten. Erlaubte Zeichen sind Kleinbuchstaben, Zahlen und Bindestriche. Die Länge beträgt 3 bis 62 Zeichen.
  • Optional: ein Logo und ein Header-Bild. Empfohlenes Format ist WebP bis zu 2 MB.
  • Optional: ein TCP-Belegdrucker im lokalen Netzwerk.

Schritt 1: Cafeteria aktivieren

  1. Öffnen Sie den HandyCafe-Server.
  2. Navigieren Sie in der Seitenleiste zu Einstellungen.
  3. Öffnen Sie den Tab Cafeteria.
  4. Schalten Sie Cafeteria aktivieren ein.
  5. Der Server kontaktiert die Cloud-API unter Verwendung Ihrer Lizenz als Autorisierungstoken. Bei Erfolg öffnet sich der Bereitstellungsassistent.

Erwartetes Ergebnis: Der Bildschirm des Bereitstellungsassistenten erscheint. Wenn Sie einen Fehler bezüglich der Lizenz oder Konnektivität sehen, überprüfen Sie Ihre Internetverbindung und bestätigen Sie, dass Ihre HandyCafe-Lizenz aktiv ist.

Schritt 2: Ihr Café bereitstellen

Der Assistent fragt nach vier Feldern.

  1. Slug. Geben Sie Ihr gewünschtes URL-Suffix ein. Der Verfügbarkeitsindikator aktualisiert sich innerhalb einer Sekunde. Wenn der Slug vergeben oder reserviert ist, wählen Sie einen anderen.
  2. Anzeigename. Der lesbare Name, der oben im Kundenmenü angezeigt wird, z.B. "Atillas Gaming Lounge".
  3. Land und Währung. Wählen Sie das Land, in dem das Café betrieben wird. Die Währung wird basierend auf dem Land voreingestellt und kann geändert werden.
  4. Zeitzone. Wählen Sie die Zeitzone für Bestell- und Abrechnungszeitstempel.
  5. Klicken Sie auf Café erstellen.

Erwartetes Ergebnis: Der Assistent schließt sich und der Cafeteria-Arbeitsbereich öffnet sich. Ihre öffentliche URL handy.cafe/{slug} ist jetzt live, obwohl das Menü leer ist.

Schritt 3: Das Unternehmensprofil ausfüllen

  1. Immer noch unter Einstellungen > Cafeteria, scrollen Sie zum Abschnitt Unternehmensprofil.
  2. Laden Sie ein Logo hoch (quadratisches Bild).
  3. Laden Sie ein Header-Bild hoch (breites Banner).
  4. Geben Sie die Adresse und Telefonnummer ein, die im Footer des Kundenmenüs angezeigt werden sollen.
  5. Schalten Sie Vorbereitungszeit im Menü anzeigen ein oder aus, je nachdem, ob Sie möchten, dass Kunden geschätzte Vorbereitungszeiten sehen.
  6. Klicken Sie auf Speichern.

Erwartetes Ergebnis: Das Logo und der Header erscheinen in einer Vorschau. Beim Besuch von handy.cafe/{slug} in einem Browser wird nun der gebrandete Header, aber noch leerer Inhalt angezeigt.

Schritt 4: Etagen erstellen

  1. In Einstellungen > Cafeteria, finden Sie den Abschnitt Etagen.
  2. Klicken Sie auf Etage hinzufügen und benennen Sie sie (z.B. "Haupthalle").
  3. Fügen Sie zusätzliche Etagen hinzu, wenn Ihr Veranstaltungsort mehrere Bereiche hat (z.B. "Zwischengeschoss", "Außenbereich").
  4. Ordnen Sie die Etagen mit den Schaltflächen nach oben und unten neu. Die oberste Etage wird im Grundriss-Editor zur Standardetage.

Erwartetes Ergebnis: Ihre Etagen erscheinen in der Liste. Der Tab Cafeteria > Grundriss zeigt nun die Etagen-Pillen oben an.

Schritt 5: Den Grundriss erstellen

  1. Öffnen Sie Cafeteria > Grundriss.
  2. Wählen Sie die erste Etage aus den Pillen aus.
  3. Klicken Sie auf Tisch hinzufügen. Ein quadratischer Tisch erscheint am Ursprung des Canvas.
  4. Ziehen Sie den Tisch an die gewünschte Position. Loslassen, um zu speichern.
  5. Klicken Sie auf den Tisch, um das Eigenschaftenfenster zu öffnen. Konfigurieren Sie:
    • Code (z.B. "T1", "Fenster 3").
    • Anzeigename (optional längeres Label).
    • Sitzanzahl (Anzahl der Sitze).
    • Form (quadratisch, rechteckig horizontal, rechteckig vertikal oder rund).
    • Größe (1 bis 10).
  6. Wiederholen Sie dies für jeden Tisch in der Etage.
  7. Optional wechseln Sie zur 3D-Ansicht, um das Layout aus Architektensicht zu überprüfen.

Erwartetes Ergebnis: Ihr Grundriss zeigt alle Tische an ihren realen Positionen. Ziehen ist in der 3D-Ansicht deaktiviert; wechseln Sie zurück zur 2D-Ansicht, um Tische zu verschieben.

Schritt 6: Das Menü erstellen

  1. Öffnen Sie Cafeteria > Menü.
  2. Klicken Sie auf Kategorie hinzufügen. Geben Sie einen Namen ein und wählen Sie ein MDI-Symbol aus dem Symbol-Picker. Klicken Sie auf Speichern.
  3. Wiederholen Sie dies für jede Kategorie (z.B. "Heiße Getränke", "Kalte Getränke", "Burger", "Desserts").
  4. Innerhalb einer Kategorie klicken Sie auf Produkt hinzufügen. Geben Sie ein:
    • Name.
    • Beschreibung (Markdown unterstützt).
    • Zutatenzeile.
    • Basispreis.
    • Mehrwertsteuersatz.
    • Vorbereitungszeit (statische Fallback).
    • Optional: Einheitenlabel, Lagerbestand verfolgen-Flag, Lagerbestand.
  5. Laden Sie ein ProduktFoto hoch. Jedes Format wird akzeptiert; WebP bis zu 2 MB wird empfohlen.
  6. Klicken Sie auf Speichern.
  7. Wenn das Produkt Optionen hat, scrollen Sie zum Abschnitt Varianten und klicken Sie auf Variante hinzufügen. Erstellen Sie eine Zeile für jede Option mit ihrem Preisdelta. Aktivieren Sie Erforderlich, wenn der Kunde eine auswählen muss.
  8. Wiederholen Sie dies für jedes Produkt in Ihrem Menü.

Erwartetes Ergebnis: Das Kundenmenü unter handy.cafe/{slug} zeigt nun Ihre Kategorien und Produkte. Besuchen Sie es in einem Browser, um dies zu überprüfen.

Schritt 7: Den Drucker konfigurieren (optional)

  1. Immer noch unter Einstellungen > Cafeteria, scrollen Sie zu Druckereinstellungen.
  2. Setzen Sie Art auf TCP.
  3. Geben Sie die Drucker-IP und Port ein. Die meisten ESC POS TCP-Drucker hören auf Port 9100.
  4. Aktivieren Sie Auto Cut, wenn der Drucker dies unterstützt.
  5. Aktivieren Sie Automatisches Drucken bei neuer Bestellung, um bei jeder eingehenden Bestellung einen Druck auszulösen.
  6. Aktivieren Sie Soundbenachrichtigung für einen akustischen Alarm neben der Desktop-Benachrichtigung.
  7. Klicken Sie auf Testdruck. Ein Musterbeleg sollte innerhalb weniger Sekunden gedruckt werden.

Erwartetes Ergebnis: Der Testbeleg wird erfolgreich gedruckt. Wenn nichts gedruckt wird, überprüfen Sie die IP, den Port und ob der Drucker im selben lokalen Netzwerk wie der Server ist.

Schritt 8: Einen Tisch besetzen und eine Testbestellung aufgeben

  1. Öffnen Sie Cafeteria > Tische (oder verwenden Sie das Aktionsmenü im Grundriss).
  2. Wählen Sie einen Tisch aus und klicken Sie auf Kunden platzieren (auch als "Tisch öffnen" bezeichnet).
  3. Notieren Sie den angezeigten 6-stelligen Sicherheitscode. Schreiben Sie ihn auf oder lassen Sie den Dialog offen.
  4. Navigieren Sie auf einem Telefon zu handy.cafe/{slug}/{table-code}. Sie können auch den QR-Code scannen, wenn Sie einen gedruckten Aufkleber haben.
  5. Geben Sie den 6-stelligen Code ein.
  6. Durchsuchen Sie das Menü und fügen Sie einen Artikel zum Warenkorb hinzu.
  7. Gehen Sie zur Kasse. Wählen Sie Bar als Zahlungsmethode (Stripe-Einrichtung ist optional und kann später hinzugefügt werden).
  8. Senden Sie die Bestellung ab.
  9. Wechseln Sie auf dem Server zu Cafeteria > Bestellungen.

Erwartetes Ergebnis: Innerhalb von 3 Sekunden erscheint eine neue Bestellkarte auf dem Bestell-Dashboard. Eine Desktop-Benachrichtigung wird ausgelöst. Ein akustischer Alarm ertönt, wenn Soundbenachrichtigungen aktiviert sind. Das Badge für die ausstehenden Bestellungen erhöht sich im Bestell-Tab.

Schritt 9: Die Testbestellung fortführen und abrechnen

  1. Klicken Sie auf der Bestellkarte auf die nächste Status-Schaltfläche. Die Bestellung wechselt von aufgegeben zu bestätigt.
  2. Klicken Sie weiter, um durch in Bearbeitung, bereit und serviert zu gehen.
  3. Öffnen Sie auf der Seite Tische denselben Tisch und klicken Sie auf Rechnung begleichen.
  4. Wählen Sie Bar als Zahlungsmethode und bestätigen Sie.

Erwartetes Ergebnis: Der Tisch kehrt zu frei zurück. Der Sicherheitscode ist abgelaufen. Ein Abrechnungsdatensatz wird erstellt und kann später geprüft werden.

Häufige Fehler, die vermieden werden sollten

  • Das Unternehmensprofil überspringen. Kunden sehen den Standardanzeigennamen und einen defekten Logo-Bereich, wenn Sie starten, bevor Sie das Profil gespeichert haben.
  • QR-Codes nach Slug-Änderungen nicht neu drucken. Das Ändern des Slugs macht jeden vorhandenen QR ungültig. Drucken Sie neue Aufkleber und ersetzen Sie sie an jedem Tisch.
  • Zu viele Kategorien beim Start veröffentlichen. Streben Sie 6 bis 10 Top-Level-Kategorien an. Kunden durchsuchen schneller, wenn das Menü auf den Bildschirm passt.
  • Den Drucker vor der ersten echten Schicht nicht konfigurieren. Ohne Automatisches Drucken bei neuer Bestellung könnten Mitarbeiter während einer geschäftigen Zeit Bestellungen übersehen. Führen Sie immer mindestens einen Testdruck durch.
  • Die Standardanzeige der Vorbereitungszeit im Menü aktiviert lassen, ohne dynamische Historie. In den ersten 30 Tagen sehen Kunden den statischen Wert. Setzen Sie realistische statische Zeiten oder deaktivieren Sie den Chip, bis die dynamische Schätzung trainiert ist.
  • Dasselbe Gerät für Mitarbeiter- und Kundentests verwenden. Die Kundensitzung bleibt 24 Stunden bestehen; wenn Ihr Testgerät später einem Kunden übergeben wurde, wäre dieser bereits ohne Verifizierung im Menü. Löschen Sie das Gerät oder verwenden Sie ein sauberes Browserprofil für Tests.