feat: Pagination et recherche des sections admin

Les listes admin (utilisateurs, classes, matières, affectations) chargeaient
toutes les données d'un coup, ce qui dégradait l'expérience avec un volume
croissant. La pagination côté serveur existait dans la config API Platform
mais aucun Provider ne l'exploitait.

Cette implémentation ajoute la pagination serveur (30 items/page, max 100)
avec recherche textuelle sur toutes les sections, des composants frontend
réutilisables (Pagination + SearchInput avec debounce), et la synchronisation
URL pour le partage de liens filtrés.

Les Query valident leurs paramètres (clamp page/limit, trim search) pour
éviter les abus. Les affectations utilisent des lookup maps pour résoudre
les noms sans N+1 queries. Les pages admin gèrent les race conditions
via AbortController.

backend/src/Administration/Application/Query/GetSubjects/GetSubjectsHandler.php

@@ -4,17 +4,16 @@ declare(strict_types=1);
 
 namespace App\Administration\Application\Query\GetSubjects;
 
+use App\Administration\Application\Dto\PaginatedResult;
 use App\Administration\Domain\Model\SchoolClass\SchoolId;
 use App\Administration\Domain\Repository\SubjectRepository;
 use App\Shared\Domain\Tenant\TenantId;
 
-use function array_map;
+use function array_slice;
+use function count;
 
 use Symfony\Component\Messenger\Attribute\AsMessageHandler;
 
-/**
- * Handler pour récupérer les matières actives d'un tenant.
- */
 #[AsMessageHandler(bus: 'query.bus')]
 final readonly class GetSubjectsHandler
 {
@@ -24,25 +23,41 @@ final readonly class GetSubjectsHandler
     }
 
     /**
-     * @return SubjectDto[]
+     * @return PaginatedResult<SubjectDto>
      */
-    public function __invoke(GetSubjectsQuery $query): array
+    public function __invoke(GetSubjectsQuery $query): PaginatedResult
     {
         $subjects = $this->subjectRepository->findActiveByTenantAndSchool(
             TenantId::fromString($query->tenantId),
             SchoolId::fromString($query->schoolId),
         );
 
-        // TODO: Récupérer les comptages d'enseignants et de classes
-        // quand les modules Affectations seront implémentés (T7)
+        if ($query->search !== null && $query->search !== '') {
+            $searchLower = mb_strtolower($query->search);
+            $subjects = array_filter(
+                $subjects,
+                static fn ($subject) => str_contains(mb_strtolower((string) $subject->name), $searchLower)
+                    || str_contains(mb_strtolower((string) $subject->code), $searchLower),
+            );
+            $subjects = array_values($subjects);
+        }
 
-        return array_map(
-            static fn ($subject) => SubjectDto::fromDomain(
-                $subject,
-                teacherCount: 0,  // Placeholder - T7
-                classCount: 0,    // Placeholder - T7
+        $total = count($subjects);
+        $offset = ($query->page - 1) * $query->limit;
+        $items = array_slice($subjects, $offset, $query->limit);
+
+        return new PaginatedResult(
+            items: array_map(
+                static fn ($subject) => SubjectDto::fromDomain(
+                    $subject,
+                    teacherCount: 0,
+                    classCount: 0,
+                ),
+                $items,
             ),
-            $subjects,
+            total: $total,
+            page: $query->page,
+            limit: $query->limit,
         );
     }
 }