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. Оновіть правила брандмауера, щоб дозволити нові порти.
  4. Усі клієнти повинні бути переналаштовані з новими значеннями.

Проблеми з сесіями

Не вдається розпочати сесію на клієнті

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

Рішення:

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

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

Симптоми: Відображений час не відповідає фактичному минулому часу.

Рішення:

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

Вартість сесії здається неправильною

Симптоми: Сума, що стягується, не відповідає очікуванням.

Рішення:

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

Призупинену сесію не можна відновити

Симптоми: Дія відновлення не вдається або недоступна.

Рішення:

  1. Переконайтеся, що ПК клієнта все ще підключений до сервера.
  2. Перевірте, що статус клієнта показує "Призупинено" (помаранчевий).
  3. Якщо клієнт відключився під час паузи, можливо, йому потрібно спочатку перепідключитися.

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

Платіжний метод відсутній у випадаючому списку

Симптоми: Очікуваний платіжний метод не з'являється при закритті сесії або замовлення.

Рішення:

  1. Переконайтеся, що платіжний метод існує в Управління > Платіжні методи.
  2. Перевірте, що платіжний метод активний (не видалений або відключений).
  3. Перевірте права касира. PAYMENT_MANAGE має бути надано для перегляду всіх методів.

Розрахунок комісії здається неправильним

Симптоми: Відрахована комісія не відповідає очікуваній ставці.

Рішення:

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

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

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

Симптоми: Екран очікування нічого не показує замість налаштованого слайд-шоу.

Рішення:

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

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

Симптоми: Запуск додатків порожній або відсутні категорії.

Рішення:

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

Тема оформлення клієнта не застосована

Симптоми: Клієнт показує стандартне оформлення замість налаштованої теми.

Рішення:

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

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

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

Симптоми: Відеопотік затримується, смикається або має низьку частоту кадрів.

Рішення:

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

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

Симптоми: Вікно віддаленого робочого столу відкривається, але показує лише чорний екран.

Рішення:

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

Не можна керувати мишею або клавіатурою віддалено

Симптоми: Ви можете бачити віддалений екран, але кліки і натискання клавіш не мають ефекту.

Рішення:

  1. Переконайтеся, що порт віддаленого управління (TCP 5003) відкритий.
  2. Перевірте, що клієнтський додаток має відповідні системні дозволи.
  3. Деякі повноекранні ігри можуть блокувати віддалений ввід.

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

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

Симптоми: Статус ліцензії показує 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. Використовуйте текстове поле пошуку для пошуку конкретної дії.