Files
Classeo/backend/tests/Unit/Scolarite/Infrastructure/EventHandler/AuditEvaluationEventsHandlerTest.php
Mathias STRASSER 80ce289b86
Some checks failed
CI / Backend Tests (push) Has been cancelled
CI / Frontend Tests (push) Has been cancelled
CI / E2E Tests (push) Has been cancelled
CI / Naming Conventions (push) Has been cancelled
CI / Build Check (push) Has been cancelled
feat: Tracer automatiquement les événements notes et évaluations dans l'audit trail
Story 1-7 avait posé les fondations d'audit trail mais laissé en dehors du
périmètre initial les événements notes/évaluations, qui étaient alors non
couverts par les domaines. Avec la clôture des epics notation, ces actions
sensibles (création/modification/suppression d'évaluation, saisie/modification
de note, publication) doivent maintenant être tracées pour répondre aux
exigences RGPD et faciliter la résolution des litiges parent/enseignant.

Les événements de domaine existants ne transportaient pas tous les champs
nécessaires à l'audit (ancien/nouveau titre, description, barème, coefficient,
date, studentId). L'enrichissement de leur payload permet aux handlers d'audit
de journaliser les diffs complets via AuditLogger, sans que les autres
consommateurs (recalcul de moyennes) n'aient besoin de changer leur logique.

Au passage, le test E2E student-grades AC5 ("Nouveau" badge) visait
séquentiellement '.grade-card' puis '.badge-new' : la fenêtre de 3 s avant
markGradesSeen pouvait se refermer entre les deux attentes sur Firefox CI.
Un seul expect combiné '.grade-card .badge-new' élimine cette course.
2026-04-23 05:41:35 +02:00

158 lines
5.8 KiB
PHP

<?php
declare(strict_types=1);
namespace App\Tests\Unit\Scolarite\Infrastructure\EventHandler;
use App\Scolarite\Domain\Event\EvaluationCreee;
use App\Scolarite\Domain\Event\EvaluationModifiee;
use App\Scolarite\Domain\Event\EvaluationSupprimee;
use App\Scolarite\Domain\Event\NotesPubliees;
use App\Scolarite\Domain\Model\Evaluation\EvaluationId;
use App\Scolarite\Infrastructure\EventHandler\AuditEvaluationEventsHandler;
use App\Shared\Application\Port\AuditLogger;
use DateTimeImmutable;
use PHPUnit\Framework\MockObject\MockObject;
use PHPUnit\Framework\TestCase;
use Ramsey\Uuid\Uuid;
final class AuditEvaluationEventsHandlerTest extends TestCase
{
private AuditLogger&MockObject $auditLogger;
private AuditEvaluationEventsHandler $handler;
protected function setUp(): void
{
$this->auditLogger = $this->createMock(AuditLogger::class);
$this->handler = new AuditEvaluationEventsHandler($this->auditLogger);
}
public function testHandleEvaluationCreeeLogsAuditEntryWithFullPayload(): void
{
$evaluationId = EvaluationId::generate();
$classId = Uuid::uuid4()->toString();
$subjectId = Uuid::uuid4()->toString();
$teacherId = Uuid::uuid4()->toString();
$evaluationDate = new DateTimeImmutable('2026-04-15');
$event = new EvaluationCreee(
evaluationId: $evaluationId,
classId: $classId,
subjectId: $subjectId,
teacherId: $teacherId,
title: 'Contrôle chapitre 3',
description: 'Sur le chapitre 3 uniquement',
evaluationDate: $evaluationDate,
gradeScale: 20,
coefficient: 2.0,
occurredOn: new DateTimeImmutable(),
);
$this->auditLogger->expects($this->once())
->method('logDataChange')
->with(
$this->equalTo('Evaluation'),
$this->callback(static fn ($uuid) => $uuid->toString() === $evaluationId->value->toString()),
$this->equalTo('EvaluationCreee'),
$this->equalTo([]),
$this->callback(static fn ($new) => $new['title'] === 'Contrôle chapitre 3'
&& $new['description'] === 'Sur le chapitre 3 uniquement'
&& $new['class_id'] === $classId
&& $new['subject_id'] === $subjectId
&& $new['teacher_id'] === $teacherId
&& $new['evaluation_date'] === '2026-04-15'
&& $new['grade_scale'] === 20
&& $new['coefficient'] === 2.0
),
);
$this->handler->handleEvaluationCreee($event);
}
public function testHandleEvaluationModifieeLogsAuditEntryWithDiff(): void
{
$evaluationId = EvaluationId::generate();
$event = new EvaluationModifiee(
evaluationId: $evaluationId,
oldTitle: 'Ancien titre',
newTitle: 'Nouveau titre',
oldDescription: 'Ancienne description',
newDescription: 'Nouvelle description',
oldCoefficient: 1.0,
newCoefficient: 2.0,
oldEvaluationDate: new DateTimeImmutable('2026-04-15'),
newEvaluationDate: new DateTimeImmutable('2026-05-01'),
oldGradeScale: 20,
newGradeScale: 100,
occurredOn: new DateTimeImmutable(),
);
$this->auditLogger->expects($this->once())
->method('logDataChange')
->with(
$this->equalTo('Evaluation'),
$this->callback(static fn ($uuid) => $uuid->toString() === $evaluationId->value->toString()),
$this->equalTo('EvaluationModifiee'),
$this->callback(static fn ($old) => $old['title'] === 'Ancien titre'
&& $old['description'] === 'Ancienne description'
&& $old['coefficient'] === 1.0
&& $old['evaluation_date'] === '2026-04-15'
&& $old['grade_scale'] === 20
),
$this->callback(static fn ($new) => $new['title'] === 'Nouveau titre'
&& $new['description'] === 'Nouvelle description'
&& $new['coefficient'] === 2.0
&& $new['evaluation_date'] === '2026-05-01'
&& $new['grade_scale'] === 100
),
);
$this->handler->handleEvaluationModifiee($event);
}
public function testHandleEvaluationSupprimeeLogsAuditEntry(): void
{
$evaluationId = EvaluationId::generate();
$event = new EvaluationSupprimee(
evaluationId: $evaluationId,
occurredOn: new DateTimeImmutable(),
);
$this->auditLogger->expects($this->once())
->method('logDataChange')
->with(
$this->equalTo('Evaluation'),
$this->callback(static fn ($uuid) => $uuid->toString() === $evaluationId->value->toString()),
$this->equalTo('EvaluationSupprimee'),
$this->equalTo([]),
$this->equalTo([]),
);
$this->handler->handleEvaluationSupprimee($event);
}
public function testHandleNotesPublieesLogsAuditEntry(): void
{
$evaluationId = EvaluationId::generate();
$event = new NotesPubliees(
evaluationId: $evaluationId,
occurredOn: new DateTimeImmutable(),
);
$this->auditLogger->expects($this->once())
->method('logDataChange')
->with(
$this->equalTo('Evaluation'),
$this->callback(static fn ($uuid) => $uuid->toString() === $evaluationId->value->toString()),
$this->equalTo('NotesPubliees'),
$this->equalTo([]),
$this->equalTo([]),
);
$this->handler->handleNotesPubliees($event);
}
}