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/tests/Unit/Scolarite/Domain/Model/Grade/GradeTest.php

@@ -7,6 +7,7 @@ namespace App\Tests\Unit\Scolarite\Domain\Model\Grade;
 use App\Administration\Domain\Model\User\UserId;
 use App\Scolarite\Domain\Event\NoteModifiee;
 use App\Scolarite\Domain\Event\NoteSaisie;
+use App\Scolarite\Domain\Exception\AppreciationTropLongueException;
 use App\Scolarite\Domain\Exception\NoteRequiseException;
 use App\Scolarite\Domain\Exception\ValeurNoteInvalideException;
 use App\Scolarite\Domain\Model\Evaluation\EvaluationId;
@@ -20,6 +21,8 @@ use DateTimeImmutable;
 use PHPUnit\Framework\Attributes\Test;
 use PHPUnit\Framework\TestCase;
 
+use function str_repeat;
+
 final class GradeTest extends TestCase
 {
     private const string TENANT_ID = '550e8400-e29b-41d4-a716-446655440001';
@@ -269,6 +272,96 @@ final class GradeTest extends TestCase
         self::assertEmpty($grade->pullDomainEvents());
     }
 
+    #[Test]
+    public function saisirAppreciationSetsAppreciation(): void
+    {
+        $grade = $this->createGrade();
+        $now = new DateTimeImmutable('2026-03-31 10:00:00');
+
+        $grade->saisirAppreciation('Très bon travail', $now);
+
+        self::assertSame('Très bon travail', $grade->appreciation);
+        self::assertEquals($now, $grade->appreciationUpdatedAt);
+        self::assertEquals($now, $grade->updatedAt);
+    }
+
+    #[Test]
+    public function saisirAppreciationAcceptsNull(): void
+    {
+        $grade = $this->createGrade();
+        $grade->saisirAppreciation('Temporaire', new DateTimeImmutable('2026-03-31 09:00:00'));
+
+        $grade->saisirAppreciation(null, new DateTimeImmutable('2026-03-31 10:00:00'));
+
+        self::assertNull($grade->appreciation);
+    }
+
+    #[Test]
+    public function saisirAppreciationAcceptsEmptyString(): void
+    {
+        $grade = $this->createGrade();
+        $grade->saisirAppreciation('Temporaire', new DateTimeImmutable('2026-03-31 09:00:00'));
+
+        $grade->saisirAppreciation('', new DateTimeImmutable('2026-03-31 10:00:00'));
+
+        self::assertNull($grade->appreciation);
+    }
+
+    #[Test]
+    public function saisirAppreciationThrowsWhenTooLong(): void
+    {
+        $grade = $this->createGrade();
+
+        $this->expectException(AppreciationTropLongueException::class);
+
+        $grade->saisirAppreciation(str_repeat('a', 501), new DateTimeImmutable('2026-03-31 10:00:00'));
+    }
+
+    #[Test]
+    public function saisirAppreciationAcceptsMaxLength(): void
+    {
+        $grade = $this->createGrade();
+
+        $grade->saisirAppreciation(str_repeat('a', 500), new DateTimeImmutable('2026-03-31 10:00:00'));
+
+        self::assertSame(500, mb_strlen($grade->appreciation ?? ''));
+    }
+
+    #[Test]
+    public function newGradeHasNullAppreciation(): void
+    {
+        $grade = $this->createGrade();
+
+        self::assertNull($grade->appreciation);
+        self::assertNull($grade->appreciationUpdatedAt);
+    }
+
+    #[Test]
+    public function reconstituteRestoresAppreciation(): void
+    {
+        $gradeId = GradeId::generate();
+        $createdAt = new DateTimeImmutable('2026-03-27 10:00:00');
+        $updatedAt = new DateTimeImmutable('2026-03-27 14:00:00');
+        $appreciationUpdatedAt = new DateTimeImmutable('2026-03-31 10:00:00');
+
+        $grade = Grade::reconstitute(
+            id: $gradeId,
+            tenantId: TenantId::fromString(self::TENANT_ID),
+            evaluationId: EvaluationId::fromString(self::EVALUATION_ID),
+            studentId: UserId::fromString(self::STUDENT_ID),
+            value: new GradeValue(15.5),
+            status: GradeStatus::GRADED,
+            createdBy: UserId::fromString(self::TEACHER_ID),
+            createdAt: $createdAt,
+            updatedAt: $updatedAt,
+            appreciation: 'Bon travail',
+            appreciationUpdatedAt: $appreciationUpdatedAt,
+        );
+
+        self::assertSame('Bon travail', $grade->appreciation);
+        self::assertEquals($appreciationUpdatedAt, $grade->appreciationUpdatedAt);
+    }
+
     private function createGrade(): Grade
     {
         return Grade::saisir(