Guida alla configurazione per media e creatori di contenuti

Corrispondenza concettuale

Nel pannello nulla si chiama programma o sostenitore. La tabella dice quale oggetto svolge quale ruolo; i capitoli seguenti li configurano in quest'ordine.

1Prerequisiti

Cosa avere prima di installare.

1. Un server (Ubuntu 22.04 o 24.04) con un indirizzo pubblico o un dominio, e banda in upload sufficiente per il pubblico che ti aspetti.
2. Gli episodi finiti, il playout o l'encoder dello studio per il canale e un negozio su una piattaforma con un connettore, o la possibilità di chiamare un'API HTTP.
3. Una decisione su livelli e affiliati: cosa concede ogni abbonamento e chi può venderlo.

2Installazione dell'infrastruttura

Prima un server, nodi man mano che il pubblico cresce.

1. Esegui l'installer sul server di gestione e metti il pannello dietro un reverse proxy con TLS; imposta i proxy attendibili così le regole IP vedono l'indirizzo reale dello spettatore.
2. Imposta l'URL base di riproduzione sull'indirizzo pubblico raggiunto dal tuo pubblico.
3. Registra da Server un nodo in una regione in cui guardano molti sostenitori; il pannello lo installa via SSH e vi instrada gli spettatori di quella regione.
4. Crea un account partner (reseller) per ogni membro dello staff che gestisce il catalogo o i sostenitori, con un proprio gruppo di permessi.

3Organizzazione dei contenuti

Programmi come serie, livelli come bouquet.

1. Crea categorie per genere e una serie per programma, con una stagione per blocco di uscite e un episodio per video.
2. Crea un bouquet per il canale live, uno per i contenuti gratuiti o di ingresso e uno per ogni livello superiore.
3. Crea un pacchetto per livello con il periodo di fatturazione come durata, un pacchetto di prova per i nuovi visitatori se lo vuoi e un prezzo in crediti per gli affiliati.
4. Tieni il catalogo storico in una categoria a parte, così può essere spostato tra i livelli senza toccare le serie.

4Configurazione dei partner (reseller)

Affiliati e distributori.

1. Crea un gruppo per gli affiliati con soli permessi sulle linee, così non possono modificare il catalogo.
2. Aggiungi ogni affiliato come reseller con quel gruppo e un saldo di crediti; il prezzo del suo pacchetto lo decide lo studio.
3. Un distributore con sub-affiliati può creare sub-reseller sotto il proprio account, fino a cinque livelli di profondità.

5Configurazione dell'accesso dei sostenitori

Una linea per sostenitore.

1. Installa il connettore del tuo negozio (ad esempio WooCommerce) e inserisci la chiave Reseller API e il pacchetto corrispondente a ogni prodotto.
2. All'abbonamento il connettore chiama create_line con il pacchetto e un id della richiesta; il periodo di fatturazione è la durata del pacchetto.
3. Imposta le connessioni massime sul numero di dispositivi che un sostenitore può usare, di solito due o tre.
4. Per un omaggio o un lancio, genera codici di attivazione in blocco o aggiungi linee da Linee → aggiungi con un pacchetto di prova.

6Libreria dei programmi

Episodi on demand.

1. Carica ogni episodio come sorgente, o importalo con il job di ingest VOD; compila il titolo, la stagione, il numero dell'episodio e i metadati TMDB se il programma ne ha.
2. Collega ogni serie ai bouquet dei livelli che possono guardarla.
3. Verifica la riproduzione con una linea di test di ogni livello prima di annunciare un'uscita.

7Il canale dello studio

Un canale 24 ore su 24.

1. Aggiungi uno stream live per il playout dello studio (invio RTMP) e inseriscilo nei bouquet di tutti i livelli che includono il canale.
2. Carica la guida del canale come XMLTV così i sostenitori vedono cosa va in onda, e attiva il catch-up per i programmi che vale la pena rivedere.
3. Mantieni il playout attivo tra un'uscita e l'altra con i contenuti programmati dello studio; il pannello si limita a ritrasmettere lo stream.

8Scadenza dell'abbonamento

L'accesso segue il pagamento.

1. Una linea scade alla fine del periodo del suo pacchetto; il negozio la rinnova con renew_line quando arriva il pagamento successivo.
2. Iscrivi il negozio ai webhook per inviare un promemoria su line.expiring e per declassare un sostenitore su line.expired.
3. Un sostenitore che annulla viene disattivato dal negozio con disable_line, e la linea può essere rinnovata più tardi senza un nuovo account.

9Integrazione con il negozio

Il negozio vende; il player riproduce.

1. Il connettore crea, rinnova e disattiva le linee al ritmo degli ordini; qualsiasi altro negozio usa la Reseller API e i webhook.
2. Gli affiliati vedono le proprie linee nella loro dashboard, e la Reseller API permette loro di automatizzarlo.
3. Non esiste il single sign-on per gli spettatori: i sostenitori accedono al player con le credenziali della propria linea, che il negozio invia loro.

10Considerazioni sulla sicurezza

Proteggi l'abbonamento, non solo il server.

1. Servi il pannello e l'URL base di riproduzione via TLS e imposta TRUSTED_PROXIES sul tuo reverse proxy.
2. Accesso a due fattori per ogni account del pannello e gruppi di permessi perché gli affiliati non possano modificare il catalogo.
3. Link di riproduzione firmati e con scadenza e un limite di connessioni per linea; associa una linea a un paese se una licenza è territoriale.
4. Backup cifrati del database con una copia esterna e il registro di audit per ogni modifica di linee e catalogo.

11Risoluzione dei problemi

I primi controlli abituali.

1. Un nuovo sostenitore non riesce a guardare dopo aver pagato: controlla la chiamata del connettore del negozio nel registro della Reseller API e la data di scadenza della linea.
2. Un sostenitore vede contenuti di un livello superiore: controlla il pacchetto della linea e i bouquet che concede.
3. Il canale si ferma alla fine di un ciclo del playout: controlla l'invio dell'encoder allo stream live e lo stato di probe dello stream.
4. La vendita di un affiliato non compare: controlla i suoi crediti e che il pacchetto usato appartenga al suo gruppo.