feat: Permettre la consultation et gestion des droits à l'image des élèves

Les administrateurs et enseignants ont besoin de consulter et gérer
les autorisations de droit à l'image des élèves pour respecter
la réglementation lors de publications contenant des photos (FR82).

Cette fonctionnalité ajoute une page dédiée avec liste filtrable
par statut, modification individuelle via dropdown, export CSV
avec BOM UTF-8 pour Excel, et préparation du système d'avertissement
avant publication (query/handler prêts, intégration à faire quand
le module publication existera).

Le filtrage par classe (AC2) est bloqué en attente d'une table
d'affectation élève↔classe qui n'existe pas encore.
This commit is contained in:
2026-02-19 13:35:14 +01:00
parent 67734e4de3
commit 1b8bd6cd78
39 changed files with 3264 additions and 19 deletions

View File

@@ -0,0 +1,187 @@
<?php
declare(strict_types=1);
namespace App\Tests\Unit\Administration\Application\Command\UpdateImageRights;
use App\Administration\Application\Command\UpdateImageRights\UpdateImageRightsCommand;
use App\Administration\Application\Command\UpdateImageRights\UpdateImageRightsHandler;
use App\Administration\Domain\Event\DroitImageModifie;
use App\Administration\Domain\Exception\UserNotFoundException;
use App\Administration\Domain\Model\User\Email;
use App\Administration\Domain\Model\User\ImageRightsStatus;
use App\Administration\Domain\Model\User\Role;
use App\Administration\Domain\Model\User\User;
use App\Administration\Infrastructure\Persistence\InMemory\InMemoryUserRepository;
use App\Shared\Domain\Clock;
use App\Shared\Domain\Tenant\TenantId;
use DateTimeImmutable;
use PHPUnit\Framework\Attributes\Test;
use PHPUnit\Framework\TestCase;
final class UpdateImageRightsHandlerTest extends TestCase
{
private const string TENANT_ID = '550e8400-e29b-41d4-a716-446655440002';
private const string MODIFIER_ID = '550e8400-e29b-41d4-a716-446655440099';
private InMemoryUserRepository $userRepository;
private Clock $clock;
private UpdateImageRightsHandler $handler;
protected function setUp(): void
{
$this->userRepository = new InMemoryUserRepository();
$this->clock = new class implements Clock {
public function now(): DateTimeImmutable
{
return new DateTimeImmutable('2026-02-18 10:00:00');
}
};
$this->handler = new UpdateImageRightsHandler($this->userRepository, $this->clock);
}
#[Test]
public function updatesImageRightsToAuthorized(): void
{
$student = $this->createAndSaveStudent();
$command = new UpdateImageRightsCommand(
studentId: (string) $student->id,
status: 'authorized',
modifiedBy: self::MODIFIER_ID,
tenantId: self::TENANT_ID,
);
$user = ($this->handler)($command);
self::assertSame(ImageRightsStatus::AUTHORIZED, $user->imageRightsStatus);
}
#[Test]
public function updatesImageRightsToRefused(): void
{
$student = $this->createAndSaveStudent();
$command = new UpdateImageRightsCommand(
studentId: (string) $student->id,
status: 'refused',
modifiedBy: self::MODIFIER_ID,
tenantId: self::TENANT_ID,
);
$user = ($this->handler)($command);
self::assertSame(ImageRightsStatus::REFUSED, $user->imageRightsStatus);
}
#[Test]
public function recordsDroitImageModifieEvent(): void
{
$student = $this->createAndSaveStudent();
$student->pullDomainEvents();
$command = new UpdateImageRightsCommand(
studentId: (string) $student->id,
status: 'authorized',
modifiedBy: self::MODIFIER_ID,
tenantId: self::TENANT_ID,
);
$user = ($this->handler)($command);
$events = $user->pullDomainEvents();
self::assertCount(1, $events);
self::assertInstanceOf(DroitImageModifie::class, $events[0]);
}
#[Test]
public function throwsWhenStudentNotFound(): void
{
$this->expectException(UserNotFoundException::class);
$command = new UpdateImageRightsCommand(
studentId: '550e8400-e29b-41d4-a716-446655440000',
status: 'authorized',
modifiedBy: self::MODIFIER_ID,
tenantId: self::TENANT_ID,
);
($this->handler)($command);
}
#[Test]
public function throwsWhenTenantMismatch(): void
{
$student = $this->createAndSaveStudent();
$this->expectException(UserNotFoundException::class);
$command = new UpdateImageRightsCommand(
studentId: (string) $student->id,
status: 'authorized',
modifiedBy: self::MODIFIER_ID,
tenantId: '550e8400-e29b-41d4-a716-446655440099',
);
($this->handler)($command);
}
#[Test]
public function throwsWhenUserIsNotStudent(): void
{
$admin = User::creer(
email: new Email('admin@example.com'),
role: Role::ADMIN,
tenantId: TenantId::fromString(self::TENANT_ID),
schoolName: 'École Alpha',
dateNaissance: null,
createdAt: new DateTimeImmutable('2026-01-15 10:00:00'),
);
$this->userRepository->save($admin);
$this->expectException(UserNotFoundException::class);
$command = new UpdateImageRightsCommand(
studentId: (string) $admin->id,
status: 'authorized',
modifiedBy: self::MODIFIER_ID,
tenantId: self::TENANT_ID,
);
($this->handler)($command);
}
#[Test]
public function savesUserAfterUpdate(): void
{
$student = $this->createAndSaveStudent();
$command = new UpdateImageRightsCommand(
studentId: (string) $student->id,
status: 'refused',
modifiedBy: self::MODIFIER_ID,
tenantId: self::TENANT_ID,
);
($this->handler)($command);
$saved = $this->userRepository->get($student->id);
self::assertSame(ImageRightsStatus::REFUSED, $saved->imageRightsStatus);
}
private function createAndSaveStudent(): User
{
$student = User::creer(
email: new Email('eleve@example.com'),
role: Role::ELEVE,
tenantId: TenantId::fromString(self::TENANT_ID),
schoolName: 'École Alpha',
dateNaissance: new DateTimeImmutable('2012-06-15'),
createdAt: new DateTimeImmutable('2026-01-15 10:00:00'),
);
$this->userRepository->save($student);
return $student;
}
}

