Терминал 8Ball POS — настройка и управление

Руководство для владельцев и администраторов клуба: как с нуля настроить терминал (касса на стойке), подключить оборудование и облако, завести справочники и вести смену.

Терминал — это десктоп-приложение (Windows/macOS), которое работает локально (своя база на месте) и синхронизируется с облаком (бекофис, отчёты, Telegram, публичные брони). Управление светом столов идёт через USB-контроллер PowerAnt (RS-232).

• Язык: русский. Валюта по умолчанию — BYN.
• Облако (бэкенд): https://billiard-backend.vercel.app
• Бекофис: https://billiard-backoffice.vercel.app

Параллельно с этим документом в самом приложении есть встроенная справка: раздел Инструкции в меню (Начало работы, Смена, Столы, Клиенты и лояльность, Печать, Инвентарь, Продажи и отчёты, Telegram-бот). Этот гайд — про настройку и администрирование; встроенные инструкции — про ежедневные операции.

#1. Роли и вход

Вход на терминал — по PIN-коду (4–8 цифр, экранная или физическая клавиатура).

Заводские PIN при первом запуске базы:

Сразу смените заводские PIN (раздел Пользователи) — это первое, что нужно сделать. Сброс всего состояния = удалить файл базы billiard-echo.db из папки данных приложения (userData).

Меню слева (зависит от роли):

• Основное (все роли): 🎱 Игровые столы, 📋 Смена, 🗓 Бронирования, ⚖️ Штрафы, 📖 Инструкции.
• Управление (владелец/админ): 🧾 Продажи, 🧑‍💼 Клиенты, 🏓 Остаток, 📚 Журнал смен, 📝 Журнал событий, 🔌 COM-порт / Свет, ⚙️ Настройки (только владелец).

Внизу боковой панели — индикаторы состояния смены (открыта/закрыта, номер) и COM-порта (подключён/нет, имя порта), а также профиль и выход.

#2. Первый запуск: активация терминала

При первом запуске (терминал ещё не привязан к клубу) — два варианта:

#Вариант А. «Активировать существующий» (по лицензионному ключу)

Если поставщик уже создал клуб и выдал ключ:

1. Выберите «Активировать существующий».
2. URL бэкенда — https://billiard-backend.vercel.app (подставлен по умолчанию).
3. Лицензионный ключ — вида ECHO-XXXX-XXXX (поле само форматирует ввод).
4. После успеха увидите название клуба и «Лицензия до …».

#Вариант Б. «Зарегистрировать новый клуб» (самообслуживание)

Мастер из 3 шагов — заводит новый клуб и пробную лицензию:

1. Подключение: URL бэкенда, название клуба (из него предлагается slug), slug публичной страницы броней (латиница, цифры, дефис, напр. 8ball-center), инвайт-код (если требует поставщик).
2. Реквизиты: юр.название, страна (по умолч. Беларусь), город, юр.адрес, УНП, валюта (BYN), email, телефон, сайт, время окончания смены (по умолч. 03:00).
3. Карточка: краткое описание для страницы броней, URL логотипа (с предпросмотром), приём онлайн-броней (вкл по умолчанию).

После завершения клуб создаётся, выдаётся пробная лицензия, клуб появляется в каталоге броней.

Подробный «под ключ»-сценарий подключения клуба к облаку (с device-токеном и Telegram) описан в docs/backoffice-onboarding.md.

#3. Облачная синхронизация

Настройки → Синхронизация. Без облака терминал работает, но не будет ни отчётов в бекофисе, ни публичных броней, ни облачного Telegram-бота.

1. Включите синк.
2. URL бэкенда: https://billiard-backend.vercel.app.
3. Device-токен: вставьте токен, выданный поставщиком (выпускается в бекофисе: Клубы → Терминалы → «Выпустить токен», показывается один раз) → Сохранить.
4. Нажмите «Проверить» — покажет связь и расхождение часов (ms). Статус станет «Облачный синк активен».

При первом синке:

• вверх уезжают существующие клиенты/тарифы/сессии (бэкфилл);
• вниз тянется облачный конфиг (для клиентов — двусторонне, по правилу «кто позже изменил»);
• если включён облачный Telegram-бот, локальный long-polling выключается.

Режим терминала: «Управление» (полный) или «Kiosk» (если включён режим киоска).

#4. Оборудование: COM-порт и свет (PowerAnt)

Меню → 🔌 COM-порт / Свет. Нужен для управления светом над столами. Без железа большинство функций работает, но реальный свет включаться не будет.

