feat: Configuration du mode de notation par établissement

Les établissements scolaires utilisent des systèmes d'évaluation variés (notes /20, /10, lettres, compétences, sans notes). Jusqu'ici l'application imposait implicitement le mode notes /20, ce qui ne correspondait pas à la réalité pédagogique de nombreuses écoles. Cette configuration permet à chaque établissement de choisir son mode de notation par année scolaire, avec verrouillage automatique dès que des notes ont été saisies pour éviter les incohérences. Le Score Sérénité adapte ses pondérations selon le mode choisi (les compétences sont converties via un mapping, le mode sans notes exclut la composante notes).
2026-02-07 01:06:55 +01:00
parent f19d0ae3ef
commit ff18850a43
51 changed files with 3963 additions and 79 deletions
--- a/backend/tests/Unit/Administration/Infrastructure/Api/Resource/GradingModeResourceTest.php
+++ b/backend/tests/Unit/Administration/Infrastructure/Api/Resource/GradingModeResourceTest.php
@@ -0,0 +1,124 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Tests\Unit\Administration\Infrastructure\Api\Resource;
+
+use App\Administration\Domain\Model\GradingConfiguration\GradingMode;
+use App\Administration\Domain\Model\GradingConfiguration\SchoolGradingConfiguration;
+use App\Administration\Domain\Model\SchoolClass\AcademicYearId;
+use App\Administration\Domain\Model\SchoolClass\SchoolId;
+use App\Administration\Infrastructure\Api\Resource\GradingModeResource;
+use App\Shared\Domain\Tenant\TenantId;
+use DateTimeImmutable;
+use PHPUnit\Framework\Attributes\Test;
+use PHPUnit\Framework\TestCase;
+
+final class GradingModeResourceTest extends TestCase
+{
+    #[Test]
+    public function fromDomainMapsAllFields(): void
+    {
+        $config = SchoolGradingConfiguration::configurer(
+            tenantId: TenantId::generate(),
+            schoolId: SchoolId::generate(),
+            academicYearId: AcademicYearId::generate(),
+            mode: GradingMode::NUMERIC_20,
+            hasExistingGrades: false,
+            configuredAt: new DateTimeImmutable(),
+        );
+
+        $resource = GradingModeResource::fromDomain($config);
+
+        self::assertSame('numeric_20', $resource->mode);
+        self::assertSame('Notes /20', $resource->label);
+        self::assertSame(20, $resource->scaleMax);
+        self::assertTrue($resource->isNumeric);
+        self::assertTrue($resource->calculatesAverage);
+        self::assertSame((string) $config->academicYearId, $resource->academicYearId);
+    }
+
+    #[Test]
+    public function fromDomainMapsCompetenciesMode(): void
+    {
+        $config = SchoolGradingConfiguration::configurer(
+            tenantId: TenantId::generate(),
+            schoolId: SchoolId::generate(),
+            academicYearId: AcademicYearId::generate(),
+            mode: GradingMode::COMPETENCIES,
+            hasExistingGrades: false,
+            configuredAt: new DateTimeImmutable(),
+        );
+
+        $resource = GradingModeResource::fromDomain($config);
+
+        self::assertSame('competencies', $resource->mode);
+        self::assertSame('Compétences', $resource->label);
+        self::assertNull($resource->scaleMax);
+        self::assertFalse($resource->isNumeric);
+        self::assertFalse($resource->calculatesAverage);
+    }
+
+    #[Test]
+    public function fromDomainMapsNoGradesMode(): void
+    {
+        $config = SchoolGradingConfiguration::configurer(
+            tenantId: TenantId::generate(),
+            schoolId: SchoolId::generate(),
+            academicYearId: AcademicYearId::generate(),
+            mode: GradingMode::NO_GRADES,
+            hasExistingGrades: false,
+            configuredAt: new DateTimeImmutable(),
+        );
+
+        $resource = GradingModeResource::fromDomain($config);
+
+        self::assertSame('no_grades', $resource->mode);
+        self::assertSame('Sans notes', $resource->label);
+        self::assertNull($resource->scaleMax);
+        self::assertFalse($resource->isNumeric);
+        self::assertFalse($resource->calculatesAverage);
+    }
+
+    #[Test]
+    public function defaultForYearUsesNumeric20(): void
+    {
+        $yearId = 'some-year-id';
+        $resource = GradingModeResource::defaultForYear($yearId);
+
+        self::assertSame($yearId, $resource->academicYearId);
+        self::assertSame('numeric_20', $resource->mode);
+        self::assertSame('Notes /20', $resource->label);
+        self::assertSame(20, $resource->scaleMax);
+        self::assertTrue($resource->isNumeric);
+        self::assertTrue($resource->calculatesAverage);
+        self::assertFalse($resource->hasExistingGrades);
+    }
+
+    #[Test]
+    public function allAvailableModesReturnsAllFiveModes(): void
+    {
+        $modes = GradingModeResource::allAvailableModes();
+
+        self::assertCount(5, $modes);
+
+        $values = array_column($modes, 'value');
+        self::assertContains('numeric_20', $values);
+        self::assertContains('numeric_10', $values);
+        self::assertContains('letters', $values);
+        self::assertContains('competencies', $values);
+        self::assertContains('no_grades', $values);
+    }
+
+    #[Test]
+    public function allAvailableModesContainsLabels(): void
+    {
+        $modes = GradingModeResource::allAvailableModes();
+
+        foreach ($modes as $mode) {
+            self::assertArrayHasKey('value', $mode);
+            self::assertArrayHasKey('label', $mode);
+            self::assertNotEmpty($mode['label']);
+        }
+    }
+}