HandyCafe Docs
owner cashier it-admin

Часті запитання

Налаштування та встановлення

Які типи бізнесу підтримує HandyCafe?

HandyCafe розроблений для інтернет-кафе, ігрових центрів, кіберспортивних арен, кібер-кафе та PC-бангів. Будь-який бізнес, що надає почасовий доступ до ПК або ігрових консолей, може використовувати HandyCafe для управління сеансами, білінгом та членством.

Які системні вимоги для HandyCafe Server?

Сервер потребує Windows 10 або пізнішу версію (64-біт), мінімум 4 ГБ оперативної пам'яті, 500 МБ дискового простору та підключення до локальної мережі. Клієнтські ПК потребують Windows 10 або пізнішу версію з 2 ГБ оперативної пам'яті. Усі ПК мають бути в одній локальній мережі. Детальніше у розділі Системні вимоги.

Як встановити HandyCafe Server?

Завантажте інсталятор з офіційного сайту, запустіть його та дотримуйтесь інструкцій. При першому запуску Майстер першого налаштування створює обліковий запис адміністратора. Детальніше у розділі Встановлення сервера.

Як підключити клієнтський ПК до сервера?

Встановіть HandyCafe Client на ПК. Він використовує mDNS для автоматичного виявлення сервера в локальній мережі. Якщо автоматичне виявлення не вдається, введіть IP-адресу сервера вручну в налаштуваннях клієнта. Детальніше у розділі Встановлення клієнта.

Чому мій клієнт не підключається до сервера?

Поширені причини: сервер не запущений, ПК знаходяться в різних підмережах, брандмауер блокує порти (TCP 5001, 5002, 5003 та UDP 5004) або ключ підключення не збігається. Детальніше у розділі Усунення неполадок.

Які порти використовує HandyCafe?

TCP 5001 (команди), TCP 5002 (передача файлів), TCP 5003 (віддалене управління), UDP 5004 (потокове передавання екрану). Їх можна налаштувати в Мережевих налаштуваннях.

Як активувати ліцензію?

Введіть ліцензійний ключ у панелі ліцензій. Сервер перевіряє його на сервері ліцензування. Для початкової активації потрібне активне інтернет-з'єднання. Детальніше у розділі Ліцензування.

Що відбувається, коли сервер офлайн понад 72 години?

HandyCafe має 72-годинний пільговий період роботи офлайн. Протягом цього часу всі функції працюють нормально. Після 72 годин без зв'язку з сервером ліцензування сервер переходить у заблокований стан до відновлення інтернет-доступу.


Сеанси та тарифи

Як запустити сеанс на ПК?

На Панелі адміністратора оберіть ПК у стані очікування (блакитний) та натисніть Запустити на картці. Оберіть постоплатний або передплачений режим, за бажанням призначте учасника, встановіть тривалість/суму для передплати, оберіть спосіб оплати та підтвердіть. Детальніше у розділі Сеанси.

Яка різниця між передплаченими та постоплатними сеансами?

У постоплатному режимі клієнт платить наприкінці за фактичний час використання. У передплаченому режимі клієнт платить наперед за фіксовану тривалість або суму. Передплата підтримує два підрежими: Фіксація при покупці (вартість фіксується на початку) та Живий розклад (вартість коригується зі зміною часових слотів). Детальніше у розділі Сеанси.

Як працює розклад тарифів?

Розклад тарифів -- це сітка 7 днів на 24 години, де кожному часовому блоку призначається кольоровий тарифний слот. Кожен слот має множник (наприклад, 1.0x стандартний, 1.5x піковий, 0.5x позапіковий). Вартість сеансу розраховується як: базова погодинна ставка помножена на множник слоту та тривалість. Детальніше у розділі Тарифікація сеансів.

Як встановити різні ціни для вихідних та будніх днів?

У Налаштування > Розклад тарифів створіть тарифні слоти з різними множниками (наприклад, "Будні" на 1.0x, "Вихідні" на 1.3x). Розфарбуйте стовпці вихідних кольором слоту Вихідних, а стовпці будніх -- кольором слоту Будніх. Детальніше у розділі Розклад тарифів.

Як призупинити та відновити сеанс?

Натисніть Призупинити на картці активного ПК. Тарифікація зупиняється на час паузи. Для відновлення натисніть Відновити на картці призупиненого ПК. При відновленні починається новий тарифний сегмент. Детальніше у розділі Сеанси.

Як додати додатковий час до активного сеансу?

