Mathias STRASSER
b7dc27f2a5
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.
39 lines
1.0 KiB
PHP
39 lines
1.0 KiB
PHP
<?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 = [];
|
|
}
|