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 abonnement ou point de présence. 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 de revendeur ou de partenaire régional | 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 |
| Palier de chaînes ou pack d'options | 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 de télévision | 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) |
| Bibliothèque VOD | 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 télévision de l'abonné | 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 |
| Fin de la période de facturation | 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 |
| Écrans par abonnement | Connexions max. de la line : combien d'appareils peuvent regarder en même temps | Les connexions max. de la line |
| Intégration facturation et provisionnement | Reseller API et webhooks : les opérations du panneau depuis votre propre système | Clés Reseller API et webhooks dans le tableau de bord du revendeur |
| Nœud d'un point de présence | 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 sur le site central (Ubuntu 22.04 ou 24.04), l'installateur, un domaine ou une adresse que les abonnés peuvent atteindre, et un serveur dans chaque point de présence pour les nœuds.
- Les flux de chaînes sous licence, la bibliothèque VOD, et le système de facturation où vivent les abonnements.
- Une décision sur les paliers, la durée d'une période de facturation, et quels revendeurs reçoivent un compte partenaire.
Déploiement de l'infrastructure
Le site central, puis les points de présence.
- Lancez l'installateur sur le serveur central ; placez le panneau derrière votre reverse proxy et définissez TRUSTED_PROXIES pour que les journaux et les règles d'IP voient l'adresse réelle de l'abonné.
- Définissez la base de lecture sur l'adresse publique que les abonnés atteignent, et la clé de licence sur le serveur.
- Enrôlez un nœud par point de présence depuis Servers ; le panneau l'installe par SSH, ou le nœud s'enrôle avec un code à usage unique, et y dirige les abonnés proches.
- Créez un compte partenaire (revendeur) pour le support ou l'équipe de facturation avec des permissions sur les lines uniquement.
Organisation du contenu
Des paliers et des options en bouquets.
- Ajoutez les chaînes sous Streams et la bibliothèque VOD sous Movies et Series, avec des catégories et une source EPG.
- Créez des bouquets pour la grille de base, les chaînes premium et la bibliothèque VOD.
- Créez un package par palier d'abonnement avec les bouquets qu'il accorde, la période de facturation comme durée et un prix en crédits.
- Créez un package d'essai court pour une promotion ou un nouveau client.
Configuration des partenaires (revendeurs)
Des revendeurs avec crédits.
- Créez un groupe pour les revendeurs avec des permissions sur leurs propres lines et sans accès au catalogue ni aux réglages.
- Ajoutez chaque revendeur régional comme compte partenaire avec ce groupe, les packages qu'il peut vendre et un solde de crédits ; un revendeur peut avoir des sous-revendeurs jusqu'à cinq niveaux de profondeur.
- Le webhook credits.low et l'avis de crédits faibles indiquent à un revendeur de recharger avant que les ventes s'arrêtent.
Configuration des lines d'abonnés
Une line par abonnement.
- La facturation crée une line quand un abonnement démarre, via un connecteur ou action=create_line de la Reseller API avec le package du palier et un identifiant de requête.
- Définissez les connexions max. par palier, le nombre d'écrans qu'un foyer peut utiliser en même temps.
- Liez une line à l'adresse, au pays ou au FAI de l'abonné quand l'offre est réservée à votre réseau.
- Pour un pilote ou un cas de support, ajoutez des lines depuis Lines → ajouter et remettez les identifiants.
Bibliothèque VOD
Le catalogue à la demande.
- Ajoutez des films et des séries avec saisons et épisodes, ingérés avec la tâche d'ingestion VOD ou téléversés, avec les métadonnées TMDB pour les affiches et les descriptions.
- Regroupez les titres en bouquets par palier ou par option, pour qu'un package accorde exactement ce que l'abonnement inclut.
- Les nœuds mettent en cache les fichiers VOD, de sorte que les titres populaires sont servis depuis le point de présence proche de l'abonné.
Chaînes en direct
La grille.
- Ajoutez chaque chaîne sous licence sous Streams avec son flux et activez le catch-up ou le timeshift seulement là où les droits le permettent.
- Ajoutez une source EPG pour que les applications et les boîtiers affichent le guide des programmes.
- Chaque nœud récupère une chaîne en direct une seule fois depuis l'origine et la redistribue à ses abonnés.
Expiration, renouvellement et résiliation
La période de facturation comme validité de la line.
- Une line dure le temps de la période de son package ; la facturation la renouvelle à chaque période avec action=renew_line ou via le connecteur.
- Quand un abonnement expire ou est résilié, la facturation appelle action=disable_line, et réactive la line à la remise en service.
- Abonnez la facturation aux webhooks pour rapprocher les lines bientôt expirées et expirées de ses enregistrements.
Intégration avec la facturation
La facturation pilote l'accès ; le lecteur lit.
- Installez le connecteur de votre système de facturation de son côté (WHMCS, Blesta, Odoo et d'autres), ou appelez la Reseller API avec une clé et un identifiant de requête depuis votre propre système.
- Il n'y a pas de connexion unique (SSO) pour les spectateurs : un abonné se connecte à une application ou un boîtier avec les identifiants de la line, que la facturation peut afficher dans l'espace client.
- Utilisez des clés Admin API avec indicateur lecture seule, liste blanche d'IP et date d'expiration pour les outils de reporting.
Considérations de sécurité
Réserver le service aux abonnés.
- Placez le panneau derrière le reverse proxy avec TLS et définissez TRUSTED_PROXIES ; gardez le trafic de gestion des nœuds sur un réseau privé.
- Connexion en deux étapes pour chaque compte du panneau et groupes de permissions pour le support et les revendeurs ; reCAPTCHA ou Turnstile sur la connexion.
- Liens de lecture signés et expirants, une limite de connexions par abonnement, et une liaison à une adresse, un pays ou un FAI là où c'est adapté.
- Sauvegardes chiffrées de la base de données avec copie externe, et journal d'audit pour chaque modification des lines et des crédits.
Dépannage
Les premières vérifications habituelles.
- Un abonné n'a pas de télévision : vérifiez que la line est activée et non expirée, puis l'appel de la facturation dans le journal des appels de la Reseller API.
- Une chaîne manque pour un palier : vérifiez les bouquets du package de ce palier.
- Un point de présence met en mémoire tampon : vérifiez le heartbeat de son nœud et que ses abonnés y sont dirigés.
- Un revendeur ne peut pas créer de line : vérifiez ses crédits et que le package fait partie de ceux qu'il peut vendre.