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.
This commit is contained in:
@@ -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 = [];
|
||||
}
|
||||
Reference in New Issue
Block a user