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 appartamento o residente. 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 dell'amministratore di condominio | Account partner (reseller): una dashboard delegata con crediti, permessi e linee proprie | Users → aggiungi un reseller; Groups per i suoi permessi |
| Palinsesto di canali | Bouquet: un insieme con nome di canali, film o serie che un pacchetto concede | Bouquets, a partire da Streams e Movies / Series |
| Canale o canale informativo | 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) |
| Video di benvenuto e avvisi | Catalogo VOD: film e serie con stagioni ed episodi, categorie e metadati | Movies e Series, oppure il job di ingest VOD |
| Accesso dell'appartamento | 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 |
| Periodo di affitto o di occupazione | 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 |
| Nodo dell'edificio | 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 per l'amministrazione (Ubuntu 22.04 o 24.04), l'installer e un server per ogni edificio che possa raggiungere la rete dei residenti.
- I segnali dei canali che la comunità può ritrasmettere (URL di pull o RTMP), gli avvisi e i video di benvenuto dell'amministrazione e i dispositivi dei residenti (set-top box, smart TV con un'app player o un browser).
- Una decisione sui tipi di abitazione (standard, senior, studenti) e su chi nell'amministrazione apre e rinnova le linee.
Installazione dell'infrastruttura
Il server centrale, poi un nodo per edificio.
- Esegui l'installer sul server centrale e imposta l'URL base di riproduzione su un indirizzo raggiungibile dagli edifici.
- Aggiungi i segnali dei canali in Stream e gli avvisi in Film, e controllali nel web player.
- Registra un nodo per edificio da Server; il pannello lo installa via SSH, oppure il nodo si registra con un codice monouso, e vi instrada i residenti di quell'edificio.
- Aggiungi l'amministratore di condominio in Utenti → aggiungi un reseller, con un gruppo che consenta le linee e nessuna modifica al catalogo.
Organizzazione dei contenuti
Palinsesti per tipo di abitazione.
- Crea un bouquet per palinsesto con i canali di ogni tipo di abitazione, e un bouquet per le informazioni dell'amministrazione.
- Aggiungi il bouquet informativo a ogni pacchetto così ogni residente riceve gli avvisi.
- Crea un pacchetto per tipo di abitazione con i suoi bouquet e una durata che corrisponda al contratto di affitto o al periodo di occupazione.
- Ordina i canali e assegna loro i loghi così il menu sulla televisione si legge bene.
Configurazione dei partner (reseller)
L'amministratore di condominio come account delegato.
- Crea un gruppo con permessi limitati alle linee, senza accesso al catalogo né ai server.
- Aggiungi ogni amministratore di condominio come reseller con quel gruppo, i pacchetti delle sue abitazioni e un saldo di crediti.
- Un amministratore di più edifici può aggiungere un sub-reseller per edificio, ciascuno con le proprie abitazioni e i propri crediti.
Configurazione degli appartamenti (linee)
Una linea per appartamento, denominata con il suo numero.
- Crea una linea per appartamento in Linee → aggiungi, con il numero dell'appartamento come nome e il pacchetto di quel tipo di abitazione.
- Imposta le connessioni massime sul numero di televisori dell'abitazione.
- Usa un codice di attivazione anziché una password quando il residente deve inserire un codice breve sul dispositivo.
- Configura il dispositivo una sola volta (Xtream Codes API o M3U con le credenziali della linea, oppure il portale MAG o Enigma2); le credenziali restano all'appartamento finché alla linea non ne vengono assegnate di nuove.
Video di benvenuto e avvisi
I video dell'amministrazione on demand.
- Carica il video di benvenuto, il regolamento condominiale e le guide alla manutenzione come film, con una categoria per argomento.
- Inseriscili nel bouquet informativo così ogni pacchetto li include.
- Sostituisci un video dal pannello quando cambiano le informazioni; i residenti vedono subito la nuova versione.
Canali e canale informativo
Il palinsesto e il canale degli avvisi come stream live.
- Aggiungi ogni canale con licenza in Stream con il suo segnale, e una sorgente EPG così la guida sulla televisione mostra i programmi.
- Aggiungi il canale informativo come stream live, alimentato da un encoder via RTMP o da una sorgente in loop, e inseriscilo nel bouquet informativo.
- Tieni i canali con limiti territoriali in bouquet che concedono soltanto i pacchetti giusti.
Ingresso, uscita e scadenza
L'occupazione come validità della linea.
- Una linea scade alla fine del periodo del suo pacchetto; rinnovala con il pacchetto o con un credito per ogni nuovo periodo di affitto.
- Quando un residente se ne va, disattiva la linea; il residente successivo la riattiva con nuove credenziali, così nulla resta al vecchio nucleo familiare.
- Iscrivi il sistema di gestione immobiliare o l'amministratore ai webhook per vedere le linee che stanno per scadere o già scadute.
Integrazione con un sistema di gestione immobiliare o di fatturazione
I sistemi aprono l'accesso; il player riproduce.
- Crea una chiave Reseller API per il sistema di gestione immobiliare o di fatturazione; chiama create_line, renew_line, enable_line e disable_line, e invia un id della richiesta a ogni scrittura.
- Usa un connettore e-commerce quando i residenti acquistano pacchetti extra online; qualsiasi altro sistema usa la Reseller API e i webhook.
- Non esiste il single sign-on per gli spettatori: un residente accede al player con le credenziali della linea.
Considerazioni sulla sicurezza
Tieni il servizio dentro la comunità.
- Servi il pannello dietro un reverse proxy con TLS e imposta TRUSTED_PROXIES così il registro di audit e le regole IP vedono gli indirizzi reali.
- Accesso a due fattori per ogni account di amministrazione; gli amministratori di condominio ricevono un gruppo di permessi limitato alle linee.
- Un limite di connessioni per linea, link di riproduzione firmati e con scadenza e associazione a indirizzo dove i dispositivi hanno indirizzi fissi.
- Attiva il backup cifrato del database con una copia esterna; le credenziali delle linee sono al suo interno.
Risoluzione dei problemi
I primi controlli abituali.
- Un appartamento non ha la televisione: controlla che la sua linea sia attiva e non scaduta, poi le credenziali del dispositivo e l'indirizzo di riproduzione.
- Un edificio va in buffering la sera: controlla l'heartbeat del nodo dell'edificio e che i suoi residenti vi siano instradati.
- Manca un canale per un tipo di abitazione: controlla i bouquet di quel pacchetto.
- Un amministratore non riesce a creare linee: controlla il saldo di crediti del reseller, i permessi del suo gruppo e i pacchetti che gli sono assegnati.