HandyCafe Docs
owner cashier it-admin

Rozwiązywanie problemów

Ta strona zawiera rozwiązania typowych problemów zorganizowane wg kategorii.

Problemy z połączeniem

Klient nie może znaleźć serwera

Objawy: Klient wyświetla "Szukanie serwera" lub "Nie znaleziono serwera".

Rozwiązania:

  1. Sprawdź czy HandyCafe Server jest uruchomiony na komputerze zarządzania.
  2. Potwierdź że oba komputery są w tej samej podsieci (np. oba na 192.168.1.x).
  3. Sprawdź czy mDNS nie jest blokowany przez switch lub router sieciowy.
  4. Spróbuj połączenia ręcznego: wpisz adres IP serwera bezpośrednio w ustawieniach klienta.
  5. Sprawdź czy żadne inne oprogramowanie nie używa portu TCP serwera (domyślnie: 5001).

Klient łączy się i natychmiast rozłącza

Objawy: Klient chwilowo wyświetla "Połączono", a następnie wraca do "Szukanie".

Rozwiązania:

  1. Sprawdź czy klucz połączenia jest zgodny na serwerze i kliencie. Klucz ustawia się w Ustawieniach > Sieć na serwerze.
  2. Sprawdź niestabilność sieci (utrata pakietów, problemy z kablami).
  3. Upewnij się, że serwer nie osiągnął limitu komputerów licencji.
  4. Przejrzyj logi serwera pod kątem komunikatów o niepowodzeniu uwierzytelniania.

Klient pokazuje "Offline" na serwerze, ale komputer działa

Objawy: Komputer kliencki jest włączony i aplikacja kliencka działa, ale serwer wyświetla go jako offline.

Rozwiązania:

  1. Na komputerze klienckim sprawdź czy HandyCafe Client faktycznie działa (sprawdź zasobnik systemowy).
  2. Sprawdź połączenie sieciowe na komputerze klienckim (czy może pingować serwer?).
  3. Zweryfikuj reguły zapory: porty TCP 5001-5003 muszą być otwarte na serwerze i kliencie.
  4. Zrestartuj HandyCafe Client na dotkniętym komputerze.
  5. Jeśli używasz VLAN-ów, upewnij się, że VLAN-y serwera i klienta mogą się komunikować.

Nie można się połączyć po zmianie ustawień sieciowych

Objawy: Po zmianie portów lub klucza połączenia klienty nie mogą się połączyć.

Rozwiązania:

  1. Upewnij się, że klienty są zaktualizowane z nowymi numerami portów i kluczem połączenia.
  2. Zrestartuj HandyCafe Server po zmianie ustawień sieciowych.
  3. Zaktualizuj reguły zapory aby dopuścić nowe porty.
  4. Wszyscy klienty muszą być przekonfigurowani z nowymi wartościami.

Problemy z sesjami

Nie można rozpocząć sesji na kliencie

Objawy: Przycisk Start jest nieaktywny lub akcja startu kończy się błędem.

Rozwiązania:

  1. Sprawdź status licencji. W trybie tylko do odczytu nowe sesje nie mogą się rozpocząć.
  2. Sprawdź czy status klienta to "Bezczynny". Sesje mogą być rozpoczynane tylko na bezczynnych klientach.
  3. Sprawdź uprawnienia kasjera. Rola musi mieć uprawnienie AUTH_CLIENT_LOGIN.
  4. Upewnij się, że wycena jest skonfigurowana (Ustawienia > Wycena musi mieć prawidłową stawkę godzinową).

Timer sesji pokazuje nieprawidłowy czas

Objawy: Wyświetlany czas nie odpowiada faktycznie upłyniętemu czasowi.

Rozwiązania:

  1. Sprawdź zegary systemowe na komputerze serwera i klienta. Powinny być zsynchronizowane (użyj NTP).
  2. Jeśli sesja była wstrzymana, czas wstrzymania nie jest liczony.
  3. Dla sesji przedpłaconych timer pokazuje pozostały czas, nie czas upłynięty.

