55 lines
4.2 KiB
Markdown
55 lines
4.2 KiB
Markdown
# Correctif : avertissements après une suspension pour cumul
|
||
|
||
Base : dépôt bob/ESBSC-CONVOC, commit ab58b33f9c45c3aaf3eb726df72a662f64bbf1cb.
|
||
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 :
|
||
|
||
```bash
|
||
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 :
|
||
|
||
```bash
|
||
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.
|