HandyCafe Docs
owner cashier

Member Wallet

Ang member wallet ay isang sistema ng balanse na nagpapahintulot sa mga miyembro na mag-prepay para sa mga serbisyo ng cafe. Sa halip na magbayad ng cash para sa bawat indibidwal na session, ang isang miyembro ay maaaring mag-load ng pondo sa kanilang wallet at awtomatikong ibabawas ng sistema mula sa balanse na iyon habang gumagamit sila ng mga PC, console, o nag-oorder ng mga produkto.

Arkitektura Batay sa Credit

Gumagamit ang wallet ng isang credit system sa halip na isang solong tumatakbong balanse. Sa tuwing may idinadagdag na pondo sa wallet ng miyembro, ang sistema ay lumilikha ng bagong wallet credit. Ang bawat entry ng credit ay isang indibidwal na talaan na may sariling balanse, pinagmulan, expiration, at limitasyon sa device. Ang disenyo na ito ay nagbibigay ng:

  • Buong traceability kung saan nagmula ang bawat unit ng balanse.
  • Independent expiration dates para sa bawat entry ng credit.
  • Mga limitasyon na partikular sa device (ang ilang credits ay maaaring magamit lamang sa mga PC, ang iba ay sa mga console lamang).
  • Malinaw na paghihiwalay sa pagitan ng bayad na pondo at mga promotional bonus.

Ang kabuuang balanse ng wallet ng miyembro ay ang kabuuan ng lahat ng natitirang halaga sa kanilang mga aktibong entry ng credit.

Mga Uri ng Credit

Ang bawat wallet credit ay may uri ng credit na tumutukoy kung paano pumasok ang pondo sa sistema:

Uri ng Credit Paglalarawan
Paid Ang miyembro ay nagbayad para sa mga pondong ito (cash, card, o ibang paraan ng pagbabayad). Nilikha kapag bumibili ng money-based campaign package.
Bonus Mga promotional na pondo na ibinigay bilang bahagi ng pagbili ng package. Halimbawa, "magbayad para sa 100 minuto, makakuha ng 20 bonus minuto na halaga ng credit."
Manual Manwal na niload ng isang cashier o admin. Ginagamit para sa goodwill credits o espesyal na kasunduan.
Correction Isang administratibong pag-aayos upang itama ang isang error sa balanse ng miyembro.
Migration Mga pondo na inimport mula sa isang legacy system sa panahon ng data migration.
Reversed refund Mga pondo na naibalik kapag ang isang dating ibinigay na refund ay ni-reverse.

Ang uri ng credit ay itinatakda kapag nilikha ang credit at hindi na mababago pagkatapos. Ito ay nagsisilbing permanenteng audit trail.

Katayuan ng Credit

Ang bawat wallet credit ay dumadaan sa isang lifecycle na sinusubaybayan ng kanyang katayuan:

  • Active: Ang credit ay may natitirang pondo at hindi pa nag-expire. Ang mga pondo ay maaaring makonsumo mula sa credit na ito.
  • Expired: Ang expiration date ng credit ay lumipas na. Ang anumang natitirang pondo ay hindi na magagamit.
  • Consumed: Ang natitirang balanse ng credit ay umabot na sa zero sa pamamagitan ng normal na konsumo.
  • Cancelled: Ang credit ay manwal na kinansela ng isang administrator, na nag-void ng anumang natitirang balanse.

Konsumo ng Wallet

Kapag ang wallet ng miyembro ay siningil (para sa session time, isang order, o ibang billable event), ang sistema ay lumilikha ng isang wallet consumption record na nag-uugnay sa isang partikular na entry ng credit at itinatala kung gaano karami ang ibinawas.

Ang bawat consumption record ay may kasamang konteksto na tumutukoy kung ano ang nag-trigger ng deduction:

Konteksto Paglalarawan
Session usage Mga pondo na nakonsumo para bayaran ang session usage time. Ang sistema ay nagbabawas mula sa wallet habang tumatakbo ang session.
Wallet payment Isang direktang pagbabayad mula sa wallet (halimbawa, kapag ang miyembro ay nagbabayad para sa isang product order gamit ang wallet balance).
Order Mga pondo na nakonsumo para bayaran ang isang product order sa cafe counter o idineliver sa PC ng miyembro.
Refund Isang negatibong adjustment na nilikha kapag ang isang refund ay pinoproseso, na binabawasan ang konsumo upang ibalik ang mga pondo sa entry ng credit.

Ang bawat consumption record ay nag-uugnay pabalik sa partikular na session, order, o transaksyon na naging sanhi nito, na nagpapahintulot ng buong audit tracing.

Log ng Balanse

Bilang karagdagan sa mga consumption record sa antas ng credit, ang sistema ay nagpapanatili ng isang member balance log na nagtatala ng bawat kaganapan na nagbabago sa kabuuang balanse ng wallet ng miyembro:

