HandyCafe Docs
owner cashier it-admin

Najczęściej Zadawane Pytania

Konfiguracja i Instalacja

Jakie rodzaje działalności obsługuje HandyCafe?

HandyCafe jest zaprojektowane dla kafejek internetowych, centrów gamingowych, aren esportowych, cyberkafejek i PC bangów. Każda firma oferująca czasowy dostęp do komputerów PC lub konsol do gier może używać HandyCafe do zarządzania sesjami, rozliczeniami i członkostwami.

Jakie są wymagania systemowe dla serwera HandyCafe?

Serwer wymaga systemu Windows 10 lub nowszego (64-bit), co najmniej 4 GB RAM, 500 MB miejsca na dysku i połączenia z siecią lokalną. Komputery klienckie potrzebują Windows 10 lub nowszego z 2 GB RAM. Wszystkie komputery muszą być w tej samej sieci LAN. Zobacz Wymagania Systemowe dla pełnych szczegółów.

Jak zainstalować serwer HandyCafe?

Pobierz instalator z oficjalnej strony, uruchom go i postępuj zgodnie z instrukcjami. Przy pierwszym uruchomieniu Kreator Pierwszej Konfiguracji utworzy Twoje konto administratora. Zobacz Instalacja Serwera dla instrukcji krok po kroku.

Jak podłączyć komputer kliencki do serwera?

Zainstaluj HandyCafe Client na komputerze. Używa mDNS do automatycznego wykrywania serwera w sieci lokalnej. Jeśli automatyczne wykrywanie zawiedzie, wprowadź ręcznie adres IP serwera w ustawieniach klienta. Zobacz Instalacja Klienta.

Dlaczego mój klient nie łączy się z serwerem?

Typowe przyczyny: serwer nie działa, komputery są w różnych podsieciach, firewall blokuje porty (TCP 5001, 5002, 5003 i UDP 5004) lub klucz połączenia nie pasuje. Zobacz Rozwiązywanie Problemów dla szczegółowych rozwiązań.

Jakie porty używa HandyCafe?

TCP 5001 (polecenia), TCP 5002 (transfer plików), TCP 5003 (zarządzanie zdalne), UDP 5004 (streaming ekranu). Można je skonfigurować w Ustawieniach Sieci.

Jak aktywować licencję?

Wprowadź klucz licencyjny w panelu licencji. Serwer weryfikuje go z serwerem licencyjnym. Do początkowej aktywacji wymagane jest aktywne połączenie z internetem. Zobacz Licencjonowanie.

Co się stanie, gdy mój serwer będzie offline przez ponad 72 godziny?

HandyCafe ma 72-godzinny okres łaski offline. W tym czasie wszystkie funkcje działają normalnie. Po 72 godzinach bez połączenia z serwerem licencyjnym, serwer przechodzi w stan zablokowany, dopóki nie zostanie przywrócony dostęp do internetu.


Sesje i Ceny

Jak rozpocząć sesję na komputerze?

W Panelu Administratora wybierz wolny komputer (cyjan) i kliknij Start na karcie. Wybierz tryb postpaid lub prepaid, opcjonalnie przypisz członka, ustaw czas/kwotę jeśli prepaid, wybierz metodę płatności i potwierdź. Zobacz Sesje.

Jaka jest różnica między sesjami prepaid a postpaid?

W trybie postpaid klient płaci na końcu na podstawie rzeczywistego czasu użytkowania. W trybie prepaid klient płaci z góry za określony czas lub kwotę. Prepaid obsługuje dwa podtryby: Zablokuj przy Zakupie (koszt zamrożony na początku) i Harmonogram na Żywo (koszt dostosowuje się do zmian w przedziale czasowym). Zobacz Sesje.

Jak działa harmonogram cenowy?

Harmonogram cenowy to siatka 7-dniowa po 24 godziny, gdzie każdy blok czasowy jest przypisany do kolorowego przedziału cenowego. Każdy przedział ma mnożnik (np. 1.0x standardowy, 1.5x szczytowy, 0.5x poza szczytem). Koszt sesji oblicza się jako: podstawowa stawka godzinowa pomnożona przez mnożnik przedziału i czas trwania. Zobacz Ceny Sesji.

