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.
2026-03-30 06:22:03 +02:00
parent b70d5ec2ad
commit b7dc27f2a5
786 changed files with 118783 additions and 316 deletions
--- a/backend/migrations/Version20260329082334.php
+++ b/backend/migrations/Version20260329082334.php
@@ -0,0 +1,84 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DoctrineMigrations;
+
+use Doctrine\DBAL\Schema\Schema;
+use Doctrine\Migrations\AbstractMigration;
+
+final class Version20260329082334 extends AbstractMigration
+{
+    public function getDescription(): string
+    {
+        return 'Création des tables dénormalisées pour les moyennes élèves et statistiques évaluations';
+    }
+
+    public function up(Schema $schema): void
+    {
+        $this->addSql(<<<'SQL'
+            CREATE TABLE student_averages (
+                id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+                tenant_id UUID NOT NULL,
+                student_id UUID NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+                subject_id UUID NOT NULL REFERENCES subjects(id) ON DELETE CASCADE,
+                period_id UUID NOT NULL REFERENCES academic_periods(id) ON DELETE CASCADE,
+                average DECIMAL(4,2),
+                grade_count INT NOT NULL DEFAULT 0,
+                updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+                UNIQUE (student_id, subject_id, period_id)
+            )
+            SQL);
+
+        $this->addSql(<<<'SQL'
+            CREATE INDEX idx_student_averages_tenant ON student_averages(tenant_id)
+            SQL);
+
+        $this->addSql(<<<'SQL'
+            CREATE INDEX idx_student_averages_student ON student_averages(student_id)
+            SQL);
+
+        $this->addSql(<<<'SQL'
+            CREATE INDEX idx_student_averages_subject ON student_averages(subject_id)
+            SQL);
+
+        $this->addSql(<<<'SQL'
+            CREATE TABLE student_general_averages (
+                id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+                tenant_id UUID NOT NULL,
+                student_id UUID NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+                period_id UUID NOT NULL REFERENCES academic_periods(id) ON DELETE CASCADE,
+                average DECIMAL(4,2),
+                updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+                UNIQUE (student_id, period_id)
+            )
+            SQL);
+
+        $this->addSql(<<<'SQL'
+            CREATE INDEX idx_student_general_averages_tenant ON student_general_averages(tenant_id)
+            SQL);
+
+        $this->addSql(<<<'SQL'
+            CREATE INDEX idx_student_general_averages_student ON student_general_averages(student_id)
+            SQL);
+
+        $this->addSql(<<<'SQL'
+            CREATE TABLE evaluation_statistics (
+                evaluation_id UUID PRIMARY KEY REFERENCES evaluations(id) ON DELETE CASCADE,
+                average DECIMAL(5,2),
+                min_grade DECIMAL(5,2),
+                max_grade DECIMAL(5,2),
+                median_grade DECIMAL(5,2),
+                graded_count INT NOT NULL DEFAULT 0,
+                updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+            )
+            SQL);
+    }
+
+    public function down(Schema $schema): void
+    {
+        $this->addSql('DROP TABLE IF EXISTS evaluation_statistics');
+        $this->addSql('DROP TABLE IF EXISTS student_general_averages');
+        $this->addSql('DROP TABLE IF EXISTS student_averages');
+    }
+}
--- a/backend/migrations/Version20260331154510.php
+++ b/backend/migrations/Version20260331154510.php
@@ -0,0 +1,56 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DoctrineMigrations;
+
+use Doctrine\DBAL\Schema\Schema;
+use Doctrine\Migrations\AbstractMigration;
+
+final class Version20260331154510 extends AbstractMigration
+{
+    public function getDescription(): string
+    {
+        return 'Ajout des appréciations sur les notes et table des modèles d\'appréciations enseignant';
+    }
+
+    public function up(Schema $schema): void
+    {
+        $this->addSql(<<<'SQL'
+            ALTER TABLE grades ADD COLUMN appreciation TEXT
+            SQL);
+
+        $this->addSql(<<<'SQL'
+            ALTER TABLE grades ADD COLUMN appreciation_updated_at TIMESTAMPTZ
+            SQL);
+
+        $this->addSql(<<<'SQL'
+            CREATE TABLE appreciation_templates (
+                id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+                tenant_id UUID NOT NULL,
+                teacher_id UUID NOT NULL REFERENCES users(id),
+                title VARCHAR(100) NOT NULL,
+                content TEXT NOT NULL,
+                category VARCHAR(50),
+                usage_count INT NOT NULL DEFAULT 0,
+                created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+                updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+            )
+            SQL);
+
+        $this->addSql(<<<'SQL'
+            CREATE INDEX idx_templates_teacher ON appreciation_templates(teacher_id)
+            SQL);
+
+        $this->addSql(<<<'SQL'
+            CREATE INDEX idx_templates_tenant ON appreciation_templates(tenant_id)
+            SQL);
+    }
+
+    public function down(Schema $schema): void
+    {
+        $this->addSql('DROP TABLE IF EXISTS appreciation_templates');
+        $this->addSql('ALTER TABLE grades DROP COLUMN IF EXISTS appreciation_updated_at');
+        $this->addSql('ALTER TABLE grades DROP COLUMN IF EXISTS appreciation');
+    }
+}
--- a/backend/migrations/Version20260402055321.php
+++ b/backend/migrations/Version20260402055321.php
@@ -0,0 +1,108 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DoctrineMigrations;
+
+use Doctrine\DBAL\Schema\Schema;
+use Doctrine\Migrations\AbstractMigration;
+
+final class Version20260402055321 extends AbstractMigration
+{
+    public function getDescription(): string
+    {
+        return 'Tables pour le mode compétences : référentiels, compétences, niveaux personnalisables, évaluations par compétences et résultats élèves';
+    }
+
+    public function up(Schema $schema): void
+    {
+        $this->addSql(<<<'SQL'
+            CREATE TABLE competency_frameworks (
+                id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+                tenant_id UUID NOT NULL,
+                name VARCHAR(255) NOT NULL,
+                is_default BOOLEAN NOT NULL DEFAULT false,
+                created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+            )
+            SQL);
+
+        $this->addSql(<<<'SQL'
+            CREATE INDEX idx_competency_frameworks_tenant ON competency_frameworks(tenant_id)
+            SQL);
+
+        $this->addSql(<<<'SQL'
+            CREATE TABLE competencies (
+                id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+                framework_id UUID NOT NULL REFERENCES competency_frameworks(id) ON DELETE CASCADE,
+                code VARCHAR(50) NOT NULL,
+                name VARCHAR(255) NOT NULL,
+                description TEXT,
+                parent_id UUID REFERENCES competencies(id) ON DELETE SET NULL,
+                sort_order INT NOT NULL DEFAULT 0
+            )
+            SQL);
+
+        $this->addSql(<<<'SQL'
+            CREATE INDEX idx_competencies_framework ON competencies(framework_id)
+            SQL);
+
+        $this->addSql(<<<'SQL'
+            CREATE TABLE competency_levels (
+                id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+                tenant_id UUID NOT NULL,
+                code VARCHAR(20) NOT NULL,
+                name VARCHAR(100) NOT NULL,
+                color VARCHAR(7),
+                sort_order INT NOT NULL DEFAULT 0,
+                UNIQUE (tenant_id, code)
+            )
+            SQL);
+
+        $this->addSql(<<<'SQL'
+            CREATE INDEX idx_competency_levels_tenant ON competency_levels(tenant_id)
+            SQL);
+
+        $this->addSql(<<<'SQL'
+            CREATE TABLE competency_evaluations (
+                id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+                evaluation_id UUID NOT NULL REFERENCES evaluations(id) ON DELETE CASCADE,
+                competency_id UUID NOT NULL REFERENCES competencies(id) ON DELETE CASCADE,
+                UNIQUE (evaluation_id, competency_id)
+            )
+            SQL);
+
+        $this->addSql(<<<'SQL'
+            CREATE INDEX idx_competency_evaluations_evaluation ON competency_evaluations(evaluation_id)
+            SQL);
+
+        $this->addSql(<<<'SQL'
+            CREATE TABLE student_competency_results (
+                id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+                tenant_id UUID NOT NULL,
+                competency_evaluation_id UUID NOT NULL REFERENCES competency_evaluations(id) ON DELETE CASCADE,
+                student_id UUID NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+                level_code VARCHAR(20) NOT NULL,
+                created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+                updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+                UNIQUE (competency_evaluation_id, student_id)
+            )
+            SQL);
+
+        $this->addSql(<<<'SQL'
+            CREATE INDEX idx_competency_results_student ON student_competency_results(student_id)
+            SQL);
+
+        $this->addSql(<<<'SQL'
+            CREATE INDEX idx_competency_results_tenant ON student_competency_results(tenant_id)
+            SQL);
+    }
+
+    public function down(Schema $schema): void
+    {
+        $this->addSql('DROP TABLE IF EXISTS student_competency_results');
+        $this->addSql('DROP TABLE IF EXISTS competency_evaluations');
+        $this->addSql('DROP TABLE IF EXISTS competency_levels');
+        $this->addSql('DROP TABLE IF EXISTS competencies');
+        $this->addSql('DROP TABLE IF EXISTS competency_frameworks');
+    }
+}