Guía de configuración para medios y creadores de contenido

Correspondencia conceptual

Nada en el panel se llama programa ni seguidor. La tabla indica qué objeto cumple cada papel; los capítulos siguientes los configuran en ese orden.

1Requisitos previos

Lo que debes tener antes de instalar.

1. 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 la audiencia que esperas.
2. Los episodios terminados, el playout o codificador del estudio para el canal y una tienda en una plataforma con conector, o la capacidad de llamar a una API HTTP.
3. Una decisión sobre niveles y afiliados: qué concede cada suscripción y quién puede venderla.

2Despliegue de la infraestructura

Primero un servidor, nodos a medida que crece la audiencia.

1. Ejecuta el instalador en el servidor de gestión y coloca el panel detrás de un proxy inverso con TLS; define los proxies de confianza para que las reglas de IP vean la dirección real del espectador.
2. Define la URL base de reproducción como la dirección pública a la que accede tu audiencia.
3. Registra desde Servidores un nodo en una región donde vean muchos seguidores; el panel lo instala por SSH y dirige a él a los espectadores de esa región.
4. Crea una cuenta de socio (revendedor) para cada miembro del personal que gestione el catálogo o a los seguidores, con su propio grupo de permisos.

3Organización del contenido

Programas como series, niveles como bouquets.

1. Crea categorías por género y una serie por programa, con una temporada por lote de estrenos y un episodio por vídeo.
2. Crea un bouquet para el canal en directo, uno para el contenido gratuito o de entrada y uno para cada nivel superior.
3. Crea un paquete por nivel con el periodo de facturación como duración, un paquete de prueba para los nuevos visitantes si lo quieres y un precio en créditos para los afiliados.
4. Guarda el fondo de catálogo en su propia categoría para poder moverlo entre niveles sin tocar las series.

4Configuración de socios (revendedores)

Afiliados y distribuidores.

1. Crea un grupo para los afiliados solo con permisos de líneas, para que no puedan cambiar el catálogo.
2. Añade a cada afiliado como revendedor con ese grupo y un saldo de créditos; el precio de su paquete es el que decida el estudio.
3. Un distribuidor con subafiliados puede crear subdistribuidores bajo su propia cuenta, hasta cinco niveles de profundidad.

5Configuración del acceso de los seguidores

Una línea por seguidor.

1. Instala el conector de tu tienda (WooCommerce, por ejemplo) e introduce la clave de la Reseller API y el paquete que corresponde a cada producto.
2. Al suscribirse, el conector llama a create_line con el paquete y un identificador de petición; el periodo de facturación es la duración del paquete.
3. Define el máximo de conexiones como el número de dispositivos que puede usar un seguidor, normalmente dos o tres.
4. Para un sorteo o un lanzamiento, genera códigos de activación en bloque o añade líneas desde Líneas → añadir con un paquete de prueba.

6Biblioteca de programas

Episodios a la carta.

1. Sube cada episodio como una fuente, o ingéstalo con la tarea de ingesta VOD; rellena el título, la temporada, el número de episodio y los metadatos de TMDB si el programa los tiene.
2. Asocia cada serie a los bouquets de los niveles que pueden verla.
3. Comprueba la reproducción con una línea de prueba de cada nivel antes de anunciar un estreno.

7El canal del estudio

Un canal las 24 horas.

1. Añade una emisión en directo para el playout del estudio (envío RTMP) y colócala en los bouquets de todos los niveles que incluyen el canal.
2. Carga la guía del canal como XMLTV para que los seguidores vean qué se emite, y activa catch-up para los programas que merecen volver a verse.
3. Mantén el playout en marcha entre estrenos con el contenido programado del propio estudio; el panel solo retransmite la emisión.

8Caducidad de la suscripción

El acceso sigue al pago.

1. Una línea caduca al final del periodo de su paquete; la tienda la renueva con renew_line cuando llega el siguiente pago.
2. Suscribe la tienda a los webhooks para enviar un recordatorio en line.expiring y bajar de nivel a un seguidor en line.expired.
3. La tienda desactiva con disable_line a un seguidor que cancela, y la línea puede renovarse más tarde sin una cuenta nueva.

9Integración con la tienda

La tienda vende; el reproductor reproduce.

1. El conector crea, renueva y desactiva líneas al ritmo de los pedidos; cualquier otra tienda usa la Reseller API y los webhooks.
2. Los afiliados ven sus propias líneas en su panel, y la Reseller API les permite automatizarlo.
3. No hay inicio de sesión único para los espectadores: los seguidores entran en el reproductor con las credenciales de su línea, que les envía la tienda.

10Consideraciones de seguridad

Protege la suscripción, no solo el servidor.

1. Sirve el panel y la URL base de reproducción por TLS y define TRUSTED_PROXIES con tu proxy inverso.
2. Inicio de sesión en dos pasos para cada cuenta del panel y grupos de permisos para que los afiliados no puedan cambiar el catálogo.
3. Enlaces de reproducción firmados y con caducidad y un límite de conexiones por línea; vincula una línea a un país si una licencia es territorial.
4. 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.

11Resolución de problemas

Las primeras comprobaciones habituales.

1. Un seguidor nuevo no puede ver tras pagar: comprueba la llamada del conector de la tienda en el registro de la Reseller API y la fecha de caducidad de la línea.
2. Un seguidor ve contenido de un nivel superior: comprueba el paquete de la línea y los bouquets que concede.
3. El canal se detiene al final de un ciclo del playout: comprueba el envío del codificador a la emisión en directo y el estado de sondeo de la emisión.
4. No aparece la venta de un afiliado: comprueba sus créditos y que el paquete que usó pertenezca a su grupo.