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 tienda ni franquiciado. 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 |
|---|---|---|
| Canal de tienda o colección de formación | Bouquet: un conjunto con nombre de canales, películas o series que concede un paquete | Bouquets, a partir de Streams y Movies / Series |
| Canal de tienda | 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ídeo de formación y de producto | Catálogo VOD: películas y series con temporadas y episodios, categorías y metadatos | Movies y Series, o la tarea de ingesta VOD |
| Pantalla de tienda o acceso del personal | 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 |
| Cuenta de franquiciado | 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 |
| Nodo regional | Nodos de streaming: servidores de borde registrados desde el panel, uno por sede o edificio | Servers → añadir un nodo, instalado por SSH |
| Pantallas o dispositivos por línea | Conexiones máximas de la línea: cuántos dispositivos pueden ver a la vez | Las conexiones máximas de la línea |
Requisitos previos
Lo que debes tener antes de instalar.
- Un servidor en la central (Ubuntu 22.04 o 24.04), el instalador y un servidor para cada región que tenga muchas tiendas y sea accesible desde ellas.
- El contenido del canal de tienda (un codificador o una fuente en bucle), las grabaciones de incorporación y de formación de producto y las pantallas o reproductores multimedia de las tiendas.
- Una decisión sobre la estructura de franquicias: qué regiones reciben un nodo y quién en cada franquiciado gestiona las líneas.
Despliegue de la infraestructura
Primero la central, después las regiones.
- Ejecuta el instalador en el servidor de la central y define la URL base de reproducción como una dirección a la que puedan acceder las tiendas, con TLS.
- Añade el canal de tienda en Emisiones y las grabaciones de formación en Películas, y compruébalos en el reproductor web.
- Registra un nodo por región 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 las tiendas de esa región.
- Crea una cuenta de socio para el equipo de contenido de la central con permisos para el catálogo y ninguno para las líneas de las tiendas.
Organización del contenido
El canal de tienda y la biblioteca de formación.
- Crea una emisión en directo para el canal de tienda y colócala en su propio bouquet.
- Crea categorías por tema y una serie por curso de formación, con un episodio por lección; añade un bouquet por puesto (personal de ventas, gerentes, recién incorporados).
- Crea un paquete para las pantallas de tienda y un paquete por puesto, cada uno con sus bouquets y con el periodo de acceso como duración.
- Da a los franquiciados los paquetes que pueden revender a sus tiendas y a su personal.
Configuración de socios (revendedores)
Una cuenta de socio por franquiciado.
- Crea un grupo con permisos limitados a líneas, sin cambios en el catálogo.
- Añade a cada franquiciado en Usuarios → añadir un revendedor, con ese grupo, sus paquetes y un saldo de créditos.
- Un franquiciado con varias regiones puede añadir un subrevendedor por región, cada uno con sus propias tiendas.
Configuración de las líneas de tienda y de personal
Una línea por pantalla y por empleado.
- Crea una línea por pantalla de tienda en Líneas → añadir con el nombre de la tienda y el paquete de tienda; el franquiciado hace lo mismo con sus propias tiendas.
- Define el máximo de conexiones como el número de pantallas de la tienda, y en dos para un empleado (sala de ventas y móvil).
- Vincula una línea de tienda a la dirección de la tienda cuando esta tenga una fija, para que las credenciales no funcionen en otro sitio.
- Configura una sola vez el reproductor de la pantalla (M3U, Xtream Codes API o la dirección del reproductor web) y guarda las credenciales en el expediente de la tienda.
Vídeo de formación y de producto
La biblioteca para el personal.
- Sube cada curso de formación como una serie y cada película de producto como una película, o ingiérelos con la tarea de ingesta VOD en la raíz multimedia.
- Coloca las grabaciones en el bouquet del puesto adecuado mediante sus categorías.
- Comprueba con una línea de prueba qué ve cada puesto antes de abrir la biblioteca a los franquiciados.
El canal de tienda
Un canal para todas las pantallas.
- Añade el canal de tienda como una emisión en directo, alimentada por el codificador de la central por RTMP o por una fuente en bucle.
- Activa catch-up para las sesiones de formación que salen en directo y sube la grabación a la biblioteca después.
- Los nodos de las regiones toman el canal una sola vez del origen y atienden a sus tiendas, de modo que los enlaces de las tiendas no se saturan.
Caducidad y renovación
El acceso sigue a la tienda o al contrato.
- Una línea caduca al final del periodo de su paquete; el franquiciado la renueva con un paquete o un crédito.
- Desactiva la línea de una tienda cerrada o de un empleado que se va.
- Suscribe el sistema de gestión de franquicias o de RR. HH. a los webhooks para ver las líneas que están a punto de caducar o que ya han caducado.
Integración con sistemas de franquicias o de RR. HH.
Los sistemas gestionan las líneas; el reproductor reproduce.
- Crea una clave de la Reseller API para el sistema de gestión de franquicias o de RR. HH.; llama a create_line, renew_line, enable_line y disable_line, con un identificador de petición en cada escritura.
- Usa un conector de comercio cuando factures el servicio a los franquiciados; cualquier otro sistema usa la Reseller API y los webhooks.
- No hay inicio de sesión único para los espectadores: el personal entra en el reproductor con las credenciales de su línea.
Consideraciones de seguridad
Mantén cada tienda en sus propias líneas.
- 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 la central; los franquiciados reciben un grupo de permisos limitado a sus propias líneas.
- Un límite de conexiones por línea, enlaces de reproducción firmados y con caducidad, y vinculación a dirección para las pantallas de tienda.
- Activa la copia de seguridad cifrada de la base de datos con una copia externa y usa el registro de auditoría para revisar los cambios de líneas y de catálogo.
Resolución de problemas
Las primeras comprobaciones habituales.
- Una pantalla de tienda está en negro: comprueba que su línea esté activada y no caducada, la vinculación a dirección y el límite de conexiones si un segundo dispositivo está usando la línea.
- Una región se entrecorta: comprueba el latido del nodo regional y que las tiendas se dirigen a él.
- Un franquiciado no puede crear líneas: comprueba su saldo de créditos, los permisos de su grupo y los paquetes que tiene asignados.
- El registro de auditoría muestra la dirección del proxy: define TRUSTED_PROXIES con el proxy y reinicia el panel.