HandyCafe Docs
owner

Paano I-set Up ang Iyong Cafe Mula sa Simula

Itinuturo ng gabay na ito ang bawat hakbang ng bagong pag-install ng HandyCafe para sa iyong internet cafe, gaming center, o esports arena. Sa katapusan mayroon kang gumaganang server, hindi bababa sa isang nakakonektang client PC, na-configure ang pricing, at isang natapos na test session na may bayad na naitala sa iyong cash report.

Kakailanganin Mo

  • Isang Windows PC para maging iyong HandyCafe Server (Windows 10 o mas bago, minimum na 4 GB RAM).
  • Hindi bababa sa isang karagdagang Windows PC para maging isang client station.
  • Isang lokal na network na kumokonekta sa lahat ng PC (inirerekomendang wired Ethernet para sa pagiging maaasahan).
  • Isang valid na HandyCafe beta license key. Ilalagay mo ito sa panahon ng unang setup.
  • Ang iyong gustong hourly rate at currency na napagdesisyunan nang maaga.

Yugto 1: I-install at I-configure ang Server

  1. I-download ang pinakabagong HandyCafe Server installer mula sa iyong HandyCafe dashboard.
  2. Patakbuhin ang installer sa PC na itinakda mo bilang server. Sundin ang mga on-screen na prompt at tanggapin ang default na installation directory.
  3. Ilunsad ang HandyCafe Server. Ang First Setup wizard ay awtomatikong lilitaw sa unang pagtakbo.
  4. Ilagay ang iyong beta license key kapag tinanong. Ia-validate ng server ang key online at ipapakita ang pangalan ng iyong cafe at limitasyon ng PC.
  5. Gumawa ng iyong admin account. Maglagay ng username at malakas na password. Ang account na ito ay may walang limitasyong access sa bawat feature.
  6. Itakda ang pangalan ng iyong cafe. Ang pangalang ito ay lilitaw sa mga client idle screen at sa mga report.
  7. I-click ang Finish para kumpletuhin ang wizard.

Inaasahang resulta: Ang pangunahing window ng server ay nagbubukas na nagpapakita ng Admin Panel na may zero nakakonektang client. Ang pangalan ng iyong cafe ay lilitaw sa title bar.

Yugto 2: I-configure ang Pricing

  1. Buksan ang Settings sa pahina sa pamamagitan ng pag-click sa gear icon sa kaliwang sidebar.
  2. Pumunta sa Pricing tab.
  3. Itakda ang iyong base currency. Pumili mula sa currency dropdown. Lahat ng presyo, transaksyon, at report ay gagamit ng currency na ito.
  4. Ilagay ang iyong hourly rate. Ito ang base na presyo bawat oras para sa mga postpaid session. Halimbawa, ilagay ang 10.00 para sa sampung unit ng iyong currency bawat oras.
  5. Itakda ang VAT rate. Ilagay ang porsyento (0 hanggang 100) na naaangkop sa mga session charge. Ilagay ang 0 kung hindi naaangkop ang VAT.
  6. Itakda ang startup fee. Ito ang minimum na bayad bawat session anuman ang tagal. Ilagay ang 0 kung hindi mo gusto ang minimum na bayad.
  7. Gumawa ng mga pricing preset para sa mga karaniwang tagal. Mag-scroll pababa sa Presets na seksyon. I-click ang Add Preset. Gumawa ng mga preset tulad ng:
    • "30 Minuto" na may tagal na 30 minuto.
    • "1 Oras" na may tagal na 60 minuto.
    • "2 Oras" na may tagal na 120 minuto.
  8. I-click ang Save para i-apply ang iyong pricing configuration.

Inaasahang resulta: Ipakita ng Pricing tab ang iyong hourly rate, VAT rate, startup fee, at lahat ng preset na nakalista sa ibaba. Ang mga preset na ito ay lilitaw bilang mga quick-select na button kapag nagsimula ng mga prepaid session.

Yugto 3: I-verify ang Mga Network Setting

  1. Habang nasa Settings pa rin, pumunta sa Network tab.
  2. I-verify ang listening port. Ang default ay 7842. Baguhin ito lamang kung ang ibang serbisyo sa iyong network ay gumagamit ng port na iyon.
  3. Itakda o tandaan ang connection key. Ang key na ito ay nagpapatunay ng mga client na koneksyon. Lahat ng client PC ay dapat gumamit ng parehong key para kumonekta.
  4. Tiyaking ang firewall ng server PC ay nagpapahintulot ng mga papasok na TCP na koneksyon sa na-configure na port. Sa Windows, ang HandyCafe ay karaniwang nagdaragdag ng rule na ito sa panahon ng installation. Kung binago mo ang port, manu-manong magdagdag ng bagong firewall rule.
  5. Tandaan ang IP address ng server PC na ipinapakita sa Network tab. Kakailanganin mo ito kung hindi makahanap ng server ang mga client sa pamamagitan ng awtomatikong discovery.

Inaasahang resulta: Ipinapakita ng Network tab ang listening port at connection key. Ang server status indicator ay nagpapakita ng "Listening" sa berde.

Yugto 4: I-deploy ang Unang Client

  1. I-download ang HandyCafe Client installer mula sa iyong dashboard.
  2. I-install ito sa iyong unang client PC. Patakbuhin ang installer at sundin ang mga prompt.
  3. Ilunsad ang HandyCafe Client. Susubukan ng client na awtomatikong ma-discover ang server sa pamamagitan ng mDNS sa lokal na network.
  4. Kung mabigo ang auto-discovery, manu-manong ilagay ang server IP address at port sa client connection dialog.
  5. Ilagay ang connection key na nabanggit mo sa Yugto 3.
  6. Hintayin na maitayo ang koneksyon. Ang client screen ay lilipat sa Idle na pahina na nagpapakita ng lock screen na may orasan.

