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 logement ou résident. 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 |
|---|---|---|
| Compte du gestionnaire immobilier | 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 |
| Grille de chaînes | 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 ou chaîne d'information | 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éos d'accueil et d'avis | 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 |
| Accès du logement | 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 |
| Période de bail ou d'occupation | Date d'expiration de la line, renouvelée par un package, un crédit ou l'API | La date d'expiration de la line et la durée du package |
| Nœud d'un bâtiment | 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 |
Prérequis
Ce qu'il faut avoir avant d'installer.
- Un serveur pour le gestionnaire (Ubuntu 22.04 ou 24.04), l'installateur, et un serveur par bâtiment pouvant atteindre le réseau des résidents.
- Les flux de chaînes que la résidence peut retransmettre (URL à récupérer ou RTMP), les avis et vidéos d'accueil du gestionnaire, et les appareils des résidents (décodeurs, smart TV avec une application de lecture, ou un navigateur).
- Une décision sur les types de foyers (standard, senior, étudiant), et sur qui, chez le gestionnaire, ouvre et renouvelle les lines.
Déploiement de l'infrastructure
Le serveur central, puis un nœud par bâtiment.
- Lancez l'installateur sur le serveur central et définissez l'URL de base de lecture sur une adresse que les bâtiments peuvent atteindre.
- Ajoutez les flux de chaînes sous Streams et les avis sous Movies, et vérifiez-les dans le lecteur web.
- Enrôlez un nœud par bâtiment depuis Servers ; le panneau l'installe par SSH, ou le nœud s'enrôle avec un code à usage unique, et y dirige les résidents de ce bâtiment.
- Ajoutez le gestionnaire immobilier sous Users → ajouter un revendeur, avec un groupe qui autorise les lines et aucune modification du catalogue.
Organisation du contenu
Des grilles par type de foyer.
- Créez un bouquet par grille à partir des chaînes de chaque type de foyer, et un bouquet pour l'information du gestionnaire.
- Ajoutez le bouquet d'information à chaque package pour que chaque résident reçoive les avis.
- Créez un package par type de foyer avec ses bouquets et une durée qui correspond au bail ou à la période d'occupation.
- Ordonnez les chaînes et donnez-leur des logos pour que le menu du téléviseur se lise bien.
Configuration des partenaires (revendeurs)
Le gestionnaire immobilier comme compte délégué.
- Créez un groupe avec des permissions limitées aux lines, sans accès au catalogue ni aux serveurs.
- Ajoutez chaque gestionnaire immobilier comme revendeur avec ce groupe, les packages de ses logements et un solde de crédits.
- Un gestionnaire de plusieurs bâtiments peut ajouter un sous-revendeur par bâtiment, chacun avec ses propres logements et crédits.
Configuration des logements (lines)
Une line par logement, nommée par son numéro.
- Créez une line par logement sous Lines → ajouter, avec le numéro du logement comme nom et le package de ce type de foyer.
- Définissez les connexions max. sur le nombre de téléviseurs du foyer.
- Utilisez un code d'activation à la place d'un mot de passe quand le résident doit saisir un code court sur l'appareil.
- Configurez l'appareil une fois (API Xtream Codes ou M3U avec les identifiants de la line, ou le portail MAG ou Enigma2) ; les identifiants restent avec le logement jusqu'à ce que la line en reçoive de nouveaux.
Vidéos d'accueil et d'avis
Les vidéos du gestionnaire à la demande.
- Téléversez la vidéo d'accueil, le règlement intérieur et les guides de maintenance comme films, avec une catégorie par sujet.
- Placez-les dans le bouquet d'information pour que chaque package les inclue.
- Remplacez une vidéo depuis le panneau quand l'information change ; les résidents voient la nouvelle version immédiatement.
Chaînes et chaîne d'information
La grille et la chaîne d'avis comme flux en direct.
- Ajoutez chaque chaîne sous licence sous Streams avec son flux, et une source EPG pour que le guide du téléviseur affiche les programmes.
- Ajoutez la chaîne d'information comme flux en direct, alimenté par un encodeur en RTMP ou par une source en boucle, et placez-la dans le bouquet d'information.
- Gardez les chaînes soumises à des limites de territoire dans des bouquets que seuls les bons packages accordent.
Emménagement, déménagement et expiration
L'occupation comme validité de la line.
- Une line expire à la fin de la période de son package ; renouvelez-la avec le package ou un crédit pour chaque nouvelle période du bail.
- Quand un résident part, désactivez la line ; le résident suivant la réactive avec de nouveaux identifiants, de sorte que rien ne reste chez l'ancien foyer.
- Abonnez le système de gestion locative ou le gestionnaire aux webhooks pour voir les lines sur le point d'expirer ou déjà expirées.
Intégration avec un système de gestion locative ou de facturation
Les systèmes ouvrent l'accès ; le lecteur lit.
- Créez une clé Reseller API pour le système de gestion locative ou de facturation ; il appelle create_line, renew_line, enable_line et disable_line, et envoie un identifiant de requête avec chaque écriture.
- Utilisez un connecteur e-commerce quand les résidents achètent des packages supplémentaires en ligne ; tout autre système utilise la Reseller API et les webhooks.
- Il n'y a pas de connexion unique (SSO) pour les spectateurs : un résident se connecte au lecteur avec les identifiants de la line.
Considérations de sécurité
Garder le service à l'intérieur de la résidence.
- 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 de gestion ; les gestionnaires immobiliers reçoivent un groupe de permissions limité aux lines.
- Une limite de connexions par line, des liens de lecture signés et expirants, et une liaison à l'adresse là où les appareils ont des adresses fixes.
- Activez la sauvegarde chiffrée de la base de données avec copie externe ; les identifiants des lines y sont conservés.
Dépannage
Les premières vérifications habituelles.
- Un logement n'a pas de télévision : vérifiez que sa line est activée et non expirée, puis les identifiants de l'appareil et l'adresse de lecture.
- Un bâtiment met en mémoire tampon le soir : vérifiez le heartbeat du nœud du bâtiment et que ses résidents y sont dirigés.
- Une chaîne manque pour un type de foyer : vérifiez les bouquets de ce package.
- Un gestionnaire ne peut pas créer de lines : vérifiez le solde de crédits du revendeur, les permissions de son groupe et les packages qui lui sont attribués.