HandyCafe Docs
owner cashier

Pamamahala ng Session

Ang mga session ang pangunahing billing unit sa HandyCafe. Gumagamit ng isang customer sa iyong internet cafe o gaming center ng PC o gaming console, isang session ang nag-ta-track ng kanilang oras ng paggamit at kinakalkula ang gastos. Ipinapaliwanag ng page na ito ang buong session lifecycle, mula sa pag-start ng session hanggang sa pagkolekta ng bayad.

Mga Uri ng Session

Sinusuportahan ng HandyCafe ang dalawang uri ng sessions:

  • Mga sesyon ng PC. Mga session sa mga PC ng kliyente na pinamamahalaan sa pamamagitan ng Admin Panel. Nilo-lock ng client software ang PC kapag idle at ina-unlock ito kapag nagsimula ang session.
  • Console session. Mga session sa gaming consoles (PlayStation, Xbox, atbp.) na mina-manage sa pamamagitan ng Consoles page. Ang mga ito ay tina-track ng server lamang; walang client software sa mismong console.

Ang uri ng session ay sumusunod sa parehong pricing engine at lifecycle ngunit mina-manage mula sa magkaibang pages sa dashboard.

Session Lifecycle

Ang bawat session ay sumusunod sa isang tinukoy na lifecycle na may malinaw na state transitions:

Start --> Running --> (Pause <--> Resume) --> Add Time --> Stop

Ang mga estado nang detalyado:

  1. Start. Sinisimulan ng cashier ang session. Naa-unlock ang client PC o simulan ang console timer.
  2. Running. Aktibo ang session. Kumukwenta ang oras at nagtitipon ang billing.
  3. Pause. Pansamantalang itinigil ng cashier ang session. Humihinto ang billing. Nagpapakita ang client ng paused state.
  4. Resume. Ipinagpapatuloy ng cashier ang naka-pause na session. Nagre-resume ang billing mula sa bagong pricing segment.
  5. Add Time. Nagdadagdag (o nagbabawas) ng minuto ang cashier sa session.
  6. Stop. Nagtatapos ang session. Kinakalkula ng system ang huling gastos at nagpo-prompt para sa bayad.

Pag-start ng Session

Para mag-start ng bagong session sa client PC:

  1. Piliin ang client. Sa Admin Panel, mag-click ng PC na nasa Idle (cyan) state para lumabas ang action buttons.
  2. Piliin ang billing type. Pumili ng Postpaid (bayad sa huli) o Prepaid (bayad muna).
  3. Mag-assign ng member (opsyonal). Kung ang customer ay isang registered member, hanapin ang kanilang account gamit ang autocomplete member search field. Ang pag-assign ng member ay nagbibigay-daan sa wallet payments at tina-track ang session sa kanilang history.
  4. I-set ang tagal o halaga (prepaid lamang). Para sa prepaid sessions, ilagay ang bilang ng minuto na binibili ng customer o ang monetary amount na binabayaran nila. Kinakalkula ng system ang katumbas na oras batay sa kasalukuyang pricing slot.
  5. Pumili ng paraan ng pagbabayad. Piliin ang paraan ng pagbabayad (Cash, Credit Card, o anumang custom na paraan na na-configure mo).
  6. Confirm. Suriin ang mga detalye at i-confirm. Agad na naa-unlock ang client PC at nagsisimula ang session timer.

Para sa console sessions, magkatulad ang proseso ngunit sinisimulan mula sa Consoles page.

Postpaid Sessions

Sa isang postpaid session, ginagamit muna ng customer ang PC at nagbabayad kapag tapos na. Ito ang pinakakaraniwang billing mode sa internet cafes, cybercafes, at gaming centers.

Paano ito gumagana:

  • Nagsisimula ang session nang walang upfront payment.
  • Tumatakbo ang timer at nagtitipon ang gastos sa real time batay sa aktibong pricing slot.
  • Kapag itinigil ang session, ipinopresenta ng system ang huling kalkuladong gastos.
  • Kinokolekta ng cashier ang bayad at kinokonfirma ang transaksyon.

Walang time limit ang postpaid sessions. Tumatakbo ang mga ito hanggang ihinto ng cashier o humiling ang customer na umalis.

Prepaid Sessions

Sa isang prepaid session, nagbabayad muna ang customer para sa partikular na halaga ng oras. Awtomatikong nagtatapos ang session kapag naubos na ang nabiling oras.

May dalawang prepaid pricing modes na naka-configure sa Settings > Pricing:

