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