Uri ng Kaganapan Paglalarawan
load Mga pondo ay idinagdag sa wallet (bagong entry ng credit na nilikha o umiiral na isa na tinop-up).
spend Mga pondo ay nakonsumo mula sa wallet (bayad sa session, bayad sa order).
refund Mga pondo ay ibinalik sa wallet (refund sa order, refund sa session).
adjustment Isang administratibong pagbabago ay ginawa sa balanse (pagwawasto, write-off).

Ang bawat entry sa balance log ay nagtatala ng halaga ng pagbabago at ang resulta ng balanse, kaya maaari mong muling buuin ang balanse ng miyembro sa anumang punto sa oras sa pamamagitan ng pagbasa ng log nang kronolohikal.

Limitasyon sa Device

Ang bawat wallet credit ay may limitasyon sa device na kumokontrol kung aling mga uri ng device ang maaaring kumonsumo mula rito:

Limitasyon Kahulugan
Client Magagamit sa client PCs. Magagamit din sa consoles maliban kung ang credit ay tahasang nilimitahan.
Console Magagamit sa gaming consoles. Magagamit din sa PCs maliban kung tahasang nilimitahan.
PCs only Magagamit lamang sa client PCs. Hindi maaaring makonsumo ng console sessions.
Consoles only Magagamit lamang sa gaming consoles. Hindi maaaring makonsumo ng PC sessions.
Both Magagamit sa anumang uri ng device na walang limitasyon. Ito ang default.

Kapag kailangan ng sistema na magbawas mula sa wallet ng miyembro, ito ay nag-filter ng mga available na credits ayon sa limitasyon sa device upang matiyak na ang mga karapat-dapat na credits lamang ang sinisingil.

Kategorya ng Wallet at Cross-Category Spend

Ang mga wallet credit ay maaaring lagyan ng tag na may kategorya ng wallet (halimbawa, "gaming" o "general"). Ito ay nagpapahintulot sa cafe na lumikha ng mga isolated na pool ng balanse na maaari lamang gastusin sa ilang mga konteksto.

Ang cross-category spending na opsyon sa bawat credit ay kumokontrol kung ang mga pondo nito ay maaaring gamitin sa labas ng itinalagang kategorya:

  • Kapag disabled (default), ang credit ay maaari lamang makonsumo sa sarili nitong kategorya.
  • Kapag enabled, ang credit ay maaari ring makonsumo ng mga transaksyon sa ibang mga kategorya.

Kung ang isang credit ay walang nakatalagang kategorya ng wallet, ito ay itinuturing bilang isang general-purpose credit at maaaring makonsumo ng anumang transaksyon anuman ang kategorya.

Paano Gumagana ang Top-Ups

Ang mga pondo sa wallet ay maaaring idagdag sa pamamagitan ng ilang mga pamamaraan:

  1. Pagbili ng campaign package: Kapag ang isang miyembro ay bumili ng money-based package mula sa isang campaign, ang sistema ay awtomatikong lumilikha ng mga wallet credit batay sa depinisyon ng package. Ang isang pagbili ng package ay maaaring lumikha ng maraming credits (isa para sa bayad na bahagi, isa para sa bonus na bahagi).

  2. Manual load: Ang isang cashier ay maaaring manwal na magdagdag ng pondo sa wallet ng miyembro mula sa member detail panel. Ito ay lumilikha ng isang entry ng credit na may "Manual" na uri ng credit.

  3. Migration: Sa panahon ng setup ng sistema, ang mga umiiral na balanse mula sa isang nakaraang sistema ay maaaring i-import bilang mga entry ng credit na may "Migration" na uri ng credit.

Paano Nakokonsumo ang Wallet sa Panahon ng Sessions

Kapag ang isang miyembro na may balanse sa wallet ay nagsimula ng session, ang sistema ay maaaring awtomatikong magbayad para sa session mula sa wallet:

  1. Kinakalkula ng session pricing engine ang halaga kada minuto batay sa aktibong pricing slot at anumang naaangkop na tier discounts.
  2. Habang tumatakbo ang session, ang sistema ay pana-panahong nagbabawas ng naipong halaga mula sa mga karapat-dapat na wallet credits ng miyembro.
  3. Ang mga credits ay nakokonsumo ayon sa petsa ng expiration (ang mga credits na unang mag-e-expire ay ginagamit muna) upang mabawasan ang pag-aaksaya mula sa expiration.
  4. Kung ang balanse ng wallet ay maubos bago matapos ang session, ang natitirang halaga ay sinisingil bilang cash payment sa pagtatapos ng session.
  5. Ang bawat deduction ay lumilikha ng consumption record na naka-link sa session bilang isang "Session usage" entry.