HandyCafe Docs
owner it-admin

Як налаштувати Кафетерію

Цей посібник проводить через повне перше налаштування модуля Кафетерія. Наприкінці у вас буде опубліковане меню для клієнтів за адресою handy.cafe/{your-slug}, план залу принаймні з одним робочим столом, меню з товарами та успішно оформлене тестове замовлення.

Що вам знадобиться

  • Активна ліцензія HandyCafe. Автентифікація Кафетерії використовує ліцензію автоматично; ключ вручну вставляти не потрібно.
  • Доступ до інтернету на сервері. Кафетерія працює за хмарною моделлю, тож створення кафе, синхронізація меню та опитування замовлень потребують вихідного доступу до cloud API.
  • Slug, який ви хочете використовувати для публічного URL меню. Дозволені символи: малі літери, цифри та дефіси. Довжина - від 3 до 62 символів.
  • Необов'язково: логотип і верхнє зображення. Рекомендований формат - WebP до 2 МБ.
  • Необов'язково: TCP-чековий принтер у локальній мережі.

Крок 1: Увімкніть Кафетерію

  1. Відкрийте HandyCafe Server.
  2. Перейдіть у Налаштування в бічній панелі.
  3. Відкрийте вкладку Кафетерія.
  4. Увімкніть Enable Кафетерій.
  5. Сервер звернеться до cloud API, використовуючи вашу ліцензію як токен авторизації. Якщо все успішно, відкриється майстер створення кафе.

Очікуваний результат: З'являється екран Provisioning Wizard. Якщо бачите помилку про ліцензію або підключення, перевірте інтернет і переконайтеся, що ваша ліцензія HandyCafe активна.

Крок 2: Створіть кафе

Майстер запитує чотири поля.

  1. Slug. Введіть бажаний суфікс URL. Індикатор доступності оновлюється менш ніж за секунду. Якщо slug уже зайнятий або зарезервований, оберіть інший.
  2. Відображуване ім'я. Людиночитна назва, яка показується вгорі меню для клієнтів, наприклад "Atilla's Gaming Lounge".
  3. Країна та валюта. Оберіть країну, де працює кафе. Валюта за замовчуванням підбирається за країною і може бути змінена.
  4. Часовий пояс. Оберіть часовий пояс для часових міток замовлень і розрахунків.
  5. Натисніть Create Cafe.

Очікуваний результат: Майстер закривається, а робочий простір Кафетерії відкривається. Ваш публічний URL handy.cafe/{slug} уже працює, хоча меню поки порожнє.

Крок 3: Заповніть профіль закладу

  1. Не виходячи з Налаштування > Кафетерія, прокрутіть до розділу Business Profile.
  2. Завантажте Logo (квадратне зображення).
  3. Завантажте Header Image (широкий банер).
  4. Введіть Address та Phone, щоб показувати їх у футері меню для клієнтів.
  5. Увімкніть або вимкніть Show Prep Time on Menu залежно від того, чи хочете ви показувати клієнтам орієнтовний час приготування.
  6. Натисніть Save.

Очікуваний результат: Логотип і верхнє зображення з'являються в прев'ю. Якщо відкрити handy.cafe/{slug} у браузері, ви побачите фірмовий заголовок, але вміст ще буде порожнім.

Крок 4: Створіть поверхи

  1. У Налаштування > Кафетерія знайдіть розділ Floors.
  2. Натисніть Add Floor і задайте назву, наприклад "Main Hall".
  3. Додайте додаткові поверхи, якщо у вашому закладі є кілька зон, наприклад "Mezzanine" або "Outdoor Patio".
  4. Переставляйте поверхи кнопками вгору та вниз. Верхній поверх стане типовим у редакторі Плану залу.

Очікуваний результат: Поверхи з'являються у списку. На вкладці Кафетерія > План залу тепер видно пігулки поверхів угорі.

