Mathias STRASSER
aedde6707e
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
1.0 KiB
PHP
34 lines
1.0 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace App\Scolarite\Domain\Repository;
|
|
|
|
use App\Scolarite\Domain\Exception\GradeNotFoundException;
|
|
use App\Scolarite\Domain\Model\Evaluation\EvaluationId;
|
|
use App\Scolarite\Domain\Model\Grade\Grade;
|
|
use App\Scolarite\Domain\Model\Grade\GradeId;
|
|
use App\Shared\Domain\Tenant\TenantId;
|
|
|
|
interface GradeRepository
|
|
{
|
|
public function save(Grade $grade): void;
|
|
|
|
/** @throws GradeNotFoundException */
|
|
public function get(GradeId $id, TenantId $tenantId): Grade;
|
|
|
|
public function findById(GradeId $id, TenantId $tenantId): ?Grade;
|
|
|
|
/** @return array<Grade> */
|
|
public function findByEvaluation(EvaluationId $evaluationId, TenantId $tenantId): array;
|
|
|
|
/**
|
|
* @param array<EvaluationId> $evaluationIds
|
|
*
|
|
* @return array<string, list<Grade>> Clé = evaluationId (string)
|
|
*/
|
|
public function findByEvaluations(array $evaluationIds, TenantId $tenantId): array;
|
|
|
|
public function hasGradesForEvaluation(EvaluationId $evaluationId, TenantId $tenantId): bool;
|
|
}
|