Niveluri de fidelitate

Sistemul de niveluri de fidelitate recompensează clienții obișnuiți cu reduceri automate bazate pe activitatea lor acumulată. Pe măsură ce membrii folosesc cafe-ul (cheltuind bani, autentificându-se, achiziționând pachete sau plasând comenzi) câștigă puncte de fidelitate. Când totalul punctelor lor depășește pragul unui nivel, avansează la un nivel superior și primesc o reducere mai mare la tarificarea sesiunilor.

Structura nivelului

Fiecare nivel de fidelitate este definit prin patru câmpuri:

Câmp	Descriere
`code`	Un cod scurt unic pentru nivel (de exemplu, `silver`, `gold`, `vip`). Folosit intern pentru identificare și în răspunsurile API.
`name`	Un nume afișat lizibil (de exemplu, "Membru Silver", "Membru Gold"). Afișat în profilul membrului și pe ecranul de blocare al clientului.
`threshold_points`	Numărul minim de puncte de fidelitate pe care un membru trebuie să le acumuleze pentru a se califica pentru acest nivel.
`discount_bps`	Reducerea aplicată tarifării sesiunilor, exprimată în puncte de bază. 100 BPS echivalează cu 1%. O valoare de 500 înseamnă o reducere de 5%.

Nivelurile sunt ordonate după valoarea threshold_points. Un membru aparține celui mai înalt nivel pentru care îndeplinește pragul de puncte.

Reduceri în puncte de bază (BPS)

Reducerile sunt exprimate în puncte de bază (BPS) în loc de procente pentru a evita erorile de rotunjire în virgulă mobilă în calculele financiare. Un punct de bază echivalează cu 0,01%, sau o sutime de procent.

Valori comune de reducere:

Valoare BPS	Procent	Exemplu pe tarif 1000 unități/oră
250	2,5%	Membrul plătește 975 pe oră
500	5%	Membrul plătește 950 pe oră
1000	10%	Membrul plătește 900 pe oră
1500	15%	Membrul plătește 850 pe oră
2000	20%	Membrul plătește 800 pe oră

Când un membru cu reducere de nivel pornește o sesiune, motorul de tarificare reduce tariful orar de bază cu discount_bps al nivelului înainte de calculul costurilor de segment.

Evenimente de fidelitate

Membrii câștigă puncte prin evenimente de fidelitate. Fiecare eveniment înregistrează o schimbare de puncte și activitatea care l-a declanșat:

Tipul evenimentului	Descriere	Puncte tipice
`spend`	Membrul a plătit pentru o sesiune (postpaid sau deducere portofel). Punctele sunt proporționale cu suma cheltuită.	Variază în funcție de sumă
`usage`	Membrul a folosit un PC sau consolă pentru o sesiune, îndiferent de plată. Punctele sunt bazate pe durata utilizării.	Variază în funcție de minute
`visit`	Membrul s-a autentificat de pe un PC client. Un bonus fix pentru fiecare vizită, încurajând frecventarea regulată.	Fix per vizită
`topup`	Membrul a adăugat fonduri în portofel. Punctele reflectă suma alimentării.	Variază în funcție de sumă
`order`	Membrul a plasat o comandă de produse (mâncare, băuturi etc.). Punctele sunt proporționale cu totalul comenzii.	Variază în funcție de total
`adjustment`	O ajustare manuală de puncte făcută de un administrator. Folosită pentru corecții, promoții sau recompense speciale.	Orice valoare (pozitivă sau negativă)

Fiecare înregistrare de eveniment de fidelitate înclude:

points_delta: Numărul de puncte câștigate (pozitiv) sau pierdute (negativ) din acest eveniment.
amount_minor: Suma monetară asociată evenimentului (în unități minore de monedă), dacă este cazul.
minutes_delta: Numărul de minute asociat evenimentului, dacă este cazul.
source_entity / source_entity_id: O referință înapoi la sesiunea, comanda sau tranzacția care a generat evenimentul.
event_at: Marca temporală când a avut loc evenimentul.

Progresia nivelurilor

Progresia nivelurilor funcționează astfel:

Un membru efectuează o activitate (sesiune, achiziție, autentificare etc.).
Sistemul creează un eveniment de fidelitate cu points_delta corespunzător.
Totalul punctelor membrului este recalculat ca suma tuturor valorilor points_delta ale evenimentelor de fidelitate.
Sistemul verifică dacă noul total îndeplinește pragul pentru un nivel superior.
Dacă membrul se califică pentru un nivel nou, câmpul tier este actualizat iar noua reducere intră în vigoare la următoarea sesiune.

Atribuirea nivelului poate fi de asemenea setată manual de un administrator, suprascriind calculul automat.

Cum se aplică reducerile de nivel la tarificarea sesiunilor

Când motorul de tarificare calculează costul unui segment de sesiune pentru un membru:

Prețul orar de bază este determinat de intervalul de tarificare activ.
Dacă membrul are un nivel cu o valoare discount_bps, prețul de bază este redus: preț_redus = preț_bază * (10000 - discount_bps) / 10000.
Suplimentar, reducerile individuale la nivel de membru (member_discount_bps pe înregistrarea membrului) sunt aplicate dacă există.
Tariful final redus este folosit pentru calculul costului segmentului.

Reducerile de nivel și reducerile la nivel de membru se pot cumula, oferind membrului beneficiul combinat al ambelor.

Crearea și gestionarea nivelurilor

Pentru a crea un nivel nou:

Navigați la Setări și deschideți secțiunea Tarife (sau zona dedicată de gestionare a nivelurilor).
Dați clic pe Adaugă nivel.
Introduceți codul (unic, cu litere mici), numele (eticheta afișată), pragul de puncte și reducerea BPS.
Salvați nivelul.

Pentru a edita un nivel existent, selectați-l din listă și modificați oricare din câmpurile sale. Modificările la discount_bps al unui nivel iau efect pe toți membrii atribuiți în prezent acelui nivel, începând cu următoarea lor sesiune.

Pentru a șterge un nivel, eliminați-l din listă. Membrii care erau atribuiți nivelului șters vor reveni la următorul nivel inferior pentru care se califică pe baza punctelor lor.

Exemplu de configurare a nivelurilor

O configurare tipică cu trei niveluri ar putea arăta astfel:

Cod	Nume	Prag puncte	Reducere BPS
`bronze`	Bronz	0	0
`silver`	Silver	500	500
`gold`	Gold	2000	1000
`vip`	VIP	5000	1500

În această configurare, un membru nou începe la Bronz (fără reducere). După acumularea a 500 de puncte din vizite, cheltuieli și comenzi, avansează automat la Silver cu o reducere de 5%. La 2000 de puncte ajunge la Gold (10%) iar la 5000 de puncte obține statutul VIP (15%).