Guida alla configurazione per le reti retail e in franchising

Corrispondenza concettuale

Nel pannello nulla si chiama negozio o affiliato. 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 della sede centrale (Ubuntu 22.04 o 24.04), l'installer e un server per ogni regione che ha molti negozi e può essere raggiunto da essi.
2. Il contenuto del canale dei negozi (un encoder o una sorgente in loop), le registrazioni di inserimento e formazione sui prodotti e gli schermi o i media player nei negozi.
3. Una decisione sulla struttura del franchising: quali regioni ricevono un nodo e chi presso ciascun affiliato gestisce le linee.

2Installazione dell'infrastruttura

Prima la sede centrale, poi le regioni.

1. Esegui l'installer sul server della sede centrale e imposta l'URL base di riproduzione su un indirizzo raggiungibile dai negozi, dietro TLS.
2. Aggiungi il canale dei negozi in Stream e le registrazioni di formazione in Film, e controllali nel web player.
3. Registra un nodo per regione da Server; il pannello lo installa via SSH, oppure il nodo si registra con un codice monouso, e vi instrada i negozi di quella regione.
4. Crea un account partner per il team contenuti della sede centrale con permessi sul catalogo e nessuno sulle linee dei negozi.

3Organizzazione dei contenuti

Il canale dei negozi e la libreria di formazione.

1. Crea uno stream live per il canale dei negozi e inseriscilo in un bouquet dedicato.
2. Crea categorie per argomento e una serie per corso di formazione, con un episodio per lezione; aggiungi un bouquet per ruolo (addetti alle vendite, responsabili, nuovi assunti).
3. Crea un pacchetto per gli schermi dei negozi e un pacchetto per ruolo, ciascuno con i propri bouquet e con il periodo di accesso come durata.
4. Dai agli affiliati i pacchetti che possono rivendere ai propri negozi e al proprio personale.

4Configurazione dei partner (reseller)

Un account partner per affiliato.

1. Crea un gruppo con permessi limitati alle linee, senza modifiche al catalogo.
2. Aggiungi ogni affiliato in Utenti → aggiungi un reseller, con quel gruppo, i suoi pacchetti e un saldo di crediti.
3. Un affiliato con più regioni può aggiungere un sub-reseller per regione, ciascuno con i propri negozi.

5Configurazione delle linee di negozio e del personale

Una linea per schermo e per dipendente.

1. Crea una linea per schermo di negozio in Linee → aggiungi con il nome del negozio e il pacchetto dei negozi; l'affiliato fa lo stesso per i propri negozi.
2. Imposta le connessioni massime sul numero di schermi del negozio, e su due per un dipendente (punto vendita e telefono).
3. Associa una linea di negozio all'indirizzo del negozio quando ne ha uno fisso, così le credenziali non funzionano altrove.
4. Configura una sola volta il player dello schermo (M3U, Xtream Codes API o l'indirizzo del web player) e conserva le credenziali nel fascicolo del negozio.

6Video di formazione e di prodotto

La libreria per il personale.

1. Carica ogni corso di formazione come serie e ogni film di prodotto come film, oppure importali con il job di ingest VOD nella root dei media.
2. Inserisci le registrazioni nel bouquet del ruolo giusto tramite le loro categorie.
3. Verifica con una linea di test cosa vede ogni ruolo prima di aprire la libreria agli affiliati.

7Il canale dei negozi

Un canale per tutti gli schermi.

1. Aggiungi il canale dei negozi come stream live, alimentato dall'encoder della sede centrale via RTMP o da una sorgente in loop.
2. Attiva il catch-up per le sessioni di formazione trasmesse in diretta e carica poi la registrazione nella libreria.
3. I nodi nelle regioni prelevano il canale una sola volta dall'origine e servono i propri negozi, così i collegamenti dei negozi non si saturano.

8Scadenza e rinnovo

L'accesso segue il negozio o il contratto.

1. Una linea scade alla fine del periodo del suo pacchetto; l'affiliato la rinnova con un pacchetto o un credito.
2. Disattiva la linea di un negozio chiuso o di un dipendente che se ne va.
3. Iscrivi il sistema di gestione del franchising o delle risorse umane ai webhook per vedere le linee che stanno per scadere o già scadute.

9Integrazione con i sistemi di franchising o delle risorse umane

I sistemi gestiscono le linee; il player riproduce.

1. Crea una chiave Reseller API per il sistema di gestione del franchising o delle risorse umane; chiama create_line, renew_line, enable_line e disable_line, con un id della richiesta a ogni scrittura.
2. Usa un connettore e-commerce quando fatturi il servizio agli affiliati; qualsiasi altro sistema usa la Reseller API e i webhook.
3. Non esiste il single sign-on per gli spettatori: il personale accede al player con le credenziali della propria linea.

10Considerazioni sulla sicurezza

Tieni ogni negozio sulle proprie linee.

1. 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.
2. Accesso a due fattori per ogni account della sede centrale; gli affiliati ricevono un gruppo di permessi limitato alle proprie linee.
3. Un limite di connessioni per linea, link di riproduzione firmati e con scadenza e associazione a indirizzo per gli schermi dei negozi.
4. Attiva il backup cifrato del database con una copia esterna e usa il registro di audit per rivedere le modifiche di linee e catalogo.

11Risoluzione dei problemi

I primi controlli abituali.

1. Uno schermo di negozio è nero: controlla che la sua linea sia attiva e non scaduta, l'associazione a indirizzo e il limite di connessioni se un secondo dispositivo sta usando la linea.
2. Una regione va in buffering: controlla l'heartbeat del nodo regionale e che i negozi vi siano instradati.
3. Un affiliato non riesce a creare linee: controlla il suo saldo di crediti, i permessi del suo gruppo e i pacchetti che gli sono assegnati.
4. Il registro di audit mostra l'indirizzo del proxy: imposta TRUSTED_PROXIES sul proxy e riavvia il pannello.