Jak ustawić różne ceny na weekendy i dni powszednie?

W Ustawieniach > Harmonogram Cenowy, utwórz przedziały cenowe z różnymi mnożnikami (np. "Dzień Powszedni" na 1.0x, "Weekend" na 1.3x). Pomaluj kolumny weekendowe kolorem przedziału Weekend i kolumny dni powszednich kolorem przedziału Dzień Powszedni. Zobacz Ustawienia Harmonogramu Cenowego.

Jak wstrzymać i wznowić sesję?

Kliknij Wstrzymaj na karcie online komputera. Rozliczanie zatrzymuje się podczas wstrzymania. Aby wznowić, kliknij Wznów na karcie wstrzymanego komputera. Nowy segment cenowy zaczyna się po wznowieniu. Zobacz Sesje.

Jak dodać dodatkowy czas do aktywnej sesji?

Kliknij Dodaj Czas na karcie online komputera. Wprowadź liczbę minut do dodania (dodatnie, aby przedłużyć, ujemne, aby skrócić). Tworzony jest zapis transakcji dla tej korekty.

Co się dzieje, gdy sesja obejmuje wiele przedziałów cenowych?

Sesja jest automatycznie dzielona na segmenty na granicach przedziałów. Każdy segment używa mnożnika aktywnego w tym okresie. Całkowity koszt to suma kosztów wszystkich segmentów. Zobacz Ceny Sesji.

Co to jest opłata startowa?

Opłata startowa to minimalna opłata naliczana za każdą sesję. Nawet jeśli sesja jest bardzo krótka, klient jest obciążany co najmniej tą kwotą. Skonfiguruj ją w Ustawieniach Cenowych.


Członkowie i Lojalność

Jak utworzyć nowego członka?

Przejdź do strony Członkowie i kliknij Dodaj Członka. Wprowadź nazwę użytkownika, nazwę wyświetlaną, opcjonalny email, telefon i inne szczegóły. Przypisz poziom, jeśli dotyczy. Zobacz Członkowie.

Jak działa system portfela?

Każdy członek ma saldo portfela. Kiedy doładujesz portfel, tworzony jest kredyt portfelowy z określoną kwotą i typem kredytu (płatny, bonusowy, ręczny, itp.). Podczas sesji portfel jest automatycznie zużywany. Kredyty mogą mieć daty ważności i ograniczenia urządzeń. Zobacz Portfel Członka.

Co to jest kredyt portfelowy?

Kredyt portfelowy to oddzielny wpis salda portfela utworzony przez pojedyncze doładowanie. Każdy kredyt śledzi swoją kwotę, typ kredytu (płatny, bonusowy, ręczny), status (aktywny, wygasły, zużyty) i ograniczenie urządzenia. Kredyty są zużywane w kolejności (najstarsze pierwsze). Zobacz Portfel Członka.

Jak działają poziomy lojalności i punkty?

Członkowie zdobywają punkty poprzez aktywności (wydatki, wizyty, doładowania, zamówienia). Każdy poziom ma próg punktowy. Gdy członek zgromadzi wystarczającą liczbę punktów, awansuje na wyższy poziom. Wyższe poziomy mogą mieć lepsze stawki rabatowe. Zobacz Poziomy Lojalności.

Jak doładować portfel członka?

Wybierz członka na stronie Członkowie, kliknij opcję płatności/doładowania, wprowadź kwotę, wybierz typ kredytu i metodę płatności, i potwierdź. Tworzony jest nowy kredyt portfelowy. Zobacz Portfel Członka.

Czy członek może używać salda portfela zarówno na PC, jak i konsole?

To zależy od ograniczenia urządzenia kredytu. Kredyty mogą być ograniczone do "tylko PC", "tylko konsole" lub "oba". Przy zakupie pakietu ograniczenie urządzenia jest definiowane przez konfigurację pakietu. Zobacz Pakiety.

Co się dzieje, gdy kredyt portfelowy wygasa?

Gdy kredyt osiągnie datę wygaśnięcia, jego status zmienia się na "wygasły" i pozostałe saldo nie jest już dostępne do użycia. Wygasła kwota jest rejestrowana w historii transakcji członka.

Jak zobaczyć historię transakcji członka?

