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. Используйте текстовое поле поиска для поиска конкретного действия.