#Подключение

1. В блоке Подключение выберите порт из списка (кнопка 🔄 Обновить обновляет список).
2. Выберите скорость: 9600 (стандарт PowerAnt) / 19200 / 38400 / 115200.
3. Нажмите 🔌 Подключить. Статус станет зелёным: «Подключён · COMx».
4. Диагностика (когда подключено): 🔍 Опросить (??), 📣 Широковещательно (!??), ?= Состояние, Отключить.

#Определитель реле (сопоставление «реле ↔ стол»)

Появляется при подключении. Сетка кнопок A–H — клик включает/выключает свет на конкретном реле (=A вкл / =a выкл). Так вы определяете, какая буква соответствует какому столу в зале, и затем проставляете буквы при настройке столов. Кнопка «Выключить включённые» гасит всё, что включали этим инструментом.

Ниже — лог соединения (последние 200 строк: → отправка, ← приём, ⚠ ошибка) и справочник протокола PowerAnt (??↵ опрос, =A↵/=a↵ вкл/выкл, +=↵ успех).

#5. Настройки (только владелец)

Раздел ⚙️ Настройки разбит по секциям:

• Заведение: название клуба (только чтение — меняется в бекофисе).
• Оформление: тема Ночная (Casino Noir) / Дневная (живой предпросмотр); формат отображения валюты (символ / код / без символа).
• Печать: режим — выкл / TCP/ESC-POS (термопринтер по сети: host + порт 9100) / Системный (выбор принтера из списка ОС). Ширина 58 мм (32 симв.) или 80 мм (48 симв.), автопечать чека. Кнопка «Тестовый чек».
• Фискальная касса (iKassa): включение, облачный режим, host, порт (по умолч. 37015), PIN, имя кассира. Кнопки «Найти кассу» и «Проверить связь».
• Синхронизация: см. раздел 3.
• Рабочие переключатели: режим Kiosk (вступает в силу после перезапуска), буквы реле.
• Лицензия: статус (пробная/платная) и срок; «Запросить продление» (с комментарием) — заявка уходит поставщику.
• Система: версия приложения, разработчик, «Открыть логи».

#6. Пользователи (PIN-доступ)

Управление учётными записями сотрудников терминала.

• Список с аватарами и ролью; у себя — метка «(это вы)».
• Новый/Изменить: имя, роль (Владелец / Администратор / Оператор), PIN 4–6 цифр (при правке пусто = не менять).

Ограничения: админ не может создавать владельцев и не может удалять владельца; себя удалить нельзя. Эти же пользователи редактируются и в бекофисе (раздел Пользователи) и синхронизируются.

#7. Столы и тарифы

#Тарифы (📋 в «Управлении» / страница Тарифы)

• «Создать тариф»: название, цена за час (в валюте клуба), цвет, время действия (HH:MM–HH:MM, пусто = круглосуточно), дни недели (пусто = каждый день), столы (на каких применяется).
• Оба поля времени заполняются вместе или оба пустые.
• В списке расписание читается как «HH:MM–HH:MM · Пн, Вт, Чт» либо «круглосуточно / каждый день».

#Столы

Назначьте каждому столу букву реле (A–H, определённую через «Определитель реле» — см. раздел 4), тип игры и доступные тарифы. Справочник столов и тарифов синхронизируется с бекофисом — там же его можно редактировать.

#8. Штрафы

⚖️ Штрафы. Сумма штрафа = базовая величина × множитель.

• Базовая величина — задаёт владелец/админ (оператор только видит). От неё считаются все штрафы.
• Каталог штрафов: название + множитель (Nх базовой) → авторасчёт суммы. Создание/правка/удаление — владелец/админ.
• Применяется штраф к клиенту со страницы Клиенты (выбор из каталога + комментарий).

#9. Товары / инвентарь (🏓 Остаток)

Каталог управляется в бекофисе (цена, залог, расходник, активность). На терминале видно текущий остаток и его можно править (кнопка «Изменить» → число → ОК). Выдача/возврат инвентаря клиенту происходит в окне оплаты на столе (см. ниже): выбор товара → количество → «Выдать» (плюс залог), позже «Вернуть» (залог возвращается).

#10. Лояльность и клиенты

• Лояльность: уровни (порог суммы → скидка % и начисление бонусов %) и акции (временные скидки/бонусы с расписанием и периодом). Обычно настраивается в бекофисе и синхронизируется.
• Клиенты: поиск по имени/телефону/карте; карточка (имя, телефон, код карты, QR, заметки); персональная скидка (с причиной), корректировка бонусов, начисление штрафа. История по клиенту в 3 вкладках: бонусы, сессии (с экспортом CSV), штрафы.

