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 squadra o socio. La tabella dice quale oggetto svolge quale ruolo; i capitoli seguenti li configurano in quest'ordine.
| Nel tuo settore | Sulla piattaforma | Dove nel pannello |
|---|---|---|
| Segnale di partita o allenamento | 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 di analisi e replay | Catalogo VOD: film e serie con stagioni ed episodi, categorie e metadati | Movies e Series, oppure il job di ingest VOD |
| Pacchetto di squadra o competizione | Bouquet: un insieme con nome di canali, film o serie che un pacchetto concede | Bouquets, a partire da Streams e Movies / Series |
| Accesso di socio o famiglia | 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 |
| Stagione o periodo di iscrizione | 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 |
| Account dello staff della squadra o dell'accademia | Account partner (reseller): una dashboard delegata con crediti, permessi e linee proprie | Users → aggiungi un reseller; Groups per i suoi permessi |
| Integrazione con negozio o gestione societaria | 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 (Ubuntu 22.04 o 24.04) con un indirizzo pubblico o un dominio, e banda in upload sufficiente per le partite che prevedi di trasmettere.
- La telecamera e l'encoder al campo in grado di inviare RTMP, e i file di allenamento e analisi registrati che i tuoi allenatori già conservano.
- Una decisione su chi vede cosa: quali squadre condividono il materiale, quali partite sono solo per i soci e quale personale riceve un account del pannello.
Installazione dell'infrastruttura
Prima l'accademia, un nodo quando i giorni di partita lo richiedono.
- Esegui l'installer sul server dell'accademia e metti il pannello dietro un reverse proxy con TLS; imposta i proxy attendibili così log e regole IP vedono l'indirizzo reale dello spettatore.
- Imposta l'URL base di riproduzione sull'indirizzo pubblico raggiunto dagli spettatori, così i link emessi dal pannello funzionano da casa.
- Se molte famiglie guardano la stessa partita, registra un nodo da Server; il pannello lo installa via SSH e da lì distribuisce il canale live.
- Crea un account partner (reseller) per lo staff tecnico con permessi sul catalogo e nessuno sulle linee dei soci.
Organizzazione dei contenuti
Squadre e stagioni come categorie, accesso come bouquet.
- Crea categorie per fascia d'età e per stagione, e serie per le competizioni con un episodio per partita.
- Crea un bouquet per il materiale di analisi di ogni squadra, uno per i canali delle partite live e uno per l'intera accademia.
- Crea un pacchetto per tipo di iscrizione: i bouquet che concede, con la stagione come durata e un prezzo in crediti se lo vende lo staff.
- Dai ai bouquet il nome della squadra o della competizione a cui appartengono, così lo staff sa quale pacchetto assegnare a una famiglia.
Configurazione dei partner (reseller)
Lo staff che gestisce i propri soci, se la società lo vuole.
- Crea un gruppo con permessi sul catalogo per gli allenatori e un gruppo con permessi sulle linee per la segreteria soci.
- Aggiungi ciascuno come reseller con il gruppo corrispondente; dai crediti alla segreteria solo se le iscrizioni vengono vendute tramite il pannello.
- Un'accademia satellite o un club di tifosi con soci propri riceve un proprio account partner e propri pacchetti.
Configurazione dell'accesso di soci e famiglie
Una linea per socio o per famiglia.
- Crea una chiave Reseller API per il negozio o il sistema di gestione della società e conservala nei segreti di quel sistema.
- All'iscrizione il sistema chiama action=create_line con il pacchetto dell'iscrizione e un id della richiesta; la stagione è la durata del pacchetto.
- Imposta le connessioni massime sui dispositivi di cui ha bisogno una famiglia (di solito tre o quattro) così un'iscrizione non viene condivisa oltre il nucleo familiare.
- Per un giorno di partita di prova, aggiungi una linea da Linee → aggiungi con un pacchetto di prova, oppure stampa codici di attivazione per i tifosi sugli spalti.
Libreria di analisi e replay
Partite e sessioni on demand.
- Carica ogni partita o sessione come sorgente di un episodio, oppure importala con il job di ingest VOD; mantieni nel titolo la data, l'avversario e la squadra.
- Collega la registrazione al bouquet della squadra tramite la sua serie, così la vedono solo le linee di quella squadra.
- Verifica la riproduzione con una linea di test di ogni iscrizione per confermare chi vede cosa.
Dirette di partite e allenamenti
Una telecamera del campo come canale live.
- Aggiungi uno stream live per ogni encoder al campo (invio RTMP) e inseriscilo nel bouquet dei giorni di partita.
- Attiva il catch-up così una famiglia che si collega in ritardo può tornare indietro, e aggiungi la registrazione alla libreria dopo il fischio finale.
- In un giorno di partita affollato, verifica che il nodo prelevi il canale una sola volta dall'origine e serva gli spettatori che gli sono instradati.
Scadenza dell'iscrizione
L'accesso segue la stagione.
- Una linea scade alla fine del periodo del suo pacchetto; il negozio la rinnova con action=renew_line quando viene pagata la quota della stagione successiva.
- Iscrivi il negozio ai webhook per inviare un promemoria su line.expiring e per chiudere l'iscrizione su line.expired.
- Un giocatore che se ne va a metà stagione viene disattivato dal negozio con action=disable_line; la linea viene conservata per i registri.
Integrazione con il negozio o il software della società
I sistemi gestiscono l'accesso; il player riproduce.
- Installa il connettore della tua piattaforma e-commerce (WooCommerce, Shopify e altri) sul lato del negozio, così un acquisto crea la linea e un pagamento la rinnova.
- Un sistema di gestione della società o di biglietteria si collega tramite la Reseller API e i webhook; non esiste un connettore nativo per esso.
- Non esiste il single sign-on per gli spettatori: i soci accedono al player con le credenziali della propria linea, che il negozio invia loro.
Considerazioni sulla sicurezza
Il materiale della squadra resta alla squadra.
- Servi il pannello e l'URL base di riproduzione via TLS e imposta TRUSTED_PROXIES sul tuo reverse proxy.
- Accesso a due fattori per ogni account del pannello e gruppi di permessi perché la segreteria non possa modificare il catalogo e gli allenatori non possano vedere le linee.
- Link di riproduzione firmati e con scadenza, un limite di connessioni per linea e un'associazione a IP o paese per le 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 genitore vede l'analisi della prima squadra: controlla il pacchetto della linea e i bouquet che concede.
- Un nuovo socio non ha accesso dopo aver pagato: controlla nel registro delle chiamate della Reseller API la richiesta del negozio e la data di scadenza della linea.
- La diretta della partita scatta al fischio d'inizio: controlla l'upload dell'encoder al campo e l'heartbeat del nodo se ce n'è uno che serve gli spettatori.
- Il registro di audit mostra l'indirizzo del proxy: imposta TRUSTED_PROXIES sul proxy e riavvia il pannello.