feat: Calculer automatiquement les moyennes après chaque saisie de notes

Les enseignants ont besoin de moyennes à jour immédiatement après la
publication ou modification des notes, sans attendre un batch nocturne.

Le système recalcule via Domain Events synchrones : statistiques
d'évaluation (min/max/moyenne/médiane), moyennes matières pondérées
(normalisation /20), et moyenne générale par élève. Les résultats sont
stockés dans des tables dénormalisées avec cache Redis (TTL 5 min).

Trois endpoints API exposent les données avec contrôle d'accès par rôle.
Une commande console permet le backfill des données historiques au
déploiement.

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

@@ -11,6 +11,7 @@ use ApiPlatform\Metadata\Post;
 use ApiPlatform\Metadata\Put;
 use App\Scolarite\Domain\Model\Grade\Grade;
 use App\Scolarite\Infrastructure\Api\Processor\PublishGradesProcessor;
+use App\Scolarite\Infrastructure\Api\Processor\SaveAppreciationProcessor;
 use App\Scolarite\Infrastructure\Api\Processor\SaveGradesProcessor;
 use App\Scolarite\Infrastructure\Api\Provider\GradeCollectionProvider;
 use DateTimeImmutable;
@@ -32,6 +33,12 @@ use DateTimeImmutable;
             processor: SaveGradesProcessor::class,
             name: 'save_evaluation_grades',
         ),
+        new Put(
+            uriTemplate: '/grades/{id}/appreciation',
+            read: false,
+            processor: SaveAppreciationProcessor::class,
+            name: 'save_grade_appreciation',
+        ),
         new Post(
             uriTemplate: '/evaluations/{evaluationId}/publish',
             uriVariables: ['evaluationId'],
@@ -56,6 +63,8 @@ final class GradeResource
 
     public ?string $status = null;
 
+    public ?string $appreciation = null;
+
     public ?DateTimeImmutable $createdAt = null;
 
     public ?DateTimeImmutable $updatedAt = null;
@@ -76,6 +85,7 @@ final class GradeResource
         $resource->studentName = $studentName;
         $resource->value = $grade->value?->value;
         $resource->status = $grade->status->value;
+        $resource->appreciation = $grade->appreciation;
         $resource->createdAt = $grade->createdAt;
         $resource->updatedAt = $grade->updatedAt;