Queste guide mettono in corrispondenza i concetti di un settore con gli oggetti che la piattaforma ha oggi (bouquet, linee, pacchetti, account partner, nodi, l'API). Sono corrispondenze concettuali, non funzioni specifiche per settore, e un account partner è un account delegato, non un tenant isolato.
Corrispondenza concettuale
Nel pannello nulla si chiama abbonamento o punto di presenza. La tabella dice quale oggetto svolge quale ruolo; i capitoli seguenti li configurano in quest'ordine.
| Nel tuo settore | Sulla piattaforma | Dove nel pannello |
|---|---|---|
| Account del dealer o del partner regionale | Account partner (reseller): una dashboard delegata con crediti, permessi e linee proprie | Users → aggiungi un reseller; Groups per i suoi permessi |
| Livello di canali o pacchetto aggiuntivo | Bouquet: un insieme con nome di canali, film o serie che un pacchetto concede | Bouquets, a partire da Streams e Movies / Series |
| Canale televisivo | Canale in diretta: uno stream con le sue fonti, l'EPG e i formati di uscita | Streams → aggiungi uno stream in diretta (URL della fonte o push RTMP) |
| Libreria VOD | Catalogo VOD: film e serie con stagioni ed episodi, categorie e metadati | Movies e Series, oppure il job di ingest VOD |
| Accesso televisivo dell'abbonato | Linea: un accesso con il suo pacchetto, i bouquet, la scadenza, il limite di connessioni e le uscite | Lines → aggiungi, oppure codici di attivazione, oppure la Reseller API |
| Fine del periodo di fatturazione | Data di scadenza della linea, rinnovata da un pacchetto, da un credito o dall'API | La data di scadenza della linea e la durata del pacchetto |
| Schermi per abbonamento | Connessioni massime della linea: quanti dispositivi possono guardare insieme | Le connessioni massime della linea |
| Integrazione con fatturazione e provisioning | Reseller API e webhook: le operazioni del pannello dal tuo sistema | Chiavi Reseller API e webhook nella dashboard del reseller |
| Nodo del punto di presenza | Nodi di streaming: server edge registrati dal pannello, uno per sede o edificio | Servers → aggiungi un nodo, installato via SSH |
Prerequisiti
Cosa avere prima di installare.
- Un server nel sito centrale (Ubuntu 22.04 o 24.04), l'installer, un dominio o un indirizzo raggiungibile dagli abbonati e un server in ogni punto di presenza per i nodi.
- I segnali dei canali con licenza, la libreria VOD e il sistema di fatturazione in cui risiedono gli abbonamenti.
- Una decisione sui livelli, sulla durata di un periodo di fatturazione e su quali dealer ricevono un account partner.
Installazione dell'infrastruttura
Il sito centrale, poi i punti di presenza.
- Esegui l'installer sul server centrale; metti il pannello dietro il tuo reverse proxy e imposta TRUSTED_PROXIES così log e regole IP vedono l'indirizzo reale dell'abbonato.
- Imposta la base di riproduzione sull'indirizzo pubblico raggiunto dagli abbonati, e la chiave di licenza sul server.
- Registra un nodo per punto di presenza da Server; il pannello lo installa via SSH, oppure il nodo si registra con un codice monouso, e vi instrada gli abbonati vicini.
- Crea un account partner (reseller) per l'assistenza o per il team di fatturazione con permessi solo sulle linee.
Organizzazione dei contenuti
Livelli e pacchetti come bouquet.
- Aggiungi i canali in Stream e la libreria VOD in Film e Serie, con categorie e una sorgente EPG.
- Crea bouquet per il palinsesto di base, i canali premium e la libreria VOD.
- Crea un pacchetto per livello di abbonamento con i bouquet che concede, il periodo di fatturazione come durata e un prezzo in crediti.
- Crea un breve pacchetto di prova per una promozione o un nuovo cliente.
Configurazione dei partner (reseller)
Dealer con crediti.
- Crea un gruppo per i dealer con permessi sulle proprie linee e senza accesso al catalogo né alle impostazioni.
- Aggiungi ogni dealer regionale come account partner con quel gruppo, i pacchetti che può vendere e un saldo di crediti; un dealer può avere sub-reseller fino a cinque livelli di profondità.
- Il webhook credits.low e l'avviso di crediti in esaurimento dicono a un dealer di ricaricare prima che le vendite si fermino.
Configurazione delle linee degli abbonati
Una linea per abbonamento.
- La fatturazione crea una linea quando inizia un abbonamento, tramite un connettore o action=create_line della Reseller API con il pacchetto del livello e un id della richiesta.
- Imposta le connessioni massime per livello, cioè il numero di schermi che una famiglia può usare contemporaneamente.
- Associa una linea all'indirizzo, al paese o all'ISP dell'abbonato quando l'offerta è riservata alla tua rete.
- Per un pilota o un caso di assistenza, aggiungi linee da Linee → aggiungi e consegna le credenziali.
Libreria VOD
Il catalogo on demand.
- Aggiungi film e serie con stagioni ed episodi, importati con il job di ingest VOD o caricati, con metadati TMDB per locandine e descrizioni.
- Raggruppa i titoli in bouquet per livello o componente aggiuntivo, così un pacchetto concede esattamente ciò che l'abbonamento comprende.
- I nodi mettono in cache i file VOD, così i titoli più richiesti vengono serviti dal punto di presenza vicino all'abbonato.
Canali live
Il palinsesto.
- Aggiungi ogni canale con licenza in Stream con il suo segnale e attiva catch-up o timeshift solo dove i diritti lo consentono.
- Aggiungi una sorgente EPG così app e box mostrano la guida ai programmi.
- Ogni nodo preleva un canale live una sola volta dall'origine e lo distribuisce ai suoi abbonati.
Scadenza, rinnovo e annullamento
Il periodo di fatturazione come validità della linea.
- Una linea dura per il periodo del suo pacchetto; la fatturazione la rinnova a ogni periodo con action=renew_line o tramite il connettore.
- Quando un abbonamento scade o viene annullato, la fatturazione chiama action=disable_line e riattiva la linea alla riattivazione.
- Iscrivi la fatturazione ai webhook per riconciliare con i suoi dati le linee in scadenza e scadute.
Integrazione con la fatturazione
La fatturazione gestisce l'accesso; il player riproduce.
- Installa sul suo lato il connettore per il tuo sistema di fatturazione (WHMCS, Blesta, Odoo e altri), oppure chiama la Reseller API con una chiave e un id della richiesta dal tuo sistema.
- Non esiste il single sign-on per gli spettatori: un abbonato accede a un'app o a un box con le credenziali della linea, che la fatturazione può mostrare nell'area clienti.
- Usa chiavi Admin API con il flag di sola lettura, una lista di IP consentiti e una data di scadenza per gli strumenti di report.
Considerazioni sulla sicurezza
Tieni il servizio per gli abbonati.
- Metti il pannello dietro il reverse proxy con TLS e imposta TRUSTED_PROXIES; tieni il traffico di gestione dei nodi su una rete privata.
- Accesso a due fattori per ogni account del pannello e gruppi di permessi per assistenza e dealer; reCAPTCHA o Turnstile sull'accesso.
- Link di riproduzione firmati e con scadenza, un limite di connessioni per abbonamento e associazione a un indirizzo, a un paese o a un ISP dove opportuno.
- Backup cifrati del database con una copia esterna e il registro di audit per ogni modifica di linee e crediti.
Risoluzione dei problemi
I primi controlli abituali.
- Un abbonato non ha la televisione: controlla che la linea sia attiva e non scaduta, poi la chiamata della fatturazione nel registro delle chiamate della Reseller API.
- Manca un canale per un livello: controlla i bouquet del pacchetto di quel livello.
- Un punto di presenza va in buffering: controlla l'heartbeat del suo nodo e che i suoi abbonati vi siano instradati.
- Un dealer non riesce a creare una linea: controlla i suoi crediti e che il pacchetto sia uno di quelli che può vendere.