Mga Madalas Itanong

Setup at Installation

Anong mga uri ng negosyo ang sinusuportahan ng HandyCafe?

Dinisenyo ang HandyCafe para sa internet cafe, gaming center, esports arena, cybercafe, at PC bang. Anumang negosyo na nagbibigay ng timed access sa PC o gaming console ay maaaring gumamit ng HandyCafe para i-manage ang sessions, billing, at memberships.

Ano ang system requirements para sa HandyCafe Server?

Kailangan ng server ang Windows 10 o mas bago (64-bit), hindi bababa sa 4 GB RAM, 500 MB disk space, at local network connection. Ang mga client PC ay nangangailangan ng Windows 10 o mas bago na may 2 GB RAM. Kailangang nasa iisang LAN ang lahat ng PC. Tingnan ang System Requirements para sa buong detalye.

Paano ko i-install ang HandyCafe Server?

I-download ang installer mula sa opisyal na website, patakbuhin ito, at sundin ang mga prompt. Sa unang launch, gagawa ang First Setup Wizard ng admin account mo. Tingnan ang Server Installation para sa step-by-step na instruksyon.

Paano ko ikokonekta ang client PC sa server?

I-install ang HandyCafe Client sa PC. Gumagamit ito ng mDNS para awtomatikong ma-discover ang server sa local network. Kapag hindi gumana ang automatic discovery, manu-manong ilagay ang IP address ng server sa client settings. Tingnan ang Client Installation.

Bakit hindi kumokonekta ang client ko sa server?

Karaniwang sanhi: hindi tumatakbo ang server, magkaiba ang subnet ng mga PC, bina-block ng firewall ang mga port (TCP 5001, 5002, 5003 at UDP 5004), o hindi magkatugma ang connection key. Tingnan ang Troubleshooting para sa mas detalyadong solusyon.

Anong ports ang ginagamit ng HandyCafe?

TCP 5001 (commands), TCP 5002 (file transfers), TCP 5003 (remote management), UDP 5004 (screen streaming). Maaaring i-configure ang mga ito sa Network Settings.

Paano ko ia-activate ang license ko?

Ilagay ang license key sa license panel. Bine-validate ito ng server sa licensing server. Kailangan ng aktibong internet connection para sa unang activation. Tingnan ang Licensing.

Ano ang mangyayari kapag ang server ko ay offline nang higit sa 72 oras?

May 72-oras na offline grace period ang HandyCafe. Sa panahong ito, normal na gumagana ang lahat ng feature. Pagkalipas ng 72 oras na walang koneksyon sa licensing server, papasok ang server sa locked state hanggang maibalik ang internet access.

Sessions at Pricing

Paano ako mag-start ng session sa isang PC?

Sa Admin Panel, pumili ng idle PC (cyan) at i-click ang Start sa card. Pumili ng postpaid o prepaid mode, opsyonal na mag-assign ng member, itakda ang duration/amount kung prepaid, pumili ng payment method, at i-confirm. Tingnan ang Sessions.

Ano ang pagkakaiba ng prepaid at postpaid sessions?

Sa postpaid mode, magbabayad ang customer sa dulo batay sa aktwal na oras ng paggamit. Sa prepaid mode, magbabayad ang customer nang pauna para sa fixed na tagal o halaga. Sinusuportahan ng prepaid ang dalawang sub-mode: Lock at Purchase (naka-freeze ang cost sa simula) at Live Schedule (nag-a-adjust ang cost ayon sa pagbabago ng time slot). Tingnan ang Sessions.

Paano gumagana ang pricing schedule?

Ang pricing schedule ay 7-araw by 24-oras na grid kung saan ang bawat time block ay naka-assign sa color-coded pricing slot. Ang bawat slot ay may multiplier, halimbawa 1.0x standard, 1.5x peak, at 0.5x off-peak. Kinukuwenta ang session cost bilang base hourly rate na minumultiply sa slot multiplier at sa tagal. Tingnan ang Session Pricing.

Paano ako magse-set ng magkakaibang presyo para sa weekend at weekday?

Sa Settings > Pricing Schedule, gumawa ng pricing slot na may magkakaibang multiplier, halimbawa "Weekday" sa 1.0x at "Weekend" sa 1.3x. Kulayan ang weekend column gamit ang Weekend slot color at ang weekday column gamit ang Weekday slot color. Tingnan ang Pricing Schedule Settings.

Paano ako magpa-pause at magre-resume ng session?

I-click ang Pause sa online PC card. Tumitigil ang billing habang naka-pause. Para mag-resume, i-click ang Resume sa naka-pause na PC card. May bagong pricing segment kapag nag-resume. Tingnan ang Sessions.

