Mathias STRASSER
e745cf326a
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.
34 lines
868 B
PHP
34 lines
868 B
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace App\Scolarite\Infrastructure\Api\Resource;
|
|
|
|
use ApiPlatform\Metadata\ApiProperty;
|
|
use ApiPlatform\Metadata\ApiResource;
|
|
use ApiPlatform\Metadata\Get;
|
|
use App\Scolarite\Infrastructure\Api\Provider\StudentAveragesProvider;
|
|
|
|
#[ApiResource(
|
|
shortName: 'StudentAverages',
|
|
operations: [
|
|
new Get(
|
|
uriTemplate: '/students/{studentId}/averages',
|
|
provider: StudentAveragesProvider::class,
|
|
name: 'get_student_averages',
|
|
),
|
|
],
|
|
)]
|
|
final class StudentAveragesResource
|
|
{
|
|
#[ApiProperty(identifier: true)]
|
|
public ?string $studentId = null;
|
|
|
|
public ?string $periodId = null;
|
|
|
|
/** @var list<array{subjectId: string, subjectName: string|null, average: float, gradeCount: int}> */
|
|
public array $subjectAverages = [];
|
|
|
|
public ?float $generalAverage = null;
|
|
}
|