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 seduta, cittadino o ufficio. La tabella dice quale oggetto svolge quale ruolo; i capitoli seguenti li configurano in quest'ordine.
| Nel tuo settore | Sulla piattaforma | Dove nel pannello |
|---|---|---|
| Seduta del consiglio o canale pubblico | 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) |
| Archivio delle sedute e libreria di formazione | Catalogo VOD: film e serie con stagioni ed episodi, categorie e metadati | Movies e Series, oppure il job di ingest VOD |
| Programma pubblico o collezione di ufficio | Bouquet: un insieme con nome di canali, film o serie che un pacchetto concede | Bouquets, a partire da Streams e Movies / Series |
| Accesso di cittadino o del personale | 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 |
| Validità di un accesso pubblico o del personale | 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 |
| Integrazione con i sistemi del comune | Reseller API e webhook: le operazioni del pannello dal tuo sistema | Chiavi Reseller API e webhook nella dashboard del reseller |
Prerequisiti
Cosa avere prima di installare.
- Un server nel data center dell'istituzione (Ubuntu 22.04 o 24.04), l'installer e un dominio dietro il reverse proxy dell'istituzione per l'indirizzo pubblico.
- L'encoder o il mixer video dell'aula in grado di inviare RTMP, le registrazioni delle sedute passate e i video di formazione per il personale.
- Una decisione su cosa è pubblico e cosa è interno, quanto dura una linea pubblica e quali operatori ricevono un account del pannello.
Installazione dell'infrastruttura
Il server di gestione, poi eventuali sedi remote.
- Esegui l'installer sul server dell'istituzione; metti il pannello dietro il reverse proxy con TLS e imposta TRUSTED_PROXIES così il registro di audit e le regole IP vedono gli indirizzi reali.
- Imposta la base di riproduzione sull'indirizzo pubblico raggiunto dai cittadini, e la chiave di licenza sul server.
- Registra da Server un nodo per una sede che ne ha bisogno, come un secondo edificio con un'aula; il pannello lo installa via SSH.
- Crea un account partner (reseller) per il team comunicazione con permessi per le linee pubbliche, e uno per le risorse umane o la formazione per le linee del personale.
Organizzazione dei contenuti
Un programma pubblico e collezioni per ufficio.
- Crea categorie per sedute, commissioni e informazione pubblica, e una serie per organo, con un episodio per riunione.
- Crea un bouquet pubblico con il canale della seduta live e l'archivio, e un bouquet per ogni collezione di formazione degli uffici.
- Crea un pacchetto per i cittadini che conceda solo il bouquet pubblico, con una durata lunga come periodo di accesso.
- Crea pacchetti per il personale che aggiungano i bouquet di formazione e interni a quello pubblico.
Configurazione dei partner (reseller)
I team che distribuiscono l'accesso.
- Crea un gruppo con permessi solo per le linee, senza accesso al catalogo né alle impostazioni.
- Aggiungi il team comunicazione come account partner con il pacchetto dei cittadini, e le risorse umane o la formazione con i pacchetti del personale.
- Un ente con più servizi può dare a ogni servizio un proprio account partner; è un account delegato, non un'installazione isolata.
Configurazione delle linee di cittadini e personale
Linee pubbliche e linee del personale.
- Crea una chiave Reseller API per il sito del comune e conservala nei suoi segreti; quando un cittadino chiede l'accesso, chiama action=create_line con il pacchetto pubblico e un id della richiesta.
- Imposta una scadenza lunga sulle linee pubbliche e un limite di connessioni adatto alla visione in famiglia.
- Crea le linee del personale per ufficio con i pacchetti del personale, dal sistema del personale del comune tramite l'API o da Linee → aggiungi.
- Associa le linee del personale all'intervallo di indirizzi dell'istituzione dove la rete lo consente.
Archivio delle sedute e libreria di formazione
Registrazioni on demand.
- Aggiungi ogni seduta registrata come episodio della serie del suo organo, importata con il job di ingest VOD o caricata, con titolo, data e descrizione.
- Metti la serie delle sedute nel bouquet pubblico e la libreria di formazione nei bouquet degli uffici.
- Verifica la riproduzione con una linea di test del pacchetto pubblico e una di un pacchetto del personale per confermare chi vede cosa.
Sedute live
L'aula come canale live.
- Aggiungi uno stream live con un invio RTMP dall'encoder dell'aula e inseriscilo nel bouquet pubblico.
- Attiva il catch-up così chi arriva in ritardo può tornare indietro, e aggiungi una voce EPG o un titolo perché gli spettatori sappiano quale riunione è in onda.
- Prova il segnale prima di ogni riunione e tieni un nodo vicino a una seconda sede se ospita anch'essa delle sedute.
Scadenza e rinnovo
Lunga per il pubblico, legata al rapporto di lavoro per il personale.
- Una linea pubblica dura quanto la durata del pacchetto; estendila con action=renew_line quando il cittadino la richiede di nuovo.
- Una linea del personale viene rinnovata finché la persona lavora per l'istituzione e disattivata con action=disable_line quando se ne va.
- Iscrivi i sistemi del comune ai webhook per vedere le linee in scadenza e disattivate.
Integrazione con i sistemi dell'istituzione
I sistemi gestiscono l'accesso; il player riproduce.
- Il sito web e il sistema del personale creano, rinnovano, attivano e disattivano linee tramite la Reseller API con una chiave e un id della richiesta.
- Non esiste il single sign-on per gli spettatori né un'integrazione nativa con uno specifico prodotto per il settore pubblico: gli spettatori accedono al player con le credenziali della propria linea.
- 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
Gestita dall'istituzione, aperta dove deve esserlo.
- Tieni la piattaforma sull'infrastruttura dell'istituzione dietro il reverse proxy con TLS e tieni il materiale pubblico e quello interno in bouquet separati.
- Accesso a due fattori per ogni account del pannello e gruppi di permessi per team; reCAPTCHA o Turnstile sull'accesso se il pannello è raggiungibile dall'esterno.
- Link di riproduzione firmati e con scadenza, un limite di connessioni per linea e associazione a indirizzo sulle linee del personale.
- Backup cifrati del database con una copia esterna e il registro di audit per ogni modifica di linee e catalogo.
Risoluzione dei problemi
I primi controlli abituali.
- Un cittadino non riesce a guardare: controlla la scadenza della linea, che sia attiva e il bouquet pubblico del pacchetto.
- Una seduta non parte: controlla l'invio dell'encoder allo stream e lo stato dello stream nel pannello.
- Il personale non vede la libreria di formazione: controlla il pacchetto della linea del personale e i bouquet che concede.
- Il registro di audit mostra l'indirizzo del proxy: imposta TRUSTED_PROXIES sul proxy e riavvia il pannello.