Wybierz członka na stronie Członkowie. Panel szczegółów członka pokazuje rejestr transakcji ze wszystkimi doładowaniami portfela, wydatkami, zwrotami i korektami z czasem i kwotami.


Produkty, Zamówienia i Inwentarz

Jak dodać produkt do katalogu?

Przejdź do Produktów i kliknij Dodaj Produkt. Wprowadź nazwę, kategorię, jednostkę, kod kreskowy, cenę sprzedaży, cenę kosztu i stawkę VAT. Przełącz aktywne/nieaktywne. Zobacz Produkty.

Jak utworzyć zamówienie dla klienta?

Przejdź do Zamówień, kliknij Nowe Zamówienie, opcjonalnie przypisz do PC lub dodaj notatkę, dodaj pozycje z katalogu produktów z ilościami, a następnie zamknij zamówienie wybierając metodę płatności. Zobacz Zamówienia.

Jak anulować lub zwrócić zamówienie?

Otwórz zamówienie na stronie Zamówienia i kliknij Anuluj. Zamówienie zostaje unieważnione i nie jest rejestrowana żadna płatność. W przypadku zwrotów zamkniętych zamówień, użyj odpowiedniego procesu zwrotu.

Jak działa śledzenie zapasów?

Każdy produkt ma poziom zapasów. Dziennik zapasów śledzi zmiany z powodami: sprzedaż (automatycznie zmniejszane przy zamknięciu zamówienia), zakup (z wpisów inwentarzowych), korekta, strata i zwrot. Zobacz Produkty i Inwentarz.


Kampanie i Pakiety

Jak utworzyć kampanię?

Przejdź do Kampanii i kliknij Dodaj Kampanię. Wprowadź nazwę, opis, ustaw jako aktywną i skonfiguruj datę wygaśnięcia, jeśli dotyczy. Następnie dodaj pakiety do kampanii. Zobacz Kampanie.

Jaka jest różnica między pakietami minutowymi a pieniężnymi?

Pakiety minutowe dają członkowi czas (minuty), który można wykorzystać na sesje. Pakiety pieniężne dodają środki do portfela członka. Oba mogą zawierać kwoty bonusowe. Zobacz Pakiety.

Jak działa system bonusów w pakietach?

Pakiet może zawierać bonus ponad podstawowe uprawnienia. Na przykład, pakiet może oferować "60 minut + 15 minut bonusowych" lub "10 USD + 2 USD bonusu". Bonus tworzy oddzielny wpis kredytowy oznaczony typem kredytu "Bonus".

Jak działają ograniczenia urządzeń w pakietach?

Każdy pakiet definiuje ograniczenie urządzenia: klient (PC), konsola (konsole), oba, tylko PC lub tylko konsole. Gdy pakiet jest kupowany, utworzone kredyty portfelowe/czasowe dziedziczą to ograniczenie i mogą być używane tylko na pasujących typach urządzeń.


Zarządzanie Kasjerami

Jak utworzyć konto kasjera?

Przejdź do Zarządzanie > Kasjerzy. Kliknij Dodaj Kasjera, wprowadź nazwę użytkownika i hasło, i przypisz rolę. Kasjer może się następnie zalogować za pomocą tych danych. Zobacz Role Kasjerów.

Jak ustawić uprawnienia dla roli kasjera?

Przejdź do Zarządzanie > Role Kasjerów. Utwórz nową rolę lub edytuj istniejącą. Zaznacz lub odznacz poszczególne flagi uprawnień w każdej z 6 kategorii (Uwierzytelnianie, Członkowie, Konsole, Dzienniki, Raporty, Metody Płatności). Zobacz Role Kasjerów.

Jakie są 6 kategorii uprawnień?

Uwierzytelnianie (1 flaga), Członkowie (6 flag: widok, dodaj, usuń, aktualizuj, pokaż email, pokaż telefon), Konsole (4 flagi: widok, dodaj, usuń, aktualizuj), Dzienniki (4 flagi: widok, pełna historia, tylko dzisiaj, usuń), Raporty (3 flagi: widok, pełna historia, tylko dzisiaj), Metody Płatności (4 flagi: zarządzaj, dodaj, usuń, aktualizuj). Łącznie: 22 indywidualne flagi uprawnień.

