HandyCafe Docs
owner

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

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

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

  • ПК с Windows для работы в качестве сервера HandyCafe (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. Если вы оставите почасовую ставку на нуле, все постоплатные сессии будут бесплатными. Всегда проверяйте ваши тарифы перед запуском.
  • Забывание сохранить настройки. Изменения на странице настроек не применяются, пока вы не нажмете "Сохранить". Если настройки кажутся неизменными после перезапуска, вероятно, вы забыли сохранить.
  • Запуск сервера и клиента на одном ПК. Хотя это технически возможно для тестирования, не рекомендуется для работы. ПК-сервер должен быть выделенной станцией.