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.
2026-03-30 06:22:03 +02:00
parent b70d5ec2ad
commit b7dc27f2a5
786 changed files with 118783 additions and 316 deletions
--- a/backend/tests/Unit/Scolarite/Domain/Model/Competency/CompetencyTest.php
+++ b/backend/tests/Unit/Scolarite/Domain/Model/Competency/CompetencyTest.php
@@ -0,0 +1,83 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Tests\Unit\Scolarite\Domain\Model\Competency;
+
+use App\Scolarite\Domain\Model\Competency\Competency;
+use App\Scolarite\Domain\Model\Competency\CompetencyFrameworkId;
+use App\Scolarite\Domain\Model\Competency\CompetencyId;
+use PHPUnit\Framework\Attributes\Test;
+use PHPUnit\Framework\TestCase;
+
+final class CompetencyTest extends TestCase
+{
+    #[Test]
+    public function creerSetsAllProperties(): void
+    {
+        $frameworkId = CompetencyFrameworkId::generate();
+
+        $competency = Competency::creer(
+            frameworkId: $frameworkId,
+            code: 'D1.1',
+            name: 'Comprendre, s\'exprimer en utilisant la langue française',
+            description: 'Domaine 1 - Langages',
+            parentId: null,
+            sortOrder: 1,
+        );
+
+        self::assertTrue($competency->frameworkId->equals($frameworkId));
+        self::assertSame('D1.1', $competency->code);
+        self::assertSame('Comprendre, s\'exprimer en utilisant la langue française', $competency->name);
+        self::assertSame('Domaine 1 - Langages', $competency->description);
+        self::assertNull($competency->parentId);
+        self::assertSame(1, $competency->sortOrder);
+    }
+
+    #[Test]
+    public function creerWithParentId(): void
+    {
+        $frameworkId = CompetencyFrameworkId::generate();
+        $parentId = CompetencyId::generate();
+
+        $competency = Competency::creer(
+            frameworkId: $frameworkId,
+            code: 'D1.1.1',
+            name: 'Lire',
+            description: null,
+            parentId: $parentId,
+            sortOrder: 1,
+        );
+
+        self::assertNotNull($competency->parentId);
+        self::assertTrue($competency->parentId->equals($parentId));
+        self::assertNull($competency->description);
+    }
+
+    #[Test]
+    public function reconstituteRestoresAllProperties(): void
+    {
+        $id = CompetencyId::generate();
+        $frameworkId = CompetencyFrameworkId::generate();
+        $parentId = CompetencyId::generate();
+
+        $competency = Competency::reconstitute(
+            id: $id,
+            frameworkId: $frameworkId,
+            code: 'D2',
+            name: 'Méthodes et outils pour apprendre',
+            description: 'Domaine 2',
+            parentId: $parentId,
+            sortOrder: 2,
+        );
+
+        self::assertTrue($competency->id->equals($id));
+        self::assertTrue($competency->frameworkId->equals($frameworkId));
+        self::assertSame('D2', $competency->code);
+        self::assertSame('Méthodes et outils pour apprendre', $competency->name);
+        self::assertSame('Domaine 2', $competency->description);
+        self::assertNotNull($competency->parentId);
+        self::assertTrue($competency->parentId->equals($parentId));
+        self::assertSame(2, $competency->sortOrder);
+    }
+}