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. Якщо ви залишите погодинну ставку на нулі, всі постоплатні сесії будуть безкоштовними. Завжди перевіряйте свої ціни перед запуском.
  • Забування зберегти налаштування. Зміни на сторінці Налаштування не застосовуються, поки ви не натиснете Зберегти. Якщо налаштування здаються незмінними після перезапуску, ви, ймовірно, забули зберегти.
  • Запуск сервера та клієнта на одному ПК. Хоча це технічно можливо для тестування, це не рекомендується для виробництва. ПК-сервер повинен бути виділеною станцією.