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/Console/Commands/PurgerClassesArchivees.php

@@ -3,6 +3,7 @@
 namespace App\Console\Commands;
 
 use App\Models\Classe;
+use App\Services\CacheTableauDeBordProf;
 use Illuminate\Console\Command;
 use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Facades\Log;
@@ -44,6 +45,7 @@ class PurgerClassesArchivees extends Command
             }
 
             DB::transaction(fn () => $classe->delete());
+            CacheTableauDeBordProf::vider($classe->user_id);
             Log::info('Purge RGPD : classe supprimée', [
                 'classe_id' => $classe->id,
                 'eleves' => $classe->eleves_count,

portail/app/Console/Commands/SynchroniserBanqueQuiz.php

@@ -3,6 +3,7 @@
 namespace App\Console\Commands;
 
 use App\Models\Quiz;
+use App\Services\Catalogue\CacheCatalogue;
 use App\Services\Quiz\BanqueOfficielle;
 use App\Services\Quiz\LecteurGift;
 use Illuminate\Console\Command;
@@ -70,5 +71,7 @@ class SynchroniserBanqueQuiz extends Command
                 $this->warn("{$identifiant} : {$avertissement}");
             }
         }
+
+        CacheCatalogue::viderQuizOfficiels();
     }
 }

portail/app/Console/Commands/SynchroniserCours.php

@@ -3,6 +3,7 @@
 namespace App\Console\Commands;
 
 use App\Models\Cours;
+use App\Services\Catalogue\CacheCatalogue;
 use Illuminate\Console\Command;
 use Illuminate\Support\Facades\File;
 use Symfony\Component\Yaml\Yaml;
@@ -41,5 +42,7 @@ class SynchroniserCours extends Command
 
             $this->line(($cours->wasRecentlyCreated ? 'créé' : 'à jour')." : {$identifiant}");
         }
+
+        CacheCatalogue::viderCours();
     }
 }

portail/app/Console/Commands/SynchroniserLabs.php

@@ -3,6 +3,7 @@
 namespace App\Console\Commands;
 
 use App\Models\Lab;
+use App\Services\Catalogue\CacheCatalogue;
 use App\Services\Labs\DefinitionLab;
 use Illuminate\Console\Command;
 
@@ -29,5 +30,7 @@ class SynchroniserLabs extends Command
 
             $this->line(($lab->wasRecentlyCreated ? 'créé' : 'à jour')." : {$identifiant}");
         }
+
+        CacheCatalogue::viderLabs();
     }
 }

portail/app/Http/Controllers/Api/V1/CoursController.php

@@ -5,6 +5,7 @@ namespace App\Http\Controllers\Api\V1;
 use App\Http\Controllers\Controller;
 use App\Http\Resources\Api\V1\CoursResource;
 use App\Models\Cours;
