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 équipe ou adhérent. 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 |
|---|---|---|
| Flux de match ou d'entraînement | 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 d'analyse et de rediffusion | 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 |
| Package d'équipe ou de compétition | Bouquet : un ensemble nommé de chaînes, films ou séries qu'un package accorde | Bouquets, à partir de Streams et de Movies / Series |
| Accès adhérent ou famille | 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 |
| Saison ou période d'adhésion | 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 |
| Compte de l'équipe ou du personnel de l'académie | 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 |
| Intégration boutique ou gestion de club | 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 |
Prérequis
Ce qu'il faut avoir avant d'installer.
- Un serveur (Ubuntu 22.04 ou 24.04) avec une adresse publique ou un domaine, et assez de bande passante montante pour les matchs que vous prévoyez de diffuser.
- La caméra et l'encodeur du terrain capables de pousser en RTMP, et les fichiers d'entraînement et d'analyse enregistrés que vos entraîneurs conservent déjà.
- Une décision sur qui voit quoi : quelles équipes partagent du matériel, quels matchs sont réservés aux adhérents, et quels membres du personnel reçoivent un compte du panneau.
Déploiement de l'infrastructure
L'académie d'abord, un nœud quand les jours de match l'exigent.
- Lancez l'installateur sur le serveur de l'académie et placez le panneau derrière un reverse proxy avec TLS ; définissez les proxys de confiance pour que les journaux et les règles d'IP voient l'adresse réelle du spectateur.
- Définissez l'URL de base de lecture sur l'adresse publique que les spectateurs atteignent, pour que les liens émis par le panneau fonctionnent depuis chez soi.
- Si de nombreuses familles regardent le même match, enrôlez un nœud depuis Servers ; le panneau l'installe par SSH et redistribue la chaîne en direct depuis celui-ci.
- Créez un compte partenaire (revendeur) pour l'encadrement avec des permissions sur le catalogue et aucune sur les lines des adhérents.
Organisation du contenu
Des équipes et des saisons en catégories, l'accès en bouquets.
- Créez des catégories par tranche d'âge et par saison, et des séries pour les compétitions avec un épisode par match.
- Créez un bouquet par matériel d'analyse d'équipe, un pour les chaînes de matchs en direct et un pour toute l'académie.
- Créez un package par type d'adhésion : les bouquets qu'il accorde, avec la saison comme durée et un prix en crédits si le personnel le vend.
- Nommez les bouquets d'après l'équipe ou la compétition à laquelle ils appartiennent, pour que le personnel sache quel package donner à une famille.
Configuration des partenaires (revendeurs)
Le personnel qui gère ses propres adhérents, si le club le souhaite.
- Créez un groupe avec des permissions sur le catalogue pour les entraîneurs et un groupe avec des permissions sur les lines pour le secrétariat des adhésions.
- Ajoutez chacun d'eux comme revendeur avec le groupe correspondant ; ne donnez des crédits au secrétariat que si les adhésions sont vendues via le panneau.
- Une académie satellite ou un club de supporters ayant ses propres adhérents reçoit son propre compte partenaire et ses propres packages.
Configuration de l'accès des adhérents et des familles
Une line par adhérent ou par famille.
- Créez une clé Reseller API pour la boutique ou le système de gestion du club et conservez-la dans les secrets de ce système.
- À l'inscription, le système appelle action=create_line avec le package de l'adhésion et un identifiant de requête ; la saison est la durée du package.
- Définissez les connexions max. sur les appareils dont une famille a besoin (en général trois ou quatre) pour qu'une adhésion ne soit pas partagée au-delà du foyer.
- Pour un jour de match d'essai, ajoutez une line depuis Lines → ajouter avec un package d'essai, ou imprimez des codes d'activation pour les supporters en tribune.
Bibliothèque d'analyse et de rediffusion
Des matchs et des séances à la demande.
- Téléversez chaque match ou séance comme source d'un épisode, ou ingérez-le avec la tâche d'ingestion VOD ; gardez la date, l'adversaire et l'équipe dans le titre.
- Rattachez l'enregistrement au bouquet de l'équipe via sa série, pour que seules les lines de cette équipe le voient.
- Vérifiez la lecture avec une line de test de chaque adhésion pour confirmer qui voit quoi.
Flux de matchs et d'entraînements
Une caméra de terrain comme chaîne en direct.
- Ajoutez un flux en direct pour chaque encodeur du terrain (push RTMP) et placez-le dans le bouquet des jours de match.
- Activez le catch-up pour qu'une famille qui arrive en retard puisse revenir en arrière, et ajoutez l'enregistrement à la bibliothèque après le coup de sifflet final.
- Un jour de match chargé, vérifiez que le nœud récupère la chaîne une seule fois depuis l'origine et dessert les spectateurs qui lui sont dirigés.
Expiration de l'adhésion
L'accès suit la saison.
- Une line expire à la fin de la période de son package ; la boutique la renouvelle avec action=renew_line quand la cotisation de la saison suivante est payée.
- Abonnez la boutique aux webhooks pour envoyer un rappel sur line.expiring et clore l'adhésion sur line.expired.
- Un joueur qui part en cours de saison est désactivé par la boutique avec action=disable_line ; la line est conservée pour les archives.
Intégration avec la boutique ou le logiciel du club
Les systèmes pilotent l'accès ; le lecteur lit.
- Installez le connecteur de votre plateforme e-commerce (WooCommerce, Shopify et d'autres) côté boutique pour qu'un achat crée la line et qu'un paiement la renouvelle.
- Un système de gestion de club ou de billetterie se connecte via la Reseller API et les webhooks ; il n'existe pas de connecteur natif pour lui.
- Il n'y a pas de connexion unique (SSO) pour les spectateurs : les adhérents se connectent au lecteur avec les identifiants de leur line, que la boutique leur envoie.
Considérations de sécurité
Le matériel d'une équipe reste dans l'équipe.
- Servez le panneau et l'URL de base de lecture en TLS et définissez TRUSTED_PROXIES sur votre reverse proxy.
- Connexion en deux étapes pour chaque compte du panneau, et groupes de permissions pour que le secrétariat ne puisse pas modifier le catalogue et que les entraîneurs ne puissent pas voir les lines.
- Liens de lecture signés et expirants, une limite de connexions par line, et une liaison à l'IP ou au pays pour les lines du personnel.
- Sauvegardes chiffrées de la base de données avec copie externe, et journal d'audit pour chaque modification des lines et du catalogue.
Dépannage
Les premières vérifications habituelles.
- Un parent voit l'analyse de l'équipe première : vérifiez le package de la line et les bouquets qu'il accorde.
- Un nouvel adhérent n'a pas d'accès après avoir payé : vérifiez dans le journal des appels de la Reseller API la requête de la boutique et la date d'expiration de la line.
- Le flux du match saccade au coup d'envoi : vérifiez l'envoi de l'encodeur au terrain, et le heartbeat du nœud si l'un dessert les spectateurs.
- Le journal d'audit montre l'adresse du proxy : définissez TRUSTED_PROXIES sur le proxy et redémarrez le panneau.