HandyCafe Docs
owner

Как настроить кафе с нуля

Это руководство проведет вас через каждый шаг новой установки HandyCafe для вашего интернет-кафе, игрового центра или киберспортивной арены. По завершении у вас будет работающий сервер, подключенный клиентский ПК, настроенная тарификация и завершенная тестовая сессия с оплатой, зафиксированной в кассовом отчете.

Что вам понадобится

  • ПК с Windows для HandyCafe Server (Windows 10 и новее, минимум 4 ГБ ОЗУ).
  • Хотя бы один дополнительный ПК с Windows для клиентской станции.
  • Локальная сеть, соединяющая все ПК (рекомендуется проводной Ethernet для надежности).
  • Действующий бета-лицензионный ключ HandyCafe. Он вводится при первой настройке.
  • Заранее определенная почасовая ставка и валюта.

Фаза 1: установка и настройка сервера

  1. Скачайте последний установщик HandyCafe Server из вашей панели управления HandyCafe.
  2. Запустите установщик на ПК, назначенном сервером. Следуйте инструкциям на экране и примите каталог установки по умолчанию.
  3. Запустите HandyCafe Server. Мастер первой настройки появится автоматически при первом запуске.
  4. Введите бета-лицензионный ключ по запросу. Сервер проверит ключ онлайн и отобразит название кафе и лимит ПК.
  5. Создайте аккаунт администратора. Введите логин и надежный пароль. Этот аккаунт имеет неограниченный доступ ко всем функциям.
  6. Задайте название кафе. Оно будет отображаться на экранах ожидания клиентов и в отчетах.
  7. Нажмите Завершить для окончания мастера.

Ожидаемый результат: главное окно сервера открывается с Панелью администрирования без подключенных клиентов. Название кафе отображается в заголовке.

Фаза 2: настройка тарификации

  1. Откройте страницу Настройки, нажав значок шестеренки в боковом меню.
  2. Перейдите на вкладку Тарификация.
  3. Задайте базовую валюту. Выберите из выпадающего списка. Все цены, транзакции и отчеты будут использовать эту валюту.
  4. Введите почасовую ставку. Это базовая цена за час для постоплатных сессий. Например, 10.00 для десяти единиц валюты в час.
  5. Задайте ставку НДС. Введите процент (от 0 до 100). Введите 0 если НДС не применяется.
  6. Задайте стоимость запуска. Это минимальный сбор за сессию. Введите 0 если не нужен.
  7. Создайте пресеты для типовых продолжительностей. Прокрутите до раздела Пресеты. Нажмите Добавить пресет. Создайте:
    • «30 минут» с продолжительностью 30 минут.
    • «1 час» с продолжительностью 60 минут.
    • «2 часа» с продолжительностью 120 минут.
  8. Нажмите Сохранить для применения конфигурации.

Ожидаемый результат: вкладка Тарификация показывает почасовую ставку, НДС, стоимость запуска и все пресеты. Эти пресеты будут отображаться как кнопки быстрого выбора при запуске предоплатных сессий.

Фаза 3: проверка сетевых настроек

  1. В Настройках перейдите на вкладку Сеть.
  2. Проверьте порт прослушивания. По умолчанию 7842. Меняйте только при конфликте с другой службой.
  3. Задайте или запомните ключ подключения. Этот ключ аутентифицирует подключения клиентов. Все ПК должны использовать одинаковый ключ.
  4. Убедитесь, что файрвол серверного ПК разрешает входящие TCP-подключения на настроенном порту. В Windows HandyCafe обычно добавляет это правило при установке. При смене порта добавьте новое правило вручную.
  5. Запишите IP-адрес серверного ПК, отображаемый на вкладке Сеть. Он понадобится если клиенты не найдут сервер автоматически.

Ожидаемый результат: вкладка Сеть показывает порт прослушивания и ключ подключения. Индикатор статуса сервера показывает «Прослушивание» зеленым цветом.

Фаза 4: развертывание первого клиента

  1. Скачайте установщик HandyCafe Client из вашей панели управления.
  2. Установите его на первый клиентский ПК. Запустите установщик и следуйте инструкциям.
  3. Запустите HandyCafe Client. Клиент попытается автоматически обнаружить сервер через mDNS в локальной сети.
  4. Если автообнаружение не сработало, введите IP-адрес и порт сервера вручную в диалоге подключения клиента.
  5. Введите ключ подключения, записанный в Фазе 3.
  6. Дождитесь установления соединения. Экран клиента переключится на страницу ожидания с экраном блокировки и часами.

