HandyCafe Docs
owner it-admin

Paano I-setup ang Kapeterya

Nilalakbay ng gabay na ito ang kumpletong first-time setup ng Kapeterya module. Sa dulo, magkakaroon ka ng published na customer menu sa handy.cafe/{your-slug}, floor plan na may hindi bababa sa isang gumaganang mesa, menu na may mga product, at matagumpay na test order.

Ang Kakailanganin Mo

  • Aktibong HandyCafe license. Awtomatikong ginagamit ng Kapeterya ang license para sa authentication; hindi ka mano-manong magpapasok ng key.
  • Internet connectivity sa server. Cloud-first ang Kapeterya, kaya ang provisioning, menu sync, at order polling ay nangangailangan ng outbound access sa cloud API.
  • Slug na gusto mong gamitin para sa public menu URL. Pinapayagan ang lowercase letters, numbers, at dash. 3 hanggang 62 character ang haba.
  • Opsyonal: logo at header image. Inirerekomendang format ang WebP hanggang 2 MB.
  • Opsyonal: TCP receipt printer sa local network.

Hakbang 1: I-enable ang Kapeterya

  1. Buksan ang HandyCafe Server.
  2. Pumunta sa Settings sa sidebar.
  3. Buksan ang Kapeterya tab.
  4. I-toggle ang Enable Kapeterya sa on.
  5. Kokontakin ng server ang cloud API gamit ang iyong license bilang authorization token. Kapag naging maayos, magbubukas ang Provisioning Wizard.

Inaasahang resulta: Lalabas ang Provisioning Wizard screen. Kung may error tungkol sa license o connectivity, suriin ang internet connection at tiyaking aktibo ang HandyCafe license mo.

Hakbang 2: I-Provision ang Cafe Mo

Hihilingin ng wizard ang apat na field.

  1. Slug. I-type ang gustong suffix ng URL mo. Nag-a-update sa loob ng isang segundo ang availability indicator. Kung taken o reserved ang slug, pumili ng iba.
  2. Display Name. Ang pangalang nakikita sa itaas ng customer menu, halimbawa "Atilla's Gaming Lounge".
  3. Country at Currency. Piliin ang bansang pinaglilingkuran ng cafe. Nakabase sa bansa ang default currency at maaari itong palitan.
  4. Timezone. Piliin ang timezone para sa order at settlement time stamp.
  5. I-click ang Create Cafe.

Inaasahang resulta: Magsasara ang wizard at bubukas ang Kapeterya workspace. Live na ngayon ang pampublikong URL mong handy.cafe/{slug}, kahit wala pang laman ang menu.

Hakbang 3: Punan ang Business Profile

  1. Nasa Settings > Kapeterya pa rin, mag-scroll sa Business Profile section.
  2. Mag-upload ng Logo (square image).
  3. Mag-upload ng Header Image (malapad na banner).
  4. Ilagay ang Address at Phone na ipapakita sa footer ng customer menu.
  5. I-toggle ang Show Prep Time on Menu depende kung gusto mong makita ng customer ang estimated preparation time.
  6. I-click ang Save.

Inaasahang resulta: Makikita sa preview ang logo at header. Kapag binisita mo ang handy.cafe/{slug} sa browser, branded na ang header pero wala pa ring content.

Hakbang 4: Gumawa ng Mga Floor

  1. Sa Settings > Kapeterya, hanapin ang Floors section.
  2. I-click ang Add Floor at pangalanan ito, halimbawa "Main Hall".
  3. Magdagdag ng karagdagang floor kung may maraming area ang venue mo, halimbawa "Mezzanine" o "Outdoor Patio".
  4. Ayusin ang pagkakasunod ng floor gamit ang move-up at move-down button. Ang top floor ang nagiging default sa Floor Plan editor.

Inaasahang resulta: Lalabas ang iyong mga floor sa listahan. Makikita na rin sa Kapeterya > Floor Plan tab ang mga floor pill sa itaas.

Hakbang 5: Bumuo ng Floor Plan

  1. Buksan ang Kapeterya > Floor Plan.
  2. Piliin ang unang floor mula sa mga pill.
  3. I-click ang Add Table. Lalabas ang isang square table sa origin ng canvas.
  4. I-drag ang mesa sa nais na puwesto. I-release para ma-save.
  5. I-click ang mesa para buksan ang properties panel nito. I-configure ang:
    • Code (halimbawa "T1", "Window 3").
    • Display Name (opsyonal na mas mahabang label).
    • Seat Count (bilang ng upuan).
    • Shape (square, rectangle horizontal, rectangle vertical, o round).
    • Size (1 hanggang 10).
  6. Ulitin para sa bawat mesa sa floor.
  7. Opsyonal na lumipat sa 3D view para masuri ang layout mula sa pananaw ng arkitekto.

Inaasahang resulta: Nagrerender ang floor plan ng lahat ng mesa sa kanilang totoong posisyon. Naka-disable ang drag sa 3D view; bumalik sa 2D para ilipat ang mga mesa.

