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 séance, habitant ou service. 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 |
|---|---|---|
| Séance du conseil ou chaîne publique | 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) |
| Archives des séances et bibliothèque de formation | 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 |
| Programme public ou collection d'un service | 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 habitant ou 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 |
| Validité d'un accès public ou du personnel | 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 |
| Intégration des systèmes du conseil | 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 dans le centre de données de l'institution (Ubuntu 22.04 ou 24.04), l'installateur, et un domaine derrière le reverse proxy de l'institution pour l'adresse publique.
- L'encodeur ou le mélangeur vidéo de la salle capable de pousser en RTMP, les enregistrements des séances passées et les vidéos de formation du personnel.
- Une décision sur ce qui est public et ce qui est interne, la durée d'une line publique, et lesquels des opérateurs reçoivent un compte du panneau.
Déploiement de l'infrastructure
Le serveur de gestion, puis les éventuels sites distants.
- Lancez l'installateur sur le serveur de l'institution ; placez le panneau derrière le 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.
- Définissez la base de lecture sur l'adresse publique que les habitants atteignent, et la clé de licence sur le serveur.
- Enrôlez un nœud depuis Servers pour un site qui en a besoin, comme un second bâtiment avec une salle de séance ; le panneau l'installe par SSH.
- Créez un compte partenaire (revendeur) pour l'équipe communication avec des permissions sur les lines publiques, et un pour les RH ou la formation pour les lines du personnel.
Organisation du contenu
Un programme public et des collections par service.
- Créez des catégories pour les séances, les commissions et l'information publique, et une série par instance, avec un épisode par réunion.
- Créez un bouquet public avec la chaîne en direct des séances et les archives, et un bouquet par collection de formation de service.
- Créez un package pour les habitants qui n'accorde que le bouquet public, avec une longue durée comme période d'accès.
- Créez des packages pour le personnel qui ajoutent les bouquets de formation et internes au bouquet public.
Configuration des partenaires (revendeurs)
Les équipes qui remettent l'accès.
- Créez un groupe avec des permissions sur les lines uniquement, et sans accès au catalogue ni aux réglages.
- Ajoutez l'équipe communication comme compte partenaire avec le package des habitants, et les RH ou la formation avec les packages du personnel.
- Un organisme ayant plusieurs services peut donner à chaque service son propre compte partenaire ; c'est un compte délégué, pas une installation isolée.
Configuration des lines des habitants et du personnel
Des lines publiques et des lines du personnel.
- Créez une clé Reseller API pour le site web du conseil et conservez-la dans ses secrets ; quand un habitant demande l'accès, il appelle action=create_line avec le package public et un identifiant de requête.
- Définissez une longue expiration sur les lines publiques, et une limite de connexions adaptée au visionnage en foyer.
- Créez des lines du personnel par service avec les packages du personnel, depuis le système du personnel du conseil via l'API ou depuis Lines → ajouter.
- Liez les lines du personnel à la plage d'adresses de l'institution quand le réseau le permet.
Archives des séances et bibliothèque de formation
Des enregistrements à la demande.
- Ajoutez chaque séance enregistrée comme épisode de la série de son instance, ingérée avec la tâche d'ingestion VOD ou téléversée, avec un titre, une date et une description.
- Placez la série des séances dans le bouquet public et la bibliothèque de formation dans les bouquets des services.
- Vérifiez la lecture avec une line de test du package public et une d'un package du personnel pour confirmer qui voit quoi.
Séances en direct
La salle comme chaîne en direct.
- Ajoutez un flux en direct avec un push RTMP depuis l'encodeur de la salle et placez-le dans le bouquet public.
- Activez le catch-up pour que les spectateurs arrivés en retard puissent revenir en arrière, et ajoutez une entrée EPG ou un titre pour que les spectateurs sachent quelle réunion est diffusée.
- Testez le flux avant chaque réunion, et gardez un nœud près d'un deuxième site s'il accueille aussi des séances.
Expiration et renouvellement
Longue pour le public, liée à l'emploi pour le personnel.
- Une line publique dure autant que la durée du package ; prolongez-la avec action=renew_line quand l'habitant la redemande.
- Une line du personnel est renouvelée tant que la personne travaille pour l'institution et désactivée avec action=disable_line quand elle part.
- Abonnez les systèmes du conseil aux webhooks pour voir les lines bientôt expirées et désactivées.
Intégration avec les systèmes de l'institution
Les systèmes pilotent l'accès ; le lecteur lit.
- Le site web et le système du personnel créent, renouvellent, activent et désactivent des lines via la Reseller API avec une clé et un identifiant de requête.
- Il n'y a pas de connexion unique (SSO) pour les spectateurs ni d'intégration native avec un produit du secteur public en particulier : les spectateurs se connectent au lecteur avec les identifiants de leur line.
- 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é
Exploité par l'institution, ouvert là où il doit l'être.
- Gardez la plateforme sur l'infrastructure de l'institution derrière le reverse proxy avec TLS, et gardez le matériel public et interne dans des bouquets séparés.
- Connexion en deux étapes pour chaque compte du panneau et groupes de permissions par équipe ; reCAPTCHA ou Turnstile sur la connexion si le panneau est joignable de l'extérieur.
- Liens de lecture signés et expirants, une limite de connexions par line, et liaison à l'adresse sur 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 habitant ne peut pas regarder : vérifiez l'expiration de la line, qu'elle est activée, et le bouquet public du package.
- Une séance ne démarre pas : vérifiez le push de l'encodeur vers le flux et l'état du flux dans le panneau.
- Le personnel ne voit pas la bibliothèque de formation : vérifiez le package de la line du personnel et les bouquets qu'il accorde.
- Le journal d'audit montre l'adresse du proxy : définissez TRUSTED_PROXIES sur le proxy et redémarrez le panneau.