🏆 Gestion des tournois

Ce document décrit l'intégralité de la fonctionnalité Tournois telle qu'elle est implémentée : organisation et hébergement d'un tournoi par un club (tournoi de jeunes / plateau, seniors…), de la création jusqu'à la page publique pour les spectateurs.

Gestionnaire = actions réservées au créateur, aux co-organisateurs ajoutés, ou à un admin du club.
Tous = visible par tous les membres du club (lecture).

1. Accès, rôles et cycle de vie

• Niveau club : les tournois appartiennent au club (et non à un groupe). Le bouton 🏆 Tournois est accessible depuis la page du club à Tous les membres.
• Rôles de gestion : le créateur du tournoi, les co-organisateurs qu'il ajoute, et les admins du club peuvent tout gérer. Les autres membres sont en lecture seule.
• Liste des tournois : chaque tournoi affiche son nom, sa date, son lieu et son statut (Brouillon / En cours / Terminé).
• Durée de vie (TTL) : un tournoi est conservé 1 an (champ expireDate), puis supprimé automatiquement avec toutes ses données associées (équipes + matchs) par une tâche planifiée quotidienne.
• Suppression manuelle Gestionnaire : un bouton supprime le tournoi et ses sous-collections (équipes, matchs), avec confirmation.

2. Création d'un tournoi

Gestionnaire (tout membre du club peut créer et devient créateur). Formulaire :

• Nom du tournoi (obligatoire).
• Date et lieu.
• Format : Poules + phases finales / Poules seules / Élimination directe.

À la création, des valeurs par défaut sont posées : 1 terrain (« Terrain 1 »), barème 3-1-0, départage FIFA, durée de poule 12 min, durée de finale 15 min, repos 3 min, pause repas à 12:00 (45 min min/équipe), reprise 13:30, début 09:00. Le créateur est ajouté comme organisateur, un identifiant de partage public est généré, et expireDate est fixé à +1 an.

3. Configuration

Gestionnaire. Toute la configuration structurelle est masquée une fois le tournoi figé ou commencé (voir §4).

3.1 Durées & horaires

Réglage	Rôle
Heure de début	Départ des premiers matchs de poule.
Durée match de poule	Durée d'un match de poule (min).
Durée match de finale	Durée d'un match de phase finale (min).
Repos entre matchs	Temps minimum entre deux matchs (équipe et terrain).
Pause repas à partir de	Heure à partir de laquelle on cale la pause déjeuner.
Pause repas min / équipe	Durée minimale de pause repas garantie par équipe.
Reprise l'après-midi	Heure à laquelle toutes les équipes ont fini leur pause (reprise).
Phases finales l'après-midi uniquement	Force le démarrage des finales à la reprise de l'après-midi.

La pause déjeuner est « flexible » : elle n'est pas fixe. Dès qu'un match d'une équipe tomberait après l'heure de début de pause, l'équipe prend sa pause (au moins la durée min) et ne rejoue qu'à partir de la reprise de l'après-midi.

3.2 Barème de points (choix obligatoire)

Barème	Attribution
3-1-0 (moderne)	Victoire 3 · Nul 1 · Défaite 0.
4-2-1 (amateur historique)	Victoire 4 · Nul 2 · Défaite 1.
3-2-1-0 (avec tirs au but)	Victoire (temps réglementaire) 3 · Victoire aux t.a.b. 2 · Défaite aux t.a.b. 1 · Défaite 0. En cas de nul, l'organisateur désigne le vainqueur des tirs au but sur le match.

3.3 Départage des égalités (choix obligatoire)

Configuration	Ordre des critères (après les points)
UEFA	Confrontation directe → goal-average général → buts marqués.
FIFA	Goal-average général → buts marqués → confrontation directe.
Express	Goal-average général → tirs au but.

