HandyCafe Docs
owner cashier it-admin

Глосарій

Алфавітний довідник термінів, що використовуються в документації HandyCafe.


Панель адміністратора Головна панель моніторингу в HandyCafe Server. Вона показує всіх підключених клієнтів, їхні статуси та активні сеанси. Також на кожній картці клієнта є кнопки дій для керування сеансами та віддаленими операціями.

Комісійна ставка Відсоток, який використовується для позначення комісії за обробку платежів. Наприклад, 1% або 5%. Використовується в конфігурації способів оплати для визначення вартості прийому конкретного способу оплати.

Бінарний протокол Компактний формат кодування, який використовується для TCP-зв'язку між HandyCafe Server і клієнтами. Обраний за швидкість і малий розмір повідомлень порівняно з текстовими форматами.

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

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

Консоль Ігровий пристрій, наприклад PlayStation або Xbox, яким керує HandyCafe. Консолі підтримують сеанси, тарифи та використання учасниками так само, як клієнтські ПК, але не запускають програмне забезпечення HandyCafe Client. Їх відстежують за MAC-адресою.

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

Кібер-кафе / Cyber Cafe Бізнес, який надає публічний доступ до комп'ютерів та інтернету, зазвичай за погодинною оплатою. Також відомий як інтернет-кафе. HandyCafe керує всіма аспектами роботи кібер-кафе, включаючи сеанси, білінг і членство.

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

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

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

План залу Візуальний редактор у Кафетерії для розміщення столів на полотні. Підтримує кілька поверхів, перетягування та 3D-вид у диметричній перспективі. Кожен стіл належить рівно одному поверху. Дивіться Кафетерія > План залу.

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

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

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

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

Idle Стан клієнта, коли ПК підключений до сервера, але активного сеансу немає. У стані idle клієнт показує екран блокування (IdlePage) і чекає на початок сеансу, вхід учасника або адміністративну дію.

Клієнт старої версії Інсталяція HandyCafe V3 або V4, яка підключається до сучасного сервера через оригінальний старий протокол. Старі клієнти з'являються в Панелі адміністратора зі скороченим набором дій (Login, Logout, Add Time, Screenshot, Logoff, Reboot, Shutdown). Увімкніть підтримку виконання в Налаштування > Старі клієнти.

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

MAC-адреса Апаратний ідентифікатор мережевого інтерфейсу. HandyCafe використовує MAC-адреси, щоб унікально ідентифікувати клієнтів і консолі, навіть якщо їхні IP-адреси змінюються.

mDNS (Multicast DNS) Протокол автоматичного виявлення сервісів у локальних мережах. Клієнти HandyCafe оголошують свою присутність через mDNS, що дає змогу серверу знаходити їх без ручного налаштування IP.

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

Мінорні одиниці Найменша одиниця валюти, яка використовується внутрішньо для всіх фінансових розрахунків, щоб уникнути помилок округлення з плаваючою комою. Наприклад, USD використовує центи (1 долар = 100 мінорних одиниць), а JPY використовує йєни безпосередньо (1 йєна = 1 мінорна одиниця).

Множник Коефіцієнт, який застосовується до базової погодинної ставки в тарифному слоті розкладу. Множник 1.0 означає стандартну ставку. Множник 1.5 означає ставку на 50% вищу, наприклад у пікові години, а 0.5 означає половинну ціну, наприклад у непіковий період.

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

Online Стан клієнта під час активного сеансу. Коли клієнт online, він показує інтерфейс робочого столу (OnlinePage), що дає змогу користувачу запускати програми, переглядати сторінки та взаємодіяти з меню клієнта.

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

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

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

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

Роль Іменований набір дозволів, призначений обліковому запису касира. Ролі визначають, які дії може виконувати касир, наприклад запускати сеанси, керувати учасниками, переглядати звіти. Кілька касирів можуть мати одну й ту саму роль, а дозволи діють по всьому інтерфейсу.

Код безпеки 6-значний код, який генерується, коли персонал садить клієнта за стіл у Кафетерії. Клієнт вводить його після сканування QR столу, щоб довести фізичну присутність. Код хешується на сервері та спливає під час Закрити стіл або Закрити рахунок. Показати код відображає кешований відкритий текст, а Оновити QR створює новий код і робить попередню наклейку недійсною.

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

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

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

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

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

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

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

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

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

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

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