Kapeterya
Ang Kapeterya ang integrated na module ng serbisyo ng pagkain at inumin sa HandyCafe. Binibigyan ka nito ng digital na floor plan ng iyong mga mesa, branded na self-service menu sa web sa handy.cafe/{your-slug}, at live na pagsubaybay sa lahat ng papasok na order mula sa server dashboard.
Nag-i-scan ang customer ng QR code sa mesa, naglalagay ng 6-digit na security code, namimili ng menu sa sarili nilang wika, at nag-o-order. Lalabas ang order sa iyong Kapeterya Orders screen sa loob ng ilang segundo. Kinikilala ng staff ang bawat yugto ng paghahanda, at kapag tapos na ang serbisyo, ang action na "Settle Check" ang nagsasara ng bill sa isang hakbang.
Para Kanino Ito
Dinisenyo ang Kapeterya para sa internet cafe, gaming center, at esports arena na nagse-serve din ng pagkain at inumin sa mismong upuan ng customer. Pinapalitan nito ang papel na order slip at mga verbal na request sa counter. Gumagana ito kasabay ng karaniwang session at pricing system ng HandyCafe; hiwalay na mino-monitor ang Kapeterya orders pero nasa iisang cafe license.
Mga Pangunahing Kakayahan
| Kakayahan | Buod |
|---|---|
| Floor plan | Visual editor para sa maraming palapag. I-drag ang mga mesa sa tamang puwesto, lumipat sa 3D view, at markahan ang mesa bilang out of service. |
| Tables | I-configure ang seat count, shape, size (1 hanggang 10), at display code ng bawat mesa. Gumawa ng QR code at i-rotate ito kapag kailangan. |
| Menu | Mga kategorya na may MDI icons, products na may larawan, markdown na description, ingredient list, at variant groups (halimbawa Size, Toppings). |
| Orders | Live dashboard na may 3-segundong polling, pending-count badge, desktop at audio notifications, at per-order at per-item status. |
| Settlement | One-click close-bill action na nagsasara ng lahat ng bukas na order sa isang mesa gamit ang napiling payment method. |
| Customer menu | Branded na web menu sa 24 na wika sa handy.cafe/{slug}, na may light at dark theme at device-aware na default na wika. |
| Online payment | Opsyonal na Stripe Checkout integration para sa pay-on-order, na may fallback sa cash payment sa mesa. |
| Printer | Opsyonal na TCP receipt printer na may auto-cut at auto-print kapag may bagong order. |
Saan Matatagpuan ang Kapeterya sa Server UI
May dalawang entry point ang Kapeterya:
- Kapeterya section sa sidebar. Ito ang operational workspace para sa araw-araw na paggamit. Mayroon itong limang tab: Tables, Floor Plan, Menu, Orders, at Schedule. Nagpapakita ang Orders tab ng pending badge tuwing may naghihintay na bagong order.
- Settings > Kapeterya. Ito ang configuration area. Nasa loob nito ang business profile (slug, display name, logo, header image, address, currency, timezone), printer settings, floor management, at mga opsyonal na feature toggle.
Pagpro-provision ng Cafe
Kapag in-enable mo ang Kapeterya sa unang pagkakataon, awtomatikong ginagamit ng server ang iyong HandyCafe license bilang authorization token. Wala kang kailangang i-paste nang mano-mano. Pagkatapos, hihilingin ng provisioning wizard ang apat na impormasyon:
- Slug. Ito ang magiging pampublikong URL sa
handy.cafe/{slug}. Pinapayagan ang lowercase letters, numbers, at dash. 3 hanggang 62 character ang slug. Real-time na chine-check ng system ang availability at nirereject ang mga reserved slug gaya ng "admin", "api", o "dashboard". - Display name. Ang pangalan na makikita sa itaas ng customer menu.
- Country at currency. Ang default currency para sa mga presyo ng menu. Naka-store ang mga presyo sa minor units (halimbawa cents) at ipinapakita gamit ang naka-configure na currency symbol.
- Timezone. Ginagamit sa dynamic preparation time calculations, time stamp ng mga order, at settlement records.
Kapag natapos ang provisioning, nalilikha ang cafe sa cloud database at bumubukas ang Kapeterya workspace. Maaari ka nang magdagdag ng floors, tables, at menu items.
Business Profile
Maaaring i-edit ang business profile anumang oras sa Settings > Kapeterya. Mga pangunahing field:
| Field | Gamit |
|---|---|
| Slug | Pampublikong bahagi ng URL. Kapag binago ang slug, masisira ang mga kasalukuyang QR code hanggang ma-regenerate ang mga ito. |
| Display Name | Ipinapakita sa itaas ng customer menu. |
| Logo | Square image. Inirerekomenda ang WebP hanggang 2 MB. |
| Header Image | Malapad na banner image sa itaas ng customer menu. Inirerekomenda ang WebP hanggang 2 MB. |
| Address at Phone | Opsyonal. Ipinapakita sa footer ng menu. |
| Currency | Inilalapat sa bawat presyo ng produkto sa menu. |
| Country | Ginagamit para sa tax at regional defaults. |
| Timezone | Inilalapat sa order at settlement time stamp. |
| Show Prep Time on Menu | Toggle. Kapag naka-on, magpapakita ang bawat produkto ng estimated preparation time chip. |
Printer Settings
Tinatanggap ng printer section ang sumusunod na configuration:
- Kind. Disabled o TCP lang. Hindi suportado ang USB direct printing sa release na ito.
- IP at Port. Ang network address ng iyong receipt printer. Karamihan sa ESC POS TCP printer ay nakikinig sa port 9100.
- Auto Cut. Nagdaragdag ng paper cut command pagkatapos ng bawat na-print na resibo.
- Auto Print on New Order. Kapag naka-on, bawat papasok na order ay awtomatikong nagpapasimula ng pag-print ng resibo.
- Sound Notification. Nagpapatugtog ng audio alert bukod pa sa desktop notification kapag may bagong order.
- Test Print. Nagpapadala ng sample receipt sa naka-configure na printer para masuri ang koneksyon.
Buod ng Arkitektura
Cloud-first ang data model ng Kapeterya. Ang bawat table, category, product, order, at settlement record ay naka-store sa cloud database ng handy.cafe. Ang iyong lokal na HandyCafe server ay nagmi-mirror ng state na ito at nagpo-poll sa Orders endpoint kada 3 segundo para sa bagong activity. Ang customer-facing pages ay direktang pinaglilingkuran ng handy.cafe cloud; hindi kailangan na maabot ang iyong server mula sa internet.
Dahil nasa cloud ang data:
- Gumagana pa rin ang QR code kahit offline ang server, pero hindi makikita ng staff ang mga order sa dashboard hanggang bumalik ang connectivity.
- Ang mga pagbabago sa menu ay naipapasa sa handy.cafe sa loob ng ilang segundo pagkatapos i-save.
- Ang mga order na ginawa ng customer ay dumarating sa Orders dashboard pagkatapos ng susunod na 3-segundong poll.
Mga Susunod na Hakbang
- Floor Plan and Tables: Bumuo ng spatial layout ng iyong venue at i-configure ang bawat mesa.
- Menu Management: Gumawa ng mga category, product, at variant.
- Orders: Ang live dashboard para sa mga papasok na order.
- Customer Menu: Ang nakikita ng customer kapag nag-scan sila ng QR ng mesa.
- Set Up Kapeterya: End-to-end na walkthrough ng setup.