Guide d'utilisation opérateur

Cette page couvre le workflow opérateur une fois qu’un admin est créé (voir first-admin.md).

1. Connexion

Ouvrez https://<your-domain>/login et connectez-vous avec vos identifiants admin. Si la 2FA est activée, saisissez le code TOTP de votre application d’authentification.

En développement, un panneau « Dev only — Connexion rapide » sous le formulaire permet de se connecter en un clic en tant que [email protected]. Éliminé du bundle (tree-shaken) en production.

Astuce — pour sauter les étapes 2 à 4 ci-dessous, lancez pnpm seed après pnpm dev : la commande crée un événement de démo + un commentateur + une invitation via l’API et affiche les URL prêtes à coller. Utile quand vous avez juste besoin d’une vue live fonctionnelle pour travailler.

2. Créer un événement

Depuis la liste des événements, cliquez sur « Nouveau ». Renseignez :

Nom — nom d’affichage (p. ex. « FC Sion vs Servette »)
Description — notes optionnelles
Date de début / fin — planification optionnelle

L’événement est créé au statut draft. Cliquez dessus pour ouvrir la vue de détail.

3. Ajouter un commentateur

Dans le détail de l’événement, descendez jusqu’à « Commentateurs » et cliquez sur « Ajouter ». Renseignez :

Nom — nom d’affichage du commentateur
Langue — fr/en/de/it
Audio channels — optionnel, utilisé pour les configurations matérielles multicanal
Gain micro — commencez à 0 dB

La v1.x n’autorise qu’un commentateur par événement (périmètre mono-commentateur).

4. Générer un lien d’invitation

Dans la carte du commentateur, dépliez « Invitations » et cliquez sur « Générer une invitation ». Options :

Mot de passe (optionnel) — ajoute une protection par mot de passe sur le lien
Usage unique — le lien est consommé après la première utilisation
Expiration — horodatage d’expiration automatique

Après génération, l’URL complète est affichée une seule fois. Cliquez sur « Copier » pour la copier dans le presse-papiers, puis envoyez-la au commentateur (SMS, e-mail, Telegram, etc.).

⚠️ L’URL n’est affichée qu’une seule fois — copiez-la avant de fermer la fenêtre.

5. Changer le statut de l’événement

Transitions disponibles :

draft → scheduled (planification confirmée)
scheduled → live (le commentateur va se connecter)
live → ended (diffusion terminée)
ended → archived (archivage à long terme)

Cliquez sur les boutons dans le détail de l’événement. Les transitions invalides sont masquées.

6. Passer en direct (côté studio)

Cliquez sur « Démarrer en direct » pour ouvrir la vue live :

Le token LiveKit est généré côté serveur, le studio rejoint la room du commentateur
Le vumètre s’anime à 60 Hz
Le badge « à l’antenne » se met à jour en temps réel via WebSocket lorsque le commentateur clique sur ON-AIR

Nouveau en v1.2 — deux panneaux vidéo supplémentaires apparaissent quand le commentateur se connecte :

ComCam apparaît comme panneau vidéo à côté de l’aperçu PGM lorsque le commentateur publie sa webcam. Utilisez l’icône en forme d’œil pour le masquer localement s’il détourne l’attention du vumètre. Si le commentateur coupe sa caméra, vous voyez le placeholder.
Aperçu PGM montre ce que voit le commentateur, audio coupé pour éviter le larsen.

7. Publication PGM + Talkback depuis le navigateur (v1.6+)

Le studio publie la vidéo + l’audio PGM (retour programme) et l’audio d’intercom talkback directement depuis le navigateur — pas d’OBS, pas de streamer externe.

Dans la vue live, deux panneaux apparaissent sous la carte du commentateur :

PGM — choisissez une webcam + un micro, cliquez sur « Publier ». Le commentateur voit la vidéo en plein écran derrière les contrôles d’antenne. L’audio est routé vers la piste pgm-audio et mixé dans le retour du commentateur.
Talkback — choisissez le micro d’intercom (typiquement un casque fermé ou le combiné talkback de la régie), cliquez sur « Publier ». L’audio part vers la piste talkback-audio. Le commentateur l’entend sur un canal séparé, avec le placeholder PiP talkback visible dans le coin du kiosk.

L’état de publication est propre à l’onglet. Si l’opérateur ferme l’onglet du studio, les deux pistes sont dépubliées — le commentateur retombe dans le silence.

Note historique : les versions v1.1–v1.5 routaient le PGM via OBS WHIP. La version LiveKit v1.7.2 déployée n’expose pas l’endpoint /whip, donc ce chemin n’a jamais fonctionné en production. La v1.6 a remplacé WHIP par la publication depuis le navigateur.

8. Révoquer / renouveler les invitations

Dans la carte du commentateur, dépliez « Invitations ». Pour chaque invitation active :

Révoquer — invalide immédiatement l’invitation. Utile si le lien a fuité.

Pour renouveler (= révoquer + nouvelle), révoquez l’invitation existante puis cliquez à nouveau sur « Générer une invitation ».

9. Gérer les utilisateurs (admin uniquement)

Depuis l’en-tête de la liste des événements, les admins voient un lien « Utilisateurs ». Sur la page des utilisateurs :

Ajouter — créer un nouvel opérateur ou admin
Modifier — changer le rôle, le nom d’affichage, la langue
Désactiver — suppression douce (l’utilisateur ne peut plus se connecter, le journal d’audit est conservé)

Vous ne pouvez pas vous désactiver vous-même.

10. Paramètres

Thème — bascule clair/sombre (persistée dans le localStorage)
Langue — fr/en/de
Sécurité — configurer la 2FA, changer le mot de passe

Après un changement de mot de passe, vous êtes déconnecté (toutes les sessions sont révoquées).