SCOREBOARD HOCKEY POUR OBS : DÉPLOIEMENT SUR belier.synaxess.ca
================================================================

ADRESSES UNE FOIS DÉPLOYÉ

  Télécommande   https://belier.synaxess.ca/scoreboard/control.html#k=TA-CLE
  Overlay OBS    https://belier.synaxess.ca/scoreboard/overlay.html?delay=2500
  Vérification   https://belier.synaxess.ca/scoreboard/api.php

  La clé (TA-CLE) est dans config.php.


DÉPLOIEMENT AVEC CPANEL (environ 5 minutes)

1. Sous-domaine
   cPanel > Domaines : vérifie que belier.synaxess.ca existe et note son dossier racine
   (colonne « Racine du document »).

2. Fichiers
   cPanel > Gestionnaire de fichiers : ouvre ce dossier racine.
   Téléverse scoreboard-hockey.zip, puis clic droit > Extraire (Extract).
   Tu obtiens le dossier scoreboard/. Rien d'autre n'est touché dans le dossier racine.
   Supprime ensuite le zip du serveur.

3. PHP
   cPanel > MultiPHP Manager : PHP 7.2 ou plus récent pour belier.synaxess.ca.
   Aucune base de données, aucune extension particulière.

4. HTTPS
   cPanel > SSL/TLS Status : belier.synaxess.ca doit avoir un certificat.
   S'il n'en a pas, lance « Run AutoSSL ».

5. Vérification du serveur
   Ouvre https://belier.synaxess.ca/scoreboard/api.php
   Tu dois voir du texte qui commence par {"ok":true et qui contient « Hawks ».
   Si tu vois du code PHP ou une erreur 500, PHP n'est pas actif pour ce dossier : retourne à l'étape 3.

6. Vérification de l'écriture
   Ouvre la télécommande sur le cell du pointage (adresse plus haut, avec la clé).
   Appuie sur « +1 but », puis sur « Retirer un but ».
   La barre du haut doit rester à « En ligne ». Ajoute la page à l'écran d'accueil.

7. OBS
   Sources > + > Navigateur. URL : l'adresse de l'overlay. Largeur 1920, hauteur 1080.
   Place la source au-dessus de la caméra dans la scène.

SANS CPANEL (SFTP ou SSH)
   Dépose le dossier scoreboard/ dans la racine web du sous-domaine.
   PHP doit pouvoir écrire dans ce dossier : il y crée state.json et games.json.


LES MATCHS PRÉPARÉS

  Trois matchs sont déjà dans la télécommande, section « Matchs préparés » :
    Vendredi 10 h 10   Hawks c. Béliers Québec-Centre
    Vendredi 17 h 50   Béliers Québec-Centre c. Tigres 2
    Samedi 12 h 20     Mustangs Napierville c. Béliers Québec-Centre

  Avant chaque match : « Charger », puis « Confirmer ». Les équipes se placent, le pointage
  revient à zéro et la carte d'avant-match s'affiche. À la mise au jeu : « Commencer le match ».

  À régler une fois, dans « Réglages du match » :
    Couleurs     celles du zip sont provisoires. Choisis les vraies ; la couleur d'une équipe
                 est retenue pour ses matchs suivants.
    Périodes     15 minutes par défaut. Change la durée si le tournoi joue autrement.
    Côtés        « Inverser gauche et droite » si l'ordre ne suit pas le tableau de l'aréna.

  Matchs suivants (demi-finale, finale) : « Ajouter un match » dans la même section.


FICHIERS

  overlay.html       ce que les spectateurs voient : bandeau de pointage, but, cartes, message
  control.html       la télécommande
  api.php            l'état partagé
  config.php         la clé de contrôle
  games.seed.json    les matchs livrés avec le zip
  fonts/             la police Saira (licence OFL, texte inclus)
  state.json         créé par api.php : le pointage en cours
  games.json         créé par api.php : tes matchs et les couleurs retenues


PARAMÈTRES DE L'OVERLAY (dans l'adresse, tous optionnels)

  delay=2500     retard en millisecondes, pour suivre la latence de la vidéo
  scale=1.2      grossit le bandeau de pointage et le message
  pos=tl|tc|tr   position du bandeau : haut gauche, haut centre, haut droite
  bg=1           faux arrière-plan, pour voir l'overlay hors d'OBS

  Exemple : overlay.html?delay=3000&scale=1.15&pos=tr


METTRE À JOUR PLUS TARD

  Téléverse le nouveau zip au même endroit et extrais-le par-dessus l'ancien.
  state.json et games.json ne sont pas dans le zip : le pointage et tes matchs restent en place.
  config.php est remplacé : si tu as changé la clé, remets-la.


SI ÇA NE MARCHE PAS

  « Clé refusée »
      La clé du lien ne correspond pas à celle de config.php.

  « Impossible d'écrire state.json » ou « games.json »
      Donne la permission 755 au dossier scoreboard dans le Gestionnaire de fichiers.

  Rien ne s'affiche dans OBS
      Ouvre overlay.html?bg=1 dans un navigateur. Si le bandeau apparaît là,
      vérifie l'adresse et la taille (1920 x 1080) de la source dans OBS.

  « Serveur injoignable » sur la télécommande
      Refais la vérification de l'étape 5.
