Эти руководства сопоставляют понятия отрасли с объектами, которые в платформе есть сегодня (букеты, линии, пакеты, аккаунты реселлеров, ноды, API). Это концептуальные соответствия, а не отраслевые функции, и аккаунт реселлера — делегированный аккаунт, а не изолированный тенант.
Концептуальное соответствие
В панели ничто не называется магазином или франчайзи. Таблица показывает, какой объект какую роль играет; главы ниже настраивают их в этом порядке.
| В вашей отрасли | На платформе | Где в панели |
|---|---|---|
| Канал магазина или обучающая коллекция | Букет: именованный набор каналов, фильмов или сериалов, который открывает пакет | Bouquets, из Streams и Movies / Series |
| Канал магазина | Прямой канал: стрим со своими источниками, EPG и форматами вывода | Streams → добавить прямой стрим (URL источника или RTMP-поток) |
| Обучающее и товарное видео | VOD-каталог: фильмы и сериалы с сезонами и эпизодами, категориями и метаданными | Movies и Series либо задача загрузки VOD |
| Экран магазина или доступ сотрудника | Линия: один доступ со своим пакетом, букетами, сроком действия, лимитом подключений и выводами | Lines → добавить, либо коды активации, либо Reseller API |
| Аккаунт франчайзи | Аккаунт реселлера: делегированная панель с кредитами, правами и собственными линиями | Users → добавить реселлера; Groups для его прав |
| Региональная нода | Ноды стриминга: edge-серверы, подключённые из панели, по одной на объект или здание | Servers → добавить ноду, установка по SSH |
| Экранов или устройств на линию | Максимум подключений линии: сколько устройств могут смотреть одновременно | Максимум подключений линии |
Требования
Что подготовить перед установкой.
- Сервер головного офиса (Ubuntu 22.04 или 24.04), установщик и сервер для каждого региона с большим числом магазинов, до которого они могут достучаться.
- Контент канала магазина (кодировщик или зацикленный источник), записи вводного обучения и обучения по продуктам и экраны или медиаплееры в магазинах.
- Решение по структуре франшизы: какие регионы получают ноду и кто у каждого франчайзи управляет линиями.
Развёртывание инфраструктуры
Сначала головной офис, затем регионы.
- Запустите установщик на сервере головного офиса и задайте базовый URL воспроизведения на адрес, доступный магазинам, за TLS.
- Добавьте канал магазина в Streams, а записи обучения — в Movies и проверьте их в веб-плеере.
- Зарегистрируйте ноду на каждый регион в разделе Servers; панель устанавливает её по SSH, либо нода регистрируется по одноразовому коду, и направляет на неё магазины этого региона.
- Создайте партнёрский аккаунт для контент-команды головного офиса с правами на каталог и без прав на линии магазинов.
Организация контента
Канал магазина и обучающая библиотека.
- Создайте прямой поток для канала магазина и поместите его в отдельный букет.
- Создайте категории по темам и сериал на каждый учебный курс, с серией на каждый урок; добавьте по одному букету на роль (продавцы, управляющие, новички).
- Создайте один пакет для экранов магазинов и по одному пакету на роль, каждый выдаёт свои букеты и несёт период доступа в качестве срока действия.
- Выдайте франчайзи пакеты, которые они вправе перепродавать своим магазинам и сотрудникам.
Настройка партнёров (реселлеров)
Один партнёрский аккаунт на франчайзи.
- Создайте группу с правами только на линии, без изменения каталога.
- Добавьте каждого франчайзи через Users → add a reseller, с этой группой, его пакетами и балансом кредитов.
- Франчайзи с несколькими регионами может добавить суб-реселлера на каждый регион, у каждого свои магазины.
Настройка линий магазинов и сотрудников
Линия на каждый экран и на каждого сотрудника.
- Создайте по одной линии на экран магазина через Lines → add, указав название магазина и пакет магазина; франчайзи делает то же самое для своих магазинов.
- Задайте максимальное число подключений по числу экранов в магазине, а для сотрудника — два (торговый зал и телефон).
- Привяжите линию магазина к адресу магазина, если он фиксированный, чтобы учётные данные не работали в другом месте.
- Один раз настройте плеер экрана (M3U, Xtream Codes API или адрес веб-плеера) и храните учётные данные в деле магазина.
Обучающее и товарное видео
Библиотека для сотрудников.
- Загрузите каждый обучающий курс как сериал, а каждый ролик о товаре как фильм либо загрузите их заданием VOD ingest в медиакаталог.
- Через категории поместите записи в букет нужной роли.
- Проверьте, что видит каждая роль, с тестовой линией, прежде чем открывать библиотеку франчайзи.
Канал магазина
Один канал для всех экранов.
- Добавьте канал магазина как прямой поток, питаемый кодировщиком головного офиса по RTMP или зацикленным источником.
- Включите catch-up для тренингов, идущих в прямом эфире, и затем загрузите запись в библиотеку.
- Ноды в регионах забирают канал у origin один раз и обслуживают свои магазины, поэтому каналы связи магазинов не перегружаются.
Срок действия и продление
Доступ следует за магазином или договором.
- Линия истекает в конце периода своего пакета; франчайзи продлевает её пакетом или кредитом.
- Отключите линию закрытого магазина или уходящего сотрудника.
- Подпишите систему управления франшизой или HR-систему на webhooks, чтобы видеть линии, которые скоро истекут или уже истекли.
Интеграция с системами франшизы или HR
Системы управляют линиями, плеер воспроизводит.
- Создайте ключ Reseller API для системы управления франшизой или HR; она вызывает create_line, renew_line, enable_line и disable_line с идентификатором запроса при каждой записи.
- Используйте торговый коннектор, когда вы выставляете франчайзи счета за сервис; любая другая система использует Reseller API и webhooks.
- Единого входа (SSO) для зрителей нет: сотрудники входят в плеер с учётными данными своей линии.
Вопросы безопасности
Держите каждый магазин на его собственных линиях.
- Отдавайте панель за reverse proxy с TLS и задайте TRUSTED_PROXIES, чтобы журнал аудита и IP-правила видели реальные адреса.
- Двухфакторный вход для каждого аккаунта головного офиса; франчайзи получают группу прав, ограниченную их собственными линиями.
- Лимит подключений на линию, подписанные и истекающие ссылки воспроизведения и привязка к адресу для экранов магазинов.
- Включите зашифрованную резервную копию базы данных с копией вне площадки и просматривайте изменения линий и каталога в журнале аудита.
Устранение неполадок
Обычные первые проверки.
- Экран магазина чёрный: проверьте, что его линия включена и не истекла, привязку к адресу и лимит подключений, если линией пользуется второе устройство.
- Регион буферизует: проверьте heartbeat региональной ноды и то, что магазины направлены на неё.
- Франчайзи не может создавать линии: проверьте его баланс кредитов, права его группы и назначенные ему пакеты.
- Журнал аудита показывает адрес прокси: укажите прокси в TRUSTED_PROXIES и перезапустите панель.