Portfel czlonka
Portfel czlonka to system salda pienieznego pozwalajacy czlonkom przedplacic za uslugi kafejki. Zamiast placic gotowka za kazda sesje, czlonek moze zaladowac srodki do portfela, a system automatycznie potraca z salda w miare korzystania z komputerow, konsol lub zamawiania produktow.
Architektura oparta na srodkach
Portfel uzywa systemu srodkow zamiast pojedynczego biezacego salda. Za kazdym razem gdy srodki sa dodawane do portfela czlonka, system tworzy nowy srodek portfela. Kazdy wpis srodka jest indywidualnym rekordem z wlasnym saldem, zrodlem, wygasnieciem i ograniczeniem urzadzen. Zapewnia to:
- Pelna identyfikowalnosc skad pochodzi kazda jednostka salda.
- Niezalezne daty wygasniecia per wpis srodka.
- Ograniczenia specyficzne dla urzadzen (niektore srodki moga byc uzywalne tylko na komputerach, inne tylko na konsolach).
- Jasny podzial miedzy oplaconymi srodkami a bonusami promocyjnymi.
Calkowite saldo portfela czlonka to suma wszystkich pozostalych wartosci ze wszystkich aktywnych wpisow srodkow.
Typy srodkow
Kazdy srodek portfela ma typ srodka identyfikujacy sposob wejscia srodkow do systemu:
| Typ srodka | Opis |
|---|---|
| Oplacony | Czlonek zaplacil za te srodki (gotowka, karta lub inna metoda platnosci). Tworzony przy zakupie pakietu pienieznego kampanii. |
| Bonus | Srodki promocyjne przyznane jako czesc zakupu pakietu. Na przyklad "zaplac za 100 minut, otrzymaj bonus 20 minut w srodkach". |
| Reczny | Zaladowany recznie przez kasjera lub administratora. Uzywany jako srodki dobrej woli lub specjalne ustalenia. |
| Korekta | Korekta administracyjna naprawiajaca blad w saldzie czlonka. |
| Migracja | Srodki zaimportowane z poprzedniego systemu podczas migracji danych. |
| Cofniety zwrot | Srodki przywrocone gdy wczesniej wydany zwrot jest cofany. |
Typ srodka jest ustawiany przy tworzeniu i nie moze byc pozniej zmieniony. Sluzy jako trwala sciezka audytu.
Status srodka
Kazdy srodek portfela przechodzi przez cykl zycia sledzony statusem:
- Aktywny: Srodek ma pozostale srodki i nie wygasl. Srodki moga byc zuzywane.
- Wygasly: Data wygasniecia srodka minela. Pozostale srodki nie sa juz uzywalne.
- Zuzyty: Pozostale saldo srodka osiagnelo zero przez normalne zuzycie.
- Anulowany: Srodek zostal recznie anulowany przez administratora, uniewazniajac pozostale saldo.
Zuzycie portfela
Gdy portfel czlonka jest obciazany (za czas sesji, zamowienie lub inne zdarzenie rozliczeniowe), system tworzy rekord zuzycia portfela laczacy z konkretnym wpisem srodka i rejestrujacy dokladnie ile zostalo potracone.
Kazdy rekord zuzycia zawiera kontekst identyfikujacy co wyzwolilo potracenie:
| Kontekst | Opis |
|---|---|
| Uzycie sesji | Srodki zuzyto na oplate za czas sesji. System potraca z portfela w miare trwania sesji. |
| Platnosc portfelem | Bezposrednia platnosc z portfela (np. gdy czlonek placi za zamowienie produktowe saldem portfela). |
| Zamowienie | Srodki zuzyto na oplate za zamowienie produktowe. |
| Zwrot | Ujemna korekta tworzona przy przetwarzaniu zwrotu, redukujaca zuzycie w celu zwrotu srodkow do wpisu srodka. |
Log salda
Oprocz rekordow zuzycia na poziomie srodkow system utrzymuje log salda czlonka rejestrujacy kazde zdarzenie zmieniajace ogolne saldo portfela czlonka:
| Typ zdarzenia | Opis |
|---|---|
load |
Dodano srodki do portfela (utworzono nowy wpis srodka lub doladowano istniejacy). |
spend |
Zuzyto srodki z portfela (platnosc za sesje, platnosc za zamowienie). |
refund |
Zwrocono srodki do portfela (zwrot zamowienia, zwrot sesji). |
adjustment |
Dokonano zmiany administracyjnej salda (korekta, umorzenie). |
Kazdy wpis logu salda rejestruje kwote zmiany i wynikowe saldo, wiec mozesz odtworzyc saldo czlonka w dowolnym momencie czytajac log chronologicznie.
Ograniczenie urzadzen
Kazdy srodek portfela ma ograniczenie urzadzen kontrolujace ktore typy urzadzen moga z niego potraccac:
| Ograniczenie | Znaczenie |
|---|---|
| Klient | Uzywalny na komputerach klienckich. Uzywalny rowniez na konsolach, chyba ze srodek jest jawnie ograniczony. |
| Konsola | Uzywalny na konsolach do gier. Uzywalny rowniez na komputerach, chyba ze jawnie ograniczony. |
| Tylko komputery | Uzywalny wylacznie na komputerach klienckich. Sesje konsolowe nie moga z niego potraccac. |
| Tylko konsole | Uzywalny wylacznie na konsolach do gier. Sesje komputerowe nie moga z niego potraccac. |
| Oba | Uzywalny na dowolnym typie urzadzenia bez ograniczen. To jest ustawienie domyslne. |
Gdy system musi potraccac z portfela czlonka, filtruje dostepne srodki wedlug ograniczenia urzadzen, aby zapewnic obciazanie tylko kwalifikujacych sie srodkow.
Jak dzialaja doladowania
Srodki portfela moga byc dodawane kilkoma sposobami:
Zakup pakietu kampanii: Gdy czlonek kupuje pakiet pieniezny z kampanii, system automatycznie tworzy srodki portfela na podstawie definicji pakietu. Pojedynczy zakup pakietu moze utworzyc wiele srodkow (jeden za czesc oplacona, jeden za czesc bonusowa).
Reczne doladowanie: Kasjer moze recznie dodac srodki do portfela czlonka z panelu szczegolowego czlonka. Tworzy to wpis srodka z typem "Reczny".
Migracja: Podczas konfiguracji systemu istniejace salda z poprzedniego systemu moga byc importowane jako wpisy srodkow z typem "Migracja".
Jak portfel jest zuzywany podczas sesji
Gdy czlonek z saldem portfela uruchamia sesje, system moze automatycznie oplacac sesje z portfela:
- Silnik cenowy sesji oblicza koszt za minute na podstawie aktywnego przedzialu cenowego i stosowanych rabatow poziomowych.
- W miare trwania sesji system okresowo potraca skumulowany koszt z kwalifikujacych sie srodkow portfela czlonka.
- Srodki sa zuzywane w kolejnosci daty wygasniecia (najwczesniej wygasajace sa uzywane najpierw) aby zminimalizowac straty z wygasniec.
- Jesli saldo portfela wyczerpie sie przed zakonczeniem sesji, pozostaly koszt jest naliczany jako platnosc gotowkowa przy zamknieciu sesji.
- Kazde potracenie tworzy rekord zuzycia polaczony z sesja jako wpis "Uzycie sesji".