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 potrącać:
| 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 potrącać. |
| Tylko konsole | Używalny wyłącznie na konsolach do gier. Sesje komputerowe nie mogą z niego potrącać. |
| Oba | Używalny na dowolnym typie urządzenia bez ograniczeń. To jest ustawienie domyślne. |
Gdy system musi potrącać z portfela członka, filtruje dostępne środki według ograniczenia urządzeń, aby zapewnić obciążanie tylko kwalifikujących się środków.
Kategoria portfela i wydawanie międzykategoryjne
Środki portfela mogą być oznaczone kategorią portfela (na przykład "gaming" albo "ogólna"). Pozwala to kafejce tworzyć odizolowane pule salda, które można wydać tylko w określonych kontekstach.
Opcja wydawania międzykategoryjnego przy każdym środku decyduje o tym, czy jego fundusze mogą być użyte poza wyznaczoną kategorią:
- Gdy jest wyłączona (domyślnie), środek może być zużyty wyłącznie we własnej kategorii.
- Gdy jest włączona, środek może być zużyty także przez transakcje w innych kategoriach.
Jeśli środek nie ma przypisanej kategorii portfela, jest traktowany jako środek ogólnego przeznaczenia i może być zużyty przez dowolną transakcję, niezależnie od kategorii.
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 wygaśnięć.
- 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".
Jak portfel jest zużywany przy zamówieniach
Gdy członek zamawia produkty ze swojego komputera klienckiego, portfel nie jest ruszany w chwili złożenia zamówienia. Zamówienie powstaje w stanie Otwarte i czeka na kasjera. Saldo opłacone jest obciążane dopiero wtedy, gdy kasjer potwierdzi wydanie akcją Oznacz jako Dostarczone:
- Złożenie zamówienia nigdy nie zmniejsza salda członka. Zamówienie odrzucone albo anulowane pozostawia portfel nietknięty.
- Gdy kasjer oznaczy zamówienie jako dostarczone, system obciąża sumą zamówienia opłacone środki portfela członka. Środki bonusowe i promocyjne pozostają nietknięte. Te fundusze są zarezerwowane na sesje i czas.
- Środki opłacone są zużywane w kolejności daty wygaśnięcia (najwcześniej wygasające jako pierwsze), tak samo jak przy użyciu sesyjnym.
- Obciążenie działa najlepszym staraniem. Jeśli opłacone saldo członka nie pokrywa całej sumy zamówienia, system pobiera to, co jest dostępne, a reszta pozostaje na otwartym rachunku do pobrania przez kasjera przy zamknięciu sesji.
- Potrącenie jest zapisywane raz na zamówienie. Ponowne naciśnięcie Oznacz jako Dostarczone albo usunięcie i ponowne oznaczenie dostawy nigdy nie obciąża portfela dwukrotnie.
- Każde potrącenie tworzy rekord zużycia powiązany z zamówieniem, dzięki czemu wydatek pojawia się w logu salda członka oraz w raportach.