Paano ako magdadagdag ng extra time sa aktibong session?

I-click ang Add Time sa online PC card. Ilagay ang bilang ng minuto na idaragdag (positive para pahabain, negative para bawasan). Nalilikha ang transaction record para sa adjustment.

Ano ang mangyayari kapag ang session ay dumaan sa maraming pricing slot?

Awtomatikong hinahati ang session sa mga segment sa hangganan ng slot. Ang bawat segment ay gumagamit ng multiplier na aktibo sa panahong iyon. Ang kabuuang cost ay kabuuan ng lahat ng segment cost. Tingnan ang Session Pricing.

Ano ang startup fee?

Ang startup fee ay minimum charge na inilalapat sa bawat session. Kahit napakaikli ng session, sinisingil pa rin ang customer ng hindi bababa sa halagang ito. I-configure ito sa Pricing Settings.

Members at Loyalty

Paano ako gagawa ng bagong member?

Pumunta sa Members page at i-click ang Add Member. Ilagay ang username, display name, opsyonal na email, phone, at iba pang detalye. Mag-assign ng tier kung naaangkop. Tingnan ang Members.

Paano gumagana ang wallet system?

Bawat member ay may wallet balance. Kapag nag-top up ka ng wallet, nalilikha ang wallet credit na may tiyak na halaga at credit type (paid, bonus, manual, atbp.). Sa mga session, awtomatikong nagagamit ang wallet. Ang credits ay maaaring may expiration date at device restriction. Tingnan ang Member Wallet.

Ano ang wallet credit?

Ang wallet credit ay hiwalay na entry ng wallet balance na nalilikha sa isang top-up. Bawat credit ay may sariling amount, credit type (paid, bonus, manual), status (active, expired, consumed), at eligible device restriction. Inuubos ang credits nang sunod-sunod, mula sa pinakaluma. Tingnan ang Member Wallet.

Paano gumagana ang loyalty tiers at points?

Kumikita ang members ng points sa pamamagitan ng mga aktibidad tulad ng paggastos, pagbisita, top-up, at order. May point threshold ang bawat tier. Kapag nakaipon ang member ng sapat na points, aangat sila sa susunod na tier. Maaaring may mas magandang discount rate ang mas mataas na tier. Tingnan ang Loyalty Tiers.

Paano ako mag-top up ng wallet ng member?

Piliin ang member sa Members page, i-click ang payment/top-up option, ilagay ang halaga, piliin ang credit type at payment method, at i-confirm. Nalilikha ang bagong wallet credit. Tingnan ang Member Wallet.

Maaari bang gamitin ng member ang wallet balance nila para sa parehong PC at console?

Depende ito sa device restriction ng credit. Maaaring i-restrict ang credits sa "PCs only", "consoles only", o "both". Kapag bumili ng package, ang device restriction ay nakabatay sa configuration ng package. Tingnan ang Packages.

Ano ang mangyayari kapag nag-expire ang wallet credit?

Kapag umabot ang credit sa expiration date nito, magbabago ang status nito sa "expired" at ang natitirang balance ay hindi na magagamit. Ini-log ang expired amount sa transaction history ng member.

Paano ko titingnan ang transaction history ng member?

Piliin ang member sa Members page. Ipinapakita ng member detail panel ang transaction ledger kasama ang lahat ng wallet load, gastos, refund, at adjustment na may timestamp at halaga.

Products, Orders, at Inventory

Paano ako magdadagdag ng product sa catalog?

Pumunta sa Products at i-click ang Add Product. Ilagay ang pangalan, category, unit, barcode, sale price, cost price, at VAT rate. I-toggle ang active/inactive. Tingnan ang Products.

Paano ako gagawa ng order para sa customer?

Pumunta sa Orders, i-click ang New Order, opsyonal na i-assign sa isang PC o magdagdag ng note, magdagdag ng item mula sa product catalog na may quantity, pagkatapos isara ang order gamit ang payment method. Tingnan ang Orders.

Paano ako magkakansela o magre-refund ng order?

Buksan ang order mula sa Orders page at i-click ang Cancel. Mawawalan ng bisa ang order at walang payment na maitatala. Para sa refund ng closed order, gamitin ang angkop na refund workflow.

Paano gumagana ang stock tracking?

May stock level ang bawat product. Sinusubaybayan ng stock log ang mga pagbabago ayon sa dahilan: sale (awtomatikong nababawas kapag isinara ang order), purchase (mula sa inventory entry), adjustment, waste, at return. Tingnan ang Products at Inventory.