View File

@@ -0,0 +1,136 @@
<?php
declare(strict_types=1);
namespace App\Tests\Unit\Administration\Application\Query\CheckImageRights;
use App\Administration\Application\Query\CheckImageRights\CheckImageRightsHandler;
use App\Administration\Application\Query\CheckImageRights\CheckImageRightsQuery;
use App\Administration\Domain\Exception\UserNotFoundException;
use App\Administration\Domain\Model\User\Email;
use App\Administration\Domain\Model\User\ImageRightsStatus;
use App\Administration\Domain\Model\User\Role;
use App\Administration\Domain\Model\User\User;
use App\Administration\Domain\Model\User\UserId;
use App\Administration\Infrastructure\Persistence\InMemory\InMemoryUserRepository;
use App\Shared\Domain\Tenant\TenantId;
use DateTimeImmutable;
use PHPUnit\Framework\Attributes\Test;
use PHPUnit\Framework\TestCase;
final class CheckImageRightsHandlerTest extends TestCase
{
private const string TENANT_ID = '550e8400-e29b-41d4-a716-446655440002';
private InMemoryUserRepository $userRepository;
private CheckImageRightsHandler $handler;
protected function setUp(): void
{
$this->userRepository = new InMemoryUserRepository();
$this->handler = new CheckImageRightsHandler($this->userRepository);
}
#[Test]
public function authorizedStudentCanPublish(): void
{
$student = $this->createStudentWithStatus(ImageRightsStatus::AUTHORIZED);
$query = new CheckImageRightsQuery(
studentId: (string) $student->id,
tenantId: self::TENANT_ID,
);
$result = ($this->handler)($query);
self::assertTrue($result->canPublish);
self::assertNull($result->warningMessage);
self::assertSame(ImageRightsStatus::AUTHORIZED, $result->status);
}
#[Test]
public function refusedStudentCannotPublish(): void
{
$student = $this->createStudentWithStatus(ImageRightsStatus::REFUSED);
$query = new CheckImageRightsQuery(
studentId: (string) $student->id,
tenantId: self::TENANT_ID,
);
$result = ($this->handler)($query);
self::assertFalse($result->canPublish);
self::assertNotNull($result->warningMessage);
self::assertStringContainsString('PAS l\'autorisation', $result->warningMessage);
}
#[Test]
public function notSpecifiedStudentCannotPublish(): void
{
$student = $this->createStudentWithStatus(ImageRightsStatus::NOT_SPECIFIED);
$query = new CheckImageRightsQuery(
studentId: (string) $student->id,
tenantId: self::TENANT_ID,
);
$result = ($this->handler)($query);
self::assertFalse($result->canPublish);
self::assertNotNull($result->warningMessage);
self::assertStringContainsString('pas renseigné', $result->warningMessage);
}
#[Test]
public function throwsWhenStudentNotFound(): void
{
$this->expectException(UserNotFoundException::class);
$query = new CheckImageRightsQuery(
studentId: '550e8400-e29b-41d4-a716-446655440000',
tenantId: self::TENANT_ID,
);
($this->handler)($query);
}
#[Test]
public function throwsWhenTenantMismatch(): void
{
$student = $this->createStudentWithStatus(ImageRightsStatus::AUTHORIZED);
$this->expectException(UserNotFoundException::class);
$query = new CheckImageRightsQuery(
studentId: (string) $student->id,
tenantId: '550e8400-e29b-41d4-a716-446655440099',
);
($this->handler)($query);
}
private function createStudentWithStatus(ImageRightsStatus $status): User
{
$student = User::creer(
email: new Email('eleve@example.com'),
role: Role::ELEVE,
tenantId: TenantId::fromString(self::TENANT_ID),
schoolName: 'École Alpha',
dateNaissance: new DateTimeImmutable('2012-06-15'),
createdAt: new DateTimeImmutable('2026-01-15 10:00:00'),
);
if ($status !== ImageRightsStatus::NOT_SPECIFIED) {
$student->modifierDroitImage(
$status,
UserId::fromString('550e8400-e29b-41d4-a716-446655440099'),
new DateTimeImmutable(),
);
}
$this->userRepository->save($student);
return $student;
}
}

