1 · Comment vous brancher

Deux URL à connaître. La première vous donne l'état complet du tournoi en une requête. La seconde vous abonne aux mises à jour en temps réel. Vous pouvez utiliser l'une, l'autre, ou les deux ensemble.

Exemple en ligne de commande

# Snapshot ponctuel (vous récupérez l'état complet une fois)
curl /api/tournoi/snapshot

# Flux temps réel (chaque événement s'affiche au fur et à mesure)
curl -N /api/stream/tournoi

Exemple JavaScript / navigateur

// 1. Récupérer l'état initial
const reponse = await fetch("/api/tournoi/snapshot")
const { data } = await reponse.json()
const tournoi = data.tournoi

// 2. S'abonner aux mises à jour en temps réel
const flux = new EventSource("/api/stream/tournoi")

flux.addEventListener("snapshot", (e) => {
  // Premier message : état complet du tournoi
  const { tournoi } = JSON.parse(e.data)
  monTemplate.mettreAJour(tournoi)
})

flux.addEventListener("evenement", (e) => {
  // Chaque changement métier (point, jeu, set, fin de match, etc.)
  const { tournoi, ev } = JSON.parse(e.data)
  monTemplate.mettreAJour(tournoi)
})

2 · Format des données

Le JSON renvoyé par les deux URL est identique en structure : il contient toujours un objet tournoi avec tous les champs ci-dessous.

Niveau racine — objet tournoi

Champs additionnels à ignorer côté régie : le JSON contient aussi poolJoueurs,poolEquipes, equipe1Id et equipe2Id. Ces champs servent à la page d'administration pour gérer un pool global d'équipes et de joueurs (création/réservation pour de futures compétitions, joueurs partagés entre plusieurs équipes). La régie n'en a pas besoin :tournoi.equipes.equipe1 et equipe2 exposent déjà tout ce qu'il faut afficher avec les joueurs résolus directement.

Une équipe — tournoi.equipes.equipe1 / equipe2

Une épreuve — un élément de tournoi.epreuves

Il y a quatre types d'épreuves, repérés par le champ type. Les champs communs sont listés en premier ; les champs spécifiques varient ensuite.

Champs spécifiques aux matchs (Frenchies + Galactic)

Spécifique au Match Frenchies (lever de rideau, chrono 30 min)

Objet timer (présent dans Frenchies et concours)

Le chrono est sérialisé avec deux champs déjà calculés par le moteur à chaque envoi (snapshot REST + heartbeat SSE chaque seconde) : chronoAffichage ettempsRestantMs. Vous pouvez les utiliser directement sans refaire le calcul vous-mêmes. Les champs bruts restent disponibles si vous voulez un chrono qui tique côté template entre deux messages (voir conseil « Chrono fluide entre deux messages » plus bas).

Spécifique aux concours (Magic Puerta, Crazy Volley, Epic Defense)

Spécifique au Jeu en Or (finale éventuelle à 12-12 sur le cumul 2 jours)

Le Jeu en Or se joue en super tie-break, premier à 5 points, point en or à 4-4 (mort subite : à 4-4 le point suivant donne la victoire 5-4). L'arbitre marque les points un par un comme sur un tie-break : pas de jeux ni de sets ici, juste un compteur de points par équipe.

Bloc tournoi.transitions — snapshots figés des dernières transitions

Ce bloc expose, en parallèle de l'état temps réel, trois snapshots figés des dernières transitions du tournoi : le dernier jeu qui vient de se terminer dans un match, le dernier set qui vient de se terminer, et la dernière épreuve qui vient de se terminer (match, concours ou Jeu en Or). Chaque snapshot porte un horodatage précis de fin (horodatageMs, milliseconde Unix), ce qui vous permet, dans votre habillage, de décider combien de temps vous gardez l'info à l'antenne — par exemple, garder le score finalisé du jeu précédent visible pendant 10 secondes avant de basculer sur le nouveau jeu, surtout utile quand le Jeu en Or démarre brusquement après un 12-12 final au score général.

Politique de conservation : une fois rempli, un champ reste rempli indéfiniment jusqu'à la prochaine transition du même type qui le remplace. À l'ouverture du tournoi (aucune transition encore survenue), les trois champs valent null.

Sous-champs de transitions.dernierJeuFini

Sous-champs de transitions.dernierSetFini

Sous-champs de transitions.derniereEpreuveFinie

3 · Cas particuliers et conseils

let decalageHorloge = 0 // écart entre votre horloge et celle du moteur

// À chaque message reçu (battement ou snapshot) :
//   decalageHorloge = Date.now() - new Date(message.ts).getTime()

function tempsRestantMs(timer) {
  const maintenantMoteur = Date.now() - decalageHorloge
  const ecoule = timer.enCours
    ? timer.tempsEcouleMs + (maintenantMoteur - timer.derniereSyncMs)
    : timer.tempsEcouleMs
  return Math.max(0, timer.dureeInitialeMs - ecoule)
}

const t = tournoi.transitions.dernierJeuFini
if (t) {
  const ageMs = Date.now() - t.horodatageMs
  if (ageMs < 10000) {
    // Le jeu s'est terminé il y a moins de 10s — on l'affiche encore
    afficherBandeau(`${t.libelleEpreuve} · Set ${t.numeroSet} · ${
      t.vainqueur === "equipe1" ? "Équipe 1" : "Équipe 2"
    } gagne le jeu ${t.scoreFinal.equipe1}-${t.scoreFinal.equipe2}`)
  }
}

4 · Démo live — JSON courant du tournoi

Le bloc ci-dessous affiche exactement ce que reçoit votre logiciel à chaque mise à jour du tournoi. Ouvrez cette page sur un second écran pendant que la tablette arbitre tourne, et vous verrez les champs bouger en temps réel.

Connexion au flux…