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>

portail/app/Services/CacheTableauDeBordProf.php

@@ -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");
+    }
+}

portail/app/Services/Catalogue/CacheCatalogue.php

@@ -0,0 +1,69 @@
+<?php
+
+namespace App\Services\Catalogue;
+
+use App\Models\Cours;
+use App\Models\Lab;
+use App\Models\Quiz;
+use Illuminate\Database\Eloquent\Collection;
+use Illuminate\Support\Facades\Cache;
+
+/**
+ * Cache Redis des lectures lourdes du catalogue (bloc B, 2026-10-14) :
+ * labs, banque de quiz officielle, cours. Change seulement quand les
+ * commandes de synchronisation tournent (déploiement) — jamais d'expiration,
+ * invalidé explicitement par ces mêmes commandes. Trié par identifiant,
+ * à chaque appelant de retrier en mémoire s'il veut un autre ordre (peu de
+ * lignes, pas besoin d'une deuxième entrée de cache).
+ *
+ * Le cache stocke les attributs bruts (`getAttributes()`), pas les modèles
+ * eux-mêmes : sérialiser un objet PHP et le relire plus tard (processus
+ * différent, éventuellement unserialize() avant que l'autoloader ait tout
+ * chargé) peut échouer avec « incomplete class » — ce qui s'est produit en
+ * vérifiant ce chantier en réel. Un tableau de scalaires n'a pas ce risque ;
+ * `Model::hydrate()` reconstruit ensuite de vrais modèles, casts compris.
+ */
+class CacheCatalogue
+{
+    /** @return Collection<int, Lab> */
+    public static function labs(): Collection
+    {
+        return Lab::hydrate(Cache::rememberForever(
+            'catalogue:labs',
+            fn () => Lab::orderBy('identifiant')->get()->map->getAttributes()->all()
+        ));
+    }
+
+    /** @return Collection<int, Quiz> */
+    public static function quizOfficiels(): Collection
+    {
+        return Quiz::hydrate(Cache::rememberForever(
+            'catalogue:quiz-officiels',
+            fn () => Quiz::where('partage', true)->whereNotNull('theme')->withCount('questions')->orderBy('theme')->get()->map->getAttributes()->all()
+        ));
+    }
+
+    /** @return Collection<int, Cours> */
+    public static function cours(): Collection
+    {
+        return Cours::hydrate(Cache::rememberForever(
+            'catalogue:cours',
+            fn () => Cours::orderBy('identifiant')->get()->map->getAttributes()->all()
+        ));
+    }
+
+    public static function viderLabs(): void
+    {
+        Cache::forget('catalogue:labs');
+    }
+
+    public static function viderQuizOfficiels(): void
+    {
+        Cache::forget('catalogue:quiz-officiels');
+    }
+
+    public static function viderCours(): void
+    {
+        Cache::forget('catalogue:cours');
+    }
+}