Lock at Purchase

Ang gastos ay naka-freeze sa sandaling magsimula ang session. Ang pricing slot at multiplier na aktibo sa oras ng pagbili ay ginagamit para sa buong tagal ng session, anuman ang mga pagbabago sa schedule habang tumatakbo ang session.

Halimbawa: Bumili ang customer ng 60 minuto sa 10:00 AM sa standard-rate slot. Kahit lumipat ang pricing schedule sa half-price slot sa 11:00 AM, hindi naaapektuhan ang natitirang oras ng customer. Nakuha nila nang eksakto ang binayaran nila sa orihinal na rate.

Live Schedule

Nag-a-adjust ang gastos sa real time habang dumadaan ang session sa iba pang pricing slots. Kung ang session ng customer ay tumawid sa slot change, nire-recalculate ang natitirang oras batay sa bagong pricing.

Halimbawa: Bumili ang customer ng 60 minuto sa 10:00 AM sa standard-rate slot. Sa 11:00 AM, lumipat ang schedule sa half-price slot. Dahil mas mura na ang bawat minuto, epektibong humahaba ang natitirang oras ng customer. Maaaring magkaroon sila ng mas maraming total minutes kaysa sa orihinal na binili.

Pag-pause ng Session

Pansamantalang itinitgil ng pause ang billing nang hindi tinatapos ang session. Kapaki-pakinabang ito kapag kailangang lumabas sandali ng customer.

Para mag-pause ng session:

  1. Piliin ang aktibong PC sa Admin Panel at i-click ang Pause button sa card.

Ano ang nangyayari kapag naka-pause ang session:

  • Agad humihinto ang billing. Walang gastos na nagtitipon sa panahon ng pause.
  • Ang kasalukuyang pricing segment ay isinasara na may "pause" boundary.
  • Nagpapakita ang client PC ng paused state na may orange status indicator.
  • Humihinto ang session timer.

Ang mga naka-pause na session ay mananatiling naka-pause nang walang hanggan hanggang sa i-resume o ihinto ng cashier.

Pag-resume ng Session

Ipinagpapatuloy ng resume ang naka-pause na session mula sa pinagtigilan nito.

Para mag-resume ng session:

  1. Piliin ang naka-pause na PC sa Admin Panel at i-click ang Resume button sa card.

Ano ang nangyayari kapag ni-resume ang session:

  • Nagsisimula ang bagong pricing segment sa kasalukuyang oras gamit ang aktibong pricing slot.
  • Nagre-resume ang billing.
  • Bumabalik ang client PC sa aktibong (green) state.

Tandaan na ang pricing slot sa oras ng resume ay maaaring magkaiba sa slot noong naka-pause ang session. Ang bagong segment ay gumagamit ng anumang rate na kasalukuyang aktibo sa pricing schedule.

Pagdagdag ng Oras

Maaari kang magdagdag o magbawas ng minuto sa isang aktibong session anumang oras.

Para magdagdag ng oras:

  1. Piliin ang aktibong PC sa Admin Panel at i-click ang Add Time button sa card.
  2. Ilagay ang bilang ng minuto na idadagdag. Gumamit ng positive value para pahabain ang session o negative value para paikliin.
  3. Confirm.

Ano ang nangyayari kapag nagdagdag ng oras:

  • Isang transaction record ang nalilikha sa session history.
  • Para sa prepaid sessions, nag-a-adjust ang end time nang pasulong (o paatras) ayon sa tinukoy na bilang ng minuto.
  • Para sa postpaid sessions, nire-record ang add-time event ngunit hindi nagse-set ng hard end time.

Pagtigil ng Session

Ang pagtigil ng session ay nagtatapos ng lahat ng billing, nilo-lock ang client PC, at nagti-trigger ng payment process.

Para itigil ang session:

  1. Piliin ang aktibo o naka-pause sa PC sa Admin Panel at i-click ang Stop button sa card.
  2. Lumalabas ang Payment Dialog na nagpapakita ng buod ng session.

Dialog ng Pagbabayad

Ipinapakita ng payment dialog ang sumusunod na impormasyon:

Field Paglalarawan
Duration Kabuuang aktibong oras (hindi kasama ang paused periods)
Nakalkulang Halaga Ang raw calculated cost based sa pricing segments
Charged Amount Ang halagang sisingilin sa customer (default sa computed ngunit maaaring i-override)
VAT Tax amount, kung naka-configure
Komisyon Payment method commission, kung ngayon
Fixed Fee Payment method fixed fee, kung naaangkop
Payment Method Dropdown para piliin kung paano magbabayad ang customer

