HandyCafe Docs
owner

Mga Antas ng Katapatan

Ang sistema ng antas ng katapatan ay nagbibigay gantimpala sa mga regular na customer ng awtomatikong diskwento batay sa kanilang naipon na aktibidad. Habang ginagamit ng mga miyembro ang cafe (gumagastos ng pera, nagla-login, bumibili ng mga package, o naglalagay ng mga order) sila ay kumikita ng mga puntos ng katapatan. Kapag ang kanilang kabuuang puntos ay lumampas sa threshold ng isang antas, sila ay umaangat sa mas mataas na antas at nakakatanggap ng mas malaking diskwento sa pagpepresyo ng session.

Estruktura ng Antas

Ang bawat antas ng katapatan ay tinutukoy ng apat na field:

Field Paglalarawan
code Isang natatanging maikling code para sa antas (hal., silver, gold, vip). Ginagamit sa loob para sa pagkakakilanlan at sa mga tugon ng API.
name Isang madaling basahin na pangalan (hal., "Silver Member", "Gold Member"). Ipinapakita sa profile ng miyembro at sa lock screen ng kliyente.
threshold_points Ang minimum na bilang ng mga puntos ng katapatan na dapat maipon ng isang miyembro upang maging kwalipikado para sa antas na ito.
discount_bps Ang diskwento na inilalapat sa pagpepresyo ng session, na ipinapahayag sa mga basis point. Ang 100 BPS ay katumbas ng 1%. Ang halaga ng 500 ay nangangahulugang 5% diskwento.

Ang mga antas ay nakaayos ayon sa kanilang threshold_points na halaga. Ang isang miyembro ay kabilang sa pinakamataas na antas kung saan sila nakakatugon sa threshold ng puntos.

Diskwento sa Basis Point (BPS)

Ang mga diskwento ay ipinapahayag sa basis points (BPS) sa halip na porsyento upang maiwasan ang mga pagkakamali sa pag-ikot ng floating-point sa mga kalkulasyon sa pananalapi. Ang isang basis point ay katumbas ng 0.01%, o isang daang bahagi ng isang porsyento.

Karaniwang mga halaga ng diskwento:

Halaga ng BPS Porsyento Halimbawa sa 1000 unit/oras na rate
250 2.5% Ang miyembro ay nagbabayad ng 975 kada oras
500 5% Ang miyembro ay nagbabayad ng 950 kada oras
1000 10% Ang miyembro ay nagbabayad ng 900 kada oras
1500 15% Ang miyembro ay nagbabayad ng 850 kada oras
2000 20% Ang miyembro ay nagbabayad ng 800 kada oras

Kapag ang isang miyembro na may diskwento sa antas ay nagsimula ng session, binabawasan ng pricing engine ang base hourly rate ng discount_bps ng antas bago kalkulahin ang mga gastos sa segment.

Mga Kaganapan ng Katapatan

Ang mga miyembro ay kumikita ng mga puntos sa pamamagitan ng mga kaganapan ng katapatan. Ang bawat kaganapan ay nagtatala ng pagbabago ng puntos at ang aktibidad na nag-trigger nito:

Uri ng Kaganapan Paglalarawan Karaniwang Puntos
spend Ang miyembro ay nagbayad para sa isang session (postpaid o pagbabawas sa wallet). Ang mga puntos ay proporsyonal sa halagang ginastos. Nag-iiba ayon sa halagang ginastos
usage Ang miyembro ay gumamit ng PC o console para sa isang session, kahit na walang bayad. Ang mga puntos ay batay sa tagal ng paggamit. Nag-iiba ayon sa minutong ginamit
visit Ang miyembro ay nag-login mula sa isang client PC. Isang flat bonus para sa bawat pagbisita, na naghihikayat ng regular na pagdalo. Fixed kada bisita
topup Ang miyembro ay nagdagdag ng pondo sa kanilang wallet. Ang mga puntos ay sumasalamin sa halaga ng top-up. Nag-iiba ayon sa halaga ng top-up
order Ang miyembro ay naglagay ng order ng produkto (pagkain, inumin, atbp.). Ang mga puntos ay proporsyonal sa kabuuang order. Nag-iiba ayon sa kabuuang order
adjustment Isang manu-manong pag-aayos ng puntos na ginawa ng isang administrator. Ginagamit para sa mga pagwawasto, promosyon, o espesyal na gantimpala. Anumang halaga (positibo o negatibo)