Крок 5: Побудуйте план залу

  1. Відкрийте Кафетерія > План залу.
  2. Виберіть перший поверх із пігулок.
  3. Натисніть Add Table. На початку полотна з'явиться квадратний стіл.
  4. Перетягніть стіл у потрібну позицію. Відпустіть, щоб зберегти.
  5. Натисніть на стіл, щоб відкрити його панель властивостей. Налаштуйте:
    • Code (наприклад "T1", "Window 3").
    • Display Name (необов'язкова довша назва).
    • Seat Count (кількість місць).
    • Shape (square, rectangle horizontal, rectangle vertical або round).
    • Size (від 1 до 10).
  6. Повторіть для кожного столу на поверсі.
  7. За бажанням перемкніться в 3D view, щоб переглянути розташування з архітектурної перспективи.

Очікуваний результат: План залу показує всі столи на їхніх реальних місцях. Перетягування вимкнене у 3D view; щоб рухати столи, поверніться в 2D.

Крок 6: Побудуйте меню

  1. Відкрийте Кафетерія > Меню.
  2. Натисніть Add Category. Введіть назву та виберіть MDI-іконку в іконпікері. Натисніть Save.
  3. Повторіть для кожної категорії, наприклад "Hot Drinks", "Cold Drinks", "Burgers", "Desserts".
  4. Усередині категорії натисніть Add Product. Введіть:
    • Назву.
    • Опис (підтримується Markdown).
    • Рядок інгредієнтів.
    • Базову ціну.
    • Ставку ПДВ.
    • Час приготування (статична резервна оцінка).
    • Необов'язково: позначку одиниці, прапорець Track Stock, кількість In Stock.
  5. Завантажте Photo товару. Підійде будь-який формат, але WebP до 2 МБ рекомендовано.
  6. Натисніть Save.
  7. Якщо у товару є вибір, прокрутіть до розділу Variants і натисніть Add Variant. Створіть рядок для кожної опції з її зміною ціни. Увімкніть Required, якщо клієнт має вибрати один варіант.
  8. Повторіть для кожного товару в меню.

Очікуваний результат: Меню для клієнтів за адресою handy.cafe/{slug} тепер показує ваші категорії та товари. Відкрийте його в браузері, щоб перевірити.

Крок 7: Налаштуйте принтер (необов'язково)

  1. Залишаючись у Налаштування > Кафетерія, прокрутіть до Printer Settings.
  2. Встановіть Kind у TCP.
  3. Введіть IP і Port принтера. Більшість ESC POS TCP-принтерів слухають порт 9100.
  4. Увімкніть Auto Cut, якщо принтер це підтримує.
  5. Увімкніть Auto Print on New Order, щоб друкувати чек для кожного нового замовлення.
  6. Увімкніть Sound Notification для звукового сповіщення разом зі сповіщенням на робочому столі.
  7. Натисніть Test Print. Пробний чек має надрукуватися за кілька секунд.

Очікуваний результат: Тестовий чек друкується успішно. Якщо нічого не друкується, перевірте IP, порт і те, що принтер у тій самій локальній мережі, що й сервер.

Крок 8: Посадіть клієнта за стіл і зробіть тестове замовлення

  1. Відкрийте Кафетерія > Столи (або скористайтеся меню дій Плану залу).
  2. Виберіть один стіл і натисніть Seat Customer (також позначено як "Open Table").
  3. Запишіть показаний 6-значний код безпеки. Можете його занотувати або залишити діалог відкритим.
  4. На телефоні відкрийте handy.cafe/{slug}/{table-code}. Якщо маєте друковану наклейку, можете відсканувати QR.
  5. Введіть 6-значний код.
  6. Перегляньте меню та додайте позицію в кошик.
  7. Перейдіть до оформлення. Оберіть Cash як спосіб оплати (налаштування Stripe необов'язкове і його можна додати пізніше).
  8. Надішліть замовлення.
  9. На сервері відкрийте Кафетерія > Замовлення.

Очікуваний результат: Протягом 3 секунд на панелі Замовлення з'являється нова картка замовлення. Спрацьовує сповіщення на робочому столі. Якщо звукові сповіщення ввімкнені, лунає звук. Значок очікуваних замовлень збільшується на вкладці Замовлення.

Крок 9: Просуньте й закрийте тестове замовлення

  1. На картці замовлення натисніть кнопку наступного статусу. Замовлення перейде з placed у confirmed.
  2. Продовжуйте натискати, щоб пройти preparing, ready і served.
  3. На сторінці Столи відкрийте той самий стіл і натисніть Settle Check.
  4. Оберіть Cash як спосіб оплати та підтвердіть.

Очікуваний результат: Стіл повертається в idle. Код безпеки спливає. Створюється запис про розрахунок, який можна перевірити пізніше.

Типові помилки, яких варто уникати

  • Пропуск профілю закладу. Якщо запустити систему до збереження профілю, клієнти побачать стандартне відображуване ім'я і зламану область логотипа.
  • Не перевидавати QR-коди після зміни slug. Зміна slug робить усі наявні QR недійсними. Надрукуйте нові наклейки і замініть їх на кожному столі.
  • Публікувати забагато категорій на старті. Орієнтуйтеся на 6-10 верхньорівневих категорій. Клієнтам легше переглядати меню, якщо воно поміщається на екран.
  • Забути налаштувати принтер до першої справжньої зміни. Без Auto Print on New Order персонал може пропустити замовлення під час напруженого періоду. Завжди запускайте принаймні один тестовий друк.
  • Залишати ввімкненим стандартний Show Prep Time on Menu без динамічної історії. Перші 30 днів клієнти бачитимуть статичне значення. Задайте реалістичний статичний час або вимкніть індикатор, доки динамічна оцінка не навчиться.
  • Використовувати той самий пристрій для тестів персоналу і клієнтів. Сеанс клієнта зберігається 24 години; якщо ваш тестовий пристрій потім отримає клієнт, він уже буде в меню без перевірки. Очистіть пристрій або використайте чистий профіль браузера для тестів.