Estas guías asignan los conceptos de un sector a los objetos que la plataforma tiene hoy (bouquets, líneas, paquetes, cuentas de socio, nodos, la API). Son correspondencias conceptuales, no funciones específicas de un sector, y una cuenta de socio es una cuenta delegada, no un inquilino aislado.
Correspondencia conceptual
Nada en el panel se llama apartamento ni residente. La tabla indica qué objeto cumple cada papel; los capítulos siguientes los configuran en ese orden.
| En tu sector | En la plataforma | Dónde en el panel |
|---|---|---|
| Cuenta del administrador de fincas | Cuenta de revendedor (reseller): un panel delegado con créditos, permisos y sus propias líneas | Users → añadir un revendedor; Groups para sus permisos |
| Parrilla de canales | Bouquet: un conjunto con nombre de canales, películas o series que concede un paquete | Bouquets, a partir de Streams y Movies / Series |
| Canal o canal de información | Canal en directo: un stream con sus fuentes, EPG y formatos de salida | Streams → añadir un stream en directo (URL de origen o envío RTMP) |
| Vídeos de bienvenida y de avisos | Catálogo VOD: películas y series con temporadas y episodios, categorías y metadatos | Movies y Series, o la tarea de ingesta VOD |
| Acceso del apartamento | Línea: un acceso con su paquete, bouquets, caducidad, límite de conexiones y salidas | Lines → añadir, o códigos de activación, o la Reseller API |
| Periodo de alquiler u ocupación | Fecha de caducidad de la línea, renovada mediante un paquete, un crédito o la API | La fecha de caducidad de la línea y la duración del paquete |
| Nodo del edificio | Nodos de streaming: servidores de borde registrados desde el panel, uno por sede o edificio | Servers → añadir un nodo, instalado por SSH |
Requisitos previos
Lo que debes tener antes de instalar.
- Un servidor para la administración (Ubuntu 22.04 o 24.04), el instalador y un servidor para cada edificio que pueda acceder a la red de los residentes.
- Las señales de canales que la comunidad puede retransmitir (URL de extracción o RTMP), los avisos y vídeos de bienvenida de la administración y los dispositivos de los residentes (receptores, smart TV con una aplicación reproductora, o un navegador).
- Una decisión sobre los tipos de vivienda (estándar, para mayores, de estudiantes) y quién en la administración abre y renueva las líneas.
Despliegue de la infraestructura
El servidor central, después un nodo por edificio.
- Ejecuta el instalador en el servidor central y define la URL base de reproducción como una dirección a la que puedan acceder los edificios.
- Añade las señales de canales en Emisiones y los avisos en Películas, y compruébalos en el reproductor web.
- Registra un nodo por edificio desde Servidores; el panel lo instala por SSH, o el nodo se registra con un código de un solo uso, y dirige a él a los residentes de ese edificio.
- Añade al administrador de fincas en Usuarios → añadir un revendedor, con un grupo que permita líneas y ningún cambio en el catálogo.
Organización del contenido
Parrillas por tipo de vivienda.
- Crea un bouquet por parrilla con los canales de cada tipo de vivienda, y un bouquet para la información de la administración.
- Añade el bouquet de información a todos los paquetes para que cada residente reciba los avisos.
- Crea un paquete por tipo de vivienda con sus bouquets y una duración que coincida con el contrato de alquiler o el periodo de ocupación.
- Ordena los canales y ponles logotipos para que el menú de la televisión se lea bien.
Configuración de socios (revendedores)
El administrador de fincas como cuenta delegada.
- Crea un grupo con permisos limitados a líneas, sin acceso al catálogo ni a los servidores.
- Añade a cada administrador de fincas como revendedor con ese grupo, los paquetes de sus viviendas y un saldo de créditos.
- Un administrador de varios edificios puede añadir un subrevendedor por edificio, cada uno con sus propias viviendas y créditos.
Configuración de apartamentos (líneas)
Una línea por apartamento, con su número como nombre.
- Crea una línea por apartamento en Líneas → añadir, con el número del apartamento como nombre y el paquete de ese tipo de vivienda.
- Define el máximo de conexiones como el número de televisores de la vivienda.
- Usa un código de activación en lugar de una contraseña cuando el residente deba introducir un código corto en el dispositivo.
- Configura el dispositivo una sola vez (Xtream Codes API o M3U con las credenciales de la línea, o el portal MAG o Enigma2); las credenciales se quedan con el apartamento hasta que se dan otras nuevas a la línea.
Vídeos de bienvenida y de avisos
Los vídeos de la administración a la carta.
- Sube el vídeo de bienvenida, las normas de la casa y las guías de mantenimiento como películas, con una categoría por tema.
- Colócalos en el bouquet de información para que todos los paquetes los incluyan.
- Sustituye un vídeo desde el panel cuando cambie la información; los residentes ven la nueva versión al instante.
Canales y canal de información
La parrilla y el canal de avisos como emisiones en directo.
- Añade cada canal con licencia en Emisiones con su señal, y una fuente EPG para que la guía de la televisión muestre los programas.
- Añade el canal de información como una emisión en directo, alimentada por un codificador por RTMP o por una fuente en bucle, y colócalo en el bouquet de información.
- Mantén los canales con límites de territorio en bouquets que solo conceden los paquetes adecuados.
Entrada, salida y caducidad
La ocupación como validez de la línea.
- Una línea caduca al final del periodo de su paquete; renuévala con el paquete o con un crédito por cada nuevo periodo del alquiler.
- Cuando un residente se va, desactiva la línea; el siguiente residente la activa de nuevo con credenciales nuevas, así que nada se queda con el hogar anterior.
- Suscribe el sistema de viviendas o al administrador a los webhooks para ver las líneas que están a punto de caducar o que ya han caducado.
Integración con un sistema de viviendas o de facturación
Los sistemas abren el acceso; el reproductor reproduce.
- Crea una clave de la Reseller API para el sistema de viviendas o de facturación; llama a create_line, renew_line, enable_line y disable_line, y envía un identificador de petición con cada escritura.
- Usa un conector de comercio cuando los residentes compren paquetes adicionales en línea; cualquier otro sistema usa la Reseller API y los webhooks.
- No hay inicio de sesión único para los espectadores: un residente entra en el reproductor con las credenciales de la línea.
Consideraciones de seguridad
Mantén el servicio dentro de la comunidad.
- Sirve el panel detrás de un proxy inverso con TLS y define TRUSTED_PROXIES para que el registro de auditoría y las reglas de IP vean direcciones reales.
- Inicio de sesión en dos pasos para cada cuenta de administración; los administradores de fincas reciben un grupo de permisos limitado a líneas.
- Un límite de conexiones por línea, enlaces de reproducción firmados y con caducidad, y vinculación a dirección donde los dispositivos tienen direcciones fijas.
- Activa la copia de seguridad cifrada de la base de datos con una copia externa; las credenciales de las líneas están en ella.
Resolución de problemas
Las primeras comprobaciones habituales.
- Un apartamento no tiene televisión: comprueba que su línea esté activada y no caducada, y después las credenciales del dispositivo y la dirección de reproducción.
- Un edificio se entrecorta por la noche: comprueba el latido del nodo del edificio y que sus residentes se dirigen a él.
- Falta un canal para un tipo de vivienda: comprueba los bouquets de ese paquete.
- Un administrador no puede crear líneas: comprueba el saldo de créditos del revendedor, los permisos de su grupo y los paquetes que tiene asignados.