Эти руководства сопоставляют понятия отрасли с объектами, которые в платформе есть сегодня (букеты, линии, пакеты, аккаунты реселлеров, ноды, API). Это концептуальные соответствия, а не отраслевые функции, и аккаунт реселлера — делегированный аккаунт, а не изолированный тенант.
Концептуальное соответствие
В панели ничто не называется отделом или сотрудником. Таблица показывает, какой объект какую роль играет; главы ниже настраивают их в этом порядке.
| В вашей отрасли | На платформе | Где в панели |
|---|---|---|
| Обучающая коллекция отдела | Букет: именованный набор каналов, фильмов или сериалов, который открывает пакет | Bouquets, из Streams и Movies / Series |
| Обучающие материалы | VOD-каталог: фильмы и сериалы с сезонами и эпизодами, категориями и метаданными | Movies и Series либо задача загрузки VOD |
| Доступ сотрудника | Линия: один доступ со своим пакетом, букетами, сроком действия, лимитом подключений и выводами | Lines → добавить, либо коды активации, либо Reseller API |
| Внутренняя обучающая сессия | Прямой канал: стрим со своими источниками, EPG и форматами вывода | Streams → добавить прямой стрим (URL источника или RTMP-поток) |
| Интеграция с HR или LMS | Reseller API и webhook: операции панели из вашей собственной системы | Ключи Reseller API и webhook в панели реселлера |
| Устройств на сотрудника | Максимум подключений линии: сколько устройств могут смотреть одновременно | Максимум подключений линии |
Требования
Что подготовить до установки.
- Сервер компании (Ubuntu 22.04 или 24.04), доступный из офисов, установщик и внутренний адрес либо домен за вашим reverse proxy.
- Обучающие записи, энкодер актового зала для прямых сессий и возможность HR-системы или LMS вызывать HTTP API.
- Решение по конфиденциальности: какой материал в какую коллекцию отдела попадает и кто в HR и в команде обучения получает аккаунт панели.
Развёртывание инфраструктуры
Сначала головной офис, затем офисы.
- Запустите установщик на сервере головного офиса; поставьте панель за reverse proxy компании и задайте доверенные прокси, чтобы журнал аудита видел реальные адреса.
- Задайте базу воспроизведения на внутренний адрес; сотрудники вне сети попадают на неё через VPN или прокси.
- Подключите ноду на каждый офис в Servers; панель установит её по SSH и направит на неё зрителей этого офиса.
- Создайте аккаунт реселлера для команды обучения с правами на каталог и без прав на линии сотрудников.
Организация контента
Коллекции по отделам, курсы как сериалы.
- Создайте категории по темам и по одному сериалу на многосерийный курс, по одному эпизоду на сессию.
- Создайте по одному букету на обучающую коллекцию отдела и букет для всех сотрудников с материалами, которые видят все.
- Создайте по одному пакету на роль: нужные этой роли букеты и никаких других, с большой длительностью (например, год) как периодом доступа; продление добавляет ещё один период, а HR отключает линию, когда контракт заканчивается.
- Чётко помечайте конфиденциальные коллекции в названиях; линия видит только букеты, которые открывает её пакет.
Настройка партнёров (реселлеров)
Команда обучения и, для группы компаний, каждая дочерняя компания.
- Создайте группу с правами на каталог для команды обучения и группу с правами на линии для HR.
- Добавьте команду обучения и HR как реселлеров с этими группами; ни одному не нужны кредиты во внутреннем развёртывании.
- Дочерняя компания с собственной библиотекой получает своего реселлера, свои букеты и свои пакеты.
Настройка доступа сотрудников
Одна линия на сотрудника, из HR.
- Создайте ключ Reseller API для HR-системы и храните его в секретах HR-системы.
- При найме HR-система вызывает action=create_line с пакетом роли и идентификатором запроса (длительность пакета — период доступа); при увольнении — action=disable_line.
- Задайте максимум подключений равным числу устройств, которыми может пользоваться сотрудник (обычно два: рабочий стол и телефон).
- Для пилота добавьте линии через Lines → добавить и передайте учётные данные нескольким сотрудникам.
Обучающие материалы
Записи по запросу.
- Загрузите каждую запись как источник эпизода или загрузите её задачей загрузки VOD; оставьте название и краткое описание.
- Привяжите запись к нужному букету отдела через её сериал.
- Проверьте воспроизведение с тестовой линией каждой роли, чтобы убедиться, кто что видит.
Внутренние обучающие сессии
Сессия как прямой канал.
- Добавьте прямой стрим для энкодера актового зала (RTMP-публикация); поместите его в букет для всех сотрудников или в букет отдела.
- Включите catch-up, чтобы опоздавшие могли перемотать назад, а запись потом загрузите в библиотеку.
- Ноды в офисах один раз забирают сессию с origin и обслуживают своих сотрудников локально.
Срок действия доступа
Доступ заканчивается вместе с контрактом.
- Линия истекает в конце периода своего пакета; пока контракт действует, HR продлевает её через action=renew_line, а когда контракт заканчивается, HR отключает её.
- Подпишите HR-систему на webhook, чтобы сверять истекающие и истёкшие линии с её собственными записями.
- Для временного доступа (подрядчики, неделя адаптации) используйте короткий срок действия, а не отдельный пакет.
Интеграция с HR или LMS
Системы управляют доступом; плеер воспроизводит.
- HR создаёт, продлевает и отключает линии через Reseller API; LMS может ссылаться на веб-плеер со страницы курса.
- Единого входа для зрителей нет: сотрудник входит в плеер с учётными данными линии, которые выдала ваша система.
- Используйте ключи Admin API с флагом «только чтение» для внутренних инструментов отчётности.
Вопросы безопасности
Конфиденциальность от сети до линии.
- Держите платформу во внутренней сети или за reverse proxy с TLS; соответственно задайте TRUSTED_PROXIES.
- Двухфакторный вход для каждого аккаунта панели; группы прав, чтобы HR не мог менять каталог, а команда обучения не видела линии.
- Подписанные и истекающие ссылки воспроизведения, низкий лимит подключений на линию и привязка к адресу там, где устройства фиксированные.
- Зашифрованные резервные копии базы с внешней копией; журнал аудита для каждого изменения линий и каталога.
Устранение неполадок
Обычные первые проверки.
- Сотрудник видит материалы другого отдела: проверьте пакет линии и открываемые им букеты.
- У нового сотрудника нет доступа: проверьте, что вызов HR прошёл успешно (журнал вызовов Reseller API), и срок действия линии.
- Офис буферизует во время прямой сессии: проверьте heartbeat ноды офиса и что зрителей направляют на неё.
- Журнал аудита показывает адрес прокси: задайте TRUSTED_PROXIES на прокси и перезапустите панель.