Campaigns at Packages

Paano ako gagawa ng campaign?

Pumunta sa Campaigns at i-click ang Add Campaign. Ilagay ang pangalan, description, itakda itong active, at mag-configure ng expiration date kung kailangan. Pagkatapos, magdagdag ng packages sa campaign. Tingnan ang Campaigns.

Ano ang pagkakaiba ng minute-based at money-based packages?

Ang minute-based packages ay nagbibigay ng oras sa member na magagamit para sa sessions. Ang money-based packages ay nagdaragdag ng funds sa wallet ng member. Pareho silang maaaring may bonus amount. Tingnan ang Packages.

Paano gumagana ang bonus system sa packages?

Maaaring may bonus ang package sa ibabaw ng base entitlement. Halimbawa, puwedeng mag-alok ang package ng "60 minutes + 15 bonus minutes" o "$10 + $2 bonus". Lumilikha ang bonus ng hiwalay na credit entry na naka-tag bilang "Bonus" credit type.

Paano gumagana ang device restrictions sa packages?

Tinutukoy ng bawat package ang device restriction: client (PC), console, both, PCs only, o consoles only. Kapag binili ang package, mamanahin ng nalikhang wallet/time credits ang restriction na ito at magagamit lamang sa tugmang uri ng device.

Cashier Management

Paano ako gagawa ng cashier account?

Pumunta sa Management > Cashiers. I-click ang Add Cashier, ilagay ang username at password, at mag-assign ng role. Maaari nang mag-log in ang cashier gamit ang mga kredensyal na ito. Tingnan ang Cashier Roles.

Paano ako magse-set ng permissions para sa cashier role?

Pumunta sa Management > Cashier Roles. Gumawa ng bagong role o i-edit ang umiiral na. I-check o i-uncheck ang indibidwal na permission flag sa bawat isa sa 6 na kategorya (Authentication, Members, Consoles, Logs, Reports, Payment Methods). Tingnan ang Cashier Roles.

Ano ang 6 na permission category?

Authentication (1 flag), Members (6 flags: view, add, delete, update, show email, show phone), Consoles (4 flags: view, add, delete, update), Logs (4 flags: view, full history, today only, delete), Reports (3 flags: view, full history, today only), Payment Methods (4 flags: manage, add, delete, update). Kabuuan: 22 individual permission flag.

Paano gumagana ang brute-force protection sa cashier login?

Pagkatapos ng 5 failed login attempt sa loob ng 10 minuto, naka-lock ang account sa loob ng 15 minuto. Lahat ng failed attempt ay naka-log sa audit trail na may security alert.

Paano ko titingnan ang cashier shift reports?

Buksan ang Cash Report page. I-filter ayon sa pangalan ng cashier para makita ang mga transaction na pinroseso ng partikular na cashier sa kanilang shift. Ipinapakita ng shift summary ang totals at breakdown ayon sa payment method.

Settings at Configuration

Paano ko babaguhin ang wika?

Pumunta sa Settings > General at piliin ang iyong wika mula sa dropdown. Sinusuportahan ng HandyCafe ang 24 na wika. Agad na nag-a-update ang interface. Tingnan ang General Settings.

Paano ako magse-set up ng Google OAuth login?

Pumunta sa Settings > OAuth. I-enable ang OAuth globally, pagkatapos i-enable ang Google. Ilagay ang iyong Google Client ID at Client Secret (mula sa Google Cloud Console). Opsyonal na i-import ang JSON credentials file. I-test ito sa pamamagitan ng pagsisimula ng OAuth login mula sa client PC. Tingnan ang OAuth Settings.

Paano ko iko-configure ang pricing schedule grid?

Pumunta sa Settings > Pricing Schedule. I-enable ang schedule, gumawa ng color-coded slot na may multiplier, pagkatapos i-click/i-drag ang 7x24 hour grid para pinturahan ang time block gamit ang gusto mong slot. Tingnan ang Pricing Schedule Settings.

Paano ko iko-customize ang client idle screen?

Pumunta sa Settings > Clients > Idle Screen tab. I-enable ang slideshow, magdagdag ng larawan o video, at mag-set ng durations at transitions. Opsyonal na i-enable ang clock at cafe name overlays. Tingnan ang Client Idle Screen.

Paano ko babaguhin ang theme ng client appearance?

Pumunta sa Settings > Clients > Appearance tab. Pumili ng theme (Neon Arena, Crimson Pulse, Emerald Depth), pumili ng layout preset, at i-configure ang background, card density, at effects. Tingnan ang Client Appearance.

Paano ako magse-set up ng sound notifications?