Натисніть Додати час на картці активного ПК. Введіть кількість хвилин для додавання (додатне для збільшення, від'ємне для зменшення). Для коригування створюється запис транзакції.

Що відбувається, коли сеанс охоплює кілька тарифних слотів?

Сеанс автоматично розбивається на сегменти на межах слотів. Кожен сегмент використовує множник, активний протягом цього періоду. Загальна вартість -- це сума вартостей усіх сегментів. Детальніше у розділі Тарифікація сеансів.

Що таке стартовий збір?

Стартовий збір -- це мінімальна плата, що застосовується до кожного сеансу. Навіть якщо сеанс дуже короткий, з клієнта стягується щонайменше ця сума. Налаштовується у розділі Налаштування тарифів.


Учасники та лояльність

Як створити нового учасника?

Перейдіть на сторінку Учасників та натисніть Додати учасника. Введіть ім'я користувача, відображуване ім'я, необов'язкову електронну пошту, телефон та інші дані. За необхідності призначте рівень. Детальніше у розділі Учасники.

Як працює система гаманця?

Кожен учасник має баланс гаманця. При поповненні гаманця створюється кредит гаманця з конкретною сумою та типом кредиту (оплачений, бонусний, ручний тощо). Під час сеансів гаманець споживається автоматично. Кредити можуть мати терміни дії та обмеження за пристроями. Детальніше у розділі Гаманець учасника.

Що таке кредит гаманця?

Кредит гаманця -- це окремий запис балансу, створений одним поповненням. Кожен кредит відстежує власну суму, тип (оплачений, бонусний, ручний), статус (активний, прострочений, спожитий) та обмеження за типом пристрою. Кредити споживаються по черзі (найстаріший першим). Детальніше у розділі Гаманець учасника.

Як працюють рівні лояльності та бали?

Учасники отримують бали за діяльність (витрати, відвідування, поповнення, замовлення). Кожен рівень має поріг балів. Коли учасник накопичує достатньо балів, він переходить на наступний рівень. Вищі рівні можуть мати кращі знижки. Детальніше у розділі Рівні лояльності.

Як поповнити гаманець учасника?

Оберіть учасника на сторінці Учасників, натисніть опцію оплати/поповнення, введіть суму, оберіть тип кредиту та спосіб оплати та підтвердіть. Створюється новий кредит гаманця. Детальніше у розділі Гаманець учасника.

Чи може учасник використовувати баланс гаманця як для ПК, так і для консолей?

Це залежить від обмеження пристрою для кредиту. Кредити можуть бути обмежені "лише ПК", "лише консолі" або "обидва". При покупці пакета обмеження пристрою визначається конфігурацією пакета. Детальніше у розділі Пакети.

Що відбувається, коли кредит гаманця закінчується?

Коли кредит досягає дати закінчення, його статус змінюється на "прострочений" і залишок більше не доступний для використання. Прострочена сума фіксується в історії транзакцій учасника.

Як переглянути історію транзакцій учасника?

Оберіть учасника на сторінці Учасників. Панель деталей учасника показує журнал транзакцій з усіма поповненнями, витратами, поверненнями та коригуваннями з мітками часу та сумами.


Товари, замовлення та інвентар

Як додати товар до каталогу?

Перейдіть до Товарів та натисніть Додати товар. Введіть назву, категорію, одиницю виміру, штрихкод, ціну продажу, собівартість та ставку ПДВ. Перемкніть активний/неактивний стан. Детальніше у розділі Товари.

Як створити замовлення для клієнта?

Перейдіть до Замовлень, натисніть Нове замовлення, за бажанням призначте до ПК або додайте примітку, додайте позиції з каталогу товарів з кількостями, потім закрийте замовлення зі способом оплати. Детальніше у розділі Замовлення.

Як скасувати або повернути замовлення?

Відкрийте замовлення зі сторінки Замовлень та натисніть Скасувати. Замовлення анулюється і жодна оплата не фіксується. Для повернень по закритих замовленнях використовуйте відповідний процес повернення.

Як працює відстеження запасів?

Кожен товар має рівень запасу. Журнал запасів відстежує зміни з причинами: продаж (автоматичне зменшення при закритті замовлення), закупівля (з записів інвентарю), коригування, списання та повернення. Детальніше у розділах Товари та Інвентар.


Акції та пакети

Як створити акцію?

Перейдіть до Акцій та натисніть Додати акцію. Введіть назву, опис, встановіть як активну та за необхідності налаштуйте дату закінчення. Потім додайте пакети до акції. Детальніше у розділі Акції.

Яка різниця між пакетами хвилин та грошовими пакетами?

Пакети хвилин надають учаснику час (хвилини) для сеансів. Грошові пакети додають кошти до гаманця учасника. Обидва можуть включати бонусні суми. Детальніше у розділі Пакети.

Як працює бонусна система у пакетах?

Пакет може включати бонус понад базове нарахування. Наприклад, пакет може пропонувати "60 хвилин + 15 бонусних хвилин" або "$10 + $2 бонус". Бонус створює окремий запис кредиту з типом "Бонус".

Як працюють обмеження за пристроями у пакетах?

Кожен пакет визначає обмеження за пристроєм: клієнт (ПК), консоль, обидва, лише ПК або лише консолі. При покупці пакета створені кредити гаманця/часу успадковують це обмеження та можуть використовуватись лише на відповідних типах пристроїв.


Управління касирами

Як створити обліковий запис касира?

Перейдіть до Управління > Касири. Натисніть Додати касира, введіть ім'я користувача та пароль, призначте роль. Касир може увійти з цими обліковими даними. Детальніше у розділі Ролі касирів.

Як встановити дозволи для ролі касира?

Перейдіть до Управління > Ролі касирів. Створіть нову роль або відредагуйте існуючу. Увімкніть або вимкніть окремі прапорці дозволів у кожній з 6 категорій (Автентифікація, Учасники, Консолі, Журнали, Звіти, Способи оплати). Детальніше у розділі Ролі касирів.

Які є 6 категорій дозволів?

Автентифікація (1 прапорець), Учасники (6 прапорців: перегляд, додавання, видалення, оновлення, показ email, показ телефону), Консолі (4 прапорці: перегляд, додавання, видалення, оновлення), Журнали (4 прапорці: перегляд, повна історія, лише сьогодні, видалення), Звіти (3 прапорці: перегляд, повна історія, лише сьогодні), Способи оплати (4 прапорці: управління, додавання, видалення, оновлення). Разом: 22 окремі прапорці дозволів.

Як працює захист від підбору паролів при вході касира?

Після 5 невдалих спроб входу протягом 10 хвилин обліковий запис блокується на 15 хвилин. Усі невдалі спроби фіксуються в аудиторському журналі зі сповіщенням безпеки.

Як переглянути звіти змін касирів?

Відкрийте сторінку Касового звіту. Фільтруйте за ім'ям касира для перегляду транзакцій, оброблених конкретним касиром за його зміну. Підсумок зміни показує підсумки та розбивку за способами оплати.


Налаштування та конфігурація

Як змінити мову?

Перейдіть до Налаштування > Загальні та оберіть мову зі спадного списку. HandyCafe підтримує 24 мови. Інтерфейс оновлюється негайно. Детальніше у розділі Загальні налаштування.

Як налаштувати вхід через Google OAuth?

Перейдіть до Налаштування > OAuth. Увімкніть OAuth глобально, потім увімкніть Google. Введіть ваш Google Client ID та Client Secret (з Google Cloud Console). За бажанням імпортуйте файл JSON-облікових даних. Протестуйте, ініціювавши вхід через OAuth з клієнтського ПК. Детальніше у розділі Налаштування OAuth.

Як налаштувати сітку розкладу тарифів?

Перейдіть до Налаштування > Розклад тарифів. Увімкніть розклад, створіть кольорові слоти з множниками, потім клацніть/перетягніть на сітці 7x24 для розфарбовування часових блоків потрібним слотом. Детальніше у розділі Розклад тарифів.

Як налаштувати екран очікування клієнта?

Перейдіть до Налаштування > Клієнти > вкладка Екран очікування. Увімкніть слайд-шоу, додайте зображення або відео, встановіть тривалість та переходи. За бажанням увімкніть накладення годинника та назви кафе. Детальніше у розділі Екран очікування клієнта.

Як змінити тему зовнішнього вигляду клієнта?

Перейдіть до Налаштування > Клієнти > вкладка Зовнішній вигляд. Оберіть тему (Neon Arena, Crimson Pulse, Emerald Depth), оберіть макет та налаштуйте фон, щільність карток та ефекти. Детальніше у розділі Зовнішній вигляд клієнта.

Як налаштувати звукові сповіщення?

Перейдіть до Налаштування > Звуки. Увімкніть основний перемикач звуків, потім оберіть звук для кожної події (Виклик касира, Нове замовлення, Завершення сеансу, Запит на вхід) з 15 вбудованих варіантів. Детальніше у розділі Налаштування звуків.

Що таке ключ підключення і чому він важливий?

Ключ підключення -- це спільний секрет для криптографічної автентифікації між сервером та клієнтами. Він запобігає підключенню несанкціонованих пристроїв до вашого сервера. Усі клієнти мають використовувати той самий ключ, що й сервер. Налаштовується у Мережевих налаштуваннях.


Віддалене управління

Як зробити віддалений знімок екрана клієнтського ПК?

Оберіть клієнта на Панелі адміністратора та натисніть Знімок екрана на картці. Засіб перегляду знімків відображає захоплене зображення. Ви можете оновити для нового захоплення або завантажити зображення. Детальніше у розділі Знімки екрана.

Як використовувати віддалений робочий стіл для управління клієнтським ПК?

Оберіть картку клієнта та натисніть Віддалений робочий стіл. Відкривається вікно з потоковим H.264-відео в реальному часі. Ви можете віддалено керувати мишкою та клавіатурою, а синхронізація буфера обміну працює між сервером та клієнтом. Детальніше у розділі Віддалений робочий стіл.

Як працює система синхронізації файлів?

Налаштуйте каталоги для синхронізації у Налаштування > Синхронізація файлів. При запуску сервер створює маніфест файлів. Клієнти порівнюють маніфест із локальними файлами та завантажують лише змінені або нові файли за допомогою блочної передачі. Детальніше у розділі Синхронізація файлів.

Як побачити, які додатки запущені на клієнтському ПК?

Оберіть клієнта на Панелі адміністратора та натисніть Запущені додатки на картці. Панель показує всі запущені процеси з назвами та деталями. Ви також можете переглянути Автозавантаження, Встановлені додатки та Віконні додатки за допомогою тих самих кнопок дій.

Як надіслати повідомлення на клієнтський ПК?

Оберіть картку клієнта та натисніть Надіслати повідомлення. Введіть повідомлення та підтвердіть. Повідомлення з'являється на екрані клієнта.

Як віддалено вимкнути або перезавантажити клієнтський ПК?

Оберіть картку клієнта та натисніть Вимкнути або Перезавантажити. Ви також можете обрати кілька клієнтів для масових операцій. Wake on LAN доступний для ввімкнення офлайн ПК, що це підтримують.


Звіти та аналітика

Як переглянути касовий звіт?

Перейдіть до Касового звіту з бічної панелі. Звіт показує підсумкові картки, історію транзакцій, дохід за пристроями та графіки. Використовуйте фільтри дат для звуження часового діапазону. Детальніше у розділі Касовий звіт.

Як експортувати дані звіту?

У Касовому звіті використайте функцію експорту/копіювання для копіювання даних транзакцій у буфер обміну у форматі CSV. Потім ви можете вставити їх в Excel або будь-який табличний додаток.

Яка аналітика доступна на сторінці Статистики?

Дев'ять вкладок аналітики: тенденції доходу, аналітика продажів, відстеження витрат, статистика сеансів, використання консолей, використання додатків, рівні використання комп'ютерів, активність учасників та ефективність касирів. Детальніше у розділі Статистика.

Як перевірити рівні використання комп'ютерів?

Перейдіть до Статистика > вкладка Використання комп'ютерів. Тут показано відсотки використання по кожному ПК, час роботи та дохід на комп'ютер. Також визначаються найзавантаженіші ПК. Детальніше у розділі Статистика сеансів та комп'ютерів.


Усунення неполадок

Клієнт показує "офлайн", але ПК увімкнений. Що робити?

Перевірте: 1) HandyCafe Client запущений на ПК, 2) обидва ПК в одній мережі/підмережі, 3) брандмауер дозволяє TCP-порти 5001-5003, 4) ключ підключення збігається між сервером та клієнтом. Детальніше у розділі Усунення неполадок.

