feat: Affectation des enseignants aux classes et matières

Permet aux administrateurs d'associer un enseignant à une classe pour une matière donnée au sein d'une année scolaire. Cette brique est nécessaire pour construire les emplois du temps et les carnets de notes par la suite. Le modèle impose l'unicité du triplet enseignant × classe × matière par année scolaire, avec réactivation automatique d'une affectation retirée plutôt que duplication. L'isolation multi-tenant est garantie au niveau du repository (findById/get filtrent par tenant_id).
2026-02-13 20:22:39 +01:00
parent 73a473ec93
commit 88e7f319db
61 changed files with 6484 additions and 52 deletions
--- a/backend/tests/Unit/Administration/Application/Query/GetAssignment/GetAssignmentHandlerTest.php
+++ b/backend/tests/Unit/Administration/Application/Query/GetAssignment/GetAssignmentHandlerTest.php
@@ -0,0 +1,126 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Tests\Unit\Administration\Application\Query\GetAssignment;
+
+use App\Administration\Application\Query\GetAssignment\GetAssignmentHandler;
+use App\Administration\Application\Query\GetAssignment\GetAssignmentQuery;
+use App\Administration\Application\Query\GetAssignmentsForTeacher\TeacherAssignmentDto;
+use App\Administration\Domain\Model\SchoolClass\AcademicYearId;
+use App\Administration\Domain\Model\SchoolClass\ClassId;
+use App\Administration\Domain\Model\Subject\SubjectId;
+use App\Administration\Domain\Model\TeacherAssignment\TeacherAssignment;
+use App\Administration\Domain\Model\User\UserId;
+use App\Administration\Infrastructure\Persistence\InMemory\InMemoryTeacherAssignmentRepository;
+use App\Shared\Domain\Tenant\TenantId;
+use DateTimeImmutable;
+use PHPUnit\Framework\Attributes\Test;
+use PHPUnit\Framework\TestCase;
+
+final class GetAssignmentHandlerTest extends TestCase
+{
+    private const string TENANT_ID = '550e8400-e29b-41d4-a716-446655440001';
+    private const string TEACHER_ID = '550e8400-e29b-41d4-a716-446655440010';
+    private const string CLASS_ID = '550e8400-e29b-41d4-a716-446655440020';
+    private const string SUBJECT_ID = '550e8400-e29b-41d4-a716-446655440030';
+    private const string ACADEMIC_YEAR_ID = '550e8400-e29b-41d4-a716-446655440040';
+
+    private InMemoryTeacherAssignmentRepository $repository;
+    private GetAssignmentHandler $handler;
+
+    protected function setUp(): void
+    {
+        $this->repository = new InMemoryTeacherAssignmentRepository();
+        $this->handler = new GetAssignmentHandler($this->repository);
+    }
+
+    #[Test]
+    public function returnsNullWhenNoAssignmentFound(): void
+    {
+        $result = ($this->handler)(new GetAssignmentQuery(
+            teacherId: self::TEACHER_ID,
+            classId: self::CLASS_ID,
+            subjectId: self::SUBJECT_ID,
+            academicYearId: self::ACADEMIC_YEAR_ID,
+            tenantId: self::TENANT_ID,
+        ));
+
+        self::assertNull($result);
+    }
+
+    #[Test]
+    public function returnsAssignmentDto(): void
+    {
+        $assignment = $this->createAndSaveAssignment();
+
+        $result = ($this->handler)(new GetAssignmentQuery(
+            teacherId: self::TEACHER_ID,
+            classId: self::CLASS_ID,
+            subjectId: self::SUBJECT_ID,
+            academicYearId: self::ACADEMIC_YEAR_ID,
+            tenantId: self::TENANT_ID,
+        ));
+
+        self::assertInstanceOf(TeacherAssignmentDto::class, $result);
+        self::assertSame((string) $assignment->id, $result->id);
+        self::assertSame(self::TEACHER_ID, $result->teacherId);
+        self::assertSame(self::CLASS_ID, $result->classId);
+        self::assertSame(self::SUBJECT_ID, $result->subjectId);
+    }
+
+    #[Test]
+    public function returnsNullForRemovedAssignment(): void
+    {
+        $assignment = $this->createAndSaveAssignment();
+        $assignment->retirer(new DateTimeImmutable('2026-02-11 10:00:00'));
+        $this->repository->save($assignment);
+
+        $result = ($this->handler)(new GetAssignmentQuery(
+            teacherId: self::TEACHER_ID,
+            classId: self::CLASS_ID,
+            subjectId: self::SUBJECT_ID,
+            academicYearId: self::ACADEMIC_YEAR_ID,
+            tenantId: self::TENANT_ID,
+        ));
+
+        self::assertNull($result);
+    }
+
+    #[Test]
+    public function dtoContainsCorrectData(): void
+    {
+        $createdAt = new DateTimeImmutable('2026-02-10 10:00:00');
+        $this->createAndSaveAssignment();
+
+        $result = ($this->handler)(new GetAssignmentQuery(
+            teacherId: self::TEACHER_ID,
+            classId: self::CLASS_ID,
+            subjectId: self::SUBJECT_ID,
+            academicYearId: self::ACADEMIC_YEAR_ID,
+            tenantId: self::TENANT_ID,
+        ));
+
+        self::assertSame(self::ACADEMIC_YEAR_ID, $result->academicYearId);
+        self::assertSame('active', $result->status);
+        self::assertEquals($createdAt, $result->startDate);
+        self::assertNull($result->endDate);
+        self::assertEquals($createdAt, $result->createdAt);
+    }
+
+    private function createAndSaveAssignment(): TeacherAssignment
+    {
+        $assignment = TeacherAssignment::creer(
+            tenantId: TenantId::fromString(self::TENANT_ID),
+            teacherId: UserId::fromString(self::TEACHER_ID),
+            classId: ClassId::fromString(self::CLASS_ID),
+            subjectId: SubjectId::fromString(self::SUBJECT_ID),
+            academicYearId: AcademicYearId::fromString(self::ACADEMIC_YEAR_ID),
+            createdAt: new DateTimeImmutable('2026-02-10 10:00:00'),
+        );
+
+        $this->repository->save($assignment);
+
+        return $assignment;
+    }
+}
--- a/backend/tests/Unit/Administration/Application/Query/GetAssignmentsForTeacher/GetAssignmentsForTeacherHandlerTest.php
+++ b/backend/tests/Unit/Administration/Application/Query/GetAssignmentsForTeacher/GetAssignmentsForTeacherHandlerTest.php
@@ -0,0 +1,133 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Tests\Unit\Administration\Application\Query\GetAssignmentsForTeacher;
+
+use App\Administration\Application\Query\GetAssignmentsForTeacher\GetAssignmentsForTeacherHandler;
+use App\Administration\Application\Query\GetAssignmentsForTeacher\GetAssignmentsForTeacherQuery;
+use App\Administration\Application\Query\GetAssignmentsForTeacher\TeacherAssignmentDto;
+use App\Administration\Domain\Model\SchoolClass\AcademicYearId;
+use App\Administration\Domain\Model\SchoolClass\ClassId;
+use App\Administration\Domain\Model\Subject\SubjectId;
+use App\Administration\Domain\Model\TeacherAssignment\TeacherAssignment;
+use App\Administration\Domain\Model\User\UserId;
+use App\Administration\Infrastructure\Persistence\InMemory\InMemoryTeacherAssignmentRepository;
+use App\Shared\Domain\Tenant\TenantId;
+use DateTimeImmutable;
+use PHPUnit\Framework\Attributes\Test;
+use PHPUnit\Framework\TestCase;
+
+final class GetAssignmentsForTeacherHandlerTest extends TestCase
+{
+    private const string TENANT_ID = '550e8400-e29b-41d4-a716-446655440001';
+    private const string TEACHER_ID = '550e8400-e29b-41d4-a716-446655440010';
+    private const string CLASS_ID = '550e8400-e29b-41d4-a716-446655440020';
+    private const string ACADEMIC_YEAR_ID = '550e8400-e29b-41d4-a716-446655440040';
+
+    private InMemoryTeacherAssignmentRepository $repository;
+    private GetAssignmentsForTeacherHandler $handler;
+
+    protected function setUp(): void
+    {
+        $this->repository = new InMemoryTeacherAssignmentRepository();
+        $this->handler = new GetAssignmentsForTeacherHandler($this->repository);
+    }
+
+    #[Test]
+    public function returnsEmptyWhenNoAssignments(): void
+    {
+        $result = ($this->handler)(new GetAssignmentsForTeacherQuery(
+            teacherId: self::TEACHER_ID,
+            tenantId: self::TENANT_ID,
+        ));
+
+        self::assertSame([], $result);
+    }
+
+    #[Test]
+    public function returnsActiveAssignmentsForTeacher(): void
+    {
+        $this->createAndSaveAssignment('550e8400-e29b-41d4-a716-446655440030');
+        $this->createAndSaveAssignment('550e8400-e29b-41d4-a716-446655440031');
+
+        $result = ($this->handler)(new GetAssignmentsForTeacherQuery(
+            teacherId: self::TEACHER_ID,
+            tenantId: self::TENANT_ID,
+        ));
+
+        self::assertCount(2, $result);
+        self::assertContainsOnlyInstancesOf(TeacherAssignmentDto::class, $result);
+    }
+
+    #[Test]
+    public function excludesRemovedAssignments(): void
+    {
+        $this->createAndSaveAssignment('550e8400-e29b-41d4-a716-446655440030');
+
+        $removed = TeacherAssignment::creer(
+            tenantId: TenantId::fromString(self::TENANT_ID),
+            teacherId: UserId::fromString(self::TEACHER_ID),
+            classId: ClassId::fromString(self::CLASS_ID),
+            subjectId: SubjectId::fromString('550e8400-e29b-41d4-a716-446655440031'),
+            academicYearId: AcademicYearId::fromString(self::ACADEMIC_YEAR_ID),
+            createdAt: new DateTimeImmutable('2026-02-10 10:00:00'),
+        );
+        $removed->retirer(new DateTimeImmutable('2026-02-11 10:00:00'));
+        $this->repository->save($removed);
+
+        $result = ($this->handler)(new GetAssignmentsForTeacherQuery(
+            teacherId: self::TEACHER_ID,
+            tenantId: self::TENANT_ID,
+        ));
+
+        self::assertCount(1, $result);
+    }
+
+    #[Test]
+    public function excludesAssignmentsFromDifferentTenant(): void
+    {
+        $this->createAndSaveAssignment('550e8400-e29b-41d4-a716-446655440030');
+
+        $result = ($this->handler)(new GetAssignmentsForTeacherQuery(
+            teacherId: self::TEACHER_ID,
+            tenantId: '550e8400-e29b-41d4-a716-446655440099',
+        ));
+
+        self::assertSame([], $result);
+    }
+
+    #[Test]
+    public function dtoContainsCorrectData(): void
+    {
+        $createdAt = new DateTimeImmutable('2026-02-10 10:00:00');
+        $subjectId = '550e8400-e29b-41d4-a716-446655440030';
+        $this->createAndSaveAssignment($subjectId);
+
+        $result = ($this->handler)(new GetAssignmentsForTeacherQuery(
+            teacherId: self::TEACHER_ID,
+            tenantId: self::TENANT_ID,
+        ));
+
+        self::assertSame(self::TEACHER_ID, $result[0]->teacherId);
+        self::assertSame(self::CLASS_ID, $result[0]->classId);
+        self::assertSame($subjectId, $result[0]->subjectId);
+        self::assertSame('active', $result[0]->status);
+        self::assertEquals($createdAt, $result[0]->startDate);
+        self::assertNull($result[0]->endDate);
+    }
+
+    private function createAndSaveAssignment(string $subjectId): void
+    {
+        $assignment = TeacherAssignment::creer(
+            tenantId: TenantId::fromString(self::TENANT_ID),
+            teacherId: UserId::fromString(self::TEACHER_ID),
+            classId: ClassId::fromString(self::CLASS_ID),
+            subjectId: SubjectId::fromString($subjectId),
+            academicYearId: AcademicYearId::fromString(self::ACADEMIC_YEAR_ID),
+            createdAt: new DateTimeImmutable('2026-02-10 10:00:00'),
+        );
+
+        $this->repository->save($assignment);
+    }
+}
--- a/backend/tests/Unit/Administration/Application/Query/GetTeachersForClass/GetTeachersForClassHandlerTest.php
+++ b/backend/tests/Unit/Administration/Application/Query/GetTeachersForClass/GetTeachersForClassHandlerTest.php
@@ -0,0 +1,131 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Tests\Unit\Administration\Application\Query\GetTeachersForClass;
+
+use App\Administration\Application\Query\GetAssignmentsForTeacher\TeacherAssignmentDto;
+use App\Administration\Application\Query\GetTeachersForClass\GetTeachersForClassHandler;
+use App\Administration\Application\Query\GetTeachersForClass\GetTeachersForClassQuery;
+use App\Administration\Domain\Model\SchoolClass\AcademicYearId;
+use App\Administration\Domain\Model\SchoolClass\ClassId;
+use App\Administration\Domain\Model\Subject\SubjectId;
+use App\Administration\Domain\Model\TeacherAssignment\TeacherAssignment;
+use App\Administration\Domain\Model\User\UserId;
+use App\Administration\Infrastructure\Persistence\InMemory\InMemoryTeacherAssignmentRepository;
+use App\Shared\Domain\Tenant\TenantId;
+use DateTimeImmutable;
+use PHPUnit\Framework\Attributes\Test;
+use PHPUnit\Framework\TestCase;
+
+final class GetTeachersForClassHandlerTest extends TestCase
+{
+    private const string TENANT_ID = '550e8400-e29b-41d4-a716-446655440001';
+    private const string CLASS_ID = '550e8400-e29b-41d4-a716-446655440020';
+    private const string ACADEMIC_YEAR_ID = '550e8400-e29b-41d4-a716-446655440040';
+
+    private InMemoryTeacherAssignmentRepository $repository;
+    private GetTeachersForClassHandler $handler;
+
+    protected function setUp(): void
+    {
+        $this->repository = new InMemoryTeacherAssignmentRepository();
+        $this->handler = new GetTeachersForClassHandler($this->repository);
+    }
+
+    #[Test]
+    public function returnsEmptyWhenNoTeachersAssigned(): void
+    {
+        $result = ($this->handler)(new GetTeachersForClassQuery(
+            classId: self::CLASS_ID,
+            tenantId: self::TENANT_ID,
+        ));
+
+        self::assertSame([], $result);
+    }
+
+    #[Test]
+    public function returnsTeachersForClass(): void
+    {
+        $this->createAndSaveAssignment('550e8400-e29b-41d4-a716-446655440010');
+        $this->createAndSaveAssignment('550e8400-e29b-41d4-a716-446655440011');
+
+        $result = ($this->handler)(new GetTeachersForClassQuery(
+            classId: self::CLASS_ID,
+            tenantId: self::TENANT_ID,
+        ));
+
+        self::assertCount(2, $result);
+        self::assertContainsOnlyInstancesOf(TeacherAssignmentDto::class, $result);
+    }
+
+    #[Test]
+    public function excludesRemovedAssignments(): void
+    {
+        $this->createAndSaveAssignment('550e8400-e29b-41d4-a716-446655440010');
+
+        $removed = TeacherAssignment::creer(
+            tenantId: TenantId::fromString(self::TENANT_ID),
+            teacherId: UserId::fromString('550e8400-e29b-41d4-a716-446655440011'),
+            classId: ClassId::fromString(self::CLASS_ID),
+            subjectId: SubjectId::fromString('550e8400-e29b-41d4-a716-446655440030'),
+            academicYearId: AcademicYearId::fromString(self::ACADEMIC_YEAR_ID),
+            createdAt: new DateTimeImmutable('2026-02-10 10:00:00'),
+        );
+        $removed->retirer(new DateTimeImmutable('2026-02-11 10:00:00'));
+        $this->repository->save($removed);
+
+        $result = ($this->handler)(new GetTeachersForClassQuery(
+            classId: self::CLASS_ID,
+            tenantId: self::TENANT_ID,
+        ));
+
+        self::assertCount(1, $result);
+    }
+
+    #[Test]
+    public function excludesAssignmentsFromDifferentTenant(): void
+    {
+        $this->createAndSaveAssignment('550e8400-e29b-41d4-a716-446655440010');
+
+        $result = ($this->handler)(new GetTeachersForClassQuery(
+            classId: self::CLASS_ID,
+            tenantId: '550e8400-e29b-41d4-a716-446655440099',
+        ));
+
+        self::assertSame([], $result);
+    }
+
+    #[Test]
+    public function dtoContainsCorrectData(): void
+    {
+        $teacherId = '550e8400-e29b-41d4-a716-446655440010';
+        $createdAt = new DateTimeImmutable('2026-02-10 10:00:00');
+        $this->createAndSaveAssignment($teacherId);
+
+        $result = ($this->handler)(new GetTeachersForClassQuery(
+            classId: self::CLASS_ID,
+            tenantId: self::TENANT_ID,
+        ));
+
+        self::assertSame($teacherId, $result[0]->teacherId);
+        self::assertSame(self::CLASS_ID, $result[0]->classId);
+        self::assertSame('active', $result[0]->status);
+        self::assertEquals($createdAt, $result[0]->startDate);
+        self::assertNull($result[0]->endDate);
+    }
+
+    private function createAndSaveAssignment(string $teacherId): void
+    {
+        $assignment = TeacherAssignment::creer(
+            tenantId: TenantId::fromString(self::TENANT_ID),
+            teacherId: UserId::fromString($teacherId),
+            classId: ClassId::fromString(self::CLASS_ID),
+            subjectId: SubjectId::fromString('550e8400-e29b-41d4-a716-446655440030'),
+            academicYearId: AcademicYearId::fromString(self::ACADEMIC_YEAR_ID),
+            createdAt: new DateTimeImmutable('2026-02-10 10:00:00'),
+        );
+
+        $this->repository->save($assignment);
+    }
+}