Cashier override: Maaaring manu-manong i-adjust ng cashier ang charged amount. Halimbawa, maaaring i-round down ng cashier bilang kagandahang-loob o mag-apply ng manual discount. Ang orihinal na computed amount ay palaging naitatago sa mga records para sa auditing.

  1. Pumili ng payment method at i-confirm. Nire-record ang session, nilo-lock ang client PC, at naise-save ang pagdadala.

Proseso ng Settlement

Kapag itinigil ang session, dinadaanan ng settlement engine ang mga hakbang na ito:

  1. Isara ang huling bukas na pricing segment.
  2. I-sum ang lahat ng closed segment amounts.
  3. I-apply ang mga rounding rules (palaging nag-round up sa naka-configure na rounding step).
  4. I-apply ang startup fee minimum (ang total ay hindi kailanman mas mababa sa startup fee).
  5. Kalkulahin ang payment method commission (BPS-based) at fixed fee.
  6. Ipresenta ang mga final amounts sa payment dialog.

Para sa detalyadong paliwanag kung paano gumagana ang pricing segments at settlement calculations, tingnan ang Session Pricing.

Mga Member Sessions

Kapag naka-assign ang isang miyembro sa session, magiging available ang karagdagang billing options:

  • Wallet payment. Maaaring ibawas ang session cost mula sa wallet balance ng member.
  • Time package deduction. Kung nakabili ang member ng time package, ibabawas ang minuto mula sa kanilang package balance sa halip na singilin ng monetary amount.
  • Member discount. Kung may naka-configure na discount ang member (sa basis points), inilalapat ito sa session cost.
  • Session history. Nakalink ang session sa account ng member at lumalabas sa kanilang session history.

Maaaring magsimula ng sarili nilang session ang mga miyembro mula sa client idle screen sa pamamagitan ng pag-log in gamit ang kanilang username at password o sa pamamagitan ng OAuth (kung naka-configure).

Mga Halaga ng Katayuan ng Session

Ang bawat client PC ay nagpapakita ng color-coded na status indicator:

Status Kulay Kahulugan
Online Green Aktibo at tumatakbo ang session
Paused Orange Naka-pause ang session; nakahinto ang billing
Idle Cyan Nakakonekta ang client ngunit walang aktibong session
Offline Red Hindi nakakonekta ang client sa server
Admin Purple Nasa admin/maintenance mode ang client
Abala Dilaw Nagpo-process ng request ang client

Ang mga status colors na ito ay lumalabas sa client cards sa Admin Panel para madali mong makita ang estado ng bawat PC sa isang tingin.

Mga Session Pricing Segment

Ang bawat session ay nahahati sa isa o higit pang pricing segments. Isang bagong segment ang nalilikha tuwing may nangyayaring billing-relevant event:

  • Pagsimula ng session
  • Pause
  • Resume
  • Pagbabago ng pricing slot (kapag tumawid ang orasan sa ibang time slot sa schedule)
  • Pagbabago ng base price (kung babaguhin ng admin ang hourly rate habang tumatakbo ang session)
  • Disconnect o reconnect

Ang bawat segment ay nagrererecord ng pricing slot, multiplier, base price, start time, end time, at calculated amount. Ang session total ay ang kabuuan ng lahat ng mga segment na may rounding at minimum charge rules.

Para sa buong detalye kung paano kinakalkula ang mga segment, tingnan ang Session Pricing.

Minimum Charge at Startup Fee

Kahit ang napakaikling session ay sinisingil ng hindi bababa sa startup fee amount. Ito ay naka-configure sa Settings > Pricing at tinitiyak na ang bawat session ay lumilikha ng minimum na antas ng revenue, gaano man kaigsi ang paggamit.

Halimbawa: Kung ang iyong startup fee ay naka-set sa $1.00 at gumamit ang customer ng PC sa loob lamang ng 30 segundo, ang sisingilin ay $1.00 at hindi ang bahagi ng sentimo na katumbas ng 30 segundo sa hourly rate.


Mga Susunod na Hakbang

  • Session Pricing: Malalim na pagsusuri sa pricing engine, segments, at settlement math
  • Admin Panel: I-monitor at kontrolin ang client PCs
  • Mga Miyembro: I-manage ang member accounts at wallet
  • Cash Report: Suriin ang session revenue at shift summaries