Jak działa ochrona przed atakami brute-force przy logowaniu kasjera?

Po 5 nieudanych próbach logowania w ciągu 10 minut, konto jest blokowane na 15 minut. Wszystkie nieudane próby są rejestrowane w dzienniku audytu z alertem bezpieczeństwa.

Jak wyświetlić raporty zmian kasjera?

Otwórz stronę Raport Kasowy. Filtruj według nazwiska kasjera, aby zobaczyć transakcje przetworzone przez konkretnego kasjera podczas jego zmiany. Podsumowanie zmiany pokazuje sumy i podział według metody płatności.


Ustawienia i Konfiguracja

Jak zmienić język?

Przejdź do Ustawienia > Ogólne i wybierz swój język z listy rozwijanej. HandyCafe obsługuje 24 języki. Interfejs aktualizuje się natychmiast. Zobacz Ustawienia Ogólne.

Jak skonfigurować logowanie przez Google OAuth?

Przejdź do Ustawienia > OAuth. Włącz OAuth globalnie, a następnie włącz Google. Wprowadź swój Google Client ID i Client Secret (z Google Cloud Console). Opcjonalnie zaimportuj plik JSON z danymi uwierzytelniającymi. Przetestuj, inicjując logowanie OAuth z komputera klienckiego. Zobacz Ustawienia OAuth.

Jak skonfigurować siatkę harmonogramu cenowego?

Przejdź do Ustawienia > Harmonogram Cenowy. Włącz harmonogram, utwórz kolorowe przedziały z mnożnikami, a następnie kliknij/przeciągnij na siatce 7x24 godziny, aby pomalować bloki czasowe wybranym przedziałem. Zobacz Ustawienia Harmonogramu Cenowego.

Jak dostosować ekran bezczynności klienta?

Przejdź do Ustawienia > Klienci > zakładka Ekran Bezczynności. Włącz pokaz slajdów, dodaj obrazy lub filmy, ustaw czas trwania i przejścia. Opcjonalnie włącz nakładki zegara i nazwy kafejki. Zobacz Ekran Bezczynności Klienta.

Jak zmienić motyw wyglądu klienta?

Przejdź do Ustawienia > Klienci > zakładka Wygląd. Wybierz motyw (Neon Arena, Crimson Pulse, Emerald Depth), wybierz preset układu i skonfiguruj tło, gęstość kart i efekty. Zobacz Wygląd Klienta.

Jak skonfigurować powiadomienia dźwiękowe?

Przejdź do Ustawienia > Dźwięki. Włącz główny przełącznik dźwięków, a następnie wybierz dźwięk dla każdego zdarzenia (Wezwanie Kasjera, Nowe Zamówienie, Koniec Sesji, Żądanie Logowania) z 15 wbudowanych opcji. Zobacz Ustawienia Dźwięków.

Co to jest klucz połączenia i dlaczego jest ważny?

Klucz połączenia to wspólny sekret używany do kryptograficznego uwierzytelniania między serwerem a klientami. Zapobiega on nieautoryzowanemu podłączaniu urządzeń do Twojego serwera. Wszyscy klienci muszą używać tego samego klucza co serwer. Skonfiguruj go w Ustawieniach Sieci.


Zarządzanie Zdalne

Jak zrobić zdalny zrzut ekranu z komputera klienckiego?

Wybierz klienta w Panelu Administratora i kliknij Zrzut Ekranu na karcie. Przeglądarka zrzutów wyświetla uchwycony obraz. Możesz odświeżyć, aby uzyskać nowy zrzut lub pobrać obraz. Zobacz Zrzuty Ekranu.

Jak używać pulpitu zdalnego do kontrolowania komputera klienckiego?

Wybierz kartę klienta i kliknij Pulpit Zdalny. Otwiera się okno z transmisją wideo H.264 na żywo. Możesz zdalnie kontrolować mysz i klawiaturę, a synchronizacja schowka działa między serwerem a klientem. Zobacz Pulpit Zdalny.

Jak działa system synchronizacji plików?

Skonfiguruj katalogi do synchronizacji w Ustawienia > Eksplorator Synchronizacji. Po uruchomieniu serwer tworzy manifest plików. Klienci porównują manifest z lokalnymi plikami i pobierają tylko zmienione lub nowe pliki, używając transferu opartego na fragmentach. Zobacz Synchronizacja Plików.

