HandyCafe Docs
owner it-admin

Floor Plan and Tables

The Zone plan tab is a visual canvas for arranging your tables. The Tables tab is the per-table operations view for seating, codes, QR stickers and settlement. Both tabs work on the same underlying table records. This page covers zones and the layout editor. Daily table operations are described in Tables and QR Codes.

Zones

Zones group tables by physical area, for example "Main Hall", "Mezzanine" or "Terrace". You create and manage zones in the Zones card under Cloud > Cafeteria.

  1. Type a name in the zone name field.
  2. Click Add.
  3. Use Move up and Move down to change the order. The first zone opens by default on the Zone plan tab.
  4. Use Delete zone to remove a zone. A zone that still has tables cannot be deleted. Move or delete its tables first.

Every table belongs to exactly one zone. Zone names must be unique. The Tables tab also offers an All zones pill that lists every table grouped by zone.

Zone Plan Editor

The Zone plan editor renders on a 1200 by 720 canvas with a 10-pixel grid. Tables appear as shapes at their stored positions. Pick the zone to edit from the zone pills at the top. The editor supports two display modes:

Mode Use it for
2D Editing and arranging. Drag tables, add or delete them and change their properties.
3D Presentation and walk-throughs. The 3D toggle tilts the canvas into an architect-style view. Drag is disabled in 3D mode because pointer mapping is ambiguous on a tilted canvas.

Adding and Positioning Tables

  1. Open Cafeteria > Zone plan.
  2. Pick the target zone from the zone pills at the top.
  3. Click Add table. A dialog asks for the Code, Display name, Seats, Size and Shape.
  4. Save. The table appears near the top left corner of the canvas.
  5. Drag the table body to your desired position. Position is saved automatically when you release the mouse button.
  6. Repeat for each table.

Positions snap to a 10-pixel grid so that aligned tables feel orderly without requiring pixel-perfect placement.

Table Properties

Field Meaning
Code Short identifier printed on the QR and visible to staff. Letters, numbers and dashes only. Spaces are turned into dashes. It must be unique within your cafe.
Display name Longer label shown to staff, for example "Window 3" or "Booth A".
Seats Number of seats at the table.
Shape Square, Rect. horizontal, Rect. vertical or Round.
Size Integer from 1 to 10. Controls the render size in the editor and on the 3D view.
Zone The zone this table belongs to.

Click a table on the canvas to open the Selected table panel. There you can change its shape and size, move it to another zone (when you have more than one zone) or Delete it.

Table States

State Label Meaning
idle Available No active session. No customer can place an order until you seat them.
in_use In use An access code is active. The customer can scan the QR and order.
out_of_order Out of service The table is unavailable. It appears dimmed and the QR page shows an unavailable notice.

Seating a customer, showing or rotating the access code, printing QR stickers, marking a table out of service and settling the check all happen on the Tables tab. See Tables and QR Codes.

QR Codes

Each table has a QR code that encodes the URL handy.cafe/{public-address}/{table-code}. A query parameter carries the QR token that proves the sticker is authentic. When the customer scans the QR:

  1. The menu page resolves the address and table code against the cloud API.
  2. If the table is in use, the customer is asked for the 6-digit access code.
  3. On a successful check, a session token is issued and stored in a cookie with a Bearer token fallback. The Bearer fallback exists because iPhone Safari may block third-party cookies in some configurations.

Print QR stickers from the Tables tab with View QR or Print all QR. Reprint stickers whenever you rotate the QR token or change the public address.

Tips for Designing a Zone Plan

  • Start by mapping the real layout to the canvas. Place the entrance near one edge and work inward. This makes it easier for staff to orient themselves.
  • Group tables by zone even if your venue has just one level. "Hall" and "Terrace" as separate zones lets staff filter the Tables tab by area.
  • Use larger Size values for booths that fit four or more people and smaller values for counter stools.
  • Mark tables Out of service when furniture needs repair so customers cannot place orders on them. Do not delete the table unless the seat is gone permanently.