Glossary

Isang alphabetical reference ng mga domain term na ginagamit sa buong HandyCafe documentation.

Admin Panel Ang pangunahing monitoring dashboard sa HandyCafe Server. Ipinapakita nito ang lahat ng nakakonektang client, ang kanilang status, at aktibong session. Nagbibigay rin ito ng action button sa bawat client card para sa session control at remote management operations.

Commission Rate Isang porsyento na ginagamit para ipahayag ang payment processing fee. Halimbawa, 1% o 5%. Ginagamit sa payment method configuration para tukuyin ang gastos ng pagtanggap ng partikular na payment method.

Binary Protocol Isang compact encoding format na ginagamit para sa TCP communication sa pagitan ng HandyCafe Server at mga client. Pinili ito dahil sa bilis at maliit na sukat ng mensahe kumpara sa text-based formats.

Client Isang customer-facing PC na nagpapatakbo ng HandyCafe Client software. Kumokonekta ang client sa server sa local network, tumatanggap ng session command, at nag-uulat ng status at usage data. Kinikilala ang bawat client sa pamamagitan ng MAC address at hostname nito.

Connection Key Isang shared secret na naka-configure sa server at sa bawat client sa panahon ng setup. Ginagamit ito para gumawa ng cryptographic authentication token para sa TCP communication, upang matiyak na ang awtorisadong device lamang ang maaaring makipagpalitan ng command sa server.

Console Isang gaming device tulad ng PlayStation o Xbox na mino-manage ng HandyCafe. Sinusuportahan ng consoles ang sessions, pricing, at member usage tulad ng client PC, pero hindi sila nagpapatakbo ng HandyCafe Client software. Tinutukoy ang mga ito sa pamamagitan ng MAC address.

Kapeterya Ang integrated na food and drink service module sa HandyCafe. Kabilang dito ang visual floor plan, table management, menu editor na may categories at products, live orders dashboard, at branded customer menu sa handy.cafe/{slug}. Cloud-first ang data model ng Kapeterya; naka-sync ang local at cloud database.

Cybercafe / Cyber Cafe Negosyo na nagbibigay ng public access sa computers at internet connectivity, karaniwang sinisingil kada oras. Tinatawag din itong internet cafe. Mino-manage ng HandyCafe ang lahat ng aspeto ng operasyon ng cybercafe kabilang ang sessions, billing, at memberships.

Device Restriction Isang setting na tumutukoy kung anong uri ng device ang saklaw ng wallet credit, time credit, o pricing rule. Posibleng value: client (PC), console (gaming consoles), PCs only, consoles only, o both (anumang device).

Esports Arena Isang venue na nakatuon sa competitive gaming at esports events, kadalasang may high-performance PC, tournament staging area, at spectator seating. Sinusuportahan ng HandyCafe ang esports arena sa pamamagitan ng session management, member tracking, at console billing.

Entitlement Ang value na natatanggap ng member mula sa pagbili ng package. Maaaring ito ay time credit (prepaid minutes ng session usage), monetary wallet balance, o kumbinasyon ng pareho. Nire-record ang entitlements bilang credit entry sa wallet o time balance ng member.

Floor Plan Isang visual editor sa Kapeterya para isaayos ang mga mesa sa canvas. Sinusuportahan nito ang maraming floor, drag-and-drop positioning, at 3D dimetric view. Bawat mesa ay naka-assign sa eksaktong isang floor. Tingnan ang Kapeterya > Floor Plan.

FX Rate Foreign exchange rate na ginagamit para i-convert ang base currency sa local display currency. Nagbibigay ito sa mga cafe sa mga rehiyong may ibang currency ng kakayahang mag-presyo sa lokal na currency habang nagpapanatili ng consistent na internal accounting base.

Gaming Center Isang commercial venue kung saan nagbabayad ang customer para gumamit ng PC o gaming console, kadalasang may high-performance hardware at social gaming environment. Ginawa ang HandyCafe para i-manage ang operasyon ng gaming center mula sa session billing hanggang membership programs.

