feat: Optimiser la pagination avec cache-aside et ports de lecture dédiés

Les listes paginées (utilisateurs, classes, matières, affectations,
invitations parents, droits à l'image) effectuaient des requêtes SQL
complètes à chaque chargement de page, sans aucun cache. Sur les
établissements avec plusieurs centaines d'enregistrements, cela causait
des temps de réponse perceptibles et une charge inutile sur PostgreSQL.

Cette refactorisation introduit un cache tag-aware (Redis en prod,
filesystem en dev) avec invalidation événementielle, et extrait les
requêtes de lecture dans des ports Application / implémentations DBAL
conformes à l'architecture hexagonale. Un middleware Messenger garantit
l'invalidation synchrone du cache même pour les événements routés en
asynchrone (envoi d'emails), évitant ainsi toute donnée périmée côté UI.

backend/src/Administration/Application/Query/GetClasses/GetClassesHandler.php

@@ -5,20 +5,16 @@ declare(strict_types=1);
 namespace App\Administration\Application\Query\GetClasses;
 
 use App\Administration\Application\Dto\PaginatedResult;
-use App\Administration\Domain\Model\SchoolClass\AcademicYearId;
-use App\Administration\Domain\Repository\ClassRepository;
-use App\Shared\Domain\Tenant\TenantId;
-
-use function array_slice;
-use function count;
-
+use App\Administration\Application\Port\PaginatedClassesReader;
+use App\Administration\Application\Service\Cache\PaginatedQueryCache;
 use Symfony\Component\Messenger\Attribute\AsMessageHandler;
 
 #[AsMessageHandler(bus: 'query.bus')]
 final readonly class GetClassesHandler
 {
     public function __construct(
-        private ClassRepository $classRepository,
+        private PaginatedClassesReader $reader,
+        private PaginatedQueryCache $cache,
     ) {
     }
 
@@ -27,33 +23,31 @@ final readonly class GetClassesHandler
      */
     public function __invoke(GetClassesQuery $query): PaginatedResult
     {
-        $classes = $this->classRepository->findActiveByTenantAndYear(
-            TenantId::fromString($query->tenantId),
-            AcademicYearId::fromString($query->academicYearId),
-        );
-
-        if ($query->search !== null && $query->search !== '') {
-            $searchLower = mb_strtolower($query->search);
-            $classes = array_filter(
-                $classes,
-                static fn ($class) => str_contains(mb_strtolower((string) $class->name), $searchLower)
-                    || ($class->level !== null && str_contains(mb_strtolower($class->level->value), $searchLower)),
-            );
-            $classes = array_values($classes);
-        }
-
-        $total = count($classes);
-        $offset = ($query->page - 1) * $query->limit;
-        $items = array_slice($classes, $offset, $query->limit);
-
-        return new PaginatedResult(
-            items: array_map(
-                static fn ($class) => ClassDto::fromDomain($class),
-                $items,
+        /* @var PaginatedResult<ClassDto> */
+        return $this->cache->getOrLoad(
+            'classes',
+            $query->tenantId,
+            $this->cacheParams($query),
+            fn (): PaginatedResult => $this->reader->findPaginated(
+                tenantId: $query->tenantId,
+                academicYearId: $query->academicYearId,
+                search: $query->search,
+                page: $query->page,
+                limit: $query->limit,
             ),
-            total: $total,
-            page: $query->page,
-            limit: $query->limit,
         );
     }
+
+    /**
+     * @return array<string, mixed>
+     */
+    private function cacheParams(GetClassesQuery $query): array
+    {
+        return [
+            'page' => $query->page,
+            'limit' => $query->limit,
+            'academic_year_id' => $query->academicYearId,
+            'search' => $query->search,
+        ];
+    }
 }