ajoute le cache Redis sur les lectures lourdes (bloc B)

Catalogue (labs, banque de quiz officielle, cours) et liste des
classes du tableau de bord prof - jamais d'expiration, invalidation
explicite par les commandes de synchronisation et par
archiver/désarchiver/purge RGPD.

Bug trouvé en vérifiant en réel sur le serveur (pas en local, où
CACHE_STORE=array ne sérialise jamais rien) : mettre en cache des
modèles Eloquent hydratés plante à la relecture via Redis
("incomplete class" à l'unserialize). Corrigé en cachant les attributs
bruts et en reconstruisant de vrais modèles avec Model::hydrate().

Mesuré en réel : 5 appels directs = 5 requêtes SQL, 5 appels via le
cache = 1 requête SQL.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
Adam Belkacemi 2026-10-14 07:34:55 +02:00
parent ecf3dfb21d
commit ca544ac620
15 changed files with 250 additions and 10 deletions

View file

@ -0,0 +1,35 @@
<?php
namespace App\Services;
use App\Models\Classe;
use Illuminate\Database\Eloquent\Collection;
use Illuminate\Support\Facades\Cache;
/**
* Cache Redis du tableau de bord prof (bloc B, 2026-10-14) : la liste de
* ses classes (avec le nombre d'élèves) est relue à chaque chargement de
* « Mes classes » et du cockpit d'une classe — et, pendant une séance en
* cours, toutes les 15 secondes par le rafraîchissement automatique. Elle
* ne change que sur une création, un archivage, un désarchivage ou une
* purge RGPD : jamais d'expiration, invalidée explicitement à ces moments.
*
* Stocke les attributs bruts, pas les modèles (voir CacheCatalogue pour le
* pourquoi) ; `Classe::hydrate()` reconstruit de vrais modèles à la lecture.
*/
class CacheTableauDeBordProf
{
/** @return Collection<int, Classe> */
public static function classes(int $profId): Collection
{
return Classe::hydrate(Cache::rememberForever(
"prof:{$profId}:classes",
fn () => Classe::where('user_id', $profId)->withCount('eleves')->orderBy('nom')->get()->map->getAttributes()->all()
));
}
public static function vider(int $profId): void
{
Cache::forget("prof:{$profId}:classes");
}
}