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.
|
||||
@@ -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
@@ -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
@@ -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
|
||||
|
||||
@@ -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;
|
||||
}
|
||||
}
|
||||
@@ -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";
|
||||
Reference in New Issue
Block a user