feat: Permettre la définition d'une semaine type récurrente pour l'emploi du temps

Les administrateurs devaient recréer manuellement l'emploi du temps chaque
semaine. Cette implémentation introduit un système de récurrence hebdomadaire
avec gestion des exceptions par occurrence, permettant de modifier ou annuler
un cours spécifique sans affecter les autres semaines.

Le ScheduleResolver calcule dynamiquement l'EDT réel en combinant les créneaux
récurrents, les exceptions ponctuelles et le calendrier scolaire (vacances/fériés).

backend/src/Scolarite/Infrastructure/Api/Resource/ResolvedScheduleSlotResource.php

@@ -0,0 +1,81 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Scolarite\Infrastructure\Api\Resource;
+
+use ApiPlatform\Metadata\ApiProperty;
+use ApiPlatform\Metadata\ApiResource;
+use ApiPlatform\Metadata\GetCollection;
+use ApiPlatform\Metadata\Link;
+use App\Scolarite\Domain\Model\Schedule\ResolvedScheduleSlot;
+use App\Scolarite\Infrastructure\Api\Provider\ResolvedScheduleWeekProvider;
+
+/**
+ * API Resource pour l'emploi du temps résolu (récurrences + exceptions + calendrier).
+ *
+ * @see Story 4.2 - Récurrences Hebdomadaires
+ * @see FR27 - Définir une semaine type qui se répète automatiquement
+ */
+#[ApiResource(
+    shortName: 'ResolvedScheduleSlot',
+    operations: [
+        new GetCollection(
+            uriTemplate: '/schedule/week/{date}',
+            uriVariables: [
+                'date' => new Link(
+                    fromClass: self::class,
+                    identifiers: ['date'],
+                ),
+            ],
+            provider: ResolvedScheduleWeekProvider::class,
+            name: 'get_resolved_schedule_week',
+        ),
+    ],
+)]
+final class ResolvedScheduleSlotResource
+{
+    #[ApiProperty(identifier: true)]
+    public ?string $id = null;
+
+    public ?string $slotId = null;
+
+    public ?string $classId = null;
+
+    public ?string $subjectId = null;
+
+    public ?string $teacherId = null;
+
+    public ?int $dayOfWeek = null;
+
+    public ?string $startTime = null;
+
+    public ?string $endTime = null;
+
+    public ?string $room = null;
+
+    public ?string $date = null;
+
+    public ?bool $isModified = null;
+
+    public ?string $exceptionId = null;
+
+    public static function fromDomain(ResolvedScheduleSlot $resolved): self
+    {
+        $resource = new self();
+        $resource->id = (string) $resolved->slotId . '_' . $resolved->date->format('Y-m-d');
+        $resource->slotId = (string) $resolved->slotId;
+        $resource->classId = (string) $resolved->classId;
+        $resource->subjectId = (string) $resolved->subjectId;
+        $resource->teacherId = (string) $resolved->teacherId;
+        $resource->dayOfWeek = $resolved->dayOfWeek->value;
+        $resource->startTime = $resolved->timeSlot->startTime;
+        $resource->endTime = $resolved->timeSlot->endTime;
+        $resource->room = $resolved->room;
+        $resource->date = $resolved->date->format('Y-m-d');
+        $resource->isModified = $resolved->isModified;
+        $resource->exceptionId = $resolved->exceptionId !== null ? (string) $resolved->exceptionId : null;
+
+        return $resource;
+    }
+}

backend/src/Scolarite/Infrastructure/Api/Resource/ScheduleOccurrenceResource.php

@@ -0,0 +1,71 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Scolarite\Infrastructure\Api\Resource;
+
+use ApiPlatform\Metadata\ApiProperty;
+use ApiPlatform\Metadata\ApiResource;
+use ApiPlatform\Metadata\Delete;
+use ApiPlatform\Metadata\Put;
+use App\Scolarite\Infrastructure\Api\Processor\CancelOccurrenceProcessor;
+use App\Scolarite\Infrastructure\Api\Processor\ModifyOccurrenceProcessor;
+use Symfony\Component\Validator\Constraints as Assert;
+
+/**
+ * API Resource pour les modifications ponctuelles d'occurrences de cours récurrents.
+ *
+ * @see Story 4.2 - Récurrences Hebdomadaires (AC3, AC5)
+ */
+#[ApiResource(
+    shortName: 'ScheduleOccurrence',
+    operations: [
+        new Put(
+            uriTemplate: '/schedule/slots/{id}/occurrence/{date}',
+            read: false,
+            processor: ModifyOccurrenceProcessor::class,
+            name: 'modify_schedule_occurrence',
+        ),
+        new Delete(
+            uriTemplate: '/schedule/slots/{id}/occurrence/{date}',
+            read: false,
+            processor: CancelOccurrenceProcessor::class,
+            name: 'cancel_schedule_occurrence',
+        ),
+    ],
+)]
+final class ScheduleOccurrenceResource
+{
+    #[ApiProperty(identifier: true)]
+    public ?string $id = null;
+
+    /**
+     * 'this_occurrence' (modifier uniquement cette date) ou 'all_future' (toutes les futures).
+     */
+    #[Assert\Choice(choices: ['this_occurrence', 'all_future'], message: 'Le scope doit être "this_occurrence" ou "all_future".')]
+    public ?string $scope = 'this_occurrence';
+
+    public ?string $classId = null;
+
+    public ?string $subjectId = null;
+
+    public ?string $teacherId = null;
+
+    public ?int $dayOfWeek = null;
+
+    #[Assert\Regex(pattern: '/^([01]\d|2[0-3]):[0-5]\d$/', message: "L'heure doit être au format HH:MM.")]
+    public ?string $startTime = null;
+
+    #[Assert\Regex(pattern: '/^([01]\d|2[0-3]):[0-5]\d$/', message: "L'heure doit être au format HH:MM.")]
+    public ?string $endTime = null;
+
+    public ?string $room = null;
+
+    public ?string $reason = null;
+
+    public ?string $type = null;
+
+    public ?string $date = null;
+
+    public ?string $slotId = null;
+}