View File

@@ -0,0 +1,144 @@
<?php
declare(strict_types=1);
namespace App\Tests\Unit\Administration\Application\Query\GetStudentsImageRights;
use App\Administration\Application\Query\GetStudentsImageRights\GetStudentsImageRightsHandler;
use App\Administration\Application\Query\GetStudentsImageRights\GetStudentsImageRightsQuery;
use App\Administration\Domain\Model\User\Email;
use App\Administration\Domain\Model\User\ImageRightsStatus;
use App\Administration\Domain\Model\User\Role;
use App\Administration\Domain\Model\User\User;
use App\Administration\Domain\Model\User\UserId;
use App\Administration\Infrastructure\Persistence\InMemory\InMemoryUserRepository;
use App\Shared\Domain\Tenant\TenantId;
use DateTimeImmutable;
use PHPUnit\Framework\Attributes\Test;
use PHPUnit\Framework\TestCase;
final class GetStudentsImageRightsHandlerTest extends TestCase
{
private const string TENANT_ID = '550e8400-e29b-41d4-a716-446655440002';
private InMemoryUserRepository $userRepository;
private GetStudentsImageRightsHandler $handler;
protected function setUp(): void
{
$this->userRepository = new InMemoryUserRepository();
$this->handler = new GetStudentsImageRightsHandler($this->userRepository);
}
#[Test]
public function returnsOnlyStudents(): void
{
$this->seedStudentsAndParent();
$query = new GetStudentsImageRightsQuery(tenantId: self::TENANT_ID);
$result = ($this->handler)($query);
self::assertCount(2, $result);
}
#[Test]
public function filtersStudentsByStatus(): void
{
$this->seedStudentsAndParent();
$query = new GetStudentsImageRightsQuery(
tenantId: self::TENANT_ID,
status: 'authorized',
);
$result = ($this->handler)($query);
self::assertCount(1, $result);
self::assertSame('authorized', $result[0]->imageRightsStatus);
}
#[Test]
public function returnsEmptyForNoStudents(): void
{
$query = new GetStudentsImageRightsQuery(tenantId: self::TENANT_ID);
$result = ($this->handler)($query);
self::assertCount(0, $result);
}
#[Test]
public function doesNotReturnStudentsFromOtherTenant(): void
{
$this->seedStudentsAndParent();
$query = new GetStudentsImageRightsQuery(
tenantId: '550e8400-e29b-41d4-a716-446655440099',
);
$result = ($this->handler)($query);
self::assertCount(0, $result);
}
#[Test]
public function returnsDtoWithCorrectFields(): void
{
$this->seedStudentsAndParent();
$query = new GetStudentsImageRightsQuery(
tenantId: self::TENANT_ID,
status: 'authorized',
);
$result = ($this->handler)($query);
self::assertCount(1, $result);
$dto = $result[0];
self::assertSame('Alice', $dto->firstName);
self::assertSame('Dupont', $dto->lastName);
self::assertSame('authorized', $dto->imageRightsStatus);
self::assertSame('Autorisé', $dto->imageRightsStatusLabel);
}
private function seedStudentsAndParent(): void
{
$student1 = User::inviter(
email: new Email('alice@example.com'),
role: Role::ELEVE,
tenantId: TenantId::fromString(self::TENANT_ID),
schoolName: 'École Alpha',
firstName: 'Alice',
lastName: 'Dupont',
invitedAt: new DateTimeImmutable('2026-01-15'),
dateNaissance: new DateTimeImmutable('2012-06-15'),
);
$student1->modifierDroitImage(
ImageRightsStatus::AUTHORIZED,
UserId::fromString('550e8400-e29b-41d4-a716-446655440099'),
new DateTimeImmutable('2026-02-01'),
);
$student2 = User::inviter(
email: new Email('bob@example.com'),
role: Role::ELEVE,
tenantId: TenantId::fromString(self::TENANT_ID),
schoolName: 'École Alpha',
firstName: 'Bob',
lastName: 'Martin',
invitedAt: new DateTimeImmutable('2026-01-15'),
dateNaissance: new DateTimeImmutable('2013-03-20'),
);
// Bob has default NOT_SPECIFIED
$parent = User::inviter(
email: new Email('parent@example.com'),
role: Role::PARENT,
tenantId: TenantId::fromString(self::TENANT_ID),
schoolName: 'École Alpha',
firstName: 'Pierre',
lastName: 'Dupont',
invitedAt: new DateTimeImmutable('2026-01-15'),
);
$this->userRepository->save($student1);
$this->userRepository->save($student2);
$this->userRepository->save($parent);
}
}

