HandyCafe Docs
owner it-admin

Floor Plan at Tables

Ang Floor Plan editor ay visual canvas para isaayos ang iyong mga mesa. Ang Tables page naman ay per-table na operations view para sa mga detalye at aksyon. Parehong screen ang gumagamit ng iisang underlying table records.

Mga Palapag

Ang mga palapag ay naghahati ng mesa ayon sa pisikal na lokasyon, halimbawa "Main Hall", "Mezzanine", o "Outdoor Patio". Ginagawa at mino-manage ang mga floor mula sa Settings > Kapeterya.

Kailangan ng bawat cafe ng kahit isang floor. Ang bawat mesa ay laging naka-assign sa eksaktong isang floor. Maaari mong ayusin ang pagkakasunod ng floors gamit ang move-up at move-down controls, at ang pinakataas na floor ang nagiging default kapag binuksan ang Floor Plan tab. Mayroon ding "All floors" pill ang Floor Plan page na nagpapakita ng lahat ng mesa sa pinagsamang view.

Floor Plan Editor

Nagre-render ang Floor Plan editor sa 1200 by 720 canvas na may 10-pixel grid. Lumalabas ang mga mesa bilang shapes sa naka-store nilang posisyon. Sinusuportahan ng editor ang dalawang display mode:

Mode Gamit
2D Para sa pag-eedit at pagsasaayos. I-drag ang mesa, magdagdag o mag-alis, at palitan ang pangalan.
3D Para sa presentation at walkthrough. Nakahilig ang canvas gamit ang CSS perspective para makabuo ng architect-style na dimetric view. Naka-disable ang drag sa 3D mode dahil hindi malinaw ang pointer mapping sa tilted canvas.

Pagdaragdag at Pagposisyon ng Mga Mesa

  1. Buksan ang Kapeterya > Floor Plan.
  2. Piliin ang target na floor mula sa mga floor pill sa itaas.
  3. I-click ang Add Table. Lalabas ang bagong mesa sa origin ng canvas na may default na shape, size, at seat count.
  4. I-drag ang katawan ng mesa sa gusto mong puwesto. Naka-save ang posisyon kapag binitiwan mo ang mouse button.
  5. Ulitin para sa bawat grupo ng upuan.

Naka-snap sa 10-pixel grid ang mga posisyon para manatiling maayos ang pagkaka-align ng mga mesa nang hindi kailangang eksaktong per-pixel ang puwesto.

Mga Property ng Mesa

May sumusunod na editable field ang bawat mesa:

Field Kahulugan
Code Maikling identifier na naka-print sa QR at nakikita ng staff. Dapat itong unique sa loob ng iyong cafe.
Display Name Mas mahabang label na nakikita ng staff, halimbawa "Window 3" o "Booth A".
Seat Count Bilang ng upuan sa mesa. Default ay 2.
Shape Isa sa: square, rectangle horizontal, rectangle vertical, round.
Size Integer mula 1 hanggang 10. Kinokontrol nito ang render size sa editor at sa 3D view.
Floor Ang floor na kinabibilangan ng mesa. Maaaring ilipat ang mesa sa ibang floor sa pamamagitan ng field na ito.
State idle, in_use, o out_of_order.

Mga Estado ng Mesa

State Kahulugan
idle Walang aktibong session. Walang customer na makakapag-order hangga't hindi pa sila ina-seat ng staff.
in_use Aktibo ang security code. Maaaring i-scan ng customer ang QR at umorder.
out_of_order Hindi available ang mesa. Lumalabas itong dimmed sa floor plan at may unavailable notice ang QR page. Kapaki-pakinabang para sa maintenance o repair ng furniture.

Pag-seat ng Customer

Para tumanggap ng order mula sa mesa, kailangang i-seat ng staff ang customer. Ang seating ay naglalabas ng security code at inililipat ang mesa sa in_use state.

  1. Sa Tables page o mula sa Floor Plan action menu, piliin ang mesa.
  2. I-click ang Seat Customer (tinatawag ding "Open Table").
  3. Bubuo ang system ng 6-digit na security code at ipapakita ito.
  4. Ibigay ang code sa customer. Ilalagay nila ito pagkatapos i-scan ang QR.

Ang code ay ipinapakita bilang plain text lamang sa oras ng pag-generate nito, at kapag binuksan ng administrator ang Show Code dialog para sa isang nakabukas nang mesa. Naka-hash ito sa server side. Mag-e-expire ang code pagkatapos ng default na tagal at maaari itong i-rotate o i-reset anumang oras.

Pagpapakita at Pag-rotate ng Code

  • Show Code. Ipinapakita ang kasalukuyang naka-cache na plain text code para sa open table. Kapaki-pakinabang ito kapag hindi nakuha ng customer ang numero sa unang beses. Hindi nito ini-rotate ang code at hindi rin nito binabago ang dating QR.
  • Rotate QR. Gumagawa ng bagong QR token para sa mesa. Hindi na gagana ang dating QR sticker. Gamitin ito kapag magre-reprint ka ng sticker o kapag pinaghihinalaan mong naipasa ang lumang QR sa labas.

Pagsasara ng Mesa

Kapag umalis ang customer nang walang nakabinbing bill, i-click ang Close Table. Agad na mae-expire ang security code, babalik ang mesa sa idle, at ang anumang susunod na pag-scan ay mangangailangan ng bagong seating.

Kung may hindi pa nababayarang order sa mesa, gamitin ang Settle Check sa halip. Isinasara ng settlement ang lahat ng open order gamit ang napiling payment method at ibinabalik ang mesa sa idle. Tingnan ang Orders page para sa flow ng settlement.

Mga QR Code

Bawat mesa ay may QR code na nag-eencode ng URL na handy.cafe/{cafe-slug}/{table-code}. May query parameter na nagdadala ng QR token na nagpapatunay na authentic ang sticker. Kapag na-scan ng customer ang QR:

  1. Ire-resolve ng menu page ang slug at table code laban sa cloud API.
  2. Kung ang mesa ay nasa in_use state, hihingan ang customer ng 6-digit na security code.
  3. Kapag pumasa ang check, mag-i-issue ng session token na naka-store sa cookie at Bearer token fallback. Nariyan ang Bearer fallback dahil maaaring i-block ng iPhone Safari ang third-party cookies sa ilang configuration.

Gumawa ng printable QR mula sa Tables page. Bawat mesa ay may QR preview na maaari mong i-save bilang SVG o PNG. Mag-reprint ng stickers kapag nag-rotate ka ng QR token o binago ang slug.

Mga Tip sa Pagdidisenyo ng Floor Plan

  • Magsimula sa pagtutugma ng totoong layout sa canvas. Ilagay ang entrance malapit sa isang gilid at gumalaw papaloob. Mas madali itong sundan ng staff.
  • I-grupo ang mga mesa ayon sa floor kahit iisang level lang ang venue mo. Ang "Hall" at "Terrace" bilang hiwalay na floor ay nagbibigay-daan para ma-filter ang order dashboard ayon sa area.
  • Gumamit ng mas malalaking Size values para sa mga booth na kasya ang apat o higit pang tao at mas maliliit na value para sa counter stool.
  • Markahan ang mga mesa bilang out_of_order kapag kailangan ng repair ang furniture para hindi makapag-order doon ang customer. Huwag i-delete ang table record maliban kung tuluyan nang wala ang upuan.