Corrige le compteur de jaunes après purge
This commit is contained in:
@@ -0,0 +1,54 @@
|
||||
# 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.
|
||||
Reference in New Issue
Block a user