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 departamento o empleado. La tabla indica qué objeto desempeña qué papel; los capítulos siguientes los configuran en ese orden.
| En tu sector | En la plataforma | Dónde en el panel |
|---|---|---|
| Colección de formación del departamento | Bouquet: un conjunto con nombre de canales, películas o series que concede un paquete | Bouquets, a partir de Streams y Movies / Series |
| Materiales de formación | 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 empleado | 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 |
| Sesión de formación interna | 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) |
| Integración con RR. HH. o LMS | Reseller API y webhooks: las operaciones del panel desde tu propio sistema | Claves de la Reseller API y webhooks en el panel del revendedor |
| Dispositivos por empleado | 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
Qué tener antes de instalar.
- Un servidor de la empresa (Ubuntu 22.04 o 24.04) accesible desde las oficinas, el instalador y una dirección interna o un dominio detrás de tu proxy inverso.
- Las grabaciones de formación, el codificador del auditorio para las sesiones en directo y la capacidad del sistema de RR. HH. o del LMS de llamar a una API HTTP.
- Una decisión sobre confidencialidad: qué material va en qué colección de departamento y quién en RR. HH. y en el equipo de formación recibe una cuenta del panel.
Despliegue de la infraestructura
Primero la sede central, después las oficinas.
- Ejecuta el instalador en el servidor de la sede central; pon el panel detrás del proxy inverso de la empresa y define los proxies de confianza para que el registro de auditoría vea las direcciones reales.
- Define la base de reproducción con la dirección interna; los empleados fuera de la red llegan a ella por la VPN o el proxy.
- Registra un nodo por oficina desde Servers; el panel lo instala por SSH y dirige a él a los espectadores de esa oficina.
- Crea una cuenta de socio para el equipo de formación con permisos sobre el catálogo y ninguno sobre las líneas de los empleados.
Organización del contenido
Colecciones por departamento, cursos como series.
- Crea categorías por tema y una serie por curso de varias partes, con un episodio por sesión.
- Crea un bouquet por colección de formación de departamento y un bouquet de toda la plantilla para el material que ve todo el mundo.
- Crea un paquete por puesto: los bouquets que ese puesto necesita y ningún otro, con una duración larga (un año, por ejemplo) como periodo de acceso; una renovación añade otro periodo y RR. HH. desactiva la línea cuando termina el contrato.
- Marca claramente las colecciones confidenciales en sus nombres; una línea ve solo los bouquets que concede su paquete.
Configuración de socios (revendedores)
El equipo de formación y, en un grupo, cada filial.
- Crea un grupo con permisos de catálogo para el equipo de formación y un grupo con permisos de líneas para RR. HH.
- Añade al equipo de formación y a RR. HH. como revendedores con esos grupos; ninguno necesita créditos en un despliegue interno.
- Una filial con biblioteca propia recibe su propio revendedor, sus propios bouquets y sus propios paquetes.
Configuración del acceso de empleados
Una línea por empleado, desde RR. HH.
- Crea una clave de la Reseller API para el sistema de RR. HH. y guárdala en los secretos del sistema de RR. HH.
- En la contratación el sistema de RR. HH. llama a action=create_line con el paquete del puesto y un identificador de solicitud (la duración del paquete es el periodo de acceso); en la baja llama a action=disable_line.
- Define las conexiones máximas con el número de dispositivos que un empleado puede usar (normalmente dos: escritorio y teléfono).
- Para un piloto, añade líneas desde Lines → añadir y entrega las credenciales a unos pocos empleados.
Materiales de formación
Grabaciones bajo demanda.
- Sube cada grabación como fuente de un episodio o ingiérela con la tarea de ingesta VOD; conserva el título y una descripción breve.
- Asocia la grabación al bouquet del departamento correcto mediante su serie.
- Comprueba la reproducción con una línea de prueba de cada puesto para confirmar quién ve qué.
Sesiones de formación internas
Una sesión como canal en directo.
- Añade un stream en directo para el codificador del auditorio (envío RTMP); ponlo en el bouquet de toda la plantilla o en el de un departamento.
- Activa catch-up para que quien llegue tarde pueda rebobinar y sube la grabación a la biblioteca después.
- Los nodos de las oficinas toman la sesión una sola vez del origen y atienden a su gente en local.
Caducidad del acceso
El acceso termina con el contrato.
- Una línea caduca al final del periodo de su paquete; mientras dura el contrato RR. HH. la renueva con action=renew_line y, cuando el contrato termina, RR. HH. la desactiva.
- Suscribe el sistema de RR. HH. a los webhooks para conciliar las líneas a punto de caducar y caducadas con sus propios registros.
- Para accesos temporales (contratistas, semana de incorporación) usa una caducidad corta en lugar de un paquete aparte.
Integración con RR. HH. o un LMS
Los sistemas gestionan el acceso; el reproductor reproduce.
- RR. HH. crea, renueva y desactiva líneas mediante la Reseller API; el LMS puede enlazar al reproductor web desde la página de un curso.
- No hay inicio de sesión único para espectadores: un empleado entra en el reproductor con las credenciales de la línea que emitió tu sistema.
- Usa claves de Admin API con el indicador de solo lectura para las herramientas internas de informes.
Consideraciones de seguridad
Confidencialidad desde la red hasta la línea.
- Mantén la plataforma en la red interna o detrás del proxy inverso con TLS; define TRUSTED_PROXIES en consecuencia.
- Inicio de sesión en dos pasos en todas las cuentas del panel; grupos de permisos para que RR. HH. no pueda cambiar el catálogo y el equipo de formación no pueda ver las líneas.
- Enlaces de reproducción firmados y con caducidad, un límite de conexiones bajo por línea y vinculación de dirección donde los dispositivos son fijos.
- Copias de seguridad cifradas de la base de datos con una copia externa; el registro de auditoría para cada cambio de líneas y catálogo.
Resolución de problemas
Las primeras comprobaciones habituales.
- Un empleado ve el material de otro departamento: comprueba el paquete de la línea y los bouquets que concede.
- Una persona recién contratada no tiene acceso: comprueba que la llamada de RR. HH. se haya completado (el registro de llamadas de la Reseller API) y la caducidad de la línea.
- Una oficina se queda en buffering durante una sesión en directo: comprueba el latido del nodo de la oficina y que los espectadores se dirijan a él.
- El registro de auditoría muestra la dirección del proxy: define TRUSTED_PROXIES con el proxy y reinicia el panel.