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 plantilla ni socio. 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 |
|---|---|---|
| Señal de partido o entrenamiento | 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) |
| Biblioteca de análisis y repeticiones | Catálogo VOD: películas y series con temporadas y episodios, categorías y metadatos | Movies y Series, o la tarea de ingesta VOD |
| Paquete de plantilla o competición | 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 socio o familia | 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 |
| Temporada o periodo de membresía | 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 |
| Cuenta del personal del equipo o la academia | 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 |
| Integración con la tienda o la gestión del club | 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 (Ubuntu 22.04 o 24.04) con una dirección pública o un dominio, y ancho de banda de subida suficiente para los partidos que planeas emitir.
- La cámara y el codificador del campo que puedan enviar RTMP, y los archivos de entrenamiento y análisis grabados que tus entrenadores ya conservan.
- Una decisión sobre quién ve qué: qué plantillas comparten material, qué partidos son solo para socios y quién del personal recibe una cuenta del panel.
Despliegue de la infraestructura
Primero la academia, un nodo cuando lo necesiten los días de partido.
- Ejecuta el instalador en el servidor de la academia y coloca el panel detrás de un proxy inverso con TLS; define los proxies de confianza para que los registros y las reglas de IP vean la dirección real del espectador.
- Define la URL base de reproducción como la dirección pública a la que acceden los espectadores, para que los enlaces que emite el panel funcionen desde casa.
- Si muchas familias ven el mismo partido, registra un nodo desde Servidores; el panel lo instala por SSH y reparte desde él el canal en directo.
- Crea una cuenta de socio (revendedor) para el cuerpo técnico con permisos para el catálogo y ninguno para las líneas de los socios.
Organización del contenido
Plantillas y temporadas como categorías, acceso como bouquets.
- Crea categorías por categoría de edad y por temporada, y series para las competiciones con un episodio por partido.
- Crea un bouquet por material de análisis de cada plantilla, uno para los canales de partidos en directo y uno para toda la academia.
- Crea un paquete por tipo de membresía: los bouquets que concede, con la temporada como duración y un precio en créditos si lo vende el personal.
- Nombra los bouquets según la plantilla o competición a la que pertenecen, para que el personal sepa qué paquete dar a una familia.
Configuración de socios (revendedores)
Personal que gestiona sus propios socios, si el club lo quiere.
- Crea un grupo con permisos de catálogo para los entrenadores y un grupo con permisos de líneas para la secretaría de socios.
- Añade a cada uno como revendedor con el grupo correspondiente; da créditos a la secretaría solo si las membresías se venden a través del panel.
- Una academia satélite o una peña con sus propios socios recibe su propia cuenta de socio y sus propios paquetes.
Configuración del acceso de socios y familias
Una línea por socio o por familia.
- Crea una clave de la Reseller API para la tienda o el sistema de gestión del club y guárdala en los secretos de ese sistema.
- Al inscribirse, el sistema llama a action=create_line con el paquete de la membresía y un identificador de petición; la temporada es la duración del paquete.
- Define el máximo de conexiones según los dispositivos que necesita una familia (normalmente tres o cuatro) para que una membresía no se comparta fuera del hogar.
- Para un día de partido de prueba, añade una línea desde Líneas → añadir con un paquete de prueba, o imprime códigos de activación para los aficionados de la grada.
Biblioteca de análisis y repeticiones
Partidos y sesiones a la carta.
- Sube cada partido o sesión como fuente de un episodio, o ingiérelo con la tarea de ingesta VOD; conserva la fecha, el rival y la plantilla en el título.
- Asocia la grabación al bouquet de la plantilla mediante su serie, para que solo vean la grabación las líneas de esa plantilla.
- Comprueba la reproducción con una línea de prueba de cada membresía para confirmar quién ve qué.
Señales de partidos y entrenamientos
Una cámara de campo como canal en directo.
- Añade una emisión en directo por cada codificador del campo (envío RTMP) y colócala en el bouquet de los días de partido.
- Activa catch-up para que una familia que se une tarde pueda rebobinar, y añade la grabación a la biblioteca tras el pitido final.
- En un día de partido con mucha demanda, comprueba que el nodo toma el canal una sola vez del origen y atiende a los espectadores que se le dirigen.
Caducidad de la afiliación
El acceso sigue a la temporada.
- Una línea caduca al final del periodo de su paquete; la tienda la renueva con action=renew_line cuando se paga la cuota de la siguiente temporada.
- Suscribe la tienda a los webhooks para enviar un recordatorio en line.expiring y cerrar la membresía en line.expired.
- La tienda desactiva con action=disable_line a un jugador que se va a mitad de temporada; la línea se conserva para los registros.
Integración con la tienda o el software del club
Los sistemas gestionan el acceso; el reproductor reproduce.
- Instala el conector de tu plataforma de comercio (WooCommerce, Shopify y otras) en el lado de la tienda para que una compra cree la línea y un pago la renueve.
- Un sistema de gestión del club o de venta de entradas se conecta mediante la Reseller API y los webhooks; no hay un conector nativo para él.
- No hay inicio de sesión único para los espectadores: los socios entran en el reproductor con las credenciales de su línea, que les envía la tienda.
Consideraciones de seguridad
El material de la plantilla se queda con la plantilla.
- Sirve el panel y la URL base de reproducción por TLS y define TRUSTED_PROXIES con tu proxy inverso.
- Inicio de sesión en dos pasos para cada cuenta del panel y grupos de permisos para que la secretaría no pueda cambiar el catálogo y los entrenadores no puedan ver las líneas.
- Enlaces de reproducción firmados y con caducidad, un límite de conexiones por línea y una vinculación a IP o país para 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 padre ve el análisis del primer equipo: comprueba el paquete de la línea y los bouquets que concede.
- Un socio nuevo no tiene acceso tras pagar: comprueba en el registro de llamadas de la Reseller API la petición de la tienda y la fecha de caducidad de la línea.
- La señal del partido se entrecorta al comienzo: comprueba la subida del codificador en el campo y el latido del nodo si hay uno que atiende a los espectadores.
- El registro de auditoría muestra la dirección del proxy: define TRUSTED_PROXIES con el proxy y reinicia el panel.