Operacje licencyjne administratora Cloud

Upoważnieni administratorzy platformy HandyCafe mogą zarządzać komercyjnym dostępem klienta na jego stronie szczegółów. Strona zaczyna się od przeglądu konta, statusu profilu, stanu połączenia na żywo oraz liczby licencji Genesis. Każda licencja Genesis ma jedną kartę operacji pokazującą jej bieżący plan, limity komputerów i konsol, saldo AI, saldo członka, dostęp do dodatków oraz stan Stripe.

Narzędzia dla wersji legacy i beta znajdują się w osobnej, rozwijanej sekcji. Aktywność ping oraz zmiany profilu są dostępne w sekcji diagnostyki i historii zmian. Dzięki temu bieżący proces Genesis pozostaje widoczny, a starsze narzędzia wsparcia nie znikają.

Podgląd wszystkich licencji Genesis

Otwórz Licencje w wewnętrznym panelu administracyjnym. Karta Genesis otwiera się domyślnie i wymienia wyłącznie bieżące plany Free oraz Genesis. Historyczne przydziały Beta pozostają na osobnej karcie Beta.

Karty podsumowania pokazują łączną liczbę licencji oraz liczbę licencji aktywnych, płatnych i bezpłatnych. Listę można przeszukiwać według kafejki, konta, adresu e-mail, planu lub klucza licencji. Administratorzy mogą też filtrować według typu planu albo statusu. Każdy wiersz pokazuje limity, dostęp do Cloud i Kafeterii, saldo AI, ważność oraz status. Wybierz Zarządzaj, aby otworzyć obszar roboczy klienta z operacjami dotyczącymi planu, usług, kredytów i rozliczeń.

Tworzenie pierwszej licencji Genesis

Gdy konto nie ma żadnej licencji Genesis, strona szczegółów klienta wyświetla formularz tworzenia licencji zamiast pustego wyniku. Wybierz aktywny plan Genesis oraz przyszłą datę wygaśnięcia. W oknie potwierdzenia sprawdź plan, datę wygaśnięcia i kraj. Wybierz Utwórz licencję, aby przypisać ją bezpośrednio do konta klienta.

Przed utworzeniem licencji konto musi mieć nazwę kafejki oraz kraj. Wybierz Edytuj profil, aby uzupełnić brakujące dane. Plan definiuje zarówno limit komputerów, jak i limit konsol. Wybrana data wygaśnięcia obowiązuje do końca tego dnia w czasie UTC.

Dostępne operacje

Przypisanie planu Genesis. Licencje tworzone ręcznie otrzymują limity i datę wygaśnięcia wybranego planu. Subskrypcje zarządzane przez Stripe podlegają zwykłym zasadom podwyższania i obniżania planu, łącznie z natychmiastowym obciążeniem albo zaplanowaną zmianą.
Zarządzanie usługami Cloud i Kafeteria. Uprawnienie do Cloud jest aktualizowane na licencji. Włączenie Kafeterii dodatkowo tworzy albo ponownie aktywuje odpowiedni tenant w handy.cafe, a wyłączenie zawiesza ten tenant. Obie usługi nigdy nie są synchronizowane w czasie trzymania blokady bazy danych.
Przyznanie kredytu AI. Sekcja operacji kredytowych pokazuje bieżące saldo AI wybranej licencji, zanim administrator wprowadzi doładowanie. Przyznanie kredytu dodaje przedpłacony kredyt w USD do portfela AI i zapisuje wpis audytu.
Przyznanie kredytu członkowi. Dodaje kredyt bonusowy do konta członka HandyCafe o tym samym adresie e-mail. Operacja jest niedostępna, gdy nie istnieje pasujący członek.
Zmiana następnej daty rozliczenia. W przypadku subskrypcji Stripe data jest aktualizowana w Stripe, a następnie synchronizowana z lokalną subskrypcją i licencją. Zaplanowaną zmianę planu trzeba najpierw anulować.
Zwrot płatności. Administrator wybiera obciążenie Stripe podlegające zwrotowi, wskazuje powód Stripe, wpisuje wymagane wyjaśnienie wewnętrzne i potwierdza zwrot. Zwrot nie anuluje subskrypcji ani nie odbiera dostępu do produktu.

Bezpieczeństwo i audyt

Każde działanie zmieniające dane wymaga potwierdzenia w panelu. Operacje backendu o dużym wpływie są ograniczone kluczem API administratora, weryfikują własność obciążeń Stripe i zapisują rekord w dzienniku audytu, do którego można wyłącznie dopisywać. Historia płatności jest ładowana tylko na żądanie i ograniczona do ostatnich obciążeń. Zwroty używają unikalnego klucza idempotencji, aby zapobiec przypadkowemu wysłaniu duplikatu.

Jeśli stara licencja nie ma już możliwego do odzyskania klucza w postaci jawnej, automatyczne udostępnienie Kafeterii jest przerywane w trybie bezpiecznym, a panel zgłasza, że administrator musi najpierw uporządkować dane uwierzytelniające licencji.

Prefiksy krajowe w kluczach licencji

Nowe klucze licencji powiązane z kontem używają dwuliterowego kodu kraju z uzupełnionego profilu klienta, na przykład GEN-TR-... dla licencji Genesis utworzonej przez administratora albo HC-TR-... dla licencji konta niezwiązanej z planem. Tworzenie przez administratora zatrzymuje się, gdy profil nie ma prawidłowego kraju. System nigdy nie tworzy nowego klucza GEN-XX-... ani HC-XX-....

Zmiana pola kraju na istniejącej licencji nie powoduje cichej rotacji jej aktywnego klucza. Administratorzy muszą uzgodnić korektę kraju z rotacją klucza, ponieważ zainstalowany serwer musi zalogować się ponownie po zmianie swoich danych uwierzytelniających.