Jak zobaczyć, jakie aplikacje są uruchomione na komputerze klienckim?

Wybierz klienta w Panelu Administratora i kliknij Uruchomione Aplikacje na karcie. Panel pokazuje wszystkie aktualnie uruchomione procesy z nazwami i szczegółami. Możesz także zobaczyć Aplikacje Startowe, Zainstalowane Aplikacje i Aplikacje Okienkowe z tych samych przycisków akcji.

Jak wysłać wiadomość do komputera klienckiego?

Wybierz kartę klienta i kliknij Wyślij Wiadomość. Wpisz swoją wiadomość i potwierdź. Wiadomość pojawia się na ekranie klienta.

Jak zdalnie wyłączyć lub zrestartować komputer kliencki?

Wybierz kartę klienta i kliknij Wyłącz lub Restartuj. Możesz także wybrać wiele klientów do operacji zbiorczych. Wake on LAN jest dostępne do włączania offline komputerów, które to obsługują.


Raporty i Analizy

Jak wyświetlić raport kasowy?

Przejdź do Raportu Kasowego z paska bocznego. Raport pokazuje karty podsumowujące, historię transakcji, zarobki urządzeń i wykresy. Użyj filtrów dat, aby zawęzić zakres czasowy. Zobacz Raport Kasowy.

Jak eksportować dane raportu?

W Raporcie Kasowym użyj funkcji eksportu/kopiowania, aby skopiować dane transakcji do schowka w formacie CSV. Następnie możesz wkleić je do Excela lub dowolnej aplikacji arkusza kalkulacyjnego.

Jakie analizy są dostępne na stronie Statystyki?

Dziewięć zakładek analitycznych: Trendy przychodów, Analiza sprzedaży, Śledzenie wydatków, Statystyki sesji, Wykorzystanie konsol, Użycie aplikacji, Wskaźniki użycia komputerów, Aktywność członków i Wydajność kasjerów. Zobacz Statystyki.

Jak sprawdzić wskaźniki użycia komputerów?

Przejdź do Statystyki > zakładka Użycie Komputerów. Pokazuje to procenty wykorzystania na komputer, czas pracy i przychody na maszynę. Identyfikuje również Twoje najbardziej zajęte komputery. Zobacz Statystyki Sesji i Komputerów.


Rozwiązywanie Problemów

Klient pokazuje "offline", ale komputer jest włączony. Co robić?

Sprawdź, czy: 1) HandyCafe Client działa na komputerze, 2) Oba komputery są w tej samej sieci/podsieci, 3) Firewall pozwala na porty TCP 5001-5003, 4) Klucz połączenia pasuje między serwerem a klientem. Zobacz Rozwiązywanie Problemów.

Ceny sesji wydają się nieprawidłowe. Jak to zweryfikować?

Sprawdź ustawienia cenowe (Ustawienia > Ceny) dla podstawowej stawki godzinowej i VAT. Sprawdź harmonogram cenowy (Ustawienia > Harmonogram Cenowy) dla aktywnych mnożników w czasie sesji. Przejrzyj segmenty cenowe sesji w szczegółach transakcji, aby zobaczyć, jak każdy segment został obliczony.

Logowanie OAuth utknęło na "oczekujące". Jak to rozwiązać?

Upewnij się, że administrator zatwierdził żądanie na stronie Żądania. Jeśli żądanie utknęło, sprawdź: 1) Dane uwierzytelniające dostawcy OAuth są poprawne w Ustawieniach > OAuth, 2) Serwer ma dostęp do internetu, aby dotrzeć do API dostawcy, 3) Kod urządzenia nie wygasł (zwykle wygasają w 15-30 minut).

Pulpit zdalny jest opóźniony. Jak poprawić wydajność?

Obniż bitrate w ustawieniach strumienia (spróbuj 1000-2000 kbps dla LAN). Sprawdź przepustowość sieci między serwerem a klientem. Upewnij się, że port UDP 5004 nie jest zablokowany. Używaj przewodowego Ethernetu zamiast WiFi dla najlepszych wyników.

