Roukmoute/Classeo
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: Calculer automatiquement les moyennes après chaque saisie de notes
Some checks failed
CI / Backend Tests (push) Has been cancelled
Details
CI / Frontend Tests (push) Has been cancelled
Details
CI / E2E Tests (push) Has been cancelled
Details
CI / Naming Conventions (push) Has been cancelled
Details
CI / Build Check (push) Has been cancelled
Details

Browse Source 
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.
This commit is contained in:
Mathias STRASSER
2026-03-30 06:22:03 +02:00
parent b70d5ec2ad
commit b7dc27f2a5
786 changed files with 118783 additions and 316 deletions
Download Patch File Download Diff File Expand all files Collapse all files

121
backend/tests/Unit/Scolarite/Domain/Model/Grade/AppreciationTemplateTest.php Normal file
View File

@@ -0,0 +1,121 @@
<?php
declare(strict_types=1);
namespace App\Tests\Unit\Scolarite\Domain\Model\Grade;
use App\Administration\Domain\Model\User\UserId;
use App\Scolarite\Domain\Model\Grade\AppreciationCategory;
use App\Scolarite\Domain\Model\Grade\AppreciationTemplate;
use App\Scolarite\Domain\Model\Grade\AppreciationTemplateId;
use App\Shared\Domain\Tenant\TenantId;
use DateTimeImmutable;
use PHPUnit\Framework\Attributes\Test;
use PHPUnit\Framework\TestCase;
final class AppreciationTemplateTest extends TestCase
{
private const string TENANT_ID = '550e8400-e29b-41d4-a716-446655440001';
private const string TEACHER_ID = '550e8400-e29b-41d4-a716-446655440010';
#[Test]
public function creerSetsAllProperties(): void
{
$now = new DateTimeImmutable('2026-03-31 10:00:00');
$template = AppreciationTemplate::creer(
tenantId: TenantId::fromString(self::TENANT_ID),
teacherId: UserId::fromString(self::TEACHER_ID),
title: 'Très bon travail',
content: 'Très bon travail, continuez ainsi !',
category: AppreciationCategory::POSITIVE,
now: $now,
);
self::assertSame('Très bon travail', $template->title);
self::assertSame('Très bon travail, continuez ainsi !', $template->content);
self::assertSame(AppreciationCategory::POSITIVE, $template->category);
self::assertSame(0, $template->usageCount);
self::assertEquals($now, $template->createdAt);
self::assertEquals($now, $template->updatedAt);
}
#[Test]
public function creerAcceptsNullCategory(): void
{
$template = $this->createTemplate(category: null);
self::assertNull($template->category);
}
#[Test]
public function modifierUpdatesProperties(): void
{
$template = $this->createTemplate();
$modifiedAt = new DateTimeImmutable('2026-03-31 14:00:00');
$template->modifier(
title: 'Nouveau titre',
content: 'Nouveau contenu',
category: AppreciationCategory::IMPROVEMENT,
now: $modifiedAt,
);
self::assertSame('Nouveau titre', $template->title);
self::assertSame('Nouveau contenu', $template->content);
self::assertSame(AppreciationCategory::IMPROVEMENT, $template->category);
self::assertEquals($modifiedAt, $template->updatedAt);
}
#[Test]
public function incrementerUtilisationIncreasesCount(): void
{
$template = $this->createTemplate();
$template->incrementerUtilisation();
self::assertSame(1, $template->usageCount);
$template->incrementerUtilisation();
self::assertSame(2, $template->usageCount);
}
#[Test]
public function reconstituteRestoresAllProperties(): void
{
$id = AppreciationTemplateId::generate();
$createdAt = new DateTimeImmutable('2026-03-31 10:00:00');
$updatedAt = new DateTimeImmutable('2026-03-31 14:00:00');
$template = AppreciationTemplate::reconstitute(
id: $id,
tenantId: TenantId::fromString(self::TENANT_ID),
teacherId: UserId::fromString(self::TEACHER_ID),
title: 'Titre',
content: 'Contenu',
category: AppreciationCategory::NEUTRAL,
usageCount: 5,
createdAt: $createdAt,
updatedAt: $updatedAt,
);
self::assertTrue($template->id->equals($id));
self::assertSame('Titre', $template->title);
self::assertSame('Contenu', $template->content);
self::assertSame(AppreciationCategory::NEUTRAL, $template->category);
self::assertSame(5, $template->usageCount);
self::assertEquals($createdAt, $template->createdAt);
self::assertEquals($updatedAt, $template->updatedAt);
}
private function createTemplate(?AppreciationCategory $category = AppreciationCategory::POSITIVE): AppreciationTemplate
{
return AppreciationTemplate::creer(
tenantId: TenantId::fromString(self::TENANT_ID),
teacherId: UserId::fromString(self::TEACHER_ID),
title: 'Très bon travail',
content: 'Très bon travail, continuez ainsi !',
category: $category,
now: new DateTimeImmutable('2026-03-31 10:00:00'),
);
}
}

