HandyCafe Docs
owner it-admin

Cafeteria

Cafeteria is the integrated food and drink service module in HandyCafe. It lets you lay out your tables by zone, publish a branded self-service menu on the web at handy.cafe/{your-slug} and track every incoming order in real time from the server.

Customers scan the QR code on their table, enter a 6-digit access code, browse the menu in their own language and place an order. The order appears on your Cafeteria Orders screen within seconds. Your staff advances each stage of preparation. When service is complete the Settle check action closes the bill in a single step. Customers can also press Call the cashier on the menu to ask for someone to come to the table.

Who This Is For

Cafeteria is designed for internet cafes, gaming centers and esports arenas that also serve food and drinks at customer seats. It replaces paper order slips and verbal requests to the counter. It works alongside the standard HandyCafe session and pricing system. Cafeteria is a separate Cloud module; see Cloud Cafeteria for how it is purchased.

Core Capabilities

Capability Summary
Zone plan Visual editor for one or more zones. Drag tables into position, switch to a 3D view and edit shape, size and zone per table.
Tables Seat customers, show the rotating access code, print QR stickers, mark tables out of service and settle the check.
Menu Root categories and sub-categories with icons and card colors. Products carry photos, descriptions, ingredients, nutrition values and allergens. AI can fill product details on request.
Orders Live dashboard with status filters, a date filter, per-order and per-item status, a pending-count badge and in-app alerts with optional sound.
Settlement One-click close-bill action that settles all open orders on a table with any payment method configured in Settings > Payment Methods, with an optional tip and note.
Customer menu Branded web menu in 24 languages at handy.cafe/{slug}, with light and dark theme and a Call the cashier button.
Printing Kitchen tickets and bills print on the printers you assign under Settings > Printers.

Where Cafeteria Lives in the Server UI

Cafeteria has two entry points:

  1. Cafeteria in the main toolbar. The button sits in the lower block of the toolbar next to Cloud and appears once Cafeteria is enabled. This is the operational workspace for daily use. It contains four tabs: Tables, Zone plan, Menu and Orders. The Orders tab shows a pending badge whenever new orders are waiting. A badge at the right of the tab bar shows the cloud connection: Connected, Connecting…, Offline or Idle.
  2. Cloud > Cafeteria. This is the configuration area. It holds the Enable Cafeteria switch, the Options card (auto-print, sound, tipping, QR rotation), the Zones list and the Business profile (public address, display name, contact details, logo, header image).

Printers are not configured in Cafeteria. Add them under Settings > Printers and assign them to the Cafeteria kitchen ticket and Cafeteria bill jobs. See Printers.

Provisioning a Cafe

Open Cloud > Cafeteria and turn on Enable Cafeteria. The server uses your HandyCafe license as the authorization automatically. You do not paste a key. If no cafeteria exists for the license yet, the Create your handy.cafe page form asks for:

  1. Public handle. This becomes the public URL at handy.cafe/{handle}. Allowed characters are lowercase letters, numbers and dashes, 3 to 62 characters. The form checks availability as you type and rejects reserved handles.
  2. Cafe name. The human-readable name shown at the top of the customer menu.
  3. Country and Currency. The currency applies to menu prices.
  4. Timezone. Used for order and settlement time stamps.

Click Create cafeteria. The cafe is created in the cloud and the rest of the settings appear. You can then add zones, tables and menu items.

Options

The Options card under Cloud > Cafeteria holds:

Option Effect
Auto-print incoming orders Each new order prints on the printer assigned to the Cafeteria kitchen ticket job under Settings > Printers.
Play sound on new order Plays a sound with the new order alert. The same sound plays when a table presses Call the cashier.
Allow tipping on bills Shows tip fields in the settle dialog. Default tip label and Default % pre-fill them.
Rotate QR token after each settle Regenerates the table QR after every settled bill. A previous guest's photo of the QR then stops working.

Click Save at the bottom of the page to apply changes.

Business Profile

The business profile is editable at any time under Cloud > Cafeteria. Key fields:

Field Purpose
Public address The handy.cafe/{address} segment printed into every table QR. Change it with Change address. The old address is released right away and QR codes printed with it stop working. Reprint them after the change. The address can be changed once every 30 days.
Display name Shown at the top of the customer menu.
Address and Phone number Optional contact details for the customer menu.
Show prep time on customer menu When on, each product displays an estimated preparation time chip.
Logo Square WebP up to 2 MB.
Header image Wide WebP up to 2 MB, shown at the top of the customer menu.

Currency, country and timezone are set when the cafe is created.

Architecture Summary

Cafeteria uses a cloud-first data model. Every table, category, product, order and settlement record is stored in the handy.cafe cloud database. Your HandyCafe server keeps a live relay connection to the cloud. New orders and cashier calls are pushed down that connection as they happen. A slower background refresh every 60 seconds reconciles any missed update. It speeds up to every 5 seconds while the relay is offline. Customer-facing pages are served by the handy.cafe cloud directly. They do not require your server to be reachable from the internet.

Because data lives in the cloud:

  • QR codes continue to work even when the server is offline. Staff cannot see orders until connectivity returns.
  • Menu changes reach handy.cafe within seconds of saving.
  • Call the cashier needs a connected server. When no server is connected the customer sees a notice that the cafe is not reachable.

Next Steps