Moja licencja pokazuje "over_limit". Co to znaczy?

Podłączono więcej komputerów klienckich niż pozwala na to Twoja licencja. Odłącz nieużywane komputery lub zaktualizuj swoją licencję. Serwer nie uruchomi nowych sesji, dopóki liczba podłączonych klientów nie będzie równa lub mniejsza od limitu.

Kasjer jest zablokowany po zbyt wielu nieudanych próbach logowania. Jak odblokować?

Poczekaj 15 minut, aż automatyczna blokada wygaśnie. Jeśli to pilne, administrator może zarządzać kontem kasjera przez interfejs zarządzania.


Kafeteria

Jak klienci składają zamówienia z ich stolika?

Skanują kod QR na stoliku swoim telefonem, wprowadzają 6-cyfrowy kod bezpieczeństwa podany przez personel, przeglądają menu w swoim języku, dodają pozycje do koszyka i składają zamówienie z płatnością gotówką lub online (Stripe). Zamówienia pojawiają się na Twoim pulpicie zamówień Kafeterii w ciągu 3 sekund. Zobacz Menu Klienta.

Jak włączyć moduł Kafeteria?

Otwórz Ustawienia > Kafeteria i przełącz Włącz Kafeterię. Serwer używa Twojej licencji HandyCafe jako autoryzacji automatycznie. Kreator konfiguracji prosi o Twój slug, nazwę wyświetlaną, kraj, walutę i strefę czasową. Zobacz Przegląd Kafeterii i Jak Skonfigurować Kafeterię.

Jakie języki obsługuje menu klienta?

Menu klienta na handy.cafe/{slug} obsługuje 24 języki. Pierwsza wizyta wybiera najlepsze dopasowanie z nagłówka Accept-Language przeglądarki. Klienci mogą zmieniać języki w dowolnym momencie za pomocą selektora na górze.

Czy Kafeteria działa bez internetu?

Nie. Kafeteria jest zorientowana na chmurę. Provisioning, synchronizacja menu i odpytywanie zamówień wymagają dostępu do internetu. Strony skierowane do klientów są serwowane przez chmurę i nie polegają na tym, że Twój lokalny serwer jest osiągalny z internetu.


Klienci Legacy

Czy HandyCafe obsługuje moje stare klientów V3 lub V4?

Tak. Włącz wsparcie w czasie rzeczywistym w Ustawieniach > Klienci Legacy, a serwer uruchomi nasłuch na oryginalnych portach legacy (UDP 710/711, TCP 712, transfer plików 717). Twoi istniejący klienci łączą się bez żadnych zmian po ich stronie. Pojawiają się w Panelu Administratora z ograniczonym zestawem akcji (Login, Logout, Dodaj Czas, Zrzut Ekranu, Wyloguj, Restartuj, Wyłącz). Zobacz Klienci Legacy.

Czy klienci legacy i nowocześni mogą działać na tym samym serwerze jednocześnie?

Tak. Dwa stosy protokołów używają różnych portów i nie kolidują ze sobą. Możesz mieszać starych i nowych klientów w tej samej sieci LAN i zarządzać nimi z tego samego Panelu Administratora.

Czy mogę przenieść moje dane z starszej instalacji HandyCafe?

Tak, na Windows. Otwórz Ustawienia > Klienci Legacy, przewiń do Migracji Bazy Danych i kliknij Rozpocznij Migrację. Członkowie, ceny, produkty, zamówienia, transakcje i dzienniki są importowane. Oryginalne pliki nie są modyfikowane ani usuwane. Jeśli wynik nie jest taki, jakiego oczekiwałeś, kliknij Cofnij Migrację, aby przywrócić. Zobacz Jak Migrować z Starszej Instalacji.

Jaka jest różnica między wariantami protokołu STE a Standard?

Ramki STE (Smart/Turbo Edition) zawierają prefiks informacji licencyjnych o długości 70 bajtów; rozmiar ramki to 1337 bajtów. Standardowe ramki pomijają prefiks; rozmiar ramki to 1267 bajtów. Wybierz wariant, który odpowiada temu, jak zbudowany był Twój serwer legacy. Wybranie niewłaściwego wariantu powoduje utratę lub błędne odczytanie ramek.