93
backend/tests/Unit/Scolarite/Domain/Model/Grade/GradeTest.php
View File

@@ -7,6 +7,7 @@ namespace App\Tests\Unit\Scolarite\Domain\Model\Grade;
use App\Administration\Domain\Model\User\UserId;
use App\Scolarite\Domain\Event\NoteModifiee;
use App\Scolarite\Domain\Event\NoteSaisie;
use App\Scolarite\Domain\Exception\AppreciationTropLongueException;
use App\Scolarite\Domain\Exception\NoteRequiseException;
use App\Scolarite\Domain\Exception\ValeurNoteInvalideException;
use App\Scolarite\Domain\Model\Evaluation\EvaluationId;
@@ -20,6 +21,8 @@ use DateTimeImmutable;
use PHPUnit\Framework\Attributes\Test;
use PHPUnit\Framework\TestCase;
use function str_repeat;
final class GradeTest extends TestCase
{
private const string TENANT_ID = '550e8400-e29b-41d4-a716-446655440001';
@@ -269,6 +272,96 @@ final class GradeTest extends TestCase
self::assertEmpty($grade->pullDomainEvents());
}
#[Test]
public function saisirAppreciationSetsAppreciation(): void
{
$grade = $this->createGrade();
$now = new DateTimeImmutable('2026-03-31 10:00:00');
$grade->saisirAppreciation('Très bon travail', $now);
self::assertSame('Très bon travail', $grade->appreciation);
self::assertEquals($now, $grade->appreciationUpdatedAt);
self::assertEquals($now, $grade->updatedAt);
}
#[Test]
public function saisirAppreciationAcceptsNull(): void
{
$grade = $this->createGrade();
$grade->saisirAppreciation('Temporaire', new DateTimeImmutable('2026-03-31 09:00:00'));
$grade->saisirAppreciation(null, new DateTimeImmutable('2026-03-31 10:00:00'));
self::assertNull($grade->appreciation);
}
#[Test]
public function saisirAppreciationAcceptsEmptyString(): void
{
$grade = $this->createGrade();
$grade->saisirAppreciation('Temporaire', new DateTimeImmutable('2026-03-31 09:00:00'));
$grade->saisirAppreciation('', new DateTimeImmutable('2026-03-31 10:00:00'));
self::assertNull($grade->appreciation);
}
#[Test]
public function saisirAppreciationThrowsWhenTooLong(): void
{
$grade = $this->createGrade();
$this->expectException(AppreciationTropLongueException::class);
$grade->saisirAppreciation(str_repeat('a', 501), new DateTimeImmutable('2026-03-31 10:00:00'));
}
#[Test]
public function saisirAppreciationAcceptsMaxLength(): void
{
$grade = $this->createGrade();
$grade->saisirAppreciation(str_repeat('a', 500), new DateTimeImmutable('2026-03-31 10:00:00'));
self::assertSame(500, mb_strlen($grade->appreciation ?? ''));
}
#[Test]
public function newGradeHasNullAppreciation(): void
{
$grade = $this->createGrade();
self::assertNull($grade->appreciation);
self::assertNull($grade->appreciationUpdatedAt);
}
#[Test]
public function reconstituteRestoresAppreciation(): void
{
$gradeId = GradeId::generate();
$createdAt = new DateTimeImmutable('2026-03-27 10:00:00');
$updatedAt = new DateTimeImmutable('2026-03-27 14:00:00');
$appreciationUpdatedAt = new DateTimeImmutable('2026-03-31 10:00:00');
$grade = Grade::reconstitute(
id: $gradeId,
tenantId: TenantId::fromString(self::TENANT_ID),
evaluationId: EvaluationId::fromString(self::EVALUATION_ID),
studentId: UserId::fromString(self::STUDENT_ID),
value: new GradeValue(15.5),
status: GradeStatus::GRADED,
createdBy: UserId::fromString(self::TEACHER_ID),
createdAt: $createdAt,
updatedAt: $updatedAt,
appreciation: 'Bon travail',
appreciationUpdatedAt: $appreciationUpdatedAt,
);
self::assertSame('Bon travail', $grade->appreciation);
self::assertEquals($appreciationUpdatedAt, $grade->appreciationUpdatedAt);
}
private function createGrade(): Grade
{
return Grade::saisir(