Inaasahang resulta: Sa server, ipinapakita na ngayon ng Admin Panel ang isang nakakonektang client. Ipinapakita ng client tile ang hostname at asul na "Idle" status. Ipinapakita ng client PC ang lock screen.

  1. Ang server ay awtomatikong mag-a-assign ng display name sa client batay sa hostname nito. Para palitan ang pangalan nito, piliin ang client tile sa server at i-click ang Rename.

Yugto 5: Patakbuhin ang Iyong Unang Test Session

  1. Sa Admin Panel ng server, i-click ang Start sa idle client tile.
  2. Sa session dialog, piliin ang Postpaid. Iwanan ang member field na walang laman para sa isang guest session.
  3. I-click ang Kumpirmahin para simulan ang session.

Inaasahang resulta: Ang client tile ay nagiging berde at nagpapakita ng tumatakbong timer na nagbibilang pataas. Sa client PC, nawawala ang lock screen at lilitaw ang Online Page desktop.

  1. Hayaang tumakbo ang session ng hindi bababa sa 5 minuto para ma-verify ang mga kalkulasyon ng pricing.
  2. I-click ang Stop sa berdeng client tile sa server.
  3. Suriin ang cost breakdown dialog. Ipapakita nito ang:
    • Tagal (hal., 5 minuto).
    • Inilapat na hourly rate.
    • Halaga ng VAT.
    • Kabuuang bayad.
  4. Pumili ng paraan ng pagbabayad (Cash ang default).
  5. I-click ang Confirm para isara ang session at itala ang bayad.

Inaasahang resulta: Ang client tile ay bumabalik sa asul na "Idle" status. Ipinapakita muli ng client PC ang lock screen. Isang transaksyon ay naitala sa system.

Yugto 6: I-verify sa Cash Report

  1. Pumunta sa Cash Report na pahina gamit ang kaliwang sidebar.
  2. Kumpirmahin na ang ulat ngayon ay nagpapakita ng isang session na naganap.
  3. I-verify na ang halaga ng transaksyon ay tumutugma sa cost breakdown na nakita mo nang tinahimik ang session.
  4. Suriin na ang payment method column ay nagpapakita ng "Cash" (o anumang pamamaraan na pinili mo).

Inaasahang resulta: Ang cash report ay naglilista ng isang natapos na session na may tamang halaga, tagal, at paraan ng pagbabayad. Ang iyong cafe ay operational na ngayon.

Yugto 7: Opsyonal na Susunod na Hakbang

Kapag gumagana na ang iyong basic na setup, isaalang-alang ang pag-configure ng mga feature na ito:

  1. Magdagdag ng mga miyembro. Pumunta sa Members na pahina. I-click ang Add para gumawa ng mga member account na may mga username at opsyonal na wallet balance. Maaaring mag-log in ang mga member mula sa mga client PC.
  2. Mag-set up ng mga produkto. Pumunta sa Products na pahina. Magdagdag ng mga pagkain at inumin na may mga presyo para makapaggawa ng mga order ang mga cashier.
  3. I-configure ang menu ng kliyente. Pumunta sa Mga Setting > Menu ng Kliyente. magdagdag ng mga kategorya ng application at app para makita ang mga customer ng launcher grid sa Online Page.
  4. Mag-deploy ng karagdagang mga client. I-install ang HandyCafe Client sa bawat station PC sa iyong cafe. Ang bawat isa ay awtomatikong lilitaw sa server.
  5. Gumawa ng mga cashier account. Pumunta sa Management na pahina. dagdagan ng mga cashier account na may mga tungkulin para makapag-log in ang mga staff at makamahal ng mga session.
  6. Mag-set up ng peak/off-peak pricing. Pumunta sa Settings > Pricing Schedule. Gumawa ng mga time-based na multiplier para sumingil ng mas marami sa panahon ng abala.
  7. I-enable ang OAuth login. Pumunta sa Settings > OAuth. I-configure ang Google o iba pang provider para makapag-log in ang mga customer gamit ang kanilang mga social account.

Mga Karaniwang Mali na Dapat Iwasan

  • Paglaktaw sa firewall rule. Kung hindi makakonekta ang mga client, ang pinaka-karaniwang dahilan ay isang Windows Firewall rule na nagbabara ng listening port. I-verify na umiiral ang rule bago mag-troubleshoot ng iba pang mga isyu.
  • Mga hindi tugmang connection key. Ang key sa bawat client ay dapat eksaktong tumugma sa key sa server. Kopyahin at i-paste ito para maiwasan ang mga typo.
  • Pagtatakda ng hourly rate sa 0. Kung iiwan mo ang hourly rate sa zero, lahat ng postpaid session ay libre. Palaging i-verify ang iyong pricing bago maging live.
  • Pagkalimot na i-save ang mga setting. Ang mga pagbabago sa Settings sa pahina ay hindi natatapos hanggang hindi mo kina-click ang Save. Kung mukhang hindi nagbago ang mga setting pagkatapos ng restart, malamang na nakalimutan mong i-save.
  • Pagpapatakbo ng server at client sa parehong PC. Bagaman posible ito para sa pag-test, hindi ito inirerekomenda para sa produksyon. Ang server PC ay dapat isang dedicated na station.