From 66362168a27ab2b613f87677494141c447d3b1e1 Mon Sep 17 00:00:00 2001 From: root Date: Tue, 17 Nov 2026 11:11:56 +0100 Subject: [PATCH] =?UTF-8?q?Corrige=20le=20compteur=20de=20jaunes=20apr?= =?UTF-8?q?=C3=A8s=20purge?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- CORRECTIF_CYCLE_JAUNES.md | 54 ++++++++++++++++++++++++ src/PlayerBadges.php | 2 +- src/Regulations.php | 2 +- src/Reports.php | 89 ++++----------------------------------- src/YellowCycles.php | 42 ++++++++++++++++++ tests/yellow_cycles.php | 38 +++++++++++++++++ 6 files changed, 144 insertions(+), 83 deletions(-) create mode 100644 CORRECTIF_CYCLE_JAUNES.md create mode 100644 src/YellowCycles.php create mode 100644 tests/yellow_cycles.php diff --git a/CORRECTIF_CYCLE_JAUNES.md b/CORRECTIF_CYCLE_JAUNES.md new file mode 100644 index 0000000..116be23 --- /dev/null +++ b/CORRECTIF_CYCLE_JAUNES.md @@ -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. diff --git a/src/PlayerBadges.php b/src/PlayerBadges.php index 5a9a498..5b19503 100644 --- a/src/PlayerBadges.php +++ b/src/PlayerBadges.php @@ -21,7 +21,7 @@ final class PlayerBadges { $disc=['status'=>'review','warnings'=>[]]; if($tid){$contexts[$tid]??=Eligibility::context($tid);$disc=Eligibility::check($p,$tid,$date,$contexts[$tid]);} $r=Regulations::individual($p,['match_date'=>$date,'team_id'=>$tid],$licences[$p['id']]??[],$disc); - $badges=self::make($r,$disc,Reports::activeYellows((int)$p['id'],$date)); + $badges=self::make($r,$disc,Reports::activeYellows((int)$p['id'],$date,$disc)); foreach($badges as &$b)$b['detail']=($b['kind']==='suspended'?$teams[$tid]['short_name'].' · ':'').(new \DateTimeImmutable($date))->format('d/m/Y').' : '.$b['detail'];unset($b); $out[$p['id']]=['badges'=>$badges,'team_id'=>$tid,'team_name'=>$teams[$tid]['short_name']??null]; } diff --git a/src/Regulations.php b/src/Regulations.php index 53cd82f..e2a50d3 100644 --- a/src/Regulations.php +++ b/src/Regulations.php @@ -104,7 +104,7 @@ final class Regulations { $participation=ParticipationRules::checks($p,$match,$profile,$r['licence'],$period); $r['issues']=array_merge($r['issues'],$participation['issues']);$r['notes']=$participation['notes']; $levels=array_column($r['issues'],'level');$r['status']=in_array('blocked',$levels,true)?'blocked':($r['issues']?'review':'available'); - $r['badges']=PlayerBadges::make($r,$disc,Reports::activeYellows((int)$p['id'],$match['match_date'])); + $r['badges']=PlayerBadges::make($r,$disc,Reports::activeYellows((int)$p['id'],$match['match_date'],$disc)); $checks[(int)$p['id']]=$r;$rows[]=['player'=>$p,'check'=>$disc,'regulatory'=>$r]; } if(!empty($profile['ten_active'])){ diff --git a/src/Reports.php b/src/Reports.php index f1c3eca..ea7e881 100644 --- a/src/Reports.php +++ b/src/Reports.php @@ -4,89 +4,15 @@ namespace App; final class Reports { - /** - * Retourne le nombre d'avertissements actifs du joueur à la date demandée. - * - * Une remise à zéro est matérialisée par un événement confirmé de type - * "yellow_reset", créé à la date à laquelle la suspension consécutive aux - * trois cartons jaunes a effectivement été purgée. - */ - public static function activeYellows(int $playerId, string $date): int + /** Purge remains relative to the team/date being checked. No database writes during a report. */ + public static function activeYellows(int $playerId, string $date, ?array $discipline = null): int { - Validation::date($date); - - $resetDate = DB::value( - "SELECT MAX(event_date) - FROM disciplinary_events - WHERE player_id = ? - AND event_type = 'yellow_reset' - AND review_status = 'confirmed' - AND event_date <= ?", + $date = Validation::date($date); + $events = DB::all( + "SELECT * FROM disciplinary_events WHERE player_id = ? AND event_type = 'yellow' AND review_status = 'confirmed' AND event_date <= ? ORDER BY event_date,id", [$playerId, $date] ); - - $sql = "SELECT COUNT(*) - FROM disciplinary_events - WHERE player_id = ? - AND event_type = 'yellow' - AND review_status = 'confirmed' - AND COALESCE(warning_effective_date, event_date) <= ? - AND COALESCE( - warning_end_date, - DATE_ADD( - COALESCE(warning_effective_date, event_date), - INTERVAL 3 MONTH - ) - ) >= ?"; - - $params = [$playerId, $date, $date]; - - if ($resetDate !== null) { - $sql .= " AND COALESCE(warning_effective_date, event_date) > ?"; - $params[] = $resetDate; - } - - return (int) DB::value($sql, $params); - } - - /** - * Enregistre la remise à zéro des cartons jaunes après purge effective - * de la suspension. La méthode est idempotente pour un joueur et une date. - */ - public static function resetYellowsAfterSuspension( - int $playerId, - string $purgeDate, - ?int $teamId = null - ): int { - Validation::date($purgeDate); - - $existing = DB::value( - "SELECT id - FROM disciplinary_events - WHERE player_id = ? - AND event_type = 'yellow_reset' - AND review_status = 'confirmed' - AND event_date = ? - LIMIT 1", - [$playerId, $purgeDate] - ); - - if ($existing !== null) { - return (int) $existing; - } - - DB::query( - "INSERT INTO disciplinary_events ( - player_id, - team_id, - event_type, - event_date, - review_status - ) VALUES (?, ?, 'yellow_reset', ?, 'confirmed')", - [$playerId, $teamId, $purgeDate] - ); - - return (int) DB::conn()->lastInsertId(); + return YellowCycles::active($events, $discipline['details'] ?? [], $date); } private static function higherTeamMatches(int $playerId, array $target, string $date): array @@ -235,7 +161,8 @@ final class Reports $yellows = self::activeYellows( (int) $player['id'], - $match['match_date'] + $match['match_date'], + $check ); $higher = $includeTen diff --git a/src/YellowCycles.php b/src/YellowCycles.php new file mode 100644 index 0000000..c8b69bb --- /dev/null +++ b/src/YellowCycles.php @@ -0,0 +1,42 @@ +$e['event_type']==='yellow'&&$e['review_status']==='confirmed'&&$e['event_date']<=$date)); + usort($events,fn($a,$b)=>[$a['event_date'],$a['id']]<=>[$b['event_date'],$b['id']]); + usort($details,fn($a,$b)=>[$a['sanction']['effective_date'],$a['sanction']['id']]<=>[$b['sanction']['effective_date'],$b['sanction']['id']]); + $allocated=[];$consumed=[]; + foreach($details as $d){ + $s=$d['sanction']; + if($s['status']!=='official'||$s['sanction_type']!=='yellow_accumulation'||($s['duration_kind']??'matches')!=='matches'||(int)$s['matches_required']<1||$s['effective_date']>$date)continue; + $cutoff=$s['decision_date']?:((new \DateTimeImmutable($s['effective_date']))->modify('-1 day')->format('Y-m-d')); + $candidates=array_values(array_filter($events,function($e)use($allocated,$s,$cutoff){ + $start=$e['warning_effective_date']??$e['event_date']; + $end=$e['warning_end_date']??(new \DateTimeImmutable($start))->modify('+3 months')->format('Y-m-d'); + return !isset($allocated[$e['id']])&&$e['event_date']<$s['effective_date']&&$e['event_date']<=$cutoff&&$start<=$cutoff&&$end>=$cutoff; + })); + $triple=[]; + // Earliest complete rolling cycle. Later cautions, including those before the purge, remain intact. + foreach($candidates as $i=>$third){ + $thirdDate=$third['warning_effective_date']??$third['event_date'];$window=[]; + foreach(array_slice($candidates,0,$i+1) as $e){ + $start=$e['warning_effective_date']??$e['event_date']; + $end=$e['warning_end_date']??(new \DateTimeImmutable($start))->modify('+3 months')->format('Y-m-d'); + if($start<=$thirdDate&&$end>=$thirdDate)$window[]=$e['id']; + } + if(count($window)>=3){$triple=array_slice($window,0,3);break;} + } + if(count($triple)!==3)continue; // Incomplete history: never invent a reset. + foreach($triple as $id)$allocated[$id]=true; + $completed=(int)($d['remaining']??-1)===0&&count($d['matches']??[])>=(int)$s['matches_required']; + if($completed)foreach($triple as $id)$consumed[$id]=true; + } + $n=0;foreach($events as $e){ + $start=$e['warning_effective_date']??$e['event_date']; + $end=$e['warning_end_date']??(new \DateTimeImmutable($start))->modify('+3 months')->format('Y-m-d'); + if(!isset($consumed[$e['id']])&&$start<=$date&&$end>=$date)$n++; + }return $n; + } +} diff --git a/tests/yellow_cycles.php b/tests/yellow_cycles.php new file mode 100644 index 0000000..02239ea --- /dev/null +++ b/tests/yellow_cycles.php @@ -0,0 +1,38 @@ +$id,'player_id'=>1,'event_type'=>'yellow','review_status'=>'confirmed','event_date'=>$date,'warning_effective_date'=>null,'warning_end_date'=>null],$extra);} +function decision(int $id=1,array $extra=[]):array{return array_replace(['id'=>$id,'player_id'=>1,'sanction_type'=>'yellow_accumulation','status'=>'official','duration_kind'=>'matches','effective_date'=>'2026-09-20','decision_date'=>'2026-09-17','purge_from'=>null,'exclusion_date'=>null,'matches_required'=>1],$extra);} +$p=['id'=>1,'active'=>1,'person_number'=>'1']; +$m=['id'=>1,'team_id'=>1,'match_date'=>'2026-09-22','counts_for_purge'=>1,'status'=>'played','is_official'=>1]; +$events=[yellow(1,'2026-09-01'),yellow(2,'2026-09-08'),yellow(3,'2026-09-15')]; +function details(array $s,array $m,string $date='2026-09-23',int $team=1):array{global $p;return Eligibility::calculate($p,$team,$date,$s,$m)['details'];} +$d=details([decision()],[$m]); +cycleCheck(YellowCycles::active($events,$d,'2026-09-23')===0,'Trois jaunes et suspension purgée : zéro'); +cycleCheck(YellowCycles::active($events,details([decision()],[]),'2026-09-23')===3,'Aucune purge : trois restent visibles'); +cycleCheck(YellowCycles::active($events,details([decision()],[$m],'2026-09-22'),'2026-09-22')===3,'Match du jour non encore crédité pour contrôle avant match'); +cycleCheck(YellowCycles::active($events,details([decision()],[$m],'2026-09-23',2),'2026-09-23')===3,'Purge d’une autre équipe non créditée'); +cycleCheck(YellowCycles::active($events,details([decision()], [array_replace($m,['status'=>'scheduled','counts_for_purge'=>0])]),'2026-09-23')===3,'Match prévu non crédité'); +cycleCheck(YellowCycles::active($events,details([decision(1,['status'=>'revoked'])],[$m]),'2026-09-23')===3,'Sanction révoquée sans remise à zéro'); +cycleCheck(YellowCycles::active($events,details([decision(1,['status'=>'provisional'])],[$m]),'2026-09-23')===3,'Décision provisoire sans remise à zéro'); +cycleCheck(YellowCycles::active($events,details([decision(1,['sanction_type'=>'commission'])],[$m]),'2026-09-23')===3,'Sanction non identifiée comme cumul : pas de déduction'); +cycleCheck(YellowCycles::active([...$events,yellow(4,'2026-09-18')],$d,'2026-09-23')===1,'Quatrième jaune avant purge conservé'); +cycleCheck(YellowCycles::active([...$events,yellow(4,'2026-09-23')],$d,'2026-09-23')===1,'Nouveau jaune après purge conservé'); +cycleCheck(YellowCycles::active(array_slice($events,0,2),$d,'2026-09-23')===2,'Historique incomplet : pas de remise à zéro inventée'); +$cancelled=$events;$cancelled[1]['review_status']='cancelled'; +cycleCheck(YellowCycles::active($cancelled,$d,'2026-09-23')===2,'Jaune annulé exclu et triple incomplet'); +cycleCheck(YellowCycles::active($events,[],'2026-09-16')===3,'Lecture historique avant suspension'); +cycleCheck(YellowCycles::active([yellow(1,'2026-06-01'),yellow(2,'2026-09-08'),yellow(3,'2026-09-15')],$d,'2026-09-23')===2,'Trois jaunes hors fenêtre ne forment pas un cycle'); +cycleCheck(YellowCycles::active([yellow(1,'2026-09-01',['warning_end_date'=>'2026-09-23'])],[],'2026-09-23')===1,'Fin de validité incluse'); +cycleCheck(YellowCycles::active([yellow(1,'2026-09-01',['warning_end_date'=>'2026-09-22'])],[],'2026-09-23')===0,'Date de fin explicite respectée'); +cycleCheck(YellowCycles::active([yellow(1,'2026-09-01',['warning_effective_date'=>'2026-09-24'])],[],'2026-09-23')===0,'Date d’effet future exclue'); +$more=[...$events,yellow(4,'2026-09-25'),yellow(5,'2026-10-01'),yellow(6,'2026-10-08'),yellow(7,'2026-10-20')]; +$s2=decision(2,['effective_date'=>'2026-10-15','decision_date'=>'2026-10-12']);$m2=array_replace($m,['id'=>2,'match_date'=>'2026-10-18']); +cycleCheck(YellowCycles::active($more,details([decision(),$s2],[$m,$m2],'2026-10-21'),'2026-10-21')===1,'Deux cycles successifs, septième jaune conservé'); +cycleCheck(YellowCycles::active($more,details([decision(),$s2],[$m,$m2],'2026-10-21'),'2026-10-21')===1,'Calcul répétable sans écriture'); +cycleCheck(YellowCycles::active($events,details([decision(),decision(2)],[$m]),'2026-09-23')===0,'Un même triple ne peut être consommé deux fois'); +cycleCheck(YellowCycles::active($events,details([decision(1,['matches_required'=>2])],[$m]),'2026-09-23')===3,'Purge partielle : aucun reset'); +cycleCheck(YellowCycles::active([yellow(91,'2025-01-01'),yellow(92,'2025-01-08'),yellow(93,'2025-01-15'),...$events],$d,'2026-09-23')===0,'Anciens cycles expirés ne capturent pas la décision récente'); +echo "$n contrôles réussis.\n";