View File

@@ -0,0 +1,113 @@
<?php
declare(strict_types=1);
namespace App\Tests\Unit\Administration\Application\Service;
use App\Administration\Application\Query\GetStudentsImageRights\StudentImageRightsDto;
use App\Administration\Application\Service\ImageRightsExporter;
use DateTimeImmutable;
use PHPUnit\Framework\Attributes\Test;
use PHPUnit\Framework\TestCase;
final class ImageRightsExporterTest extends TestCase
{
private ImageRightsExporter $exporter;
protected function setUp(): void
{
$this->exporter = new ImageRightsExporter();
}
#[Test]
public function startsWithUtf8Bom(): void
{
$csv = $this->exporter->export([]);
self::assertStringStartsWith("\xEF\xBB\xBF", $csv);
}
#[Test]
public function exportsHeaderRow(): void
{
$csv = $this->exporter->export([]);
self::assertStringContainsString('Nom;Prénom;Classe;Statut', $csv);
}
#[Test]
public function exportsStudentData(): void
{
$students = [
new StudentImageRightsDto(
id: 'id-1',
firstName: 'Alice',
lastName: 'Dupont',
email: 'alice@example.com',
imageRightsStatus: 'authorized',
imageRightsStatusLabel: 'Autorisé',
imageRightsUpdatedAt: new DateTimeImmutable(),
className: '6ème A',
),
new StudentImageRightsDto(
id: 'id-2',
firstName: 'Bob',
lastName: 'Martin',
email: 'bob@example.com',
imageRightsStatus: 'refused',
imageRightsStatusLabel: 'Refusé',
imageRightsUpdatedAt: null,
className: '5ème B',
),
];
$csv = $this->exporter->export($students);
self::assertStringContainsString('Dupont;Alice;"6ème A";Autorisé', $csv);
self::assertStringContainsString('Martin;Bob;"5ème B";Refusé', $csv);
}
#[Test]
public function handlesNullClassName(): void
{
$students = [
new StudentImageRightsDto(
id: 'id-1',
firstName: 'Alice',
lastName: 'Dupont',
email: 'alice@example.com',
imageRightsStatus: 'not_specified',
imageRightsStatusLabel: 'Non renseigné',
imageRightsUpdatedAt: null,
className: null,
),
];
$csv = $this->exporter->export($students);
self::assertStringContainsString('Dupont;Alice;;"Non renseigné"', $csv);
}
#[Test]
public function exportContainsCorrectNumberOfLines(): void
{
$students = [
new StudentImageRightsDto(
id: 'id-1',
firstName: 'Alice',
lastName: 'Dupont',
email: 'alice@example.com',
imageRightsStatus: 'authorized',
imageRightsStatusLabel: 'Autorisé',
imageRightsUpdatedAt: null,
className: '6ème A',
),
];
$csv = $this->exporter->export($students);
$lines = array_filter(explode("\n", trim($csv)));
// 1 header + 1 data row
self::assertCount(2, $lines);
}
}