#11. Ежедневная работа

#Смена (📋 Смена)

• Открыть смену: введите «Внесение в кассу» (остаток налички с прошлой смены) → ▶ Открыть смену. При открытии терминал проверяет связь с облаком.
• В открытой смене видно: номер, время и кто открыл, внесение, и статистику (сессии, выручка, наличные, безнал) + список сессий.
• X-отчёт (промежуточный) — кнопка 🧾 X-отчёт: итоги без закрытия смены, с печатью.
• Закрыть смену: показывается «К изъятию (наличные в кассе)» → введите сумму инкассации → ⏹ Подтвердить закрытие. Если смена открыта >24 ч — предупреждение с быстрым закрытием.

#Игровые столы (🎱)

Сверху — число активных столов, включённого света и текущая выручка.

• ▶ Старт: выбор тарифа (если действует несколько) и длительности. Варианты: пресеты 15/30/45/60/90/120 мин, своё число минут, 💰 По сумме (вводите сумму — система считает время по тарифу), ∞ Открытая игра.
• ▶+ Продлить: +15 / +30 / +60 мин.
• 💳 Оплатить / ⏹ Стоп: окно оплаты — метод (Наличные / Безнал / Сборная), сумма (авторасчёт), лояльность (поиск клиента, скидки/бонусы; персональная скидка требует PIN админа), 🎱 Инвентарь (выдача/возврат), 🖨 Печать чека, ✓ Подтвердить оплату.
• ⚙ Сервис: сервисный режим стола (свет включён, игра заблокирована — для обслуживания).
• Когда время истекло — карточка краснеет, пульсирует и звучит сигнал (повтор каждые 30 с).

#Бронирования (🗓)

Список броней (имя, телефон, стол, время, статус, источник: Терминал/Сайт/Бэкофис/Telegram). Подтвердить / Отмена; «Новая бронь» — стол, имя, телефон, дата, время с/до, тип игры, заметки. Список обновляется каждые 60 с, новые брони показываются всплывающим уведомлением со звуком.

#12. Отчёты и журналы

• 🧾 Продажи: вкладки Чеки (фильтры: номер/период/стол), Выручка (по дням), Методы оплаты, Z-Отчёты (по сменам, с печатью Z-отчёта).
• 📚 Журнал смен: карточки смен с итогами (всего смен, выручка, нал, безнал).
• 📝 Журнал событий: лог действий. Оператор видит события текущей смены; владелец/админ — последние 500 событий, с кнопкой «Очистить».

#13. Telegram-бот (✈️)

Меню → Telegram. Статус интеграции, имя клуба (для заголовков сообщений), Bot Token (из @BotFather), Chat ID, и переключатели уведомлений (открытие/закрытие смены, изменение тарифа). Кнопки «Отправить тест» и «Проверить» (валидирует токен и тянет имя бота).

При активном облачном синке ботом управляет облако (вебхук); команды бота настраиваются на стороне бэкенда.

#14. Печать чеков

В Настройки → Печать выберите режим (TCP/ESC-POS или системный), ширину (58/80 мм) и при желании автопечать на подтверждении оплаты. Кнопка «Тестовый чек» проверяет печать. Чек содержит шапку (логотип, название клуба, УНП, номер чека, дату, оператора), тело (стол, тариф, время, метод оплаты, скидка) и итог. X-отчёт печатается со страницы Смена, Z-отчёт — из раздела Продажи.

#15. Лицензия и продление

Статус и срок лицензии — в Настройки → Лицензия. Предупреждения:

• за ≤14 дней — баннер «Лицензия истекает через N дн.»;
• за ≤3 дней — окно при запуске;
• по истечении — красный баннер «Доступ ограничен: срок лицензии истёк» + контакты поддержки, ключевые действия (открыть смену, старт игры) блокируются.

Продление: Настройки → Лицензия → «Запросить продление» (можно с комментарием) — заявка уходит поставщику, который одобряет её в бекофисе (раздел Лицензии).

#16. Режим киоска (Kiosk)

Включается в Настройки → Рабочие переключатели → Kiosk (вступает в силу после перезапуска). Экран блокируется поверх; для разблокировки — клик и ввод PIN администратора. Удобно для точек самообслуживания, чтобы клиенты не лезли в управление.

#Чек-лист настройки нового терминала

