feat: Permettre aux enseignants de créer et gérer les devoirs

Les enseignants avaient besoin d'un outil pour créer des devoirs assignés à leurs classes, avec filtrage automatique par matière selon la classe sélectionnée. Le système valide que la date d'échéance tombe un jour ouvrable (lundi-vendredi) et empêche les dates dans le passé. Le domaine modélise le devoir comme un agrégat avec pièces jointes, statut brouillon/publié, et événements métier (création, modification, suppression). Les handlers de notification écoutent ces événements pour les futurs envois aux parents et élèves.
2026-03-12 10:11:06 +01:00
parent 56bc808d85
commit e9efb90f59
51 changed files with 4776 additions and 7 deletions
--- a/backend/tests/Unit/Scolarite/Application/Command/CreateHomework/CreateHomeworkHandlerTest.php
+++ b/backend/tests/Unit/Scolarite/Application/Command/CreateHomework/CreateHomeworkHandlerTest.php
@@ -0,0 +1,157 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Tests\Unit\Scolarite\Application\Command\CreateHomework;
+
+use App\Administration\Domain\Model\SchoolCalendar\SchoolCalendar;
+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\User\UserId;
+use App\Scolarite\Application\Command\CreateHomework\CreateHomeworkCommand;
+use App\Scolarite\Application\Command\CreateHomework\CreateHomeworkHandler;
+use App\Scolarite\Application\Port\CurrentCalendarProvider;
+use App\Scolarite\Application\Port\EnseignantAffectationChecker;
+use App\Scolarite\Domain\Exception\DateEcheanceInvalideException;
+use App\Scolarite\Domain\Exception\EnseignantNonAffecteException;
+use App\Scolarite\Domain\Model\Homework\HomeworkId;
+use App\Scolarite\Domain\Model\Homework\HomeworkStatus;
+use App\Scolarite\Domain\Service\DueDateValidator;
+use App\Scolarite\Infrastructure\Persistence\InMemory\InMemoryHomeworkRepository;
+use App\Shared\Domain\Clock;
+use App\Shared\Domain\Tenant\TenantId;
+use DateTimeImmutable;
+use PHPUnit\Framework\Attributes\Test;
+use PHPUnit\Framework\TestCase;
+
+final class CreateHomeworkHandlerTest 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 SUBJECT_ID = '550e8400-e29b-41d4-a716-446655440030';
+    private const string TEACHER_ID = '550e8400-e29b-41d4-a716-446655440010';
+
+    private InMemoryHomeworkRepository $homeworkRepository;
+    private Clock $clock;
+
+    protected function setUp(): void
+    {
+        $this->homeworkRepository = new InMemoryHomeworkRepository();
+        $this->clock = new class implements Clock {
+            public function now(): DateTimeImmutable
+            {
+                return new DateTimeImmutable('2026-03-12 10:00:00');
+            }
+        };
+    }
+
+    #[Test]
+    public function itCreatesHomeworkSuccessfully(): void
+    {
+        $handler = $this->createHandler(affecte: true);
+        $command = $this->createCommand();
+
+        $homework = $handler($command);
+
+        self::assertNotEmpty((string) $homework->id);
+        self::assertSame(HomeworkStatus::PUBLISHED, $homework->status);
+        self::assertSame('Exercices chapitre 5', $homework->title);
+    }
+
+    #[Test]
+    public function itPersistsHomeworkInRepository(): void
+    {
+        $handler = $this->createHandler(affecte: true);
+        $command = $this->createCommand();
+
+        $created = $handler($command);
+
+        $homework = $this->homeworkRepository->get(
+            HomeworkId::fromString((string) $created->id),
+            TenantId::fromString(self::TENANT_ID),
+        );
+
+        self::assertSame('Exercices chapitre 5', $homework->title);
+    }
+
+    #[Test]
+    public function itThrowsWhenTeacherNotAffected(): void
+    {
+        $handler = $this->createHandler(affecte: false);
+
+        $this->expectException(EnseignantNonAffecteException::class);
+
+        $handler($this->createCommand());
+    }
+
+    #[Test]
+    public function itThrowsWhenDueDateIsInvalid(): void
+    {
+        $handler = $this->createHandler(affecte: true);
+
+        $this->expectException(DateEcheanceInvalideException::class);
+
+        $handler($this->createCommand(dueDate: '2026-03-11'));
+    }
+
+    #[Test]
+    public function itAllowsNullDescription(): void
+    {
+        $handler = $this->createHandler(affecte: true);
+        $command = $this->createCommand(description: null);
+
+        $homework = $handler($command);
+
+        self::assertNull($homework->description);
+    }
+
+    private function createHandler(bool $affecte): CreateHomeworkHandler
+    {
+        $affectationChecker = new class($affecte) implements EnseignantAffectationChecker {
+            public function __construct(private readonly bool $affecte)
+            {
+            }
+
+            public function estAffecte(UserId $teacherId, ClassId $classId, SubjectId $subjectId, TenantId $tenantId): bool
+            {
+                return $this->affecte;
+            }
+        };
+
+        $calendarProvider = new class implements CurrentCalendarProvider {
+            public function forCurrentYear(TenantId $tenantId): SchoolCalendar
+            {
+                return SchoolCalendar::reconstitute(
+                    tenantId: $tenantId,
+                    academicYearId: AcademicYearId::fromString('550e8400-e29b-41d4-a716-446655440002'),
+                    zone: null,
+                    entries: [],
+                );
+            }
+        };
+
+        return new CreateHomeworkHandler(
+            $this->homeworkRepository,
+            $affectationChecker,
+            $calendarProvider,
+            new DueDateValidator(),
+            $this->clock,
+        );
+    }
+
+    private function createCommand(
+        ?string $dueDate = null,
+        mixed $description = 'Faire les exercices 1 à 10',
+    ): CreateHomeworkCommand {
+        return new CreateHomeworkCommand(
+            tenantId: self::TENANT_ID,
+            classId: self::CLASS_ID,
+            subjectId: self::SUBJECT_ID,
+            teacherId: self::TEACHER_ID,
+            title: 'Exercices chapitre 5',
+            description: $description,
+            dueDate: $dueDate ?? '2026-04-15',
+        );
+    }
+}
--- a/backend/tests/Unit/Scolarite/Application/Command/DeleteHomework/DeleteHomeworkHandlerTest.php
+++ b/backend/tests/Unit/Scolarite/Application/Command/DeleteHomework/DeleteHomeworkHandlerTest.php
@@ -0,0 +1,130 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Tests\Unit\Scolarite\Application\Command\DeleteHomework;
+
+use App\Administration\Domain\Model\SchoolClass\ClassId;
+use App\Administration\Domain\Model\Subject\SubjectId;
+use App\Administration\Domain\Model\User\UserId;
+use App\Scolarite\Application\Command\DeleteHomework\DeleteHomeworkCommand;
+use App\Scolarite\Application\Command\DeleteHomework\DeleteHomeworkHandler;
+use App\Scolarite\Domain\Exception\DevoirDejaSupprimeException;
+use App\Scolarite\Domain\Exception\HomeworkNotFoundException;
+use App\Scolarite\Domain\Exception\NonProprietaireDuDevoirException;
+use App\Scolarite\Domain\Model\Homework\Homework;
+use App\Scolarite\Domain\Model\Homework\HomeworkId;
+use App\Scolarite\Domain\Model\Homework\HomeworkStatus;
+use App\Scolarite\Infrastructure\Persistence\InMemory\InMemoryHomeworkRepository;
+use App\Shared\Domain\Clock;
+use App\Shared\Domain\Tenant\TenantId;
+use DateTimeImmutable;
+use PHPUnit\Framework\Attributes\Test;
+use PHPUnit\Framework\TestCase;
+
+final class DeleteHomeworkHandlerTest extends TestCase
+{
+    private const string TENANT_ID = '550e8400-e29b-41d4-a716-446655440001';
+
+    private InMemoryHomeworkRepository $homeworkRepository;
+    private Clock $clock;
+    private HomeworkId $existingHomeworkId;
+
+    protected function setUp(): void
+    {
+        $this->homeworkRepository = new InMemoryHomeworkRepository();
+        $this->clock = new class implements Clock {
+            public function now(): DateTimeImmutable
+            {
+                return new DateTimeImmutable('2026-03-12 10:00:00');
+            }
+        };
+
+        $this->seedHomework();
+    }
+
+    #[Test]
+    public function itDeletesHomeworkSuccessfully(): void
+    {
+        $handler = $this->createHandler();
+
+        $homework = $handler(new DeleteHomeworkCommand(
+            tenantId: self::TENANT_ID,
+            homeworkId: (string) $this->existingHomeworkId,
+            teacherId: '550e8400-e29b-41d4-a716-446655440010',
+        ));
+
+        self::assertSame(HomeworkStatus::DELETED, $homework->status);
+    }
+
+    #[Test]
+    public function itThrowsWhenHomeworkNotFound(): void
+    {
+        $handler = $this->createHandler();
+
+        $this->expectException(HomeworkNotFoundException::class);
+
+        $handler(new DeleteHomeworkCommand(
+            tenantId: self::TENANT_ID,
+            homeworkId: (string) HomeworkId::generate(),
+            teacherId: '550e8400-e29b-41d4-a716-446655440010',
+        ));
+    }
+
+    #[Test]
+    public function itThrowsWhenHomeworkAlreadyDeleted(): void
+    {
+        $homework = $this->homeworkRepository->get($this->existingHomeworkId, TenantId::fromString(self::TENANT_ID));
+        $homework->supprimer(new DateTimeImmutable('2026-03-12'));
+        $this->homeworkRepository->save($homework);
+
+        $handler = $this->createHandler();
+
+        $this->expectException(DevoirDejaSupprimeException::class);
+
+        $handler(new DeleteHomeworkCommand(
+            tenantId: self::TENANT_ID,
+            homeworkId: (string) $this->existingHomeworkId,
+            teacherId: '550e8400-e29b-41d4-a716-446655440010',
+        ));
+    }
+
+    #[Test]
+    public function itThrowsWhenNotOwner(): void
+    {
+        $handler = $this->createHandler();
+
+        $this->expectException(NonProprietaireDuDevoirException::class);
+
+        $handler(new DeleteHomeworkCommand(
+            tenantId: self::TENANT_ID,
+            homeworkId: (string) $this->existingHomeworkId,
+            teacherId: '550e8400-e29b-41d4-a716-446655440099',
+        ));
+    }
+
+    private function seedHomework(): void
+    {
+        $homework = Homework::creer(
+            tenantId: TenantId::fromString(self::TENANT_ID),
+            classId: ClassId::fromString('550e8400-e29b-41d4-a716-446655440020'),
+            subjectId: SubjectId::fromString('550e8400-e29b-41d4-a716-446655440030'),
+            teacherId: UserId::fromString('550e8400-e29b-41d4-a716-446655440010'),
+            title: 'Exercices',
+            description: 'Description',
+            dueDate: new DateTimeImmutable('2026-04-15'),
+            now: new DateTimeImmutable('2026-03-10 10:00:00'),
+        );
+
+        $this->existingHomeworkId = $homework->id;
+        $this->homeworkRepository->save($homework);
+    }
+
+    private function createHandler(): DeleteHomeworkHandler
+    {
+        return new DeleteHomeworkHandler(
+            $this->homeworkRepository,
+            $this->clock,
+        );
+    }
+}
--- a/backend/tests/Unit/Scolarite/Application/Command/UpdateHomework/UpdateHomeworkHandlerTest.php
+++ b/backend/tests/Unit/Scolarite/Application/Command/UpdateHomework/UpdateHomeworkHandlerTest.php
@@ -0,0 +1,179 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Tests\Unit\Scolarite\Application\Command\UpdateHomework;
+
+use App\Administration\Domain\Model\SchoolCalendar\SchoolCalendar;
+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\User\UserId;
+use App\Scolarite\Application\Command\UpdateHomework\UpdateHomeworkCommand;
+use App\Scolarite\Application\Command\UpdateHomework\UpdateHomeworkHandler;
+use App\Scolarite\Application\Port\CurrentCalendarProvider;
+use App\Scolarite\Domain\Exception\DateEcheanceInvalideException;
+use App\Scolarite\Domain\Exception\DevoirDejaSupprimeException;
+use App\Scolarite\Domain\Exception\HomeworkNotFoundException;
+use App\Scolarite\Domain\Exception\NonProprietaireDuDevoirException;
+use App\Scolarite\Domain\Model\Homework\Homework;
+use App\Scolarite\Domain\Model\Homework\HomeworkId;
+use App\Scolarite\Domain\Service\DueDateValidator;
+use App\Scolarite\Infrastructure\Persistence\InMemory\InMemoryHomeworkRepository;
+use App\Shared\Domain\Clock;
+use App\Shared\Domain\Tenant\TenantId;
+use DateTimeImmutable;
+use PHPUnit\Framework\Attributes\Test;
+use PHPUnit\Framework\TestCase;
+
+final class UpdateHomeworkHandlerTest extends TestCase
+{
+    private const string TENANT_ID = '550e8400-e29b-41d4-a716-446655440001';
+
+    private InMemoryHomeworkRepository $homeworkRepository;
+    private Clock $clock;
+    private HomeworkId $existingHomeworkId;
+
+    protected function setUp(): void
+    {
+        $this->homeworkRepository = new InMemoryHomeworkRepository();
+        $this->clock = new class implements Clock {
+            public function now(): DateTimeImmutable
+            {
+                return new DateTimeImmutable('2026-03-12 10:00:00');
+            }
+        };
+
+        $this->seedHomework();
+    }
+
+    #[Test]
+    public function itUpdatesHomeworkSuccessfully(): void
+    {
+        $handler = $this->createHandler();
+        $command = new UpdateHomeworkCommand(
+            tenantId: self::TENANT_ID,
+            homeworkId: (string) $this->existingHomeworkId,
+            teacherId: '550e8400-e29b-41d4-a716-446655440010',
+            title: 'Titre modifié',
+            description: 'Nouvelle description',
+            dueDate: '2026-04-20',
+        );
+
+        $homework = $handler($command);
+
+        self::assertSame('Titre modifié', $homework->title);
+        self::assertSame('Nouvelle description', $homework->description);
+    }
+
+    #[Test]
+    public function itThrowsWhenHomeworkNotFound(): void
+    {
+        $handler = $this->createHandler();
+
+        $this->expectException(HomeworkNotFoundException::class);
+
+        $handler(new UpdateHomeworkCommand(
+            tenantId: self::TENANT_ID,
+            homeworkId: (string) HomeworkId::generate(),
+            teacherId: '550e8400-e29b-41d4-a716-446655440010',
+            title: 'Test',
+            description: null,
+            dueDate: '2026-04-20',
+        ));
+    }
+
+    #[Test]
+    public function itThrowsWhenDueDateInvalid(): void
+    {
+        $handler = $this->createHandler();
+
+        $this->expectException(DateEcheanceInvalideException::class);
+
+        $handler(new UpdateHomeworkCommand(
+            tenantId: self::TENANT_ID,
+            homeworkId: (string) $this->existingHomeworkId,
+            teacherId: '550e8400-e29b-41d4-a716-446655440010',
+            title: 'Test',
+            description: null,
+            dueDate: '2026-03-11',
+        ));
+    }
+
+    #[Test]
+    public function itThrowsWhenHomeworkDeleted(): void
+    {
+        $homework = $this->homeworkRepository->get($this->existingHomeworkId, TenantId::fromString(self::TENANT_ID));
+        $homework->supprimer(new DateTimeImmutable('2026-03-12'));
+        $this->homeworkRepository->save($homework);
+
+        $handler = $this->createHandler();
+
+        $this->expectException(DevoirDejaSupprimeException::class);
+
+        $handler(new UpdateHomeworkCommand(
+            tenantId: self::TENANT_ID,
+            homeworkId: (string) $this->existingHomeworkId,
+            teacherId: '550e8400-e29b-41d4-a716-446655440010',
+            title: 'Test',
+            description: null,
+            dueDate: '2026-04-20',
+        ));
+    }
+
+    #[Test]
+    public function itThrowsWhenNotOwner(): void
+    {
+        $handler = $this->createHandler();
+
+        $this->expectException(NonProprietaireDuDevoirException::class);
+
+        $handler(new UpdateHomeworkCommand(
+            tenantId: self::TENANT_ID,
+            homeworkId: (string) $this->existingHomeworkId,
+            teacherId: '550e8400-e29b-41d4-a716-446655440099',
+            title: 'Test',
+            description: null,
+            dueDate: '2026-04-20',
+        ));
+    }
+
+    private function seedHomework(): void
+    {
+        $homework = Homework::creer(
+            tenantId: TenantId::fromString(self::TENANT_ID),
+            classId: ClassId::fromString('550e8400-e29b-41d4-a716-446655440020'),
+            subjectId: SubjectId::fromString('550e8400-e29b-41d4-a716-446655440030'),
+            teacherId: UserId::fromString('550e8400-e29b-41d4-a716-446655440010'),
+            title: 'Exercices',
+            description: 'Description',
+            dueDate: new DateTimeImmutable('2026-04-15'),
+            now: new DateTimeImmutable('2026-03-10 10:00:00'),
+        );
+
+        $this->existingHomeworkId = $homework->id;
+        $this->homeworkRepository->save($homework);
+    }
+
+    private function createHandler(): UpdateHomeworkHandler
+    {
+        $calendarProvider = new class implements CurrentCalendarProvider {
+            public function forCurrentYear(TenantId $tenantId): SchoolCalendar
+            {
+                return SchoolCalendar::reconstitute(
+                    tenantId: $tenantId,
+                    academicYearId: AcademicYearId::fromString('550e8400-e29b-41d4-a716-446655440002'),
+                    zone: null,
+                    entries: [],
+                );
+            }
+        };
+
+        return new UpdateHomeworkHandler(
+            $this->homeworkRepository,
+            $calendarProvider,
+            new DueDateValidator(),
+            $this->clock,
+        );
+    }
+}