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 facultad, semestre ni estudiante. 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 de facultad o departamento | 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 |
| Colección de facultad o parrilla del campus | Bouquet: un conjunto con nombre de canales, películas o series que concede un paquete | Bouquets, a partir de Streams y Movies / Series |
| Canal del campus o evento en directo | 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) |
| Archivo de clases | 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 de estudiante o de 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 |
| Fin del semestre o de la matrícula | 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 de campus o de residencia | Nodos de streaming: servidores de borde registrados desde el panel, uno por sede o edificio | Servers → añadir un nodo, instalado por SSH |
| Integración con el sistema de información de estudiantes | Reseller API y webhooks: las operaciones del panel desde tu propio sistema | Claves de la Reseller API y webhooks en el panel del revendedor |
Requisitos previos
Lo que debes tener antes de instalar.
- Un servidor en el campus principal (Ubuntu 22.04 o 24.04) accesible desde los demás campus y las residencias, el instalador y una dirección interna o un dominio detrás de tu proxy inverso.
- Las señales de los canales del campus y las grabaciones de clases (o la exportación del sistema de captura de clases) y la capacidad del sistema de información de estudiantes de llamar a una API HTTP.
- Una decisión sobre la estructura: qué facultades reciben una cuenta de socio, cómo se nombran las series de clases y cuánto dura un paquete de semestre.
Despliegue de la infraestructura
Primero el campus principal, después las demás sedes.
- Ejecuta el instalador en el servidor del campus principal; coloca el panel detrás del proxy inverso de la universidad y define los proxies de confianza para que los registros y las reglas de IP vean direcciones reales.
- Define la base de reproducción como la dirección a la que acceden los estudiantes desde el campus y las residencias.
- Registra un nodo por campus y por residencia desde Servidores; el panel lo instala por SSH y dirige a él a los espectadores de esa sede.
- Introduce la clave de licencia en el servidor; una institución con dominio académico puede solicitar por correo electrónico la clave Professional gratuita del programa para la educación.
Organización del contenido
Colecciones de facultad y la parrilla del campus.
- Crea categorías por facultad y asignatura, y una serie por curso con una temporada por periodo lectivo y un episodio por clase.
- Crea un bouquet por colección de facultad, uno para los canales del campus y otro para el material común, como los vídeos de bienvenida.
- Crea paquetes para estudiantes y personal: los bouquets que necesita cada uno, con el semestre como duración, de modo que el acceso termina con el periodo lectivo salvo que se renueve.
- Crea un paquete de prueba corto para jornadas de puertas abiertas o estudiantes visitantes.
Configuración de socios (revendedores)
Facultades como cuentas delegadas.
- Crea un grupo con permisos para líneas y para el catálogo propio de la facultad, y sin acceso a los ajustes.
- Añade cada facultad o departamento como cuenta de socio (revendedor) con ese grupo y sus paquetes; los subrevendedores pueden reflejar los departamentos dentro de una facultad.
- Una facultad ve y gestiona solo sus propias líneas; el equipo central conserva la vista completa. Es una cuenta delegada, no una instalación aislada.
Configuración del acceso de los estudiantes
Una línea por estudiante, desde el SIS.
- Crea una clave de la Reseller API para el sistema de información de estudiantes y guárdala en los secretos de ese sistema.
- En la matrícula, el SIS llama a action=create_line con el paquete del estudiante y un identificador de petición; la duración del paquete, el semestre, es el periodo de acceso.
- Define el máximo de conexiones como el número de dispositivos que un estudiante puede usar a la vez (normalmente dos: móvil y portátil).
- Para el personal y para un piloto, añade líneas desde Líneas → añadir y entrega las credenciales.
Archivos de clases
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 del curso y una breve descripción.
- Asocia la serie al bouquet de la facultad, para que solo vean el curso los estudiantes cuyo paquete lo concede.
- Comprueba la reproducción con una línea de prueba de cada paquete para confirmar quién ve qué.
Canales del campus y eventos en directo
Canales en directo para el campus.
- Añade las señales de los canales del campus como emisiones en directo en Emisiones y una fuente EPG para la guía.
- Añade una emisión en directo por aula o evento, alimentada por el codificador del aula por RTMP, y activa catch-up para que quienes llegan tarde puedan rebobinar.
- Coloca cada canal en el bouquet adecuado; los nodos de las residencias lo toman una sola vez del origen y atienden a los estudiantes localmente.
Caducidad y renovación
El semestre como validez de la línea.
- Una línea caduca al final del periodo de su paquete; en la nueva matrícula el SIS llama a action=renew_line y se añade otro periodo.
- Cuando un estudiante se da de baja o se gradúa, el SIS llama a action=disable_line.
- Suscribe el SIS a los webhooks para conciliar con sus registros las líneas que van a caducar y las caducadas.
Integración con el sistema de información de estudiantes
El SIS gestiona el acceso; el reproductor reproduce.
- El SIS crea, renueva, activa y desactiva líneas mediante la Reseller API con una clave y un identificador de petición.
- No hay inicio de sesión único para los espectadores ni integración nativa con LMS o SIS: un estudiante entra en el reproductor con las credenciales de la línea, y la página de un curso en el LMS puede enlazar al reproductor web.
- Usa claves de la Admin API con indicador de solo lectura, lista de IP permitidas y fecha de caducidad para las herramientas internas de informes.
Consideraciones de seguridad
Mantén el acceso para estudiantes y personal.
- Mantén la plataforma en la red del campus o detrás del proxy inverso con TLS; define TRUSTED_PROXIES con el proxy.
- Inicio de sesión en dos pasos para cada cuenta del panel y un grupo de permisos por función, para que una facultad no pueda ver las líneas de otra.
- Enlaces de reproducción firmados y con caducidad, un límite de conexiones por línea y vinculación a un país o a una dirección donde ayude.
- Copias de seguridad cifradas de la base de datos con una copia externa, y el registro de auditoría de cada cambio de líneas y de catálogo.
Resolución de problemas
Las primeras comprobaciones habituales.
- Un estudiante no ve clases: comprueba la caducidad de la línea, después el paquete y los bouquets que concede.
- Un estudiante nuevo no tiene acceso: comprueba en el registro de llamadas de la Reseller API que la llamada del SIS tuvo éxito y que el identificador de petición es nuevo.
- Una residencia se entrecorta por la noche: comprueba el latido de su nodo y que los espectadores se dirigen a él.
- El registro de auditoría muestra la dirección del proxy: define TRUSTED_PROXIES con el proxy y reinicia el panel.