Ожидаемый результат: на сервере в Панели администрирования появился один подключенный клиент. Плитка клиента отображает имя хоста и синий статус «Ожидание». На клиентском ПК показывается экран блокировки.

  1. Сервер автоматически назначит клиенту отображаемое имя на основе имени хоста. Для переименования выберите плитку клиента на сервере и нажмите Переименовать.

Фаза 5: первая тестовая сессия

  1. На сервере в Панели администрирования нажмите Старт на незанятой плитке клиента.
  2. В диалоге сессии выберите Постоплату. Оставьте поле участника пустым для гостевой сессии.
  3. Нажмите Подтвердить для запуска сессии.

Ожидаемый результат: плитка клиента стала зеленой с таймером, отсчитывающим время вверх. На клиентском ПК экран блокировки исчез и появился рабочий стол.

  1. Дайте сессии поработать хотя бы 5 минут для проверки расчетов ценообразования.
  2. Нажмите Стоп на зеленой плитке клиента.
  3. Просмотрите диалог разбивки стоимости:
    • Продолжительность (например, 5 минут).
    • Примененная почасовая ставка.
    • Сумма НДС.
    • Итоговая сумма.
  4. Выберите способ оплаты (Наличные по умолчанию).
  5. Нажмите Подтвердить для закрытия сессии и записи оплаты.

Ожидаемый результат: плитка клиента возвращается к синему «Ожидание». На клиентском ПК снова показывается экран блокировки. Транзакция записана.

Фаза 6: проверка в кассовом отчете

  1. Перейдите на страницу Кассовый отчет через боковое меню.
  2. Подтвердите, что сегодняшний отчет показывает одну транзакцию сессии.
  3. Проверьте, что сумма транзакции совпадает с разбивкой стоимости при остановке сессии.
  4. Убедитесь, что в столбце способа оплаты указано «Наличные» (или выбранный вами способ).

Ожидаемый результат: кассовый отчет содержит одну завершенную сессию с корректной суммой, продолжительностью и способом оплаты. Ваше кафе готово к работе.

Фаза 7: дальнейшие шаги (по желанию)

После запуска базовой конфигурации рассмотрите настройку следующих функций:

  1. Добавьте участников. Перейдите на страницу Участники. Нажмите Добавить для создания аккаунтов с логинами и балансами кошельков. Участники смогут входить с клиентских ПК.
  2. Настройте продукты. Перейдите на страницу Продукты. Добавьте позиции еды и напитков с ценами для создания заказов кассирами.
  3. Настройте клиентское меню. Перейдите в Настройки > Клиентское меню. Добавьте категории и приложения для отображения сетки запуска на рабочем столе.
  4. Разверните дополнительные клиенты. Установите HandyCafe Client на каждый ПК вашего кафе. Каждый автоматически появится на сервере.
  5. Создайте аккаунты кассиров. Перейдите на страницу Управление. Добавьте аккаунты кассиров с соответствующими ролями.
  6. Настройте пиковое/непиковое ценообразование. Перейдите в Настройки > Расписание тарификации. Создайте временные множители для повышенных тарифов в загруженные часы.
  7. Включите OAuth-вход. Перейдите в Настройки > OAuth. Настройте Google или другие провайдеры для входа клиентов через социальные аккаунты.

Типичные ошибки

  • Пропуск правила файрвола. Если клиенты не подключаются, наиболее вероятная причина -- правило Брандмауэра Windows, блокирующее порт. Проверьте правило прежде чем диагностировать другие проблемы.
  • Несовпадение ключей подключения. Ключ на каждом клиенте должен точно совпадать с серверным. Используйте копирование и вставку для исключения опечаток.
  • Почасовая ставка равна 0. Если оставить почасовую ставку нулевой, все постоплатные сессии будут бесплатными. Всегда проверяйте тарификацию перед запуском.
  • Не сохранены настройки. Изменения на странице Настройки не применяются пока вы не нажмете Сохранить. Если настройки не изменились после перезапуска, вероятно, вы забыли сохранить.
  • Сервер и клиент на одном ПК. Технически возможно для тестирования, но не рекомендуется для рабочей эксплуатации. Серверный ПК должен быть выделенной станцией.