4.2 KiB
Correctif : avertissements après une suspension pour cumul
Base : dépôt bob/ESBSC-CONVOC, commit ab58b33f9c.
Branche de travail proposée : fix/yellow-cycle-after-suspension.
Résultat
Les trois jaunes confirmés formant le cycle d’une suspension officielle de type « Cumul de jaunes » ne sont plus comptés une fois les matchs fermes purgés dans le contexte équipe/date consulté. Le quatrième jaune, même reçu avant la purge, reste compté. Les événements et décisions ne sont ni supprimés ni modifiés.
Le calcul est partagé entre rapports régénérés, préparation des matchs et badges du registre. Les rapports déjà enregistrés restent des instantanés : les régénérer après correction.
Conditions et limites
- La suspension doit être officielle, en matchs fermes et d’origine « Cumul de jaunes ». Un rouge ou une sanction générique « Commission » ne remet pas à zéro les jaunes. Si l’ancienne saisie n’identifie pas l’origine, vérifier la décision puis modifier son origine sur la page Sanctions.
- La purge est celle déjà calculée par Eligibility pour l’équipe concernée : des matchs prévus, reportés ou non admissibles ne la valident pas. Le match cible ne se purge pas lui-même. Aucun indicateur global « servi » n’est créé.
- Le triple est rapproché chronologiquement des avertissements confirmés encore valides à la décision (à défaut, la veille de son effet), antérieurs à la date d’effet. Les dates d’effet/de fin explicites des avertissements sont respectées. Le premier cycle complet est réservé à la décision, sans réutilisation pour la suivante.
- Le fichier ne contient pas de lien explicite entre une décision et trois IDs de cartons : le rapprochement est calculé, pas certifié par un identifiant FFF. Un historique incomplet ne déclenche pas une remise à zéro inventée. Un dossier exceptionnel ou un ancien cycle sans décision importée nécessite une vérification.
- Dans le registre, sans équipe choisie ni équipe habituelle, aucun contexte de purge n’est inventé ; le compteur brut des jaunes valides reste utilisé. Choisir l’équipe pour le contrôle.
- Une modification du calendrier ou une révocation recalcule le résultat. Aucune écriture lors de la lecture d’un rapport.
L’ancienne tentative de Reports utilisait yellow_reset, non pris en charge dans l’ENUM des événements, et n’était appelée par aucun code du dépôt. Elle est remplacée par ce calcul en lecture seule.
Installation Git
Sauvegarder la base et vérifier que les changements locaux sont enregistrés. Décompresser le ZIP hors du dossier public, puis depuis le dépôt :
git switch -c fix/yellow-cycle-after-suspension
git apply --check /chemin/correctif-cycle-jaunes.patch
git apply /chemin/correctif-cycle-jaunes.patch
php tests/yellow_cycles.php
php tests/run.php
php tests/regulations.php
git diff --check
git diff --stat
En cas d’échec de git apply --check, ne pas remplacer les fichiers à l’aveugle : la version locale diffère de la base du patch.
Aucune migration SQL, aucune réimportation nécessaire si les décisions et les trois jaunes sont déjà importés. Recharger Apache/OPcache après mise en service. Vérifier un joueur concerné sur la copie de recette et refaire son rapport.
Pour enregistrer et pousser la branche une fois les contrôles effectués :
git add src/YellowCycles.php src/Reports.php src/Regulations.php src/PlayerBadges.php tests/yellow_cycles.php CORRECTIF_CYCLE_JAUNES.md
git commit -m "Fix yellow count after served accumulation suspension"
git push -u origin fix/yellow-cycle-after-suspension
Aucune modification n’a été poussée dans Gitea ni installée sur le serveur par l’assistant.
Vérifications
PHP 8.4 : 22 contrôles du cycle, 24 tests existants du moteur disciplinaire/CSV/PDF et 16 tests réglementaires réussis. Syntaxe des PHP modifiés et application du patch sur sa base vérifiées. Les scénarios couvrent purge complète/partielle, date du contrôle, contexte d’équipe, sanction révoquée/provisoire, nouveau jaune, historique incomplet, expiration, deux cycles et absence de double consommation. Pas d’essai sur une copie de la base de production ni de recette navigateur.