View File

@@ -0,0 +1,46 @@
<?php
declare(strict_types=1);
namespace App\Tests\Unit\Administration\Domain\Model\User;
use App\Administration\Domain\Model\User\ImageRightsStatus;
use PHPUnit\Framework\Attributes\Test;
use PHPUnit\Framework\TestCase;
final class ImageRightsStatusTest extends TestCase
{
#[Test]
public function allCasesHaveLabels(): void
{
foreach (ImageRightsStatus::cases() as $status) {
self::assertNotEmpty($status->label());
}
}
#[Test]
public function authorizedEstAutorise(): void
{
self::assertTrue(ImageRightsStatus::AUTHORIZED->estAutorise());
}
#[Test]
public function refusedNEstPasAutorise(): void
{
self::assertFalse(ImageRightsStatus::REFUSED->estAutorise());
}
#[Test]
public function notSpecifiedNEstPasAutorise(): void
{
self::assertFalse(ImageRightsStatus::NOT_SPECIFIED->estAutorise());
}
#[Test]
public function backedValuesAreCorrect(): void
{
self::assertSame('authorized', ImageRightsStatus::AUTHORIZED->value);
self::assertSame('refused', ImageRightsStatus::REFUSED->value);
self::assertSame('not_specified', ImageRightsStatus::NOT_SPECIFIED->value);
}
}

View File

