⚙️

Guide administrateur

Configuration et gestion du système REFCOMM — teams, téléphones, drapeaux, coordinateur ESP32, et paramétrage avancé.

Architecture du système

REFCOMM repose sur trois composants qui peuvent fonctionner ensemble ou séparément :

L'application iOS — installée sur le téléphone de chaque arbitre. Gère la communication vocale, les alertes drapeau, et la connexion BLE directe avec les drapeaux BLE.
Le coordinateur ESP32 — boîtier matériel sur le terrain. Reçoit les signaux 433MHz des télécommandes de drapeau, sert un point d'accès Wi-Fi local, et relaie les signaux à tous les téléphones connectés. Optionnel en mode global.
Le serveur global (Node.js) — ce site. Gère les comptes, les teams, et sert de coordinateur logiciel pour les matchs où un ESP32 n'est pas disponible ou quand les arbitres sont à distance.

Mode	Réseau requis	Convient pour
Local (ESP32)	Wi-Fi local créé par le boîtier	Terrain sans Internet, latence minimale
Global (serveur)	Internet (4G/5G ou Wi-Fi)	Arbitres dispersés, salle avec Wi-Fi

Créer un compte et se connecter

Rendez-vous sur la page d'accueil du site REFCOMM.

Cliquez Connexion puis onglet Inscription. Renseignez nom, email et mot de passe (6 caractères minimum).

Vérifiez votre email — un lien d'activation est envoyé automatiquement.

Une fois activé, connectez-vous. Vous arrivez sur le tableau de bord Mes teams.

Le premier compte créé n'est pas administrateur système. Le rôle Admin est attribué manuellement via la page Utilisateurs (accessible aux admins existants).

Gérer les teams

Créer une team

Dans Mes teams, saisissez un nom et cliquez Créer. Chaque team est un espace isolé avec ses propres téléphones et drapeaux. Un administrateur peut gérer plusieurs teams (un match par team, par exemple).

Partager une team avec les arbitres

Depuis la page d'une team, la section 📱 Connexion propose :

Un QR code à faire scanner par les arbitres depuis l'app.
Un bouton « Ouvrir dans REFCOMM » à transmettre par lien (SMS, email).
Une Clef de connexion à copier-coller dans le coordinateur ESP32 local.

Supprimer une team

En bas de la page de la team, bouton Supprimer cette team. Cette action est irréversible — tous les téléphones et drapeaux associés sont effacés.

Gérer les téléphones

Quand un arbitre scanne le QR code de la team, son téléphone apparaît dans la section En attente. Vous devez l'autoriser manuellement avant qu'il puisse communiquer.

Autoriser un téléphone

Dans la section En attente, cliquez Autoriser en face du nom de l'arbitre. Son téléphone passe immédiatement en Téléphones autorisés et l'app de l'arbitre sort du mode « En attente d'autorisation ».

Modifier le rôle d'un téléphone

Dans Téléphones autorisés, chaque entrée dispose d'un menu déroulant permettant de changer le rôle (JT1, JT2, RF, SUP, Central). La modification est prise en compte immédiatement, sans déconnexion.

Le nom et le rôle peuvent aussi être modifiés par l'arbitre lui-même depuis l'app. La valeur la plus récente prime des deux côtés.

Révoquer ou supprimer un téléphone

Révoquer — déconnecte l'arbitre et le repasse en « En attente ». Il peut se reconnecter mais devra être ré-autorisé.
Supprimer (depuis En attente) — retire définitivement le téléphone de la team.

Drapeaux 433MHz

Les drapeaux 433MHz sont des télécommandes radio physiques captées par le récepteur RF du coordinateur ESP32. Le serveur global peut aussi les simuler via l'interface admin du coordinateur en mode Gateway.

Appairer un drapeau 433MHz

Dans l'app iOS d'un arbitre, allez dans Réglages → Mes drapeaux → Ajouter un drapeau 433MHz.

Le coordinateur passe en mode appairage (60 secondes). Un compte à rebours s'affiche dans l'app.

Appuyez sur le bouton de la télécommande 433MHz. Le code radio est capté, le drapeau est enregistré.

Dans l'app, attribuez un nom, un rôle et un mode (BIP, Voix, ou BIP+Voix).

Chaque arbitre peut appairer ses propres drapeaux. Ils sont associés à son compte et visibles dans l'interface admin de la team.

Drapeaux BLE

Les drapeaux BLE (Seeed XIAO nRF52840, firmware REFCOMM) se connectent directement via Bluetooth à l'iPhone de l'arbitre, sans passer par le coordinateur. L'app relaie ensuite les événements au coordinateur.

Appairer un drapeau BLE

Allumez le drapeau : maintenez le bouton 3 secondes jusqu'aux deux bips de confirmation.

Dans l'app : Réglages → Mes drapeaux → Ajouter un drapeau BLE.

