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).

backend/src/Administration/Application/Command/ConfigureGradingMode/ConfigureGradingModeCommand.php

@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Administration\Application\Command\ConfigureGradingMode;
+
+final readonly class ConfigureGradingModeCommand
+{
+    public function __construct(
+        public string $tenantId,
+        public string $schoolId,
+        public string $academicYearId,
+        public string $gradingMode,
+    ) {
+    }
+}

backend/src/Administration/Application/Command/ConfigureGradingMode/ConfigureGradingModeHandler.php

@@ -0,0 +1,67 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Administration\Application\Command\ConfigureGradingMode;
+
+use App\Administration\Application\Port\GradeExistenceChecker;
+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\Domain\Repository\GradingConfigurationRepository;
+use App\Shared\Domain\Clock;
+use App\Shared\Domain\Tenant\TenantId;
+use Symfony\Component\Messenger\Attribute\AsMessageHandler;
+
+/**
+ * Handler pour configurer le mode de notation d'un établissement.
+ *
+ * Crée une nouvelle configuration si aucune n'existe pour l'année scolaire,
+ * ou modifie la configuration existante si aucune note n'a été saisie.
+ */
+#[AsMessageHandler(bus: 'command.bus')]
+final readonly class ConfigureGradingModeHandler
+{
+    public function __construct(
+        private GradingConfigurationRepository $repository,
+        private GradeExistenceChecker $gradeExistenceChecker,
+        private Clock $clock,
+    ) {
+    }
+
+    public function __invoke(ConfigureGradingModeCommand $command): SchoolGradingConfiguration
+    {
+        $tenantId = TenantId::fromString($command->tenantId);
+        $schoolId = SchoolId::fromString($command->schoolId);
+        $academicYearId = AcademicYearId::fromString($command->academicYearId);
+        $mode = GradingMode::from($command->gradingMode);
+        $now = $this->clock->now();
+
+        $existing = $this->repository->findBySchoolAndYear($tenantId, $schoolId, $academicYearId);
+        $hasGrades = $this->gradeExistenceChecker->hasGradesForYear($tenantId, $schoolId, $academicYearId);
+
+        if ($existing === null) {
+            $configuration = SchoolGradingConfiguration::configurer(
+                tenantId: $tenantId,
+                schoolId: $schoolId,
+                academicYearId: $academicYearId,
+                mode: $mode,
+                hasExistingGrades: $hasGrades,
+                configuredAt: $now,
+            );
+        } else {
+            $existing->changerMode(
+                nouveauMode: $mode,
+                hasExistingGrades: $hasGrades,
+                at: $now,
+            );
+
+            $configuration = $existing;
+        }
+
+        $this->repository->save($configuration);
+
+        return $configuration;
+    }
+}

backend/src/Administration/Application/Port/GradeExistenceChecker.php

@@ -5,6 +5,7 @@ declare(strict_types=1);
 namespace App\Administration\Application\Port;
 
 use App\Administration\Domain\Model\SchoolClass\AcademicYearId;
+use App\Administration\Domain\Model\SchoolClass\SchoolId;
 use App\Shared\Domain\Tenant\TenantId;
 
 /**
@@ -20,4 +21,16 @@ interface GradeExistenceChecker
         AcademicYearId $academicYearId,
         int $periodSequence,
     ): bool;
+
+    /**
+     * Vérifie si des notes existent pour une année scolaire entière.
+     *
+     * Utilisé pour bloquer le changement de mode de notation quand
+     * des évaluations ont déjà été saisies.
+     */
+    public function hasGradesForYear(
+        TenantId $tenantId,
+        SchoolId $schoolId,
+        AcademicYearId $academicYearId,
+    ): bool;
 }

backend/src/Administration/Application/Query/HasGradesForYear/HasGradesForYearHandler.php

@@ -0,0 +1,35 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Administration\Application\Query\HasGradesForYear;
+
+use App\Administration\Application\Port\GradeExistenceChecker;
+use App\Administration\Domain\Model\SchoolClass\AcademicYearId;
+use App\Administration\Domain\Model\SchoolClass\SchoolId;
+use App\Shared\Domain\Tenant\TenantId;
+use Symfony\Component\Messenger\Attribute\AsMessageHandler;
+
+/**
+ * Handler pour vérifier la présence de notes dans une année scolaire.
+ *
+ * Délègue au port GradeExistenceChecker qui sera implémenté par le module Notes
+ * quand il existera. Pour l'instant, retourne toujours false (pas de notes).
+ */
+#[AsMessageHandler(bus: 'query.bus')]
+final readonly class HasGradesForYearHandler
+{
+    public function __construct(
+        private GradeExistenceChecker $gradeExistenceChecker,
+    ) {
+    }
+
+    public function __invoke(HasGradesForYearQuery $query): bool
+    {
+        return $this->gradeExistenceChecker->hasGradesForYear(
+            TenantId::fromString($query->tenantId),
+            SchoolId::fromString($query->schoolId),
+            AcademicYearId::fromString($query->academicYearId),
+        );
+    }
+}

backend/src/Administration/Application/Query/HasGradesForYear/HasGradesForYearQuery.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Administration\Application\Query\HasGradesForYear;
+
+/**
+ * Query pour vérifier si des notes existent pour une année scolaire entière.
+ *
+ * Utilisée pour bloquer le changement de mode de notation quand des
+ * évaluations ont déjà été saisies durant l'année en cours.
+ */
+final readonly class HasGradesForYearQuery
+{
+    public function __construct(
+        public string $tenantId,
+        public string $schoolId,
+        public string $academicYearId,
+    ) {
+    }
+}