Files
Classeo/backend/tests/Unit/Scolarite/Application/Command/UpdateAppreciationTemplate/UpdateAppreciationTemplateHandlerTest.php
Mathias STRASSER e745cf326a
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: Calculer automatiquement les moyennes après chaque saisie de notes
Les enseignants ont besoin de moyennes à jour immédiatement après la
publication ou modification des notes, sans attendre un batch nocturne.

Le système recalcule via Domain Events synchrones : statistiques
d'évaluation (min/max/moyenne/médiane), moyennes matières pondérées
(normalisation /20), et moyenne générale par élève. Les résultats sont
stockés dans des tables dénormalisées avec cache Redis (TTL 5 min).

Trois endpoints API exposent les données avec contrôle d'accès par rôle.
Une commande console permet le backfill des données historiques au
déploiement.
2026-04-02 06:45:41 +02:00

174 lines
6.0 KiB
PHP

<?php
declare(strict_types=1);
namespace App\Tests\Unit\Scolarite\Application\Command\UpdateAppreciationTemplate;
use App\Administration\Domain\Model\User\UserId;
use App\Scolarite\Application\Command\UpdateAppreciationTemplate\UpdateAppreciationTemplateCommand;
use App\Scolarite\Application\Command\UpdateAppreciationTemplate\UpdateAppreciationTemplateHandler;
use App\Scolarite\Domain\Exception\AppreciationTemplateNonTrouveeException;
use App\Scolarite\Domain\Exception\CategorieAppreciationInvalideException;
use App\Scolarite\Domain\Exception\NonProprietaireDuModeleException;
use App\Scolarite\Domain\Model\Grade\AppreciationCategory;
use App\Scolarite\Domain\Model\Grade\AppreciationTemplate;
use App\Scolarite\Infrastructure\Persistence\InMemory\InMemoryAppreciationTemplateRepository;
use App\Shared\Domain\Clock;
use App\Shared\Domain\Tenant\TenantId;
use DateTimeImmutable;
use PHPUnit\Framework\Attributes\Test;
use PHPUnit\Framework\TestCase;
final class UpdateAppreciationTemplateHandlerTest extends TestCase
{
private const string TENANT_ID = '550e8400-e29b-41d4-a716-446655440001';
private const string TEACHER_ID = '550e8400-e29b-41d4-a716-446655440010';
private InMemoryAppreciationTemplateRepository $templateRepository;
private Clock $clock;
protected function setUp(): void
{
$this->templateRepository = new InMemoryAppreciationTemplateRepository();
$this->clock = new class implements Clock {
public function now(): DateTimeImmutable
{
return new DateTimeImmutable('2026-03-31 10:00:00');
}
};
}
#[Test]
public function itUpdatesTemplate(): void
{
$template = $this->seedTemplate();
$handler = new UpdateAppreciationTemplateHandler($this->templateRepository, $this->clock);
$updated = $handler(new UpdateAppreciationTemplateCommand(
tenantId: self::TENANT_ID,
teacherId: self::TEACHER_ID,
templateId: (string) $template->id,
title: 'Titre modifié',
content: 'Contenu modifié',
category: 'improvement',
));
self::assertSame('Titre modifié', $updated->title);
self::assertSame('Contenu modifié', $updated->content);
self::assertSame(AppreciationCategory::IMPROVEMENT, $updated->category);
}
#[Test]
public function itPersistsUpdatedTemplate(): void
{
$template = $this->seedTemplate();
$handler = new UpdateAppreciationTemplateHandler($this->templateRepository, $this->clock);
$handler(new UpdateAppreciationTemplateCommand(
tenantId: self::TENANT_ID,
teacherId: self::TEACHER_ID,
templateId: (string) $template->id,
title: 'Persisté',
content: 'Contenu persisté',
category: null,
));
$found = $this->templateRepository->findById(
$template->id,
TenantId::fromString(self::TENANT_ID),
);
self::assertNotNull($found);
self::assertSame('Persisté', $found->title);
self::assertNull($found->category);
}
#[Test]
public function itThrowsWhenTemplateNotFound(): void
{
$handler = new UpdateAppreciationTemplateHandler($this->templateRepository, $this->clock);
$this->expectException(AppreciationTemplateNonTrouveeException::class);
$handler(new UpdateAppreciationTemplateCommand(
tenantId: self::TENANT_ID,
teacherId: self::TEACHER_ID,
templateId: '550e8400-e29b-41d4-a716-446655440099',
title: 'Test',
content: 'Contenu',
category: null,
));
}
#[Test]
public function itThrowsWhenTeacherNotOwner(): void
{
$template = $this->seedTemplate();
$handler = new UpdateAppreciationTemplateHandler($this->templateRepository, $this->clock);
$this->expectException(NonProprietaireDuModeleException::class);
$handler(new UpdateAppreciationTemplateCommand(
tenantId: self::TENANT_ID,
teacherId: '550e8400-e29b-41d4-a716-446655440099',
templateId: (string) $template->id,
title: 'Hijack',
content: 'Contenu',
category: null,
));
}
#[Test]
public function itThrowsWhenCategoryInvalid(): void
{
$template = $this->seedTemplate();
$handler = new UpdateAppreciationTemplateHandler($this->templateRepository, $this->clock);
$this->expectException(CategorieAppreciationInvalideException::class);
$handler(new UpdateAppreciationTemplateCommand(
tenantId: self::TENANT_ID,
teacherId: self::TEACHER_ID,
templateId: (string) $template->id,
title: 'Test',
content: 'Contenu',
category: 'invalid_category',
));
}
#[Test]
public function itUpdatesTemplateWithNullCategory(): void
{
$template = $this->seedTemplate();
$handler = new UpdateAppreciationTemplateHandler($this->templateRepository, $this->clock);
$updated = $handler(new UpdateAppreciationTemplateCommand(
tenantId: self::TENANT_ID,
teacherId: self::TEACHER_ID,
templateId: (string) $template->id,
title: 'Sans catégorie',
content: 'Contenu mis à jour',
category: null,
));
self::assertNull($updated->category);
self::assertSame('Sans catégorie', $updated->title);
}
private function seedTemplate(): AppreciationTemplate
{
$template = AppreciationTemplate::creer(
tenantId: TenantId::fromString(self::TENANT_ID),
teacherId: UserId::fromString(self::TEACHER_ID),
title: 'Template original',
content: 'Contenu original',
category: AppreciationCategory::POSITIVE,
now: $this->clock->now(),
);
$this->templateRepository->save($template);
return $template;
}
}