1. Активировать терминал (ключ или регистрация нового клуба) — раздел 2.
2. Включить и проверить облачный синк — раздел 3.
3. Подключить COM-порт / PowerAnt, определить реле — раздел 4.
4. Настроить печать и (при наличии) фискальную кассу — разделы 5 и 14.
5. Сменить заводские PIN и завести сотрудников — раздел 6.
6. Завести столы (буквы реле) и тарифы (расписание) — раздел 7.
7. Настроить штрафы, лояльность, проверить остаток товаров — разделы 8–10.
8. (Опц.) Подключить Telegram-бот — раздел 13.
9. Открыть тестовую смену, запустить/оплатить стол, напечатать чек — проверить связку целиком.

Бекофис 8Ball — руководство владельца клуба

Бекофис — это облачная веб-админка для владельца клуба: дашборды, отчёты, CRM, лояльность и настройка справочников (тарифы, столы, товары). Терминал в клубе работает локально и синхронизируется с этим же облаком, поэтому изменения, сделанные здесь, прилетают на терминал, а продажи/смены с терминала — сюда.

• Адрес: https://billiard-backoffice.vercel.app
• Открывается в браузере (Chrome / Edge / Safari) на любом устройстве — компьютере, планшете, телефоне.
• Язык интерфейса: русский. Валюта по умолчанию — BYN.

Что делает поставщик (супер-администратор), а что — владелец, разведено намеренно. Регистрация клуба, выпуск лицензий и токенов терминалов — зона поставщика (см. раздел «Для поставщика» в конце). Всё остальное в этом документе — для вас, владельца.

#1. Вход

1. Откройте https://billiard-backoffice.vercel.app.
2. На экране «8Ball Бекофис — Вход для сотрудников клуба» введите email и пароль, которые вам выдал поставщик при подключении клуба.
3. Нажмите Войти.

Если данные неверны — увидите «Неверный email или пароль». Сессия сохраняется в браузере; кнопка выхода — справа вверху рядом с вашим именем.

#Роли в бекофисе

Вы всегда работаете в контексте своего клуба — переключателя клубов у владельца нет (он есть только у поставщика).

#Лицензия — что вы видите

Сверху может появляться баннер о состоянии лицензии:

• зелёный/без баннера — всё в порядке;
• жёлтый — лицензия истекает в ближайшие 14 дней, пора продлевать;
• красный — срок истёк, доступ к данным ограничивается.

Продление лицензии запрашивается с терминала (Настройки → Лицензия → «Запросить продление») и одобряется поставщиком. Контакты поддержки показываются прямо в баннере.

#2. Что где в меню

Меню слева разбито на два блока:

Основное (день-в-день):

• Дашборд — сводка за текущий месяц.
• Отчёты — отчёт за период и детализация смены (X/Z).
• Финансы — счета на оплату от поставщика.
• Бронирования — заявки на брони столов.
• Смены — список и детализация смен.
• Журнал — лог событий (аудит).

Конфигурация (справочники, меняются редко):

• Тарифы, Столы, Лояльность, Клиенты, Остаток (товары/инвентарь), Пользователи (PIN-доступ к терминалу), Настройки, Telegram.

#3. Дашборд

Открывается первым. Показывает ключевые цифры за текущий месяц (с 1-го числа до сейчас): выручка, наличные, безнал, число сессий, скидки, потраченные бонусы. Отдельно — бонусные обязательства лояльности: сколько клиентов и на какую сумму накоплено бонусов (это ваш «долг» перед клиентами).

Фильтров на дашборде нет — для произвольного периода идите в Отчёты.

#4. Отчёты

#Отчёт за период

1. Выберите даты с и по (конец дня включительно).
2. Нажмите построить.

Получите:

• сводку (выручка, наличные, безнал, сессии, скидки, бонусы);
• разбивку по тарифам, по столам, по операторам (количество, сумма, доля %);
• столбчатый график по дням.

#Детализация смены (X/Z-отчёт)

Введите номер/идентификатор смены — получите карточку смены: когда открыта/закрыта, кто открыл/закрыл, сумма внесения и инкассации, итоги (выручка, нал, безнал, сессии, скидки, бонусы), список сессий и разбивку по тарифам и столам. То же доступно по клику в разделе Смены.

#5. Смены

Список закрытых и открытых смен за выбранный период: номер, время открытия/закрытия, оператор, выручка, инкассация, нал/безнал. Клик по строке раскрывает полную карточку смены (см. X/Z выше). Открытая смена помечена статусом «Открыта» (это X-отчёт), закрытая — «Закрыта» (Z-отчёт).