Le drapeau apparaît sous le nom BLE-XXXX (4 caractères hex dérivés de l'adresse BLE). Appuyez pour appairer.

Une fois appairé, attribuez un nom, un rôle et un mode depuis Mes drapeaux.

Un drapeau BLE est lié à l'arbitre qui l'a appairé. Si vous souhaitez transférer un drapeau à un autre arbitre, supprimez-le de l'app de l'un puis appairez-le depuis l'app de l'autre.

Configuration avancée du drapeau BLE

Depuis Réglages → Mes drapeaux, le bouton curseurs (⊞) sur un drapeau BLE connecté ouvre l'écran de configuration avancée. Ces réglages sont stockés dans la mémoire flash du drapeau et survivent aux coupures d'alimentation.

Réglage	Défaut	Description
Veille sans connexion	2 min	Durée sans connexion téléphone avant mise en veille automatique
Veille sans clic	2 h	Durée sans appui bouton avant veille, même si connecté
Clics pour éteindre	3 clics	Nombre de clics courts rapprochés pour déclencher l'extinction manuelle
Appui de démarrage	3 s	Durée d'appui requise pour allumer ou réveiller le drapeau (min 1 s, max 10 s)

Si Appui de démarrage est réglé trop long, il sera difficile de réveiller le drapeau rapidement sur le terrain. La valeur de 3 secondes est un bon compromis entre sécurité (pas de réveil accidentel) et praticité.

Coordinateur ESP32

Le coordinateur matériel est un boîtier ESP32 exécutant le firmware REFCOMM. Il crée un réseau Wi-Fi local REFCOMM-XXXXXXXX auquel les téléphones se connectent, sans nécessiter d'infrastructure réseau externe.

Accéder à l'interface admin

Depuis un téléphone connecté au réseau Wi-Fi du coordinateur, ouvrez un navigateur et allez sur http://refcomm.local (ou l'adresse IP affichée sur l'écran du boîtier si disponible).

Configuration Wi-Fi (mode connecté)

Si votre salle dispose d'un réseau Wi-Fi, le coordinateur peut s'y connecter (section Configuration WiFi → Connecté au réseau). Dans ce mode, les téléphones se connectent au Wi-Fi de la salle plutôt qu'au point d'accès du boîtier.

Mode Gateway (pont vers le serveur global)

En mode Gateway, le coordinateur ESP32 relaie les signaux 433MHz captés localement vers votre team sur le serveur global. Utile pour combiner des drapeaux 433MHz sur le terrain avec une team gérée sur le serveur.

Dans l'interface admin du coordinateur, section Configuration WiFi, passez en mode Gateway.

Saisissez ou envoyez la Clef de connexion de votre team (disponible sur la page de la team du site).

Sur la page de la team, cliquez l'icône flèche à côté de la clef pour l'envoyer directement au coordinateur.

Mise à jour du firmware (OTA)

La section Mise à jour de l'interface admin permet de mettre à jour le firmware du coordinateur via Wi-Fi, sans câble USB.

Modes de fonctionnement combinés

Scénario	Configuration recommandée
Terrain isolé, drapeaux 433MHz	Coordinateur ESP32 en mode standalone, app en mode local
Salle avec Wi-Fi, drapeaux BLE uniquement	Serveur global, pas d'ESP32 nécessaire
Terrain avec 433MHz + arbitres distants	ESP32 en mode Gateway, team sur serveur global
Mix 433MHz + BLE	ESP32 pour le 433MHz, BLE directement sur les apps iOS

Rôles et modes des drapeaux

Chaque drapeau a deux paramètres configurables, indépendants du rôle de l'arbitre :

Rôle du drapeau

Détermine le nombre de bips joués sur tous les téléphones quand ce drapeau se déclenche. Permet d'identifier acoustiquement qui a levé le drapeau, sans regarder l'écran.

JT1 → 1 bip
JT2 → 2 bips
RF → 3 bips
SUP → 4 bips

Mode du drapeau

BIP + Voix — bips sonores + message vocal synthétique annonçant le nom du drapeau.
BIP seul — bips uniquement, pas de voix.
Voix seule — message vocal uniquement, sans bips.

Ces deux paramètres se configurent depuis l'app iOS de l'arbitre propriétaire du drapeau, ou depuis l'interface web (section Drapeaux de la team).

Dépannage

Symptôme	Solution
Téléphone bloqué en « En attente » après autorisation	Révoquez puis ré-autorisez. Si persistant, demandez à l'arbitre de relancer l'app.
Drapeau 433MHz non capté	Vérifiez que le coordinateur est bien en mode appairage (icône 📡 visible). Réessayez à moins de 20 m.
Coordinateur ESP32 introuvable sur le réseau	Essayez `http://refcomm.local` ou scannez les IPs locales. Redémarrez le boîtier si nécessaire.
Mode Gateway ne se connecte pas au serveur	Vérifiez que la clef de connexion est correcte et que le coordinateur a accès à Internet.
Drapeau BLE ne se reconnecte pas	Éteignez et rallumez le drapeau (3 clics → 3 secondes appui). Vérifiez que le Bluetooth est actif sur l'iPhone.
Config drapeau BLE non sauvegardée	Le drapeau doit être connecté (point vert) pour que « Enregistrer » soit actif. Approchez le drapeau.
Lien QR code expiré ou refusé	Les clefs n'expirent pas — si la connexion échoue, vérifiez que le serveur est accessible et que la team existe toujours.