Pumunta sa Settings > Sounds. I-enable ang master sounds toggle, pagkatapos pumili ng sound para sa bawat event (Call Cashier, New Order, Session End, Login Request) mula sa 15 built-in na opsyon. Tingnan ang Sounds Settings.

Ano ang connection key at bakit ito mahalaga?

Ang connection key ay shared secret na ginagamit para sa cryptographic authentication sa pagitan ng server at clients. Pinipigilan nito ang mga hindi awtorisadong device na kumonekta sa server mo. Lahat ng client ay kailangang gumamit ng parehong key gaya ng server. I-configure ito sa Network Settings.

Remote Management

Paano ako kukuha ng remote screenshot ng client PC?

Piliin ang client sa Admin Panel at i-click ang Screenshot sa card. Ipinapakita ng screenshot viewer ang nakuhang larawan. Maaari mo itong i-refresh para sa bagong capture o i-download ang larawan. Tingnan ang Screenshots.

Paano ako gagamit ng remote desktop para kontrolin ang client PC?

Piliin ang client card at i-click ang Remote Desktop. Magbubukas ang window na may live H.264 video streaming. Maaari mong i-control nang remote ang mouse at keyboard, at gumagana ang clipboard sync sa pagitan ng server at client. Tingnan ang Remote Desktop.

Paano gumagana ang file sync system?

I-configure ang mga directory na isi-sync sa Settings > Sync Explorer. Kapag na-trigger, gumagawa ang server ng file manifest. Ikinukumpara ng client ang manifest laban sa lokal na file at dina-download lamang ang mga binago o bagong file gamit ang chunk-based transfer. Tingnan ang File Sync.

Paano ko makikita kung anong apps ang tumatakbo sa client PC?

Piliin ang client sa Admin Panel at i-click ang Running Apps sa card. Nagpapakita ang panel ng lahat ng kasalukuyang tumatakbong process kasama ang pangalan at detalye. Maaari mo ring tingnan ang Startup Apps, Installed Apps, at Windowed Apps mula sa parehong action button.

Paano ako magpapadala ng mensahe sa client PC?

Piliin ang client card at i-click ang Send Message. I-type ang iyong mensahe at i-confirm. Lalabas ang mensahe sa screen ng customer.

Paano ko i-shu-shutdown o i-re-restart ang client PC nang remote?

Piliin ang client card at i-click ang Shutdown o Reboot. Maaari ka ring mag-multi-select ng mga client para sa bulk operations. Available ang Wake on LAN para i-power on ang mga offline PC na sumusuporta nito.

Reports at Analytics

Paano ko titingnan ang cash report?

Pumunta sa Cash Report mula sa sidebar. Ipinapakita ng report ang summary card, transaction history, device earnings, at charts. Gumamit ng date filter para paliitin ang time range. Tingnan ang Cash Report.

Paano ako mag-e-export ng report data?

Sa Cash Report, gamitin ang export/copy function para kopyahin ang transaction data sa clipboard mo bilang CSV. Maaari mo itong i-paste sa Excel o anumang spreadsheet application.

Anong analytics ang available sa Statistics page?

Siyam na analytics tab: Revenue trends, Sales analytics, Expense tracking, Session statistics, Console utilization, Application usage, Computer usage rates, Member activity, at Cashier performance. Tingnan ang Statistics.

Paano ko iche-check ang computer utilization rates?

Pumunta sa Statistics > Computer Usage tab. Ipinapakita nito ang utilization percentage bawat PC, uptime, at revenue bawat makina. Tinutukoy din nito ang pinaka-busy mong PC. Tingnan ang Sessions & Computer Statistics.

Troubleshooting

Naka-offline daw ang client pero naka-on ang PC. Ano ang gagawin ko?

Suriin kung: 1) tumatakbo ang HandyCafe Client sa PC, 2) nasa iisang network/subnet ang parehong PC, 3) pinapayagan ng firewall ang TCP ports 5001-5003, 4) tugma ang connection key sa server at client. Tingnan ang Troubleshooting.

Mukhang mali ang session pricing. Paano ko ito ibe-verify?

Suriin ang pricing settings (Settings > Pricing) para sa base hourly rate at VAT. Suriin ang pricing schedule (Settings > Pricing Schedule) para sa aktibong multiplier noong oras ng session. Tingnan ang pricing segments ng session sa transaction details para makita kung paano kinuwenta ang bawat segment.

Na-stuck sa "pending" ang OAuth login. Paano ko ito aayusin?

