feat: Calculer automatiquement les moyennes après chaque saisie de notes
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

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:
2026-03-30 06:22:03 +02:00
parent b70d5ec2ad
commit b7dc27f2a5
786 changed files with 118783 additions and 316 deletions

View File

@@ -0,0 +1,38 @@
<?php
declare(strict_types=1);
namespace App\Scolarite\Infrastructure\Api\Resource;
use ApiPlatform\Metadata\ApiProperty;
use ApiPlatform\Metadata\ApiResource;
use ApiPlatform\Metadata\GetCollection;
use App\Scolarite\Infrastructure\Api\Provider\StudentCompetencyProgressProvider;
#[ApiResource(
shortName: 'StudentCompetencyProgress',
operations: [
new GetCollection(
uriTemplate: '/students/{studentId}/competency-progress',
uriVariables: ['studentId'],
provider: StudentCompetencyProgressProvider::class,
name: 'get_student_competency_progress',
),
],
)]
final class StudentCompetencyProgressResource
{
#[ApiProperty(identifier: true)]
public ?string $competencyId = null;
public ?string $competencyCode = null;
public ?string $competencyName = null;
public ?string $currentLevelCode = null;
public ?string $currentLevelName = null;
/** @var array<array{date: string, levelCode: string, evaluationTitle: string}> */
public array $history = [];
}