Les critères fair-play (cartons) et tirage au sort ne sont pas calculés automatiquement : ils resteraient un départage manuel. La partie calculable (points, confrontation directe, goal-average, buts marqués) est appliquée selon la configuration choisie.
Précision : l'application collecte bien les cartons, mais sur les matchs d'un groupe (module Statistiques du match en direct). Les matchs de tournoi sont un modèle distinct, sans saisie de cartons — d'où l'absence de départage fair-play ici.

3.4 Terrains & co-organisateurs

• Terrains : liste modifiable (ajout / suppression), utilisée par la planification multi-terrains. Retirer un terrain déplace les matchs qui y étaient programmés vers un terrain restant, et le nombre de matchs déplacés est annoncé — un match ne reste jamais rattaché à un terrain qui n'existe plus.
• Co-organisateurs : le créateur peut ajouter des membres du club pour l'aider à piloter le tournoi (le créateur ne peut pas être retiré). Seuls le créateur et un admin du club peuvent modifier cette liste : un co-organisateur ne peut ni s'en retirer ni en ajouter (contrainte portée par les règles Firestore, pas seulement par l'interface).

4. Gel de la configuration & verrouillage

• Gel manuel Gestionnaire : un bouton « Figer la configuration » verrouille la structure (utile quand les horaires et adversaires ont été communiqués aux clubs). Un bouton « Défiger » permet de revenir en arrière tant qu'aucun score n'a été saisi.
• Verrouillage automatique : dès la première saisie de score (ou changement de statut d'un match), la configuration est verrouillée définitivement.
• Une fois verrouillée, la configuration structurelle est masquée ; seule reste la bannière d'information (et le bouton défiger si applicable).
• La correction d'un score reste toujours possible, même après verrouillage.
• La liste des arbitres reste ajustable à tout moment (voir §8), de même que le renommage d'une équipe (§5) et le terrain/arbitre par match (§7).

5. Équipes participantes

Bloc repliable. Tous voient la liste ; Gestionnaire pour l'édition.

• Ajout par nom libre (équipes externes possibles), avec logo optionnel et club d'origine optionnel (ex. « ASSE ») — utile quand plusieurs équipes d'un même club participent.
• Lier une équipe interne du club : récupère automatiquement le nom et le logo.
• Doublon interdit : deux équipes ne peuvent pas porter le même nom (insensible à la casse).
• Renommage : possible à tout moment, même une fois le tournoi commencé.
• Suppression : possible uniquement avant le démarrage (bloquée une fois le tournoi lancé).

6. Poules

• Choix du nombre de poules (1 à 6).
• Répartition automatique équilibrée (bouton) : les équipes sont distribuées entre les poules (A, B, C…).
• Ajustement manuel : un sélecteur par équipe permet de changer sa poule.
• Zone « Non réparties » pour les équipes sans poule.
• La répartition est verrouillée dès le tournoi figé/commencé.

7. Calendrier & planification multi-terrains

Gestionnaire. Le bouton « Générer le calendrier » produit en une fois les matchs de poule et le bracket des phases finales (voir §11).

Algorithme des poules

• Round-robin par la méthode du cercle : toutes les équipes d'une poule se rencontrent.
• Planification par tours : dans un tour, chaque équipe ne joue qu'une fois → temps de repos garanti.
• Multi-terrains : les matchs sont répartis sur les terrains disponibles ; le repos entre matchs est respecté.
• Pause déjeuner appliquée par équipe (cf. §3.1).

La génération du calendrier crée aussi les matchs de finale (à vide) et les planifie après les poules → on obtient l'heure d'atterrissage (fin estimée) du tournoi dès le départ.

Les choix de génération sont mémorisés sur le tournoi (nombre de poules, taille du tableau, petite finale, consolante). Sans cela, rouvrir la page puis relancer la génération repartait des valeurs par défaut et changeait le tableau sous les pieds de l'organisateur.

8. Arbitres

• Liste des arbitres : ajustable à tout moment (les arbitres arrivent souvent à la dernière minute), dans une carte dédiée.
• Affectation découplée : un bouton « Affecter les arbitres aux matchs » (séparé de la génération du calendrier) attribue au mieux un arbitre à chaque match à venir, en évitant qu'un arbitre soit sur deux matchs en même temps et en répartissant la charge.
• Ajustement manuel par match : le terrain et l'arbitre d'un match restent modifiables tant que le match n'a pas commencé (§7 / §9).

9. Saisie des scores

Gestionnaire, directement sur chaque match (dépliage).

• Steppers +/− pour chaque score, pensés pour une saisie mobile sur le terrain.
• Statut du match : À venir / En cours / Terminé.
• Terrain & arbitre modifiables tant que le match est « À venir ».
• Match nul (élimination directe, ou poule en barème 3-2-1-0) : un sélecteur permet de désigner le vainqueur aux tirs au but.
• Sécurité : impossible de saisir un score tant que les deux équipes ne sont pas déterminées (match précédent du bracket non terminé) → affichage « En attente des équipes qualifiées ».
• 0-0 pris en compte : en passant un match en cours / terminé, les scores non touchés sont enregistrés à 0.
• La correction d'un score reste toujours possible.

9.1 Forfait / abandon

• Gestionnaire Sur un match, désigner l'équipe forfait : le match passe à « Terminé », l'adversaire est déclaré vainqueur et le score est posé automatiquement.
• Score de forfait configurable (défaut 3-0) : c'est le score attribué au vainqueur, réglable dans la configuration du tournoi.
• Une confirmation nomme l'équipe déclarée forfait et le score qui sera enregistré, avant d'écrire.
• Le match porte ensuite un badge « forfait » dans l'application, et la mention [FORFAIT] sur l'export PDF (§14).
• Le résultat alimente les classements et la propagation du bracket comme un match normal.

10. Classements de poule

• Calculés en direct sur les matchs terminés.
• Colonnes : rang, équipe, joués (J), différence de buts (Diff), points (Pts). 1^er mis en avant.
• Points selon le barème choisi (dont victoire/défaite aux tirs au but en 3-2-1-0).
• Départage selon la configuration choisie (UEFA / FIFA / Express), incluant la confrontation directe.

11. Phases finales

Le format se choisit dans la section Calendrier ; le bracket est généré dès la génération du calendrier, à vide (places « 1^er poule A », « 2^e poule B »…), puis alimenté automatiquement dès qu'une poule est entièrement terminée. Ensuite, les vainqueurs (et perdants pour les petites finales) se propagent automatiquement de tour en tour.

Format	Principe
Classique — 2 premiers/poule	Demi-finales croisées (1er A vs 2e B, 1er B vs 2e A) → petite finale (3e place) + finale. Option Consolante : 3es/4es jouent les places 5 à 8.
Tableau intégral (1-8)	Quarts croisés puis tableau haut (1-4) et tableau bas (5-8) → classement complet de la 1re à la 8e place.
Finale directe	Matchs de classement par rang : 1er A vs 1er B (finale), 2es (3e place), 3es (5e place), 4es (7e place).
2e phase de poules	Poule Haute (1ers + 2es) et Poule Basse (3es + 4es) : mini-championnats avec leurs propres classements.
Élimination directe (générique)	Tableau par taille : Finale (2) / Demies (4) / Quarts (8) / 16es (16), + petite finale optionnelle. Repli toujours disponible, y compris hors structure « 2 poules ». Les tailles proposées s'adaptent au nombre d'équipes engagées.

Les quatre premiers formats sont proposés pour une structure à 2 poules (leur conception d'origine, cas courant des tournois de jeunes) ; pour toute autre structure, l'élimination directe générique est proposée. Un vainqueur de finale nul se départage aux tirs au but (vainqueur désigné). Le 🏆 champion est affiché en fin de tournoi.

12. Retard / décalage dynamique

• Champ « Retard (min) » + bouton « Décaler les matchs à venir », utilisable même tournoi lancé.
• Décale l'horaire de tous les matchs non commencés ; les matchs déjà joués/en cours gardent leur heure réelle.

13. Page publique spectateurs

• Lien partageable (bouton « Partager le lien spectateurs » : partage natif / copie du lien).
• Accessible sans authentification, en lecture seule et en direct.
• Affiche : en-tête du tournoi, 🏆 vainqueur, classements de poule, phases finales et calendrier / résultats (avec terrain, heure et arbitre).
• Reste accessible jusqu'à l'expiration du tournoi (1 an), sans fenêtre de partage limitée dans le temps — contrairement à la page live d'un match, fermée aux visiteurs 7 jours après la rencontre.

Le calendrier public nomme les arbitres. Ce sont des personnes, sur une page sans authentification et non exclue des moteurs de recherche : à trancher si le tournoi accueille des arbitres mineurs ou si les noms n'ont pas à être diffusés (masquer l'arbitre sur la page publique, ou aligner la page sur la fenêtre de 7 jours de la page live).

14. Export PDF

Gestionnaire Un bouton produit le dossier du tournoi en PDF, à imprimer ou à diffuser aux clubs invités. Le document est généré dans l'application (bibliothèque pdf-lib, chargée à la demande) : aucun service externe, aucune donnée envoyée ailleurs.

• Équipes participantes, avec leur poule.
• Calendrier des matchs : heure, terrain, arbitre, phase (badge Poule / Phase finale), score si saisi, et la mention [FORFAIT] le cas échéant.
• Classement général final.
• Pied de page horodaté (« Généré le … avec Krampon »).

15. Modèle de données & sécurité

Collections Firestore

• tournaments/{id} : clubId, name, date, location, format, status, settings (barème, départages, terrains, arbitres, durées, pause, options finales…), createdBy, organizerIds[], publicShareId, locked, createdAt, expireDate.
• tournaments/{id}/entries/{id} : équipe participante (name, logoURL, internalTeamId, groupId = poule).
• tournaments/{id}/matches/{id} : match (phase pool/quarter/semi/final/third, groupId, label, order, entryAId/entryBId, field, scheduledTime, refereeName, scoreA/scoreB, status, winnerEntryId, feedsFrom = alimentation par un autre match, seedFrom = alimentation par un classement de poule).

Règles d'accès

• Lecture publique par identifiant du tournoi et de ses sous-collections (page spectateurs).
• Liste réservée aux membres du club concerné — et non à tout compte connecté : la page club filtre par clubId, et la règle l'impose, ce qui interdit l'énumération des tournois d'un autre club.
• Création : tout membre du club, à condition de se déclarer créateur et de figurer dans organizerIds.
• Écriture réservée au créateur, aux co-organisateurs et aux admins du club. Le clubId et le createdBy d'un tournoi ne peuvent pas être réécrits, et la liste des organisateurs n'est modifiable que par le créateur ou un admin du club.
• Suppression automatique après expireDate via une fonction planifiée quotidienne : le tournoi, ses sous-collections, et les événements de planning créés pour les équipes internes engagées (sinon ils restaient dans l'agenda en pointant un tournoi disparu).

16. Limites connues & évolutions possibles

• La planification des phases finales est une estimation : au moment de la génération, les équipes des finales sont encore des places de poule (« placeholders »). Pour la « 2^e phase de poules », l'ordre des mini-poules est approximatif.
• Départages fair-play et tirage au sort non automatisés (les matchs de tournoi ne collectent pas les cartons, cf. §3.3).
• La page spectateurs affiche le nom des arbitres et reste accessible sans authentification jusqu'à l'expiration du tournoi (1 an). À l'inverse de la page live d'un match, elle n'a pas de fenêtre de partage limitée dans le temps ni d'exclusion des moteurs de recherche — point ouvert.
• Pistes V2 : affichage « live » plein écran (TV / buvette), notification « prochain match » aux équipes, feuilles de match individuelles à imprimer, statistiques (buteurs).

Deux éléments listés comme « pistes V2 » dans une version antérieure de ce document sont livrés : l'export PDF (§14) et les tableaux à 16 en élimination directe (Finale / Demies / Quarts / 16^es).