Koszt sesji wydaje się nieprawidłowy

Objawy: Naliczona kwota nie odpowiada oczekiwaniom.

Rozwiązania:

  1. Sprawdź harmonogram cenowy. Jeśli jest włączony, sesja mogła przechodzić przez wiele slotów cenowych z różnymi mnożnikami.
  2. Przejrzyj ustawienia wyceny: bazową stawkę godzinową, VAT, opłatę startową, zaokrąglanie.
  3. Sprawdź segmenty cenowe sesji w szczegółach transakcji.
  4. Zweryfikuj prowizję i stałe opłaty metody płatności.
  5. Dla sesji przedpłaconych sprawdź czy aktywny jest tryb "Zablokuj przy zakupie" czy "Harmonogram na żywo".

Wstrzymana sesja nie może być wznowiona

Objawy: Akcja wznowienia nie powiedzie się lub nie jest dostępna.

Rozwiązania:

  1. Sprawdź czy komputer kliencki jest nadal podłączony do serwera.
  2. Sprawdź czy status klienta pokazuje "Wstrzymana" (pomarańczowy).
  3. Jeśli klient rozłączył się podczas pauzy, może wymagać ponownego połączenia.

Problemy z płatnościami

Metoda płatności nie pojawia się w rozwijanym menu

Objawy: Oczekiwana metoda płatności nie pojawia się podczas zamykania sesji lub zamówienia.

Rozwiązania:

  1. Sprawdź czy metoda płatności istnieje w Zarządzanie > Metody płatności.
  2. Sprawdź czy metoda płatności jest aktywna (nie usunięta ani wyłączona).
  3. Sprawdź uprawnienia kasjera. Uprawnienie PAYMENT_MANAGE musi być przyznane aby widzieć wszystkie metody.

Obliczenie prowizji wydaje się nieprawidłowe

Objawy: Potrącona prowizja nie odpowiada oczekiwanej stawce.

Rozwiązania:

  1. Zweryfikuj stawkę prowizji metody płatności (jako procent) i opłatę stałą.
  2. Wzór prowizji: prowizja = (kwota obciążenia * stawka prowizji / 100) + opłata stała.
  3. Sprawdź czy kasjer zastosował ręczne nadpisanie kwoty obciążenia.

Problemy z wyświetlaniem klienta

Ekran bezczynności klienta jest pusty

Objawy: Ekran bezczynności nie wyświetla nic zamiast skonfigurowanego pokazu slajdów.

Rozwiązania:

  1. Sprawdź czy ekran bezczynności jest włączony w Ustawieniach > Klienty > Ekran bezczynności.
  2. Sprawdź czy dodano co najmniej jeden element multimedialny (obraz lub wideo).
  3. Sprawdź czy pliki multimedialne są prawidłowe i nie uszkodzone.
  4. Wyzwól synchronizację aby przesłać najnowsze ustawienia do klienta.

Menu klienta nie wyświetla aplikacji

Objawy: Launcher aplikacji jest pusty lub brakuje kategorii.

Rozwiązania:

  1. Sprawdź czy aplikacje i kategorie są skonfigurowane w Ustawieniach > Klienty > Zawartość.
  2. Sprawdź czy kategorie i aplikacje mają włączoną widoczność.
  3. Sprawdź czy klient otrzymał najnowsze dane menu (zmiany są przesyłane automatycznie przez TCP).
  4. Zrestartuj klienta jeśli synchronizacja w czasie rzeczywistym nie zadziałała.

Motyw wyglądu klienta nie jest stosowany

Objawy: Klient wyświetla domyślny wygląd zamiast skonfigurowanego motywu.

Rozwiązania:

  1. Sprawdź czy ustawienia motywu są zapisane w Ustawieniach > Klienty > Wygląd.
  2. Wyzwól przesyłanie ustawień do klientów.
  3. Zrestartuj aplikację kliencką.