+use App\Services\Catalogue\CacheCatalogue;
 use Illuminate\Http\Resources\Json\AnonymousResourceCollection;
 
 /**
@@ -14,7 +15,7 @@ class CoursController extends Controller
 {
     public function index(): AnonymousResourceCollection
     {
-        return CoursResource::collection(Cours::orderBy('identifiant')->get());
+        return CoursResource::collection(CacheCatalogue::cours());
     }
 
     public function show(Cours $cours): CoursResource

portail/app/Http/Controllers/Api/V1/LabController.php

@@ -5,6 +5,7 @@ namespace App\Http\Controllers\Api\V1;
 use App\Http\Controllers\Controller;
 use App\Http\Resources\Api\V1\LabResource;
 use App\Models\Lab;
+use App\Services\Catalogue\CacheCatalogue;
 use Illuminate\Http\Resources\Json\AnonymousResourceCollection;
 
 /**
@@ -14,7 +15,7 @@ class LabController extends Controller
 {
     public function index(): AnonymousResourceCollection
     {
-        return LabResource::collection(Lab::orderBy('identifiant')->get());
+        return LabResource::collection(CacheCatalogue::labs());
     }
 
     public function show(Lab $lab): LabResource

portail/app/Http/Controllers/Api/V1/QuizController.php

@@ -5,6 +5,7 @@ namespace App\Http\Controllers\Api\V1;
 use App\Http\Controllers\Controller;
 use App\Http\Resources\Api\V1\QuizResource;
 use App\Models\Quiz;
+use App\Services\Catalogue\CacheCatalogue;
 use Illuminate\Http\Resources\Json\AnonymousResourceCollection;
 
 /**
@@ -16,9 +17,7 @@ class QuizController extends Controller
 {
     public function index(): AnonymousResourceCollection
     {
-        return QuizResource::collection(
-            Quiz::where('partage', true)->whereNotNull('theme')->withCount('questions')->orderBy('theme')->get()
-        );
+        return QuizResource::collection(CacheCatalogue::quizOfficiels());
     }
 
     public function show(Quiz $quiz): QuizResource

portail/app/Http/Controllers/BibliothequeProfController.php

@@ -2,8 +2,8 @@
 
 namespace App\Http\Controllers;
 
-use App\Models\Lab;
 use App\Models\Quiz;
+use App\Services\Catalogue\CacheCatalogue;
 use Illuminate\View\View;
 
 /**
@@ -22,7 +22,7 @@ class BibliothequeProfController extends Controller
             ->get();
 
         return view('bibliotheque-app', [
-            'labs' => Lab::orderBy('titre')->get(),
+            'labs' => CacheCatalogue::labs()->sortBy('titre')->values(),
             'groupesQuiz' => $quizzes->groupBy(fn (Quiz $q) => $q->theme ?? '')->sortKeys(),
         ]);
     }

portail/app/Http/Controllers/ClasseController.php

@@ -8,6 +8,8 @@ use App\Models\DemandeInscription;
 use App\Models\Eleve;
 use App\Models\LabSession;
 use App\Models\Seance;
+use App\Services\CacheTableauDeBordProf;
+use App\Services\Catalogue\CacheCatalogue;
 use App\Services\GenerateurCompteEleve;
 use App\Services\Labs\DefinitionLab;
 use Illuminate\Http\JsonResponse;
@@ -24,7 +26,7 @@ class ClasseController extends Controller
 
     public function index(): View
     {
-        $classes = Auth::guard('web')->user()->classes()->withCount('eleves')->latest()->get();
+        $classes = CacheTableauDeBordProf::classes(Auth::guard('web')->id())->sortByDesc('created_at')->values();
 
         return view('mes-classes.index', ['classes' => $classes]);
     }
@@ -80,7 +82,7 @@ class ClasseController extends Controller
             : null;
 
         return view('mes-classes.show', [
-            'classes' => Auth::guard('web')->user()->classes()->withCount('eleves')->orderBy('nom')->get(),
+            'classes' => CacheTableauDeBordProf::classes(Auth::guard('web')->id()),
             'classe' => $classe->load(['eleves', 'annonces.auteur', 'observations.eleve']),
             'demandes' => $classe->demandesInscription()->where('statut', DemandeInscription::EN_ATTENTE)->oldest()->get(),
             'seance' => $seance,
@@ -88,6 +90,7 @@ class ClasseController extends Controller
             'progressionSeance' => $progressionSeance,
             'reussiteMoyenne' => $corrections->isNotEmpty() ? (int) round($corrections->avg(fn ($c) => $c->note_max > 0 ? $c->note / $c->note_max * 100 : 0)) : null,
             'mains' => ($seance && $seance->visioOuverte()) ? VisioController::mainsLevees($seance) : [],
+            'labsCatalogue' => CacheCatalogue::labs()->sortBy('titre')->values(),
         ]);
     }
 
@@ -237,6 +240,7 @@ class ClasseController extends Controller
         $classe->forceFill(['archivee_a' => now()])->save();
         $classe->seances()->whereIn('statut', [Seance::PLANIFIEE, Seance::SALLE_ATTENTE, Seance::EN_COURS])
             ->update(['statut' => Seance::TERMINEE, 'terminee_a' => now()]);
+        CacheTableauDeBordProf::vider($classe->user_id);
 
         return redirect()->route('mes-classes.show', $classe);
     }
@@ -245,6 +249,7 @@ class ClasseController extends Controller
     {
         $this->verifierProprietaire($classe);
         $classe->forceFill(['archivee_a' => null])->save();
+        CacheTableauDeBordProf::vider($classe->user_id);
 
         return redirect()->route('mes-classes.show', $classe);
     }

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