#6. Финансы (счета)

Здесь видны счета на оплату, которые выставляет поставщик (например, за лицензию/обслуживание): номер счёта, назначение, сумма к оплате, статус (оплачен/ожидает), номер платёжки, дата и сумма платежа, прикреплённый акт (PDF).

Для владельца это раздел для просмотра: создание счетов, ввод оплат и загрузка актов — на стороне поставщика. Зелёным помечены оплаченные счета, жёлтым — ожидающие оплаты.

#7. Бронирования

Заявки на брони столов из всех источников (сайт, Telegram, бекофис, терминал).

• Фильтры: период (по умолчанию сегодня … +14 дней) и статус (все / ожидает / подтверждена / активна / завершена / отменена / неявка).
• Таблица: время, имя клиента, телефон, стол, тип игры, статус, источник.
• Действия по заявке:
  • Подтвердить (для «ожидает») → статус «подтверждена»;
  • Неявка / Отмена (для ожидающих/подтверждённых);
  • Удалить (корзина).

#Создать бронь вручную

Кнопка «Новая бронь» → форма:

• имя клиента (обязательно), телефон (обязательно, минимум 5 цифр);
• тип игры: любой / русский / пул;
• стол: автоподбор или выбрать вручную;
• начало (дата и время) и длительность (60 / 90 / 120 / 180 / 240 мин).

#8. Журнал событий

Аудит-лог: время, тип события, сообщение, сотрудник. Фильтры — период (по умолчанию 7 дней) и тип (все / смена / синхронизация / тариф / товары / клиент). Удобно, чтобы посмотреть «кто что менял».

#9. Тарифы

Цена за час и расписание действия тарифа. Эти тарифы синхронизируются на терминал и применяются при старте игры.

• Список: название (с цветовой меткой), цена/час, временное окно, дни недели.
• «Новый тариф» / иконки правки и удаления.

#Форма тарифа

• Название (обязательно), цена за час, цвет.
• Расписание (галочка): включите, чтобы ограничить тариф по времени (с HH:MM до HH:MM) и дням недели; без галочки тариф действует круглосуточно и всю неделю.

Какие тарифы доступны на конкретном столе — задаётся на странице Столы.

#10. Столы

Игровые столы клуба и их привязка к реле PowerAnt (управление светом над столом).

• Список: название, буква реле (A–H), тип игры, позиция, тариф по умолчанию.
• «Новый стол» / правка / удаление.

#Форма стола

• Название (обязательно).
• Реле — буква из доступных (по умолчанию A–H); если буква уже занята, показывается, за каким столом она закреплена.
• Позиция — порядок в зале (необязательно).
• Тип игры — универсальный / русский / пул.
• Тариф по умолчанию (необязательно).
• Разрешённые тарифы — какие тарифы можно выбрать на этом столе (множественный выбор).

Чтобы точно сопоставить «буква реле ↔ конкретный стол», используйте «Определитель реле» на терминале (страница COM-порт / Свет): он по очереди включает свет на столах.

#11. Лояльность

Две вкладки.

#Уровни

Накопительные уровни клиента: название, порог (сумма потраченного, чтобы достичь уровня), скидка %, начисление бонусов %, цвет, порядок. Клиент автоматически поднимается по уровням по мере роста суммы покупок.

#Акции (промо)

Временные скидки/повышенные бонусы:

• скидка % и бонус %;
• расписание (с HH:MM до HH:MM, дни недели — необязательно);
• период действия (с даты по дату — необязательно, пусто = бессрочно);
• переключатель «Промо включено».

#12. Клиенты (CRM)

• Поиск по имени / телефону / коду карты.
• Список: имя, телефон, уровень лояльности, персональная скидка %, баланс бонусов.
• «Новый клиент» и по каждой строке — корректировка бонусов, штрафы, правка, удаление.

#Карточка клиента

Имя (обязательно), телефон, уровень лояльности, код карты, QR-код, персональная скидка % с комментарием-причиной, заметки.

#Корректировка бонусов

Кнопка корректировки → введите сумму (положительная — начислить, отрицательная — списать) и комментарий. История изменений сохраняется.

#Штрафы клиента

Просмотр начисленных штрафов (синхронизируются с терминала): дата, название, комментарий, сумма и итог «Штрафов: N на сумму M».

#13. Остаток (товары/инвентарь)