Ang bawat tala ng kaganapan ng katapatan ay kinabibilangan ng:

  • points_delta: Ang bilang ng mga puntos na nakuha (positibo) o nawala (negatibo) mula sa kaganapang ito.
  • amount_minor: Ang halagang pinansyal na nauugnay sa kaganapan (sa minor currency units), kung naaangkop.
  • minutes_delta: Ang bilang ng mga minuto na nauugnay sa kaganapan, kung naaangkop.
  • source_entity / source_entity_id: Isang sanggunian pabalik sa session, order, o transaksyon na nag-generate ng kaganapan.
  • event_at: Ang timestamp kung kailan naganap ang kaganapan.

Pag-usad ng Antas

Ang pag-usad ng antas ay gumagana sa ganitong paraan:

  1. Ang isang miyembro ay nagsasagawa ng isang aktibidad (session, pagbili, pag-login, atbp.).
  2. Ang sistema ay lumilikha ng isang kaganapan ng katapatan na may kaukulang points_delta.
  3. Ang kabuuang puntos ng miyembro ay muling kinakalkula bilang kabuuan ng lahat ng kanilang points_delta na halaga ng kaganapan ng katapatan.
  4. Sinusuri ng sistema kung ang bagong kabuuan ay nakakatugon sa threshold para sa mas mataas na antas.
  5. Kung ang miyembro ay kwalipikado para sa bagong antas, ang kanilang tier na field ay ina-update at ang bagong diskwento ay magkakabisa sa kanilang susunod na session.

Ang pagtatalaga ng antas ay maaari ring itakda nang manu-mano ng isang administrator, na nag-o-override sa awtomatikong kalkulasyon.

Paano Nag-aaplay ang Mga Diskwento sa Antas sa Pagpepresyo ng Session

Kapag kinakalkula ng pricing engine ang halaga ng isang segment ng session para sa isang miyembro:

  1. Ang base hourly price ay tinutukoy ng aktibong pricing slot.
  2. Kung ang miyembro ay may antas na may discount_bps na halaga, ang base price ay nababawasan: discounted_price = base_price * (10000 - discount_bps) / 10000.
  3. Bukod pa rito, ang mga indibidwal na diskwento sa antas ng miyembro (member_discount_bps sa tala ng miyembro) ay inilalapat kung mayroon.
  4. Ang huling discounted rate ay ginagamit upang kalkulahin ang halaga ng segment.

Ang mga diskwento sa antas at mga diskwento sa antas ng miyembro ay maaaring pagsamahin, na nagbibigay sa miyembro ng pinagsamang benepisyo ng pareho.

Paglikha at Pamamahala ng Mga Antas

Upang lumikha ng bagong antas:

  1. Pumunta sa Settings at buksan ang seksyong Pricing (o ang dedikadong lugar ng pamamahala ng antas).
  2. I-click ang Add Tier.
  3. Ipasok ang code (natatangi, lowercase), name (display label), threshold points, at discount BPS.
  4. I-save ang antas.

Upang i-edit ang umiiral na antas, piliin ito mula sa listahan at baguhin ang alinman sa mga field nito. Ang mga pagbabago sa discount_bps ng isang antas ay magkakabisa sa lahat ng miyembro na kasalukuyang nakatalaga sa antas na iyon, simula sa kanilang susunod na session.

Upang tanggalin ang isang antas, alisin ito mula sa listahan. Ang mga miyembrong nakatalaga sa natanggal na antas ay babalik sa susunod na mas mababang antas kung saan sila kwalipikado batay sa kanilang mga puntos.

Halimbawa ng Setup ng Antas

Ang isang tipikal na tatlong antas na configuration ay maaaring ganito:

Code Name Threshold Points Discount BPS
bronze Bronze 0 0
silver Silver 500 500
gold Gold 2000 1000
vip VIP 5000 1500

Sa setup na ito, ang bagong miyembro ay nagsisimula sa Bronze (walang diskwento). Pagkatapos makaipon ng 500 puntos mula sa mga pagbisita, paggastos, at mga order, sila ay awtomatikong nag-a-upgrade sa Silver na may 5% diskwento. Sa 2000 puntos, sila ay umaabot sa Gold (10%) at sa 5000 puntos, sila ay nakakamit ng VIP status (15%).