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 sesión, residente ni departamento. 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 |
|---|---|---|
| Pleno o canal público | 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 sesiones y biblioteca 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 |
| Programación pública o colección de un departamento | Bouquet: un conjunto con nombre de canales, películas o series que concede un paquete | Bouquets, a partir de Streams y Movies / Series |
| Acceso de residente 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 |
| Validez de un acceso público o del personal | 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 |
| Integración con el sistema del ayuntamiento | 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 centro de datos de la institución (Ubuntu 22.04 o 24.04), el instalador y un dominio detrás del proxy inverso de la institución para la dirección pública.
- El codificador o mezclador de vídeo del salón de plenos capaz de enviar RTMP, las grabaciones de sesiones pasadas y los vídeos de formación para el personal.
- Una decisión sobre qué es público y qué es interno, cuánto dura una línea pública y cuáles de los operadores reciben una cuenta del panel.
Despliegue de la infraestructura
El servidor de gestión, después cualquier sede remota.
- Ejecuta el instalador en el servidor de la institución; coloca el panel detrás del proxy inverso con TLS y define TRUSTED_PROXIES para que el registro de auditoría y las reglas de IP vean direcciones reales.
- Define la base de reproducción como la dirección pública a la que acceden los residentes, y la clave de licencia en el servidor.
- Registra desde Servidores un nodo para una sede que lo necesite, como un segundo edificio con un salón de plenos; el panel lo instala por SSH.
- Crea una cuenta de socio (revendedor) para el equipo de comunicación con permisos para líneas públicas, y otra para RR. HH. o formación para las líneas del personal.
Organización del contenido
Una programación pública y colecciones por departamento.
- Crea categorías para sesiones, comisiones e información pública, y una serie por órgano, con un episodio por reunión.
- Crea un bouquet público con el canal de la sesión en directo y el archivo, y un bouquet por colección de formación de cada departamento.
- Crea un paquete para residentes que conceda solo el bouquet público, con una duración larga como periodo de acceso.
- Crea paquetes para el personal que añadan los bouquets de formación e internos al público.
Configuración de socios (revendedores)
Equipos que entregan el acceso.
- Crea un grupo con permisos solo para líneas y sin acceso al catálogo ni a los ajustes.
- Añade al equipo de comunicación como cuenta de socio con el paquete de residentes, y a RR. HH. o formación con los paquetes del personal.
- Un organismo con varios servicios puede dar a cada servicio su propia cuenta de socio; es una cuenta delegada, no una instalación aislada.
Configuración de las líneas de residentes y personal
Líneas públicas y líneas del personal.
- Crea una clave de la Reseller API para el sitio web del ayuntamiento y guárdala en sus secretos; cuando un residente pide acceso, llama a action=create_line con el paquete público y un identificador de petición.
- Define una caducidad larga en las líneas públicas y un límite de conexiones adecuado para el visionado en un hogar.
- Crea líneas del personal por departamento con los paquetes del personal, desde el sistema de personal del ayuntamiento mediante la API o desde Líneas → añadir.
- Vincula las líneas del personal al rango de direcciones de la institución donde la red lo permita.
Archivo de sesiones y biblioteca de formación
Grabaciones bajo demanda.
- Añade cada sesión grabada como un episodio de la serie de su órgano, ingerida con la tarea de ingesta VOD o subida, con título, fecha y descripción.
- Pon la serie de sesiones en el bouquet público y la biblioteca de formación en los bouquets de los departamentos.
- Comprueba la reproducción con una línea de prueba del paquete público y otra de un paquete del personal para confirmar quién ve qué.
Sesiones en directo
El salón de plenos como canal en directo.
- Añade una emisión en directo con envío RTMP desde el codificador del salón de plenos y colócala en el bouquet público.
- Activa catch-up para que quienes llegan tarde puedan rebobinar, y añade una entrada EPG o un título para que los espectadores sepan qué reunión se está emitiendo.
- Prueba la señal antes de cada reunión y mantén un nodo cerca de una segunda sede si también acoge sesiones.
Caducidad y renovación
Larga para el público, ligada al empleo para el personal.
- Una línea pública dura lo que dure el paquete; amplíala con action=renew_line cuando el residente vuelva a pedirla.
- Una línea del personal se renueva mientras la persona trabaja para la institución y se desactiva con action=disable_line cuando se va.
- Suscribe los sistemas del ayuntamiento a los webhooks para ver las líneas que van a caducar y las desactivadas.
Integración con los sistemas de la institución
Los sistemas gestionan el acceso; el reproductor reproduce.
- El sitio web y el sistema de personal crean, renuevan, activan y desactivan 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 un producto concreto del sector público: los espectadores entran en el reproductor con las credenciales de su línea.
- Usa claves de la Admin API con indicador de solo lectura, lista de IP permitidas y fecha de caducidad para las herramientas de informes.
Consideraciones de seguridad
Gestionado por la institución, abierto donde debe serlo.
- Mantén la plataforma en la infraestructura de la institución detrás del proxy inverso con TLS y guarda el material público y el interno en bouquets separados.
- Inicio de sesión en dos pasos para cada cuenta del panel y grupos de permisos por equipo; reCAPTCHA o Turnstile en el inicio de sesión si el panel es accesible desde fuera.
- Enlaces de reproducción firmados y con caducidad, un límite de conexiones por línea y vinculación a dirección en las líneas del personal.
- 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 residente no puede ver: comprueba la caducidad de la línea, que esté activada y el bouquet público del paquete.
- Una sesión no empieza: comprueba el envío del codificador a la emisión y el estado de la emisión en el panel.
- El personal no ve la biblioteca de formación: comprueba el paquete de la línea del personal y los bouquets que concede.
- El registro de auditoría muestra la dirección del proxy: define TRUSTED_PROXIES con el proxy y reinicia el panel.