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/Domain/Model/GradingConfiguration/GradingConfigurationTest.php
+++ b/backend/tests/Unit/Administration/Domain/Model/GradingConfiguration/GradingConfigurationTest.php
@@ -0,0 +1,79 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Tests\Unit\Administration\Domain\Model\GradingConfiguration;
+
+use App\Administration\Domain\Model\GradingConfiguration\GradingConfiguration;
+use App\Administration\Domain\Model\GradingConfiguration\GradingMode;
+use PHPUnit\Framework\Attributes\Test;
+use PHPUnit\Framework\TestCase;
+
+final class GradingConfigurationTest extends TestCase
+{
+    #[Test]
+    public function itCreatesNumeric20Configuration(): void
+    {
+        $config = new GradingConfiguration(GradingMode::NUMERIC_20);
+
+        self::assertSame(GradingMode::NUMERIC_20, $config->mode);
+    }
+
+    #[Test]
+    public function itCreatesCompetenciesConfiguration(): void
+    {
+        $config = new GradingConfiguration(GradingMode::COMPETENCIES);
+
+        self::assertSame(GradingMode::COMPETENCIES, $config->mode);
+    }
+
+    #[Test]
+    public function itCreatesNoGradesConfiguration(): void
+    {
+        $config = new GradingConfiguration(GradingMode::NO_GRADES);
+
+        self::assertSame(GradingMode::NO_GRADES, $config->mode);
+    }
+
+    #[Test]
+    public function equalConfigurationsAreEqual(): void
+    {
+        $config1 = new GradingConfiguration(GradingMode::NUMERIC_20);
+        $config2 = new GradingConfiguration(GradingMode::NUMERIC_20);
+
+        self::assertTrue($config1->equals($config2));
+    }
+
+    #[Test]
+    public function differentConfigurationsAreNotEqual(): void
+    {
+        $config1 = new GradingConfiguration(GradingMode::NUMERIC_20);
+        $config2 = new GradingConfiguration(GradingMode::COMPETENCIES);
+
+        self::assertFalse($config1->equals($config2));
+    }
+
+    #[Test]
+    public function itDelegatesToModeForScaleMax(): void
+    {
+        $config = new GradingConfiguration(GradingMode::NUMERIC_20);
+        self::assertSame(20, $config->scaleMax());
+
+        $config = new GradingConfiguration(GradingMode::COMPETENCIES);
+        self::assertNull($config->scaleMax());
+    }
+
+    #[Test]
+    public function itDelegatesToModeForEstNumerique(): void
+    {
+        self::assertTrue((new GradingConfiguration(GradingMode::NUMERIC_20))->estNumerique());
+        self::assertFalse((new GradingConfiguration(GradingMode::NO_GRADES))->estNumerique());
+    }
+
+    #[Test]
+    public function itDelegatesToModeForCalculeMoyenne(): void
+    {
+        self::assertTrue((new GradingConfiguration(GradingMode::NUMERIC_20))->calculeMoyenne());
+        self::assertFalse((new GradingConfiguration(GradingMode::COMPETENCIES))->calculeMoyenne());
+    }
+}
--- a/backend/tests/Unit/Administration/Domain/Model/GradingConfiguration/GradingModeTest.php
+++ b/backend/tests/Unit/Administration/Domain/Model/GradingConfiguration/GradingModeTest.php
@@ -0,0 +1,97 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Tests\Unit\Administration\Domain\Model\GradingConfiguration;
+
+use App\Administration\Domain\Model\GradingConfiguration\GradingMode;
+use App\Scolarite\Domain\Model\GradingMode as ScolariteGradingMode;
+use PHPUnit\Framework\Attributes\Test;
+use PHPUnit\Framework\TestCase;
+
+final class GradingModeTest extends TestCase
+{
+    #[Test]
+    public function itHasCorrectValues(): void
+    {
+        self::assertSame('numeric_20', GradingMode::NUMERIC_20->value);
+        self::assertSame('numeric_10', GradingMode::NUMERIC_10->value);
+        self::assertSame('letters', GradingMode::LETTERS->value);
+        self::assertSame('competencies', GradingMode::COMPETENCIES->value);
+        self::assertSame('no_grades', GradingMode::NO_GRADES->value);
+    }
+
+    #[Test]
+    public function numeric20HasCorrectScale(): void
+    {
+        self::assertSame(20, GradingMode::NUMERIC_20->scaleMax());
+    }
+
+    #[Test]
+    public function numeric10HasCorrectScale(): void
+    {
+        self::assertSame(10, GradingMode::NUMERIC_10->scaleMax());
+    }
+
+    #[Test]
+    public function nonNumericModesHaveNullScale(): void
+    {
+        self::assertNull(GradingMode::LETTERS->scaleMax());
+        self::assertNull(GradingMode::COMPETENCIES->scaleMax());
+        self::assertNull(GradingMode::NO_GRADES->scaleMax());
+    }
+
+    #[Test]
+    public function numericModesUseNumericGrading(): void
+    {
+        self::assertTrue(GradingMode::NUMERIC_20->estNumerique());
+        self::assertTrue(GradingMode::NUMERIC_10->estNumerique());
+    }
+
+    #[Test]
+    public function nonNumericModesDoNotUseNumericGrading(): void
+    {
+        self::assertFalse(GradingMode::LETTERS->estNumerique());
+        self::assertFalse(GradingMode::COMPETENCIES->estNumerique());
+        self::assertFalse(GradingMode::NO_GRADES->estNumerique());
+    }
+
+    #[Test]
+    public function modesRequiringAverageCalculation(): void
+    {
+        self::assertTrue(GradingMode::NUMERIC_20->calculeMoyenne());
+        self::assertTrue(GradingMode::NUMERIC_10->calculeMoyenne());
+        self::assertTrue(GradingMode::LETTERS->calculeMoyenne());
+        self::assertFalse(GradingMode::COMPETENCIES->calculeMoyenne());
+        self::assertFalse(GradingMode::NO_GRADES->calculeMoyenne());
+    }
+
+    #[Test]
+    public function labelsAreInFrench(): void
+    {
+        self::assertSame('Notes /20', GradingMode::NUMERIC_20->label());
+        self::assertSame('Notes /10', GradingMode::NUMERIC_10->label());
+        self::assertSame('Lettres (A-E)', GradingMode::LETTERS->label());
+        self::assertSame('Compétences', GradingMode::COMPETENCIES->label());
+        self::assertSame('Sans notes', GradingMode::NO_GRADES->label());
+    }
+
+    #[Test]
+    public function administrationAndScolariteEnumsAreInSync(): void
+    {
+        $adminValues = array_map(
+            static fn (GradingMode $m) => $m->value,
+            GradingMode::cases(),
+        );
+        $scolariteValues = array_map(
+            static fn (ScolariteGradingMode $m) => $m->value,
+            ScolariteGradingMode::cases(),
+        );
+
+        self::assertSame(
+            $adminValues,
+            $scolariteValues,
+            'Les enums GradingMode des contextes Administration et Scolarité doivent rester synchronisées.',
+        );
+    }
+}
--- a/backend/tests/Unit/Administration/Domain/Model/GradingConfiguration/SchoolGradingConfigurationTest.php
+++ b/backend/tests/Unit/Administration/Domain/Model/GradingConfiguration/SchoolGradingConfigurationTest.php
@@ -0,0 +1,186 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Tests\Unit\Administration\Domain\Model\GradingConfiguration;
+
+use App\Administration\Domain\Exception\CannotChangeGradingModeWithExistingGradesException;
+use App\Administration\Domain\Model\GradingConfiguration\GradingConfiguration;
+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\Shared\Domain\Tenant\TenantId;
+use DateTimeImmutable;
+use PHPUnit\Framework\Attributes\Test;
+use PHPUnit\Framework\TestCase;
+
+final class SchoolGradingConfigurationTest extends TestCase
+{
+    private TenantId $tenantId;
+    private SchoolId $schoolId;
+    private AcademicYearId $academicYearId;
+
+    protected function setUp(): void
+    {
+        $this->tenantId = TenantId::generate();
+        $this->schoolId = SchoolId::generate();
+        $this->academicYearId = AcademicYearId::generate();
+    }
+
+    #[Test]
+    public function itConfiguresGradingMode(): void
+    {
+        $config = SchoolGradingConfiguration::configurer(
+            tenantId: $this->tenantId,
+            schoolId: $this->schoolId,
+            academicYearId: $this->academicYearId,
+            mode: GradingMode::NUMERIC_20,
+            hasExistingGrades: false,
+            configuredAt: new DateTimeImmutable('2026-02-01'),
+        );
+
+        self::assertSame(GradingMode::NUMERIC_20, $config->gradingConfiguration->mode);
+        self::assertSame($this->tenantId, $config->tenantId);
+        self::assertSame($this->schoolId, $config->schoolId);
+        self::assertSame($this->academicYearId, $config->academicYearId);
+    }
+
+    #[Test]
+    public function itEmitsEventOnCreation(): void
+    {
+        $config = SchoolGradingConfiguration::configurer(
+            tenantId: $this->tenantId,
+            schoolId: $this->schoolId,
+            academicYearId: $this->academicYearId,
+            mode: GradingMode::COMPETENCIES,
+            hasExistingGrades: false,
+            configuredAt: new DateTimeImmutable('2026-02-01'),
+        );
+
+        $events = $config->pullDomainEvents();
+        self::assertCount(1, $events);
+    }
+
+    #[Test]
+    public function itChangesGradingModeWhenNoGradesExist(): void
+    {
+        $config = SchoolGradingConfiguration::configurer(
+            tenantId: $this->tenantId,
+            schoolId: $this->schoolId,
+            academicYearId: $this->academicYearId,
+            mode: GradingMode::NUMERIC_20,
+            hasExistingGrades: false,
+            configuredAt: new DateTimeImmutable('2026-02-01'),
+        );
+        $config->pullDomainEvents();
+
+        $config->changerMode(
+            nouveauMode: GradingMode::COMPETENCIES,
+            hasExistingGrades: false,
+            at: new DateTimeImmutable('2026-02-02'),
+        );
+
+        self::assertSame(GradingMode::COMPETENCIES, $config->gradingConfiguration->mode);
+        $events = $config->pullDomainEvents();
+        self::assertCount(1, $events);
+    }
+
+    #[Test]
+    public function itBlocksChangeWhenGradesExist(): void
+    {
+        $config = SchoolGradingConfiguration::configurer(
+            tenantId: $this->tenantId,
+            schoolId: $this->schoolId,
+            academicYearId: $this->academicYearId,
+            mode: GradingMode::NUMERIC_20,
+            hasExistingGrades: false,
+            configuredAt: new DateTimeImmutable('2026-02-01'),
+        );
+
+        $this->expectException(CannotChangeGradingModeWithExistingGradesException::class);
+
+        $config->changerMode(
+            nouveauMode: GradingMode::COMPETENCIES,
+            hasExistingGrades: true,
+            at: new DateTimeImmutable('2026-02-02'),
+        );
+    }
+
+    #[Test]
+    public function itDoesNotEmitEventWhenModeIsUnchanged(): void
+    {
+        $config = SchoolGradingConfiguration::configurer(
+            tenantId: $this->tenantId,
+            schoolId: $this->schoolId,
+            academicYearId: $this->academicYearId,
+            mode: GradingMode::NUMERIC_20,
+            hasExistingGrades: false,
+            configuredAt: new DateTimeImmutable('2026-02-01'),
+        );
+        $config->pullDomainEvents();
+
+        $config->changerMode(
+            nouveauMode: GradingMode::NUMERIC_20,
+            hasExistingGrades: false,
+            at: new DateTimeImmutable('2026-02-02'),
+        );
+
+        self::assertEmpty($config->pullDomainEvents());
+    }
+
+    #[Test]
+    public function itReconstitutesFromStorage(): void
+    {
+        $id = SchoolGradingConfiguration::generateId();
+
+        $config = SchoolGradingConfiguration::reconstitute(
+            id: $id,
+            tenantId: $this->tenantId,
+            schoolId: $this->schoolId,
+            academicYearId: $this->academicYearId,
+            gradingConfiguration: new GradingConfiguration(GradingMode::LETTERS),
+            configuredAt: new DateTimeImmutable('2026-02-01'),
+            updatedAt: new DateTimeImmutable('2026-02-02'),
+        );
+
+        self::assertSame(GradingMode::LETTERS, $config->gradingConfiguration->mode);
+        self::assertEmpty($config->pullDomainEvents());
+    }
+
+    #[Test]
+    public function itBlocksInitialNonDefaultModeWhenGradesExist(): void
+    {
+        $this->expectException(CannotChangeGradingModeWithExistingGradesException::class);
+
+        SchoolGradingConfiguration::configurer(
+            tenantId: $this->tenantId,
+            schoolId: $this->schoolId,
+            academicYearId: $this->academicYearId,
+            mode: GradingMode::COMPETENCIES,
+            hasExistingGrades: true,
+            configuredAt: new DateTimeImmutable('2026-02-01'),
+        );
+    }
+
+    #[Test]
+    public function itAllowsInitialDefaultModeWhenGradesExist(): void
+    {
+        $config = SchoolGradingConfiguration::configurer(
+            tenantId: $this->tenantId,
+            schoolId: $this->schoolId,
+            academicYearId: $this->academicYearId,
+            mode: GradingMode::NUMERIC_20,
+            hasExistingGrades: true,
+            configuredAt: new DateTimeImmutable('2026-02-01'),
+        );
+
+        self::assertSame(GradingMode::NUMERIC_20, $config->gradingConfiguration->mode);
+    }
+
+    #[Test]
+    public function defaultModeIsNumeric20(): void
+    {
+        self::assertSame(GradingMode::NUMERIC_20, SchoolGradingConfiguration::DEFAULT_MODE);
+    }
+}