Corrige le compteur de jaunes après purge

This commit is contained in:
root
2026-11-17 11:11:56 +01:00
parent ab58b33f9c
commit 66362168a2
6 changed files with 144 additions and 83 deletions
+54
View File
@@ -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.
+1 -1
View File
@@ -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];
}
+1 -1
View File
@@ -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'])){
+8 -81
View File
@@ -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
+42
View File
@@ -0,0 +1,42 @@
<?php
namespace App;
/** Read-only projection: retain events, remove only triples attached to a completed yellow suspension. */
final class YellowCycles {
public static function active(array $events,array $details,string $date): int {
$date=Validation::date($date);
$events=array_values(array_filter($events,fn($e)=>$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;
}
}
+38
View File
@@ -0,0 +1,38 @@
<?php
require dirname(__DIR__).'/bootstrap.php';
use App\{YellowCycles,Eligibility};
$n=0;
function cycleCheck(bool $ok,string $label):void{global $n;if(!$ok)throw new RuntimeException($label);echo 'OK '.(++$n).' '.$label."\n";}
function yellow(int $id,string $date,array $extra=[]):array{return array_replace(['id'=>$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";