Portfel członka
Portfel członka to system salda pieniężnego pozwalający członkom przedpłacić za usługi kafejki. Zamiast płacić gotówką za każdą sesję, członek może załadować środki do portfela, a system automatycznie potrąca z salda w miarę korzystania z komputerów, konsol lub zamawiania produktów.
Architektura oparta na środkach
Portfel używa systemu środków zamiast pojedynczego bieżącego salda. Za każdym razem gdy środki są dodawane do portfela członka, system tworzy nowy środek portfela. Każdy wpis środka jest indywidualnym rekordem z własnym saldem, źródłem, wygaśnięciem i ograniczeniem urządzeń. Zapewnia to:
- Pełną identyfikowalność skąd pochodzi każda jednostka salda.
- Niezależne daty wygaśnięcia per wpis środka.
- Ograniczenia specyficzne dla urządzeń (niektóre środki mogą być używalne tylko na komputerach, inne tylko na konsolach).
- Jasny podział między opłaconymi środkami a bonusami promocyjnymi.
Całkowite saldo portfela członka to suma wszystkich pozostałych wartości ze wszystkich aktywnych wpisów środków.
Typy środków
Każdy środek portfela ma typ środka identyfikujący sposób wejścia środków do systemu:
| Typ środka | Opis |
|---|---|
| Opłacony | Członek zapłacił za te środki (gotówka, karta lub inna metoda płatności). Tworzony przy zakupie pakietu pieniężnego kampanii. |
| Bonus | Środki promocyjne przyznane jako część zakupu pakietu. Na przykład "zapłać za 100 minut, otrzymaj bonus 20 minut w środkach". |
| Ręczny | Załadowany ręcznie przez kasjera lub administratora. Używany jako środki dobrej woli lub specjalne ustalenia. |
| Korekta | Korekta administracyjna naprawiająca błąd w saldzie członka. |
| Migracja | Środki zaimportowane z poprzedniego systemu podczas migracji danych. |
| Cofnięty zwrot | Środki przywrócone gdy wcześniej wydany zwrot jest cofany. |
Typ środka jest ustawiany przy tworzeniu i nie może być później zmieniony. Służy jako trwała ścieżka audytu.
Status środka
Każdy środek portfela przechodzi przez cykl życia śledzony statusem:
- Aktywny: Środek ma pozostałe środki i nie wygasł. Środki mogą być zużywane.
- Wygasły: Data wygaśnięcia środka minęła. Pozostałe środki nie są już używalne.
- Zużyty: Pozostałe saldo środka osiągnęło zero przez normalne zużycie.
- Anulowany: Środek został ręcznie anulowany przez administratora, unieważniając pozostałe saldo.
Zużycie portfela
Gdy portfel członka jest obciążany (za czas sesji, zamówienie lub inne zdarzenie rozliczeniowe), system tworzy rekord zużycia portfela łączący z konkretnym wpisem środka i rejestrujący dokładnie ile zostało potrącone.
Każdy rekord zużycia zawiera kontekst identyfikujący co wyzwoliło potrącenie:
| Kontekst | Opis |
|---|---|
| Użycie sesji | Środki zużyto na opłatę za czas sesji. System potrąca z portfela w miarę trwania sesji. |
| Płatność portfelem | Bezpośrednia płatność z portfela (np. gdy członek płaci za zamówienie produktowe saldem portfela). |
| Zamówienie | Środki zużyto na opłatę za zamówienie produktowe. |
| Zwrot | Ujemna korekta tworzona przy przetwarzaniu zwrotu, redukująca zużycie w celu zwrotu środków do wpisu środka. |
Log salda
Oprócz rekordów zużycia na poziomie środków system utrzymuje log salda członka rejestrujący każde zdarzenie zmieniające ogólne saldo portfela członka:
| Typ zdarzenia | Opis |
|---|---|
load |
Dodano środki do portfela (utworzono nowy wpis środka lub doładowano istniejący). |
spend |
Zużyto środki z portfela (płatność za sesję, płatność za zamówienie). |
refund |
Zwrócono środki do portfela (zwrot zamówienia, zwrot sesji). |
adjustment |
Dokonano zmiany administracyjnej salda (korekta, umorzenie). |
Każdy wpis logu salda rejestruje kwotę zmiany i wynikowe saldo, więc możesz odtworzyć saldo członka w dowolnym momencie czytając log chronologicznie.
Ograniczenie urządzeń
Każdy środek portfela ma ograniczenie urządzeń kontrolujące które typy urządzeń mogą z niego potraccac:
| Ograniczenie | Znaczenie |
|---|---|
| Klient | Używalny na komputerach klienckich. Używalny również na konsolach, chyba że środek jest jawnie ograniczony. |
| Konsola | Używalny na konsolach do gier. Używalny również na komputerach, chyba że jawnie ograniczony. |
| Tylko komputery | Używalny wyłącznie na komputerach klienckich. Sesje konsolowe nie mogą z niego potraccac. |
| Tylko konsole | Używalny wyłącznie na konsolach do gier. Sesje komputerowe nie mogą z niego potraccac. |
| Oba | Używalny na dowolnym typie urządzenia bez ograniczeń. To jest ustawienie domyślne. |
Gdy system musi potraccac z portfela członka, filtruje dostępne środki według ograniczenia urządzeń, aby zapewnić obciążanie tylko kwalifikujących się środków.
Jak działają doładowania
Środki portfela mogą być dodawane kilkoma sposobami:
Zakup pakietu kampanii: Gdy członek kupuje pakiet pieniężny z kampanii, system automatycznie tworzy środki portfela na podstawie definicji pakietu. Pojedynczy zakup pakietu może utworzyć wiele środków (jeden za część opłaconą, jeden za część bonusową).
Ręczne doładowanie: Kasjer może ręcznie dodać środki do portfela członka z panelu szczegółowego członka. Tworzy to wpis środka z typem "Ręczny".
Migracja: Podczas konfiguracji systemu istniejące salda z poprzedniego systemu mogą być importowane jako wpisy środków z typem "Migracja".
Jak portfel jest zużywany podczas sesji
Gdy członek z saldem portfela uruchamia sesję, system może automatycznie opłacać sesję z portfela:
- Silnik cenowy sesji oblicza koszt za minutę na podstawie aktywnego przedziału cenowego i stosowanych rabatów poziomowych.
- W miarę trwania sesji system okresowo potrąca skumulowany koszt z kwalifikujących się środków portfela członka.
- Środki są zużywane w kolejności daty wygaśnięcia (najwcześniej wygasające są używane najpierw) aby zminimalizować straty z wygasniec.
- Jeśli saldo portfela wyczerpie się przed zakończeniem sesji, pozostały koszt jest naliczany jako płatność gotówkowa przy zamknięciu sesji.
- Każde potrącenie tworzy rekord zużycia połączony z sesją jako wpis "Użycie sesji".