HandyCafe Docs
owner cashier it-admin

Усунення неполадок

На цій сторінці наведені рішення для типових проблем, організовані за категоріями.


Проблеми підключення

Клієнт не знаходить сервер

Симптоми: Клієнт показує "Пошук сервера" або "Сервер не знайдено".

Рішення:

  1. Переконайтеся, що HandyCafe Server запущений на комп'ютері управління.
  2. Перевірте, що обидва ПК в одній підмережі (наприклад, обидва на 192.168.1.x).
  3. Переконайтеся, що mDNS не заблоковано мережевим комутатором або маршрутизатором.
  4. Спробуйте ручне підключення: введіть IP-адресу сервера в налаштуваннях клієнта.
  5. Перевірте, що інше ПЗ не використовує TCP-порт сервера (за замовчуванням: 5001).

Клієнт підключається та негайно відключається

Симптоми: Клієнт ненадовго показує "Підключено", потім повертається до "Пошук".

Рішення:

  1. Перевірте збіг ключа підключення на сервері та клієнті. Ключ встановлюється в Налаштування > Мережа.
  2. Перевірте стабільність мережі (втрата пакетів, проблеми з кабелями).
  3. Переконайтеся, що сервер не досяг ліцензійного ліміту ПК.
  4. Перегляньте серверні журнали на повідомлення про помилки автентифікації.

Клієнт показує "Офлайн" на сервері, але ПК працює

Рішення:

  1. На клієнтському ПК переконайтеся, що HandyCafe Client запущений (перевірте системний трей).
  2. Перевірте мережеве з'єднання клієнтського ПК (чи може він пінгувати сервер?).
  3. Перевірте правила брандмауера: TCP-порти 5001-5003 мають бути відкриті на обох машинах.
  4. Перезапустіть HandyCafe Client на проблемному ПК.
  5. При використанні VLAN переконайтеся, що VLAN сервера та клієнта можуть спілкуватись.

Неможливо підключитись після зміни мережевих налаштувань

Рішення:

  1. Переконайтеся, що клієнти оновлені з новими номерами портів та ключем підключення.
  2. Перезапустіть HandyCafe Server після зміни мережевих налаштувань.
  3. Оновіть правила брандмауера для нових портів.

Проблеми сеансів

Неможливо запустити сеанс

Рішення:

  1. Перевірте статус ліцензії. У режимі лише для читання нові сеанси не запускаються.
  2. Переконайтеся, що клієнт у стані "Очікування". Сеанси можуть запускатись лише на очікуючих клієнтах.
  3. Перевірте дозволи касира. Роль повинна мати дозвіл AUTH_CLIENT_LOGIN.
  4. Переконайтеся, що тарифікація налаштована (Налаштування > Тарифи повинні мати коректну погодинну ставку).

Таймер сеансу показує неправильний час

Рішення:

  1. Перевірте системні годинники на обох ПК. Вони повинні бути синхронізовані (NTP).
  2. При паузі час паузи не враховується.
  3. Для передплачених сеансів таймер показує залишковий час, а не минулий.

Вартість сеансу здається невірною

Рішення:

  1. Перевірте розклад тарифів. Сеанс міг пройти через кілька тарифних слотів з різними множниками.
  2. Перевірте налаштування тарифів: базову ставку, ПДВ, стартовий збір, округлення.
  3. Перегляньте тарифні сегменти сеансу в деталях транзакції.
  4. Перевірте комісію та фіксовану комісію способу оплати.
  5. Для передплачених сеансів перевірте, який режим активний -- "Фіксація при покупці" або "Живий розклад".

Проблеми оплати

Спосіб оплати відсутній у списку

Рішення:

  1. Перевірте наявність способу оплати в Управління > Способи оплати.
  2. Переконайтеся, що спосіб активний (не видалений або вимкнений).
  3. Перевірте дозволи касира. PAYMENT_MANAGE повинен бути наданий.

Комісія розраховується невірно

Рішення:

  1. Перевірте комісійну ставку (у відсотках) та фіксовану комісію способу оплати.
  2. Формула: комісія = (стягнута сума * комісійна ставка / 100) + фіксована комісія.
  3. Перевірте, чи касир застосував ручне перевизначення суми.

Проблеми відображення клієнта

Екран очікування клієнта порожній

Рішення:

  1. Перевірте увімкнення екрана очікування в Налаштування > Клієнти > Екран очікування.
  2. Переконайтеся, що додано щонайменше один медіа-елемент (зображення або відео).
  3. Перевірте валідність та цілісність медіа-файлів.
  4. Запустіть синхронізацію для передачі останніх налаштувань клієнту.

Меню клієнта не показує додатки

Рішення:

  1. Перевірте конфігурацію додатків та категорій в Налаштування > Клієнти > Вміст.
  2. Переконайтеся, що видимість категорій та додатків увімкнена.
  3. Перевірте отримання клієнтом останніх даних меню (зміни передаються автоматично через TCP).
  4. Перезапустіть клієнт, якщо синхронізація в реальному часі не застосувалась.

Проблеми віддаленого робочого стола

Віддалений робочий стіл гальмує або переривається

Рішення:

  1. Зменште бітрейт (спробуйте 1000-2000 кбіт/с для стандартної локальної мережі).
  2. Зменште налаштування FPS.
  3. Використовуйте дротовий Ethernet замість Wi-Fi.
  4. Перевірте перевантаження мережі від інших додатків.
  5. Переконайтеся, що UDP-порт 5004 не заблоковано.

Віддалений робочий стіл показує чорний екран

Рішення:

  1. Переконайтеся, що клієнт онлайн та відповідає (спробуйте зробити знімок спочатку).
  2. Перевірте відкриття UDP-порту 5004 у двох напрямках.
  3. Графічний драйвер клієнта може потребувати оновлення.
  4. Спробуйте запитати оновлення ключового кадру.

Проблеми ліцензування

Ліцензія показує "offline_grace"

Рішення:

  1. Відновіть інтернет-з'єднання на серверному ПК.
  2. Перевірте DNS-резолюцію. Сервер повинен досягати сервера ліцензування.
  3. Перевірте проксі або брандмауер, що блокують вихідні HTTPS-з'єднання.
  4. У вас є 72 години для відновлення зв'язку до блокування сервера.

Ліцензія показує "over_limit"

Рішення:

  1. Відключіть невикористовуваних клієнтів.
  2. Перевірте поточну кількість клієнтів порівняно з лімітом ліцензії.
  3. Оновіть ліцензію для більшої ємності.
  4. Зверніть увагу: консолі враховуються у загальному ліміті ПК.

Ліцензія показує "expired" або "revoked"

Рішення:

  1. Перевірте дату закінчення ліцензії.
  2. Поновіть ліцензію через сайт HandyCafe.
  3. Для відкликаних ліцензій зверніться до підтримки HandyCafe.

Загальні проблеми

Зміни налаштувань не зберігаються

Рішення:

  1. Переконайтеся, що натиснули кнопку Зберегти після внесення змін.
  2. Перевірте помилки валідації (виділені поля з повідомленнями про помилки).
  3. Переконайтеся, що у вас є дозволи адміністратора.

Журнали аудиту не містять записів

Рішення:

  1. Перевірте фільтри журналу. Переконайтеся, що обрано правильну категорію та діапазон дат.
  2. Переконайтеся, що дозвіл LOG_DISPLAY_FULL надано (інакше показуються лише сьогоднішні журнали).
  3. Використайте текстовий пошук для конкретної дії.