Каталог товаров и инвентаря, который выдаётся/продаётся на терминале (кии, мячи, напитки, и т.п.).

• Список: название (метка «расходник», если применимо), цена, залог, остаток, активность.
• «Новый товар» / правка / удаление.

#Форма товара

• Название (обязательно), цена, залог (для прокатных позиций), базовый остаток.
• Расходник — списывается при продаже и не возвращается.
• Активен — доступен на терминале.

#Отчёт по продажам товаров

Выберите период → итоги (выручка, количество), разбивка по товарам и по типу операции (выдача / возврат / расход / корректировка).

#14. Пользователи (PIN-доступ к терминалу)

Сотрудники, которые входят на терминале по PIN-коду.

• Список: имя, роль (Владелец / Администратор / Оператор).
• «Новый пользователь» / правка / удаление.

#Форма пользователя

• Имя (обязательно), роль, PIN — 4–8 цифр (при правке оставьте пустым, чтобы не менять).

Роли на терминале:

• Владелец — полный доступ, включая Настройки.
• Администратор — справочники, продажи, история, COM-порт; без раздела Настройки.
• Оператор — только запуск/остановка игр и текущая смена.

#15. Настройки

Карточка клуба и параметры, часть из которых уезжает на терминал и в публичный сайт броней.

• Карточка клиента (реквизиты): тип субъекта (ЮЛ / ИП / физлицо), контакты, юр.название и форма, УНП, банковские реквизиты, подписант, юридический и почтовый адреса, страна/город/сайт, код валюты, время окончания смены, формат отображения валюты (символ / код / без символа).
• Реле PowerAnt: список букв реле через пробел (по умолчанию A–H для 8 столов).
• Бронирования: приём онлайн-броней, название клуба, slug (адрес публичной страницы броней), описание, URL логотипа, шаг слота, мин/макс длительность брони, смещение от UTC, параметры SMS (отправитель, логин, пароль), часы работы.
• Прочие параметры: редактор «ключ-значение» для нетиповых настроек.

#16. Telegram-бот

Уведомления и бот лояльности для клуба.

• Токен бота (из @BotFather) и Chat ID (для группы — отрицательный).
• Уведомления: открытие смены, закрытие смены, изменение тарифа, новые брони.
• «Зарегистрировать вебхук» — привязывает бота к облаку (после добавления новых команд бота регистрацию нужно повторить).

При активной облачной синхронизации ботом управляет облако (вебхук), а локальный long-polling на терминале выключается.

#Для поставщика (супер-администратор)

Эти разделы видит только супер-администратор платформы (не владелец клуба). Сюда же относится переключатель клубов справа вверху.

#Клубы

• Список всех клубов, правка, мягкое удаление (клуб исчезает из списков, данные не стираются).
• «Новый клуб» — быстрая форма (название + часовой пояс) или мастер из 2 шагов:
  1. Клуб и каталог: название, slug (латиница), часовой пояс, онлайн-брони, описание, логотип.
  2. Реквизиты: организация, страна/город, юр.адрес, УНП, валюта, сайт, email, телефон, время окончания смены, формат валюты.
• Внутри клуба:
  • Терминалы — «Выпустить токен» (имя терминала → одноразовый токен, показывается один раз; его вставляют в Настройки терминала) и отзыв токена;
  • Сотрудники — добавление логинов бекофиса (email, пароль ≥6, имя, роль owner/admin/viewer).

#Лицензии

• Заявки на продление от терминалов — «Одобрить» с новой датой окончания.
• Ключи лицензий по клубу — «Выпустить ключ» с датой окончания (по умолчанию +1 год).
• Активные терминалы — ближайшая дата окончания лицензии и статус продления.

#Подключение нового клуба «под ключ»

Автоматизировано скриптом — см. docs/backoffice-onboarding.md: один запуск создаёт клуб, owner-логин, device-токен терминала и (опц.) настраивает Telegram-бота.

#Частые вопросы

• Изменил тариф/товар в бекофисе — почему не видно на терминале? Изменения приезжают при ближайшей синхронизации терминала. Убедитесь, что на терминале включён облачный синк и он активен.
• Продажи с терминала не видно в отчётах? Терминал заливает смены/сессии в облако при синке; проверьте связь на терминале (Настройки → Облачный синк → «Проверить»).
• Истекает лицензия. Продление запрашивается с терминала и одобряется поставщиком; следите за баннером и за разделом Финансы.
• Сбросить пароль входа в бекофис — обратитесь к поставщику (управление логинами — на его стороне).