Files
ESBSC-CONVOC/MISE_A_JOUR_V3_FINALE.md
T
2026-11-11 09:24:28 +01:00

82 lines
8.5 KiB
Markdown

# ESBSC 3.0.0 — version finale
Cette version remplace les RC1, RC2 et RC3. Elle conserve leurs imports XLSX, cachets, licences multiples, discipline par personne, FMI, favoris, convocations et rapports.
## Installation sans Docker
1. Arrêter temporairement les écritures et tâches planifiées. Sauvegarder la base MariaDB, la configuration et `storage/`.
2. Installer cette archive en conservant votre configuration de connexion et votre `storage/`. Le DocumentRoot reste `public/`.
3. Depuis le dossier de l'application, avec la configuration de la base cible :
```bash
php bin/console.php migrate
```
4. Réimporter l'export complet `44171420d.xlsx`, type joueurs/personnes, saison **2026/2027**, puis valider l'aperçu. Ce réimport ajoute notamment les dates de naissance nécessaires au contrôle U23. Aucune table n'est à vider, aucun utilisateur à recréer. Ne pas lancer `demo`.
5. Effectuer le paramétrage initial ci-dessous, puis contrôler une convocation et son rapport. Réactiver les accès et tâches.
Les migrations sont relançables. Pour revenir en arrière, restaurer ensemble la base sauvegardée, le code et le dossier `storage/` correspondants. Pour une mise à jour depuis V2, consulter aussi le guide initial `MISE_A_JOUR_V3.md` pour l'installation et les changements de discipline.
## Paramétrage une fois par équipe, compétition et saison
Dans **Règlements**, reprendre chaque profil existant ou en créer un avec le libellé exact du calendrier. Les paramètres ne sont pas redemandés chaque week-end et les profils existants ne sont pas écrasés par la migration.
| Paramètre | Configuration ESBSC convenue |
|---|---|
| Mutés E1 | Base 4 + bonus 1 ; hors période maximum 2 |
| Mutés E2, E3, E4 | Base 4, bonus 0 ; hors période maximum 2 |
| Descente | Cocher le contrôle automatique du dernier match supérieur pour les compétitions concernées |
| Type de compétition | Cocher « championnat » pour les championnats, y compris celui de l'équipe 1 utilisé comme source de l'exception |
| Fin de saison | Cocher « calendrier complet » si toutes les rencontres de championnat sont importées ; sinon saisir une fois la date de début des cinq dernières rencontres |
| Quota +10 | Activer pour les équipes/compétitions concernées, maximum 3 selon le paramétrage club ; périmètre : participations effectives en matchs officiels de toutes les équipes supérieures |
| Exception U23 | Activer sur le championnat de la première réserve, avec la confirmation du District comme référence |
Confirmer les profils une fois. Ces paramètres sont ceux convenus avec le club ; ce ne sont pas des valeurs réglementaires universelles. Créer séparément les profils de coupe. Ne pas activer un périmètre +10 différent du texte applicable à une compétition.
L'ordre des équipes dans le registre des équipes détermine les équipes supérieures : l'équipe première est la première équipe active, la première réserve la deuxième. Conserver E1, E2, E3, E4 dans cet ordre.
Un calendrier déclaré complet permet de recalculer la période des cinq dernières rencontres après modification de dates. Un report sans nouvelle date ou moins de cinq rencontres exploitables produit une alerte précise. Sans calendrier complet, la date manuelle reste à actualiser lorsqu'un report change la période. Le calendrier doit couvrir toute la phase de championnat concernée sous le même libellé de compétition.
## Contrôle du groupe pour le match choisi
- Aucun contrôle systématique de surclassement : le club a confirmé que son registre contient uniquement des joueurs éligibles seniors. Une interdiction individuelle explicitement saisie reste bloquante.
- MN et MH valides à la date du match sont comptés sur **toute la sélection**. MH compte aussi dans le sous-total hors période. Être muté n'est pas un blocage individuel ; dépasser le quota du groupe est un blocage collectif.
- Les suspensions sont calculées par personne, pour **l'équipe de reprise** et la date choisies. Le moteur de purge existant est conservé.
- Le statut de licence est importé. La qualification est calculée à quatre jours francs, soit J+5. Qualifié dimanche signifie non qualifié samedi.
- Le nombre de joueurs à plus de dix matchs supérieurs est calculé dans le groupe, avec application du quota pendant la période configurée. Une FMI supérieure manquante pendant cette période déclenche une alerte de calcul incomplet.
- Le dernier match supérieur et les participations effectives à des matchs officiels le même jour ou sur deux jours consécutifs sont contrôlés. L'exception de première réserve est appliquée lorsque ses conditions sont établies.
- Les alertes générales « vérifier catégorie/surclassement », « vérifier toutes les exceptions » et « +10 non confirmé » pour chaque joueur ont été retirées. Les faits manquants utiles au contrôle restent signalés.
Le bilan du groupe se met à jour à chaque case cochée. Les contrôles sont refaits côté serveur lors de l'enregistrement et du rapport. Un favori n'est jamais présélectionné et ne contourne aucun contrôle. Un changement de données sportives périme une validation antérieure.
## Exception de première réserve
La confirmation du District fournie par le club est retenue pour cette saison : l'exception peut s'appliquer dès le lendemain, mais aussi la semaine suivante lorsque l'équipe première ne joue pas. Une participation intermédiaire avec la réserve n'efface pas la situation du dernier match de l'équipe première.
Conditions implémentées :
- Première équipe vers première réserve uniquement.
- Réserve en championnat, hors des cinq dernières rencontres.
- Match source de championnat identifié par son profil confirmé, Coupe de France ou coupe régionale reconnue par son libellé.
- Joueur âgé de moins de 23 ans au 1er juillet de la saison, ou gardien de but confirmé pour le match source.
- Première entrée en jeu en seconde période. Un titulaire ou une entrée en première période ne permet pas l'exception.
- Autres contrôles toujours applicables : suspension, qualification, statut, quotas et participations avec d'autres équipes.
Le contrôle de descente examine le dernier match officiel pertinent de chaque équipe supérieure. Si le dernier match de l'équipe 1 manque, l'application ne réutilise pas une ancienne exception comme preuve. Si le joueur a rejoué en première période avec l'équipe 1, l'exception n'est plus acquise pour ce nouveau match.
### Préciser une entrée en jeu une seule fois
L'import PDF actuel identifie titulaires, remplaçants et participations, mais **ne certifie pas automatiquement la période de première entrée**.
Lorsqu'une exception est nécessaire : ouvrir le match joué de l'équipe 1, **Groupe → Précisions de participation**, choisir la personne, renseigner première/seconde période et la source. Le gardien peut aussi être identifié ici. Seuls les utilisateurs habilités à modifier les données sportives peuvent enregistrer ces précisions ; elles sont historisées.
Cette information reste enregistrée et réutilisable. Elle ne doit pas être ressaisie à chaque journée. **Un nouvel import de la FMI de ce même match remplace les participations et remet les précisions à inconnu** : les confirmer à nouveau après une correction de FMI. L'ancienne valeur demeure dans l'audit. La date de naissance vient de l'export Footclubs complet ; si elle manque, réimporter le registre.
## Vérifications et limites pratiques
Tests sur base MariaDB jetable : migration depuis V2 et relance, suites imports/cachets/FMI/favoris/convocations, 19 scénarios supplémentaires pour la finale (samedi/dimanche, U23 immédiat et semaine suivante, passage en réserve, nouvelle participation E1, limites d'âge, gardien, coupe, équipe 3, FMI manquante et reports). Tests HTTP des formulaires, quotas, droits de lecture seule, précisions de participation et conservation des sélections. Syntaxe PHP et JavaScript vérifiée.
La version fonctionne dans le périmètre seniors ESBSC décrit ici. Elle ne prétend pas traiter toutes les exceptions possibles de toutes les compétitions FFF. Les dates et les FMI doivent rester actualisées ; une absence de participation ne peut être déduite d'une feuille manquante. Les alertes de fraîcheur existantes sont conservées. Un rapport PDF est un instantané : le régénérer après modification des données.
Les exports personnels ne sont pas livrés dans l'archive. Les tests SQL requièrent une base jetable avec `ESBSC_TEST_DATABASE=1` : ne pas les exécuter en production.