Ces guides font correspondre les concepts d'un secteur aux objets que la plateforme possède aujourd'hui (bouquets, lines, packages, comptes revendeurs, nœuds, l'API). Ce sont des correspondances conceptuelles, pas des fonctionnalités propres à un secteur, et un compte revendeur est un compte délégué, pas un locataire isolé.
Correspondance conceptuelle
Rien dans le panneau ne s'appelle magasin ou franchisé. Le tableau indique quel objet joue quel rôle ; les chapitres ci-dessous les configurent dans cet ordre.
| Dans votre secteur | Sur la plateforme | Où dans le panneau |
|---|---|---|
| Chaîne magasin ou collection de formation | Bouquet : un ensemble nommé de chaînes, films ou séries qu'un package accorde | Bouquets, à partir de Streams et de Movies / Series |
| Chaîne magasin | Chaîne en direct : un stream avec ses sources, son EPG et ses formats de sortie | Streams → ajouter un stream en direct (URL source ou push RTMP) |
| Vidéo de formation et produit | Catalogue VOD : films et séries avec saisons et épisodes, catégories et métadonnées | Movies et Series, ou la tâche d'ingestion VOD |
| Écran de magasin ou accès du personnel | Line : un accès avec son package, ses bouquets, son expiration, sa limite de connexions et ses sorties | Lines → ajouter, ou codes d'activation, ou la Reseller API |
| Compte du franchisé | Compte revendeur : un tableau de bord délégué avec crédits, permissions et ses propres lines | Users → ajouter un revendeur ; Groups pour ses permissions |
| Nœud régional | Nœuds de streaming : serveurs edge enrôlés depuis le panneau, un par site ou par bâtiment | Servers → ajouter un nœud, installé par SSH |
| Écrans ou appareils par line | Connexions max. de la line : combien d'appareils peuvent regarder en même temps | Les connexions max. de la line |
Prérequis
Ce qu'il faut avoir avant d'installer.
- Un serveur au siège (Ubuntu 22.04 ou 24.04), l'installateur, et un serveur par région comptant de nombreux magasins et joignable depuis ceux-ci.
- Le contenu de la chaîne magasin (un encodeur ou une source en boucle), les enregistrements d'intégration et de formation produit, et les écrans ou lecteurs multimédias dans les magasins.
- Une décision sur la structure de franchise : quelles régions reçoivent un nœud, et qui, chez chaque franchisé, gère les lines.
Déploiement de l'infrastructure
Le siège d'abord, puis les régions.
- Lancez l'installateur sur le serveur du siège et définissez l'URL de base de lecture sur une adresse que les magasins peuvent atteindre, derrière TLS.
- Ajoutez la chaîne magasin sous Streams et les enregistrements de formation sous Movies, et vérifiez-les dans le lecteur web.
- Enrôlez un nœud par région depuis Servers ; le panneau l'installe par SSH, ou le nœud s'enrôle avec un code à usage unique, et y dirige les magasins de cette région.
- Créez un compte partenaire pour l'équipe contenu du siège avec des permissions sur le catalogue et aucune sur les lines des magasins.
Organisation du contenu
La chaîne magasin et la bibliothèque de formation.
- Créez un flux en direct pour la chaîne magasin et placez-le dans son propre bouquet.
- Créez des catégories par sujet et une série par cours de formation, avec un épisode par leçon ; ajoutez un bouquet par rôle (vendeurs, responsables, nouveaux arrivants).
- Créez un package pour les écrans de magasin et un package par rôle, chacun accordant ses bouquets et portant la période d'accès comme durée.
- Donnez aux franchisés les packages qu'ils peuvent revendre à leurs magasins et à leur personnel.
Configuration des partenaires (revendeurs)
Un compte partenaire par franchisé.
- Créez un groupe avec des permissions limitées aux lines, sans modification du catalogue.
- Ajoutez chaque franchisé sous Users → ajouter un revendeur, avec ce groupe, ses packages et un solde de crédits.
- Un franchisé ayant plusieurs régions peut ajouter un sous-revendeur par région, chacun avec ses propres magasins.
Configuration des lines de magasin et du personnel
Une line par écran et par employé.
- Créez une line par écran de magasin sous Lines → ajouter avec le nom du magasin et le package magasin ; le franchisé fait de même pour ses propres magasins.
- Définissez les connexions max. sur le nombre d'écrans du magasin, et sur deux pour un employé (surface de vente et téléphone).
- Liez une line de magasin à l'adresse du magasin quand celui-ci en a une fixe, pour que les identifiants ne fonctionnent pas ailleurs.
- Configurez une fois le lecteur de l'écran (M3U, API Xtream Codes ou adresse du lecteur web) et conservez les identifiants dans le dossier du magasin.
Vidéo de formation et produit
La bibliothèque pour le personnel.
- Téléversez chaque cours de formation comme série et chaque film produit comme film, ou ingérez-les avec la tâche d'ingestion VOD dans la racine des médias.
- Placez les enregistrements dans le bouquet du bon rôle via leurs catégories.
- Vérifiez ce que voit chaque rôle avec une line de test avant d'ouvrir la bibliothèque aux franchisés.
La chaîne magasin
Une chaîne pour tous les écrans.
- Ajoutez la chaîne magasin comme flux en direct, alimenté par l'encodeur du siège en RTMP ou par une source en boucle.
- Activez le catch-up pour les sessions de formation diffusées en direct, et téléversez l'enregistrement dans la bibliothèque ensuite.
- Les nœuds des régions récupèrent la chaîne une seule fois depuis l'origine et desservent leurs magasins, de sorte que les liaisons des magasins ne sont pas saturées.
Expiration et renouvellement
L'accès suit le magasin ou le contrat.
- Une line expire à la fin de la période de son package ; le franchisé la renouvelle avec un package ou un crédit.
- Désactivez la line d'un magasin fermé ou d'un employé qui part.
- Abonnez le système de gestion de franchise ou de RH aux webhooks pour voir les lines sur le point d'expirer ou déjà expirées.
Intégration avec les systèmes de franchise ou de RH
Les systèmes pilotent les lines ; le lecteur lit.
- Créez une clé Reseller API pour le système de gestion de franchise ou de RH ; il appelle create_line, renew_line, enable_line et disable_line, avec un identifiant de requête sur chaque écriture.
- Utilisez un connecteur e-commerce quand vous facturez le service aux franchisés ; tout autre système utilise la Reseller API et les webhooks.
- Il n'y a pas de connexion unique (SSO) pour les spectateurs : le personnel se connecte au lecteur avec les identifiants de sa line.
Considérations de sécurité
Garder chaque magasin sur ses propres lines.
- Servez le panneau derrière un reverse proxy avec TLS et définissez TRUSTED_PROXIES pour que le journal d'audit et les règles d'IP voient les vraies adresses.
- Connexion en deux étapes pour chaque compte du siège ; les franchisés reçoivent un groupe de permissions limité à leurs propres lines.
- Une limite de connexions par line, des liens de lecture signés et expirants, et une liaison à l'adresse pour les écrans de magasin.
- Activez la sauvegarde chiffrée de la base de données avec copie externe, et utilisez le journal d'audit pour revoir les modifications des lines et du catalogue.
Dépannage
Les premières vérifications habituelles.
- Un écran de magasin est noir : vérifiez que sa line est activée et non expirée, la liaison à l'adresse, et la limite de connexions si un deuxième appareil utilise la line.
- Une région met en mémoire tampon : vérifiez le heartbeat du nœud régional et que les magasins y sont dirigés.
- Un franchisé ne peut pas créer de lines : vérifiez son solde de crédits, les permissions de son groupe et les packages qui lui sont attribués.
- Le journal d'audit montre l'adresse du proxy : définissez TRUSTED_PROXIES sur le proxy et redémarrez le panneau.