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 Кбит/с для стандартного использования в LAN).
  2. Уменьшите настройку FPS.
  3. Используйте проводной Ethernet вместо Wi-Fi.
  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. Используйте текстовый поиск для нахождения конкретного действия.