Tiyaking na-approve ng admin ang request sa Requests page. Kung na-stuck ang request, suriin kung: 1) tama ang OAuth provider credentials sa Settings > OAuth, 2) may internet access ang server para maabot ang API ng provider, 3) hindi pa expired ang device code (karaniwang 15-30 minuto ang expiry).

Mabagal ang remote desktop. Paano ko mapapabuti ang performance?

Babaan ang bitrate sa stream settings (subukan ang 1000-2000 kbps para sa LAN). Suriin ang network bandwidth sa pagitan ng server at client. Tiyaking hindi naka-block ang UDP port 5004. Gumamit ng wired Ethernet sa halip na WiFi para sa pinakamahusay na resulta.

Naka-"over_limit" ang license ko. Ano ang ibig sabihin nito?

Mas maraming client PC ang nakakonekta kaysa sa pinapayagan ng license mo. I-disconnect ang mga hindi ginagamit na client o i-upgrade ang license mo. Hindi mag-uumpisa ang server ng bagong session hanggang ang bilang ng nakakonektang client ay nasa loob na ng limit.

Naka-lock out ang cashier pagkatapos ng maraming failed login attempt. Paano ko ito i-unlock?

Maghintay ng 15 minuto para ma-expire ang automatic lockout. Kung urgent, maaaring i-manage ng admin ang cashier account sa management interface.

Kapeterya

Paano nag-o-order ang customer mula sa mesa nila?

Ini-scan nila ang QR code sa mesa gamit ang phone nila, inilalagay ang 6-digit na security code na ibinigay ng staff, bumabrowse ng menu sa sarili nilang wika, nagdadagdag ng item sa cart, at nagsusumite gamit ang Cash o Online (Stripe) payment. Lalabas ang order sa Kapeterya Orders dashboard mo sa loob ng 3 segundo. Tingnan ang Customer Menu.

Paano ko ine-enable ang Kapeterya module?

Buksan ang Settings > Kapeterya at i-toggle ang Enable Kapeterya. Ginagamit ng server ang iyong HandyCafe license bilang authorization nang awtomatiko. May provisioning wizard na hihingi ng slug, display name, country, currency, at timezone mo. Tingnan ang Kapeterya Overview at How to Set Up Kapeterya.

Anong mga wika ang sinusuportahan ng customer menu?

Sinusuportahan ng customer menu sa handy.cafe/{slug} ang 24 na wika. Ang unang pagbisita ay pumipili ng pinakamalapit na tugma mula sa browser's Accept-Language header. Maaaring magpalit ng wika ang customer anumang oras gamit ang picker sa itaas.

Gumagana ba ang Kapeterya kahit walang internet?

Hindi. Cloud-first ang Kapeterya. Kinakailangan ng provisioning, menu sync, at order polling ang outbound internet access. Ang customer-facing pages ay pinaglilingkuran ng cloud at hindi umaasa sa iyong lokal na server para maabot mula sa internet.

Legacy Clients

Sinusuportahan ba ng HandyCafe ang luma kong V3 o V4 clients?

Oo. I-enable ang runtime support sa Settings > Legacy Clients at magse-start ang server ng listeners sa orihinal na legacy ports (UDP 710/711, TCP 712, file transfer 717). Kumokonekta ang mga dati mong client nang walang pagbabago sa kanilang side. Lalabas sila sa Admin Panel na may mas maliit na action set (Login, Logout, Add Time, Screenshot, Logoff, Reboot, Shutdown). Tingnan ang Legacy Clients.

Maaari bang tumakbo ang legacy at modern clients sa iisang server nang sabay?

Oo. Gumagamit ng magkaibang port ang dalawang protocol stack at hindi sila nagbabanggaan. Maaari mong pagsamahin ang luma at bagong client sa iisang LAN at i-manage sila mula sa iisang Admin Panel.

Maaari ko bang dalhin ang data ko mula sa mas lumang HandyCafe installation?

Oo, sa Windows. Buksan ang Settings > Legacy Clients, mag-scroll sa Database Migration, at i-click ang Start Migration. Ine-import ang members, pricing, products, orders, transactions, at logs. Hindi binabago o dini-delete ang orihinal na files. Kung hindi mo gusto ang resulta, i-click ang Undo Migration para i-roll back. Tingnan ang How to Migrate from a Legacy Installation.

Ano ang pagkakaiba ng STE at Standard protocol variants?

Ang STE (Smart/Turbo Edition) frames ay may 70-byte license info prefix; ang frame size ay 1337 bytes. Ang Standard frames ay walang prefix; ang frame size ay 1267 bytes. Piliin ang variant na tugma sa kung paano binuo ang iyong legacy server. Kapag mali ang variant, madi-drop o mali ang basa sa mga frame.