Cryptographic Authentication Isang message verification mechanism na ginagamit para matiyak ang integrity at authenticity ng TCP message sa pagitan ng server at mga client. Ginagamit ng parehong panig ang Connection Key para kalkulahin at i-validate ang authentication code.

Internet Cafe Negosyo na nagbibigay sa customer ng timed access sa computers at internet services. Ito ang pangunahing use case ng HandyCafe, na humahawak sa session management, pricing, membership programs, at point-of-sale operations.

Idle Ang client state kapag nakakonekta ang PC sa server pero walang aktibong session. Sa idle state, ipinapakita ng client ang lock screen (IdlePage) at naghihintay ng session start, member login, o administrative action.

Legacy Client Isang HandyCafe V3 o V4 client installation na kumokonekta sa modern server sa pamamagitan ng orihinal na legacy protocol. Lumalabas ang legacy clients sa Admin Panel na may mas kaunting action set (Login, Logout, Add Time, Screenshot, Logoff, Reboot, Shutdown). I-enable ang runtime support sa Settings > Legacy Clients.

Wallet Credit / Time Credit Hiwalay na entry ng wallet balance o prepaid minutes na nalikha sa pamamagitan ng top-up o package purchase. Bawat credit entry ay nagtatala ng pinagmulan nito (cash top-up, package entitlement, campaign bonus), natitirang value, at naaangkop na device restriction. Inuubos ang credits nang sunod-sunod sa panahon ng session settlement.

MAC Address Hardware identifier na naka-assign sa network interface. Ginagamit ng HandyCafe ang MAC address para natatanging matukoy ang client at console, upang makilala ang device kahit magbago ang IP address nila.

mDNS (Multicast DNS) Isang protocol para sa awtomatikong service discovery sa local network. Inaanunsyo ng HandyCafe client ang presensya nila sa pamamagitan ng mDNS, na nagpapahintulot sa server na matukoy sila nang walang manu-manong IP configuration.

Member Isang rehistradong customer na may profile sa HandyCafe system. May wallet, tier level, at transaction history ang member. Maaari silang mag-log in sa client PC para sa personalized session. Maaari rin silang may OAuth-linked account.

Minor Units Ang pinakamaliit na denominasyon ng currency, na ginagamit internaly para sa lahat ng financial calculation upang maiwasan ang floating-point rounding error. Halimbawa, ang USD ay gumagamit ng cents (1 dollar = 100 minor units), habang ang JPY ay direktang yen (1 yen = 1 minor unit).

Multiplier Factor na inilalapat sa base hourly rate sa loob ng pricing schedule slot. Ang multiplier na 1.0 ay nangangahulugang standard rate ang ginagamit. Ang multiplier na 1.5 ay nangangahulugang 50% mas mataas ang rate, habang ang 0.5 ay kalahating presyo.

PC Bang Korean-style na internet cafe at gaming center kung saan nagbabayad ang customer para sa hourly PC access. Kilala ang PC bang sa high-end gaming hardware at competitive gaming culture. Sinusuportahan ng HandyCafe ang operasyon ng PC bang gamit ang flexible pricing schedule at session management.

Online Ang client state habang aktibo ang session. Kapag online, ipinapakita ng client ang desktop interface (OnlinePage), na nagbibigay-daan sa customer na gumamit ng application, mag-browse, at makipag-ugnayan sa client menu.

Postpaid Session billing mode kung saan malayang ginagamit ng customer ang PC at nagbabayad sa dulo batay sa aktwal na tagal ng paggamit. Kinukuwenta ang final cost sa pag-close ng session gamit ang pricing schedule segment na naaangkop.

Prepaid Session billing mode kung saan nagbabayad ang customer nang pauna para sa fixed na tagal. Awtomatikong nagtatapos ang session kapag naubos ang biniling oras, maliban na lang kung na-extend.

Pricing Segment Bahagi ng session kung saan iisang pricing multiplier ang inilalapat. Nalilikha ang segment boundary sa mga event tulad ng session start, pause, resume, o paglipat ng pricing slot sa schedule.

Pricing Slot Color-coded na zone sa weekly pricing schedule grid. Tinutukoy ng bawat slot ang time range at multiplier na nagmo-modify sa base hourly rate. Maaaring sumakop ang slots sa mga partikular na oras sa partikular na araw, na nagbibigay-daan sa magkakaibang presyo para sa peak at off-peak period.

