Поширені запитання

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

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

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

Які системні вимоги має HandyCafe Server?

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

У режимі postpaid клієнт платить наприкінці за фактичний час використання. У режимі prepaid клієнт платить наперед за фіксовану тривалість або суму. Prepaid підтримує два підрежими: Lock at Purchase (вартість фіксується на старті) та Live Schedule (вартість змінюється разом із часовими слотами). Дивіться Сеанси.

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

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

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

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

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

Натисніть Pause на картці онлайн-ПК. Під час паузи тарифікація зупиняється. Щоб відновити, натисніть Resume на картці призупиненого ПК. Після відновлення починається новий тарифний сегмент. Дивіться Сеанси.

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

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

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

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

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

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

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

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

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

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

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

Що таке wallet credit?

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

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

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

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

Виберіть учасника на сторінці Учасники, натисніть опцію оплати або поповнення, введіть суму, виберіть тип кредиту та спосіб оплати й підтвердіть. Створюється новий wallet credit. Дивіться Гаманець учасника.

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

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

Що відбувається, коли wallet credit спливає?

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Керування касирами

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

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

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

Перейдіть до Management > Cashier Roles. Створіть нову роль або відредагуйте наявну. Увімкніть або вимкніть окремі прапорці дозволів у кожній із 6 категорій: Authentication, Members, Consoles, Logs, Reports, Payment Methods. Дивіться Ролі касирів.

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

Authentication (1 прапорець), Members (6 прапорців: view, add, delete, update, show email, show phone), Consoles (4 прапорці: view, add, delete, update), Logs (4 прапорці: view, full history, today only, delete), Reports (3 прапорці: view, full history, today only), Payment Methods (4 прапорці: manage, add, delete, update). Усього: 22 окремі прапорці дозволів.

Як працює захист від brute-force під час входу касира?

Після 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), оберіть пресет макета та налаштуйте фон, щільність карток і ефекти. Дивіться Зовнішній вигляд клієнта.

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

Перейдіть до Налаштування > Звуки. Увімкніть головний перемикач звуків, потім виберіть звук для кожної події (Call Cashier, New Order, Session End, Login Request) з 15 вбудованих варіантів. Дивіться Налаштування звуків.

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

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

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

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

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

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

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

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

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

Як побачити, які застосунки працюють на клієнтському ПК?

Виберіть клієнта в Панелі адміністратора та натисніть Running Apps на картці. Панель показує всі запущені процеси з назвами й деталями. Також можна переглянути Startup Apps, Installed Apps та Windowed Apps тими самими кнопками дій.

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

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

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

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

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

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

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

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

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

Яка аналітика є на сторінці Статистики?

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

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

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

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

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

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

Розрахунок тарифу виглядає неправильним. Як перевірити?

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

OAuth-вхід завис у статусі "pending". Як це виправити?

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

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

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

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

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

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

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

Кафетерія

Як клієнти роблять замовлення зі свого столу?

Вони сканують QR-код на столі телефоном, вводять 6-значний код безпеки, який їм дав персонал, переглядають меню своєю мовою, додають товари в кошик і надсилають замовлення з оплатою Cash або Online (Stripe). Замовлення з'являються на вашій панелі Замовлення Кафетерії протягом 3 секунд. Дивіться Меню для клієнтів.

Як увімкнути модуль Кафетерія?

Відкрийте Налаштування > Кафетерія і увімкніть Enable Кафетерій. Сервер автоматично використовує вашу ліцензію HandyCafe як авторизацію. Майстер створення запитає slug, відображуване ім'я, країну, валюту та часовий пояс. Дивіться Огляд Кафетерії і Як налаштувати Кафетерію.

Які мови підтримує меню для клієнтів?

Меню для клієнтів на handy.cafe/{slug} підтримує 24 мови. Перший візит підбирає найкращу відповідність із заголовка Accept-Language браузера. Клієнти можуть змінити мову будь-коли через перемикач угорі меню.

Чи працює Кафетерія без інтернету?

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

Старі клієнти

Чи підтримує HandyCafe мої старі клієнти V3 або V4?

Так. Увімкніть підтримку виконання в Налаштування > Старі клієнти, і сервер запустить listener-и на оригінальних старих портах (UDP 710/711, TCP 712, file transfer 717). Ваші наявні клієнти підключаться без змін на своєму боці. Вони з'являться в Панелі адміністратора з урізаним набором дій (Login, Logout, Add Time, Screenshot, Logoff, Reboot, Shutdown). Дивіться Клієнти старих версій.

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

Так. Два стеки протоколів використовують різні порти і не конфліктують. Ви можете змішувати старі та нові клієнти в тій самій LAN і керувати ними з тієї самої Панелі адміністратора.

Чи можу я перенести дані зі старішої інсталяції HandyCafe?

Так, на Windows. Відкрийте Налаштування > Старі клієнти, прокрутіть до Міграції бази даних і натисніть Start Migration. Імпортуються учасники, тарифи, товари, замовлення, транзакції та журнали. Оригінальні файли не змінюються і не видаляються. Якщо результат не такий, як очікували, натисніть Undo Migration, щоб відкотитися. Дивіться Як виконати міграцію зі старої інсталяції.

У чому різниця між варіантами протоколу STE та Standard?

STE (Smart/Turbo Edition) кадри містять 70-байтовий префікс license info; розмір кадру - 1337 байтів. Standard кадри не містять префікса; розмір кадру - 1267 байтів. Обирайте варіант, який відповідає тому, як збирався ваш старий сервер. Неправильний варіант призводить до втрати або помилкового читання кадрів.