Эти руководства сопоставляют понятия отрасли с объектами, которые в платформе есть сегодня (букеты, линии, пакеты, аккаунты реселлеров, ноды, API). Это концептуальные соответствия, а не отраслевые функции, и аккаунт реселлера — делегированный аккаунт, а не изолированный тенант.
Концептуальное соответствие
В панели ничто не называется номером или проживанием. Таблица показывает, какой объект какую роль играет; главы ниже настраивают их в этом порядке.
| В вашей отрасли | На платформе | Где в панели |
|---|---|---|
| Оператор отеля или авторизованный партнёр | Аккаунт реселлера: делегированная панель с кредитами, правами и собственными линиями | Users → добавить реселлера; Groups для его прав |
| Пакет каналов | Букет: именованный набор каналов, фильмов или сериалов, который открывает пакет | Bouquets, из Streams и Movies / Series |
| Номер или устройство | Линия: один доступ со своим пакетом, букетами, сроком действия, лимитом подключений и выводами | Lines → добавить, либо коды активации, либо Reseller API |
| Информационные видео отеля | VOD-каталог: фильмы и сериалы с сезонами и эпизодами, категориями и метаданными | Movies и Series либо задача загрузки VOD |
| Лицензированные телеканалы | Прямой канал: стрим со своими источниками, EPG и форматами вывода | Streams → добавить прямой стрим (URL источника или RTMP-поток) |
| Срок проживания | Срок действия линии, который продлевается пакетом, кредитом или через API | Срок действия линии и длительность пакета |
| Одна нода на здание или крыло | Ноды стриминга: edge-серверы, подключённые из панели, по одной на объект или здание | Servers → добавить ноду, установка по SSH |
Требования
Что подготовить до установки.
- Сервер в сети объекта (Ubuntu 22.04 или 24.04), установщик и адрес, до которого дотягиваются устройства в номерах.
- Потоки каналов, на которые у объекта есть права (URL для получения или RTMP), информационные видео отеля и устройства в номерах (приставки Android TV, приставки MAG или Enigma2, смарт-телевизоры с приложением-плеером или браузером).
- Возможность PMS вызывать HTTP API при заезде и выезде либо процедура для стойки регистрации, чтобы делать это в панели.
Развёртывание инфраструктуры
Центральный сервер и нода на каждое здание.
- Запустите установщик на центральном сервере; задайте базу воспроизведения на внутренний адрес объекта, чтобы номера оставались в локальной сети.
- Добавьте потоки каналов в Streams, а информационные видео в Movies; проверьте их в веб-плеере.
- Подключите ноду на каждое крыло или здание в Servers; панель установит её по SSH и направит на неё номера этого здания.
- Задайте лицензионный ключ на сервере; активация проходит на месте, и сервис работает без внешнего канала.
Организация контента
Пакеты каналов и видео отеля.
- Создайте по одному букету на пакет каналов (стандартные номера, люксы, конференции) из каналов объекта.
- Создайте букет видео отеля (приветствие, удобства, безопасность) и добавьте его в каждый пакет.
- Создайте по одному пакету на категорию номера с букетами, которые он открывает, и длительностью в один день: при заезде линия номера продлевается по одному разу за каждую ночь проживания (каждое продление добавляет длительность пакета), а при выезде отключается (глава 8).
- Упорядочьте каналы и задайте им логотипы, чтобы меню на телевизоре читалось хорошо.
Настройка партнёров (реселлеров)
Объект или оператор нескольких объектов как делегированный аккаунт.
- Создайте группу с правами только на линии (номера) и без изменений каталога.
- Добавьте стойку регистрации объекта или оператора как реселлера с этой группой и пакетами номеров.
- Оператор нескольких объектов получает по одному реселлеру на объект, у каждого свои номера и кредиты.
Настройка номеров (линий)
Одна линия на номер, названная его номером.
- Создайте по одной линии на номер в Lines, указав номер комнаты как имя и пакет категории номера.
- Задайте максимум подключений 1 (один телевизор) или числу экранов в номере.
- Привяжите линию к адресу устройства номера, если сеть выдаёт устройствам фиксированные адреса.
- Один раз настройте устройство (Xtream Codes API или M3U с учётными данными линии либо портал MAG / Enigma2); учётные данные остаются за номером.
Информационные видео отеля
Собственные видео объекта по запросу.
- Загрузите приветственные и информационные видео как фильмы, а версии объекта на разных языках — как отдельные записи или аудиодорожки.
- Поместите их в букет видео отеля, чтобы их получала каждая категория номеров.
- Обновляйте их из панели при каждом изменении информации; номера сразу видят новую версию.
Лицензированные телеканалы
Каналы объекта как прямые стримы.
- Добавьте каждый лицензированный канал в Streams с его потоком; включайте timeshift или catch-up только там, где это разрешает лицензия.
- Добавьте источник EPG, чтобы телепрограмма на телевизоре показывала передачи.
- Держите каналы с территориальными ограничениями в букетах, которые открывают только нужные пакеты.
Заезд, выезд и срок действия
Проживание как срок действия линии.
- При заезде включите линию номера и продлите её на срок проживания (PMS через API либо стойка регистрации в панели).
- При выезде отключите линию; новое проживание включает её снова, поэтому учётные данные никогда не покидают номер.
- Подпишите PMS или стойку регистрации на webhook, чтобы видеть включённые, отключённые и истёкшие линии.
Интеграция с PMS
Заезд и выезд управляют номерами.
- Создайте ключ Reseller API для PMS и храните его в конфигурации PMS.
- При заезде PMS вызывает action=enable_line и action=renew_line для линии номера с идентификатором запроса; при выезде — action=disable_line.
- Гостевое приложение (вызов персонала, уборка, экспресс-выезд, обслуживание номеров) и его связь с бэк-офисом входят в тариф Enterprise и определяются вместе с объектом.
Вопросы безопасности
Держите каналы внутри объекта.
- Держите базу воспроизведения и ноды в сети объекта; не открывайте в интернет ничего, что не нужно номерам.
- Одно подключение на номер, привязанное к устройству; подписанные ссылки истекают, поэтому скопированная ссылка перестаёт работать.
- Двухфакторный вход для панели; стойка регистрации получает ограниченную группу прав.
- Включите зашифрованное резервное копирование базы; учётные данные номеров хранятся в ней.
Устранение неполадок
Обычные первые проверки.
- В номере нет телевидения: проверьте, что линия включена и не истекла, затем учётные данные и адрес устройства.
- В номере пропал канал: проверьте букет пакета категории номера.
- Телевидение пропадает при сбое интернета: проверьте, что база воспроизведения и источники — внутренние адреса; внешние потоки зависят от внешнего канала.
- Вызов из PMS не проходит: проверьте ключ API, что записи выполняются через POST, и идентификатор запроса при повторах.