@@ -0,0 +1,138 @@
<?php
declare(strict_types=1);
namespace App\Tests\Unit\Administration\Domain\Model\User;
use App\Administration\Domain\Event\DroitImageModifie;
use App\Administration\Domain\Model\User\Email;
use App\Administration\Domain\Model\User\ImageRightsStatus;
use App\Administration\Domain\Model\User\Role;
use App\Administration\Domain\Model\User\User;
use App\Administration\Domain\Model\User\UserId;
use App\Shared\Domain\Tenant\TenantId;
use DateTimeImmutable;
use PHPUnit\Framework\Attributes\Test;
use PHPUnit\Framework\TestCase;
final class UserImageRightsTest extends TestCase
{
private const string TENANT_ID = '550e8400-e29b-41d4-a716-446655440002';
private const string SCHOOL_NAME = 'École Alpha';
private const string MODIFIER_ID = '550e8400-e29b-41d4-a716-446655440099';
#[Test]
public function newUserHasNotSpecifiedImageRights(): void
{
$user = $this->createStudent();
self::assertSame(ImageRightsStatus::NOT_SPECIFIED, $user->imageRightsStatus);
self::assertNull($user->imageRightsUpdatedAt);
self::assertNull($user->imageRightsUpdatedBy);
}
#[Test]
public function modifierDroitImageSetsAuthorized(): void
{
$user = $this->createStudent();
$at = new DateTimeImmutable('2026-02-18 10:00:00');
$modifierId = UserId::fromString(self::MODIFIER_ID);
$user->modifierDroitImage(ImageRightsStatus::AUTHORIZED, $modifierId, $at);
self::assertSame(ImageRightsStatus::AUTHORIZED, $user->imageRightsStatus);
self::assertEquals($at, $user->imageRightsUpdatedAt);
self::assertTrue($user->imageRightsUpdatedBy->equals($modifierId));
}
#[Test]
public function modifierDroitImageSetsRefused(): void
{
$user = $this->createStudent();
$at = new DateTimeImmutable('2026-02-18 10:00:00');
$modifierId = UserId::fromString(self::MODIFIER_ID);
$user->modifierDroitImage(ImageRightsStatus::REFUSED, $modifierId, $at);
self::assertSame(ImageRightsStatus::REFUSED, $user->imageRightsStatus);
}
#[Test]
public function modifierDroitImageRecordsDroitImageModifieEvent(): void
{
$user = $this->createStudent();
$user->pullDomainEvents();
$at = new DateTimeImmutable('2026-02-18 10:00:00');
$modifierId = UserId::fromString(self::MODIFIER_ID);
$user->modifierDroitImage(ImageRightsStatus::AUTHORIZED, $modifierId, $at);
$events = $user->pullDomainEvents();
self::assertCount(1, $events);
self::assertInstanceOf(DroitImageModifie::class, $events[0]);
/** @var DroitImageModifie $event */
$event = $events[0];
self::assertTrue($user->id->equals($event->userId));
self::assertSame(ImageRightsStatus::AUTHORIZED, $event->nouveauStatut);
self::assertSame(ImageRightsStatus::NOT_SPECIFIED, $event->ancienStatut);
}
#[Test]
public function modifierDroitImageTracksOldStatus(): void
{
$user = $this->createStudent();
$modifierId = UserId::fromString(self::MODIFIER_ID);
$user->modifierDroitImage(ImageRightsStatus::AUTHORIZED, $modifierId, new DateTimeImmutable());
$user->pullDomainEvents();
$user->modifierDroitImage(ImageRightsStatus::REFUSED, $modifierId, new DateTimeImmutable());
$events = $user->pullDomainEvents();
/** @var DroitImageModifie $event */
$event = $events[0];
self::assertSame(ImageRightsStatus::AUTHORIZED, $event->ancienStatut);
self::assertSame(ImageRightsStatus::REFUSED, $event->nouveauStatut);
}
#[Test]
public function reconstitutePreservesImageRightsData(): void
{
$at = new DateTimeImmutable('2026-02-18 10:00:00');
$modifierId = UserId::fromString(self::MODIFIER_ID);
$user = User::reconstitute(
id: UserId::generate(),
email: new Email('eleve@example.com'),
roles: [Role::ELEVE],
tenantId: TenantId::fromString(self::TENANT_ID),
schoolName: self::SCHOOL_NAME,
statut: \App\Administration\Domain\Model\User\StatutCompte::EN_ATTENTE,
dateNaissance: null,
createdAt: new DateTimeImmutable(),
hashedPassword: null,
activatedAt: null,
consentementParental: null,
imageRightsStatus: ImageRightsStatus::AUTHORIZED,
imageRightsUpdatedAt: $at,
imageRightsUpdatedBy: $modifierId,
);
self::assertSame(ImageRightsStatus::AUTHORIZED, $user->imageRightsStatus);
self::assertEquals($at, $user->imageRightsUpdatedAt);
self::assertTrue($user->imageRightsUpdatedBy->equals($modifierId));
}
private function createStudent(): User
{
return User::creer(
email: new Email('eleve@example.com'),
role: Role::ELEVE,
tenantId: TenantId::fromString(self::TENANT_ID),
schoolName: self::SCHOOL_NAME,
dateNaissance: new DateTimeImmutable('2012-06-15'),
createdAt: new DateTimeImmutable('2026-01-15 10:00:00'),
);
}
}

View File

@@ -183,6 +183,11 @@ final class ActivateAccountProcessorTest extends TestCase
{
return [];
}
public function findStudentsByTenant(TenantId $tenantId): array
{
return [];
}
};
$consentementPolicy = new ConsentementParentalPolicy($this->clock);