Problemy ze zdalnym pulpitem

Zdalny pulpit jest opóźniony lub rwący

Objawy: Obraz wideo jest opóźniony, zacinający się lub ma niski framerate.

Rozwiązania:

  1. Obniż bitrate (spróbuj 1000-2000 kbps dla standardowego LAN).
  2. Zmniejsz ustawienie FPS.
  3. Użyj kablowego Ethernetu zamiast Wi-Fi.
  4. Sprawdź przeciążenie sieci lub wysokie zużycie pasma przez inne aplikacje.
  5. Upewnij się, że port UDP 5004 nie jest blokowany ani ograniczany.

Zdalny pulpit pokazuje czarny ekran

Objawy: Okno zdalnego pulpitu otwiera się, ale pokazuje tylko czerń.

Rozwiązania:

  1. Sprawdź czy klient jest online i odpowiada (spróbuj najpierw zrobić zrzut ekranu).
  2. Sprawdź czy port UDP 5004 jest otwarty dwukierunkowo.
  3. Sterownik graficzny klienta może wymagać aktualizacji.
  4. Spróbuj zażądać odświeżenia klatki kluczowej.

Nie można sterować myszą lub klawiaturą zdalnie

Objawy: Widzisz zdalny ekran, ale kliknięcia i naciśnięcia klawiszy nie mają efektu.

Rozwiązania:

  1. Sprawdź czy port zdalnego zarządzania (TCP 5003) jest otwarty.
  2. Sprawdź czy aplikacja kliencka posiada odpowiednie uprawnienia systemowe.
  3. Niektóre gry pełnoekranowe mogą blokować zdalne wprowadzanie danych.

Problemy z licencjonowaniem

Licencja pokazuje "offline_grace"

Objawy: Status licencji pokazuje offline_grace z odliczaniem.

Rozwiązania:

  1. Przywróć łączność internetową na komputerze serwera.
  2. Sprawdź rozwiązywanie DNS. Serwer musi mieć dostęp do serwera licencji.
  3. Sprawdź czy proxy lub zapora nie blokuje wychodzących połączeń HTTPS.
  4. Masz 72 godziny na przywrócenie łączności zanim serwer się zablokuje.

Licencja pokazuje "over_limit"

Objawy: Podłączonych jest więcej klientów niż pozwala licencja.

Rozwiązania:

  1. Odłącz bezczynnych klientów nie będących w użyciu.
  2. Sprawdź bieżącą liczbę klientów w stosunku do limitu licencji.
  3. Ulepsz licencję o większą pojemność komputerów.
  4. Uwaga: konsole wliczają się do łącznego limitu komputerów.

Licencja pokazuje "expired" lub "revoked"

Objawy: Serwer przechodzi w tryb ograniczony.

Rozwiązania:

  1. Sprawdź datę wygaśnięcia licencji.
  2. Odnów licencję przez stronę HandyCafe.
  3. W przypadku cofniętych licencji skontaktuj się ze wsparciem HandyCafe.

Problemy ogólne

Zmiany ustawień nie są zapisywane

Objawy: Zmiany cofają się po przejściu ze strony ustawień.

Rozwiązania:

  1. Upewnij się, że klikasz przycisk Zapisz po dokonaniu zmian.
  2. Sprawdź błędy walidacji (podświetlone pola z komunikatami o błędach).
  3. Sprawdź czy masz uprawnienia administratora.

Logi audytu nie zawierają wpisów

Objawy: Oczekiwane czynności nie pojawiają się na stronie Logów.

Rozwiązania:

  1. Sprawdź filtry logów. Upewnij się, że wybrano właściwą kategorię i zakres dat.
  2. Sprawdź czy przyznano uprawnienie LOG_DISPLAY_FULL (w przeciwnym razie wyświetlane są tylko logi z dzisiejszego dnia).
  3. Użyj pola wyszukiwania tekstowego dla konkretnej czynności.