Hakbang 6: Bumuo ng Menu

  1. Buksan ang Kapeterya > Menu.
  2. I-click ang Add Category. Maglagay ng pangalan at pumili ng MDI icon mula sa icon picker. I-click ang Save.
  3. Ulitin para sa bawat category, halimbawa "Hot Drinks", "Cold Drinks", "Burgers", "Desserts".
  4. Sa loob ng category, i-click ang Add Product. Ilagay ang:
    • Name.
    • Description (suportado ang Markdown).
    • Ingredients line.
    • Base Price.
    • VAT Rate.
    • Preparation Time (static fallback).
    • Opsyonal: Unit label, Track Stock flag, In Stock count.
  5. Mag-upload ng product Photo. Tinatanggap ang anumang format; inirerekomenda ang WebP hanggang 2 MB.
  6. I-click ang Save.
  7. Kung may choices ang product, mag-scroll sa Variants section at i-click ang Add Variant. Gumawa ng row para sa bawat option na may price delta nito. I-toggle ang Required kung kailangang pumili ang customer ng isa.
  8. Ulitin para sa bawat product sa menu mo.

Inaasahang resulta: Ipinapakita na ngayon ng customer menu sa handy.cafe/{slug} ang iyong mga category at product. Bisitahin ito sa browser para mag-verify.

Hakbang 7: I-configure ang Printer (Opsyonal)

  1. Nasa Settings > Kapeterya pa rin, mag-scroll sa Printer Settings.
  2. Itakda ang Kind sa TCP.
  3. Ilagay ang printer IP at Port. Karamihan sa ESC POS TCP printer ay nakikinig sa port 9100.
  4. I-enable ang Auto Cut kung sinusuportahan ito ng printer.
  5. I-enable ang Auto Print on New Order para awtomatikong mag-print para sa bawat papasok na order.
  6. I-enable ang Sound Notification para may audio alert kasabay ng desktop notification.
  7. I-click ang Test Print. Dapat mag-print ang sample receipt sa loob ng ilang segundo.

Inaasahang resulta: Matagumpay na nagpi-print ang test receipt. Kung walang lumabas, i-verify ang IP, port, at kung nasa iisang local network ang printer at server.

Hakbang 8: I-upuan ang Mesa at Subukan ang Order

  1. Buksan ang Kapeterya > Tables (o gamitin ang action menu ng Floor Plan).
  2. Pumili ng isang mesa at i-click ang Seat Customer (tinatawag ding "Open Table").
  3. Tandaan ang 6-digit na security code na ipinakita. Isulat ito o iwanang bukas ang dialog.
  4. Sa phone, pumunta sa handy.cafe/{slug}/{table-code}. Maaari mo ring i-scan ang QR kung may naka-print kang sticker.
  5. Ilagay ang 6-digit na code.
  6. Buksan ang menu at magdagdag ng item sa cart.
  7. Dumiretso sa checkout. Piliin ang Cash bilang payment method (opsyonal lang ang Stripe setup at maaari itong idagdag mamaya).
  8. Isumite ang order.
  9. Sa server, lumipat sa Kapeterya > Orders.

Inaasahang resulta: Sa loob ng 3 segundo, may lalabas na bagong order card sa Orders dashboard. Magti-trigger ang desktop notification. Tutunog ang audio alert kung naka-enable ang sound notifications. Tataas ang pending-count badge sa Orders tab.

Hakbang 9: I-advance at I-settle ang Test Order

  1. Sa order card, i-click ang susunod na status button. Lilipat ang order mula placed patungong confirmed.
  2. Ipagpatuloy ang pag-click upang dumaan sa preparing, ready, at served.
  3. Sa Tables page, buksan ang parehong mesa at i-click ang Settle Check.
  4. Piliin ang Cash bilang payment method at i-confirm.

Inaasahang resulta: Babalik ang mesa sa idle. Mae-expire ang security code. Nalilikha ang settlement record at maaari itong i-audit sa susunod.

Mga Karaniwang Pagkakamaling Dapat Iwasan

  • Nilalaktawan ang business profile. Makikita ng customer ang default display name at sirang logo area kung mag-launch ka bago i-save ang profile.
  • Hindi nire-reprint ang QR code kapag nagbago ang slug. Kapag binago ang slug, mawawalan ng bisa ang lahat ng umiiral na QR. Mag-print ng bagong sticker at palitan ang bawat mesa.
  • Masyadong maraming category ang inilalabas sa launch. Sikaping may 6 hanggang 10 top-level category. Mas mabilis makapag-browse ang customer kapag kasya sa screen ang menu.
  • Nakakalimutang i-configure ang printer bago ang unang totoong shift. Kung walang Auto Print on New Order, maaaring hindi mapansin ng staff ang order sa masikip na panahon. Palaging magpatakbo ng kahit isang test print.
  • Naka-default na naka-on ang Show Prep Time on Menu pero walang dynamic history. Sa unang 30 araw, ang static value ang nakikita ng customer. Magtakda ng makatotohanang static time o i-disable ang chip hanggang matuto ang dynamic estimate.
  • Ginagamit ang parehong device para sa staff at customer testing. Nananatili ang customer session nang 24 oras; kung ang test device mo ay ibibigay mamaya sa customer, naka-login na sila sa menu nang hindi na-verify. I-clear ang device o gumamit ng malinis na browser profile para sa tests.