Тарифікація сеансу здається невірною. Як перевірити?

Перевірте налаштування тарифів (Налаштування > Тарифи) для базової погодинної ставки та ПДВ. Перевірте розклад тарифів (Налаштування > Розклад тарифів) для активних множників на час сеансу. Перегляньте тарифні сегменти сеансу в деталях транзакції для розуміння розрахунку кожного сегмента.

Вхід через OAuth завис на "очікуванні". Як вирішити?

Переконайтеся, що адміністратор схвалив запит на сторінці Запитів. Якщо запит завис, перевірте: 1) облікові дані провайдера OAuth правильні в Налаштування > OAuth, 2) сервер має інтернет-доступ до API провайдера, 3) код пристрою не прострочений (зазвичай вони діють 15-30 хвилин).

Віддалений робочий стіл гальмує. Як покращити продуктивність?

Зменште бітрейт у налаштуваннях потоку (спробуйте 1000-2000 кбіт/с для локальної мережі). Перевірте пропускну здатність мережі між сервером та клієнтом. Переконайтеся, що UDP-порт 5004 не заблоковано. Використовуйте дротовий Ethernet замість Wi-Fi для найкращих результатів.

Моя ліцензія показує "over_limit". Що це означає?

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

Касир заблокований після забагатьох невдалих спроб входу. Як розблокувати?

Зачекайте 15 хвилин до автоматичного завершення блокування. Якщо терміново, адміністратор може керувати обліковим записом касира через інтерфейс управління.