Role Pinangalanang set ng permissions na naka-assign sa cashier account. Tinutukoy ng roles kung anong aksyon ang magagawa ng cashier, halimbawa mag-start ng session, mag-manage ng member, o tumingin ng report. Maaaring magbahagi ang maraming cashier ng parehong role at ipinatutupad ang permission sa buong interface.

Security Code 6-digit na code na nalilikha kapag in-seat ng staff ang customer sa mesa sa Kapeterya. Ini-type ito ng customer pagkatapos i-scan ang table QR para patunayan ang pisikal na presensya. Naka-hash ito sa server side at nag-e-expire sa Close Table o Settle Check. Ipinapakita ng Show Code ang naka-cache na plain text; ang Rotate QR ay lumilikha ng bagong code at ibinabasura ang lumang sticker.

Segment Boundary Event na nagti-trigger ng paglikha ng bagong pricing segment sa loob ng session. Kabilang sa mga boundary ang: session start, session stop, session pause, session resume, at pricing slot change kapag tumawid ang oras mula sa isang slot papunta sa isa pa.

Session Timed period ng paggamit ng PC o console ng customer. Sinusubaybayan ng sessions ang start time, end time, pause, pricing segment, at kabuuang halagang siningil. Maaaring prepaid o postpaid ang mga ito.

Settlement Kalkulasyon na ginagawa kapag nagtatapos ang session para matukoy ang final cost. Pinoproseso nito ang lahat ng pricing segment, inilalapat ang naaangkop na multiplier, idinaragdag ang startup fee at VAT, ibinabawas ang member discount, at gumagawa ng total amount due. Sa Kapeterya, ang settlement ay one-click na aksyon din na nagsasara ng lahat ng bukas na order sa isang mesa gamit ang napiling payment method at ibinabalik ang mesa sa idle.

STE (Smart/Turbo Edition) Protocol variant para sa legacy clients. Ang STE frames ay may 70-byte license info prefix; ang frame size ay 1337 bytes. Ang alternatibo ay Standard (1267 bytes, walang prefix). Itugma ang variant sa kung paano ginawa ang legacy server mo, kung hindi ay madi-drop o mali ang basa sa mga frame. I-set ang variant sa Settings > Legacy Clients.

Shift Work period ng cashier mula login hanggang logout. Lahat ng transaction, session operation, at administrative action na ginawa sa loob ng shift ay naka-attribute sa naka-login na cashier. Ginagamit ang shift data para sa accountability at performance analysis.

Startup Fee Minimum charge na inilalapat kada session anuman ang tagal. Kung ang nakalkulang cost ng session batay sa oras at pricing ay mas mababa sa startup fee, ang startup fee ang sisingilin sa halip. Tinitiyak nito ang baseline revenue bawat session.

Sync Proseso ng file synchronization mula sa HandyCafe Server patungo sa client PC. Gumagamit ito ng manifest-based comparison at chunk-based transfer para mahusay na maipamahagi ang file sa network.

Tier Loyalty level sa member tier system. Tinutukoy ang tiers ng point threshold at nagbibigay ng discount rate sa sessions at orders. Habang nag-iipon ng points ang member sa pamamagitan ng paggastos, umaakyat sila sa mas mataas na tier na may mas magandang benepisyo.

Transaction Financial record ng bayad para sa session, order, wallet top-up, o iba pang billable event. Nire-record ng transactions ang halaga, payment method, kaugnay na member o cashier, at timestamp.

VAT (Value Added Tax) Porsyentong tax na inilalapat sa session charge at order amount. Naka-configure ang VAT rate sa pricing settings at isinasama sa settlement calculation. Hiwalay na tinatala ang mga halaga ng VAT para sa tax reporting.

Wallet Prepaid monetary balance ng member na naka-store sa HandyCafe system. Binubuo ang wallet ng isa o higit pang credit entry at maaaring gamitin para magbayad ng sessions, orders, at iba pang serbisyo. Maaaring mag-top up gamit ang cash, packages, o campaigns.