optimise MariaDB : deux index confirmés par EXPLAIN, N+1 supprimé

Jeu de données de charge (500 classes, 20 000 élèves, 30 000 sessions
de lab) généré localement contre une MariaDB jetable, jamais en
production, via la nouvelle commande charge:generer (refuse de
tourner si APP_ENV=production).

EXPLAIN confirme deux manques réels : lab_sessions.etat (30 056 lignes
parcourues sans index, lu chaque minute par l'expiration des sessions
et le self-healing) et classes.archivee_a (lu chaque jour par la purge
RGPD). devoirs.echeance n'avait besoin de rien : l'index existant sur
classe_id suffisait déjà, EXPLAIN l'a confirmé plutôt que d'ajouter un
index inutile.

ResultatsController faisait une requête de corrections et une
d'observations par classe du prof (N+1) : remplacé par une requête de
chaque pour toutes les classes, regroupées en mémoire.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
Adam Belkacemi 2026-10-14 09:31:11 +02:00
parent ca544ac620
commit e35e0e3c0b
5 changed files with 305 additions and 6 deletions

View file

@ -0,0 +1,153 @@
<?php
namespace App\Console\Commands;
use Illuminate\Console\Command;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Hash;
use Illuminate\Support\Str;
/**
* Jeu de données de charge (bloc B, CLAUDE.md : « 500 classes, 20 000
* élèves ») pour mesurer l'effet des index avec EXPLAIN sur un volume
* réaliste. Jamais en production : efface et recrée des données, et
* 20 000 lignes sur un serveur de production gênerait les vrais profs
* pendant la mesure. À lancer contre une base locale ou jetable.
*
* Insertions en lot (DB::table()->insert() par paquets), pas par Eloquent
* un par un : 20 000 `Hash::make()` individuels prendraient des minutes.
*/
class GenererJeuDeChargeTest extends Command
{
protected $signature = 'charge:generer {--classes=500} {--eleves-par-classe=40}';
protected $description = 'Remplit la base avec un jeu de données de charge réaliste (jamais en production)';
public function handle(): int
{
if ($this->laravel->environment('production')) {
$this->error('Jamais en production : lance ceci contre une base locale ou jetable.');
return self::FAILURE;
}
$nombreClasses = (int) $this->option('classes');
$elevesParClasse = (int) $this->option('eleves-par-classe');
$maintenant = now();
$codeSecretHache = Hash::make('123456'); // un seul hachage, réutilisé pour toutes les lignes
$this->info("Génération de {$nombreClasses} classes, {$elevesParClasse} élève(s) chacune…");
$etablissementIds = $this->inserer('etablissements', range(1, 100), fn (int $i) => [
'nom' => "Établissement de charge {$i}", 'ville' => 'Test', 'uai' => "CHARGE{$i}",
'created_at' => $maintenant, 'updated_at' => $maintenant,
]);
$profIds = $this->inserer('users', range(1, (int) ceil($nombreClasses / 2)), fn (int $i) => [
'name' => "Prof de charge {$i}", 'email' => "prof-charge-{$i}@charge.test",
'password' => $codeSecretHache, 'etablissement_id' => $etablissementIds[$i % count($etablissementIds)],
'created_at' => $maintenant, 'updated_at' => $maintenant,
]);
$classeIds = $this->inserer('classes', range(1, $nombreClasses), fn (int $i) => [
'etablissement_id' => $etablissementIds[$i % count($etablissementIds)],
'user_id' => $profIds[$i % count($profIds)],
'nom' => "Classe de charge {$i}", 'code_classe' => Str::upper(Str::random(5)).$i,
'archivee_a' => null, 'created_at' => $maintenant, 'updated_at' => $maintenant,
]);
$labId = DB::table('labs')->first()->id ?? DB::table('labs')->insertGetId([
'identifiant' => 'charge-test', 'titre' => 'Lab de charge', 'created_at' => $maintenant, 'updated_at' => $maintenant,
]);
$compteurEleve = 0;
$this->withProgressBar($classeIds, function (int $classeId) use (&$compteurEleve, $elevesParClasse, $maintenant, $codeSecretHache, $labId) {
$eleveIds = $this->inserer('eleves', range(1, $elevesParClasse), function (int $i) use (&$compteurEleve, $classeId, $maintenant, $codeSecretHache) {
$compteurEleve++;
return [
'classe_id' => $classeId, 'prenom' => "Élève{$compteurEleve}", 'nom' => 'Charge',
'identifiant' => "eleve-charge-{$compteurEleve}", 'code_secret' => $codeSecretHache,
'derniere_connexion_a' => $maintenant->copy()->subDays(random_int(0, 30)),
'created_at' => $maintenant, 'updated_at' => $maintenant,
];
});
// 3 séances par classe : deux terminées (historique), une sur dix encore en cours (activité réelle).
$enCours = random_int(1, 10) === 1;
$statuts = [$enCours ? 'en_cours' : 'terminee', 'terminee', 'terminee'];
foreach ($statuts as $indice => $statut) {
$demarreeA = $maintenant->copy()->subDays(random_int(1, 90));
$seanceId = DB::table('seances')->insertGetId([
'classe_id' => $classeId, 'lab_id' => $labId, 'statut' => $statut,
'demarree_a' => $demarreeA, 'terminee_a' => $statut === 'terminee' ? $demarreeA->copy()->addMinutes(45) : null,
'mode_examen' => false, 'created_at' => $demarreeA, 'updated_at' => $maintenant,
]);
// La moitié des élèves de la classe a une session de lab sur cette séance, avec sa correction.
$participants = array_slice($eleveIds, 0, (int) (count($eleveIds) / 2));
$labSessions = [];
foreach ($participants as $eleveId) {
$labSessions[] = [
'seance_id' => $seanceId, 'eleve_id' => $eleveId, 'lab_id' => $labId,
'etat' => $statut === 'terminee' ? 'termine' : 'actif',
'created_at' => $demarreeA, 'updated_at' => $maintenant,
];
}
if ($labSessions !== []) {
DB::table('lab_sessions')->insert($labSessions);
}
}
// 2 devoirs par classe, rendus par un peu plus d'un tiers des élèves.
foreach ([1, 2] as $n) {
$devoirId = DB::table('devoirs')->insertGetId([
'classe_id' => $classeId, 'titre' => "Devoir {$n}", 'consigne' => 'Consigne de charge.',
'echeance' => $maintenant->copy()->addDays(random_int(-30, 30)),
'created_at' => $maintenant, 'updated_at' => $maintenant,
]);
$rendus = [];
foreach (array_slice($eleveIds, 0, (int) (count($eleveIds) / 3)) as $eleveId) {
$rendus[] = [
'devoir_id' => $devoirId, 'eleve_id' => $eleveId, 'reponse' => 'Réponse de charge.',
'note' => random_int(5, 20), 'rendu_a' => $maintenant, 'created_at' => $maintenant, 'updated_at' => $maintenant,
];
}
if ($rendus !== []) {
DB::table('rendus_devoirs')->insert($rendus);
}
}
});
$this->newLine(2);
$this->info('Terminé : '.DB::table('classes')->count().' classes, '.DB::table('eleves')->count().' élèves, '
.DB::table('seances')->count().' séances, '.DB::table('lab_sessions')->count().' sessions de lab, '
.DB::table('devoirs')->count().' devoirs, '.DB::table('rendus_devoirs')->count().' rendus.');
return self::SUCCESS;
}
/**
* Insère en lots de 500 et renvoie les ids créés, dans l'ordre.
*
* @param array<int, int> $indices
* @param callable(int): array<string, mixed> $fabrique
* @return array<int, int>
*/
private function inserer(string $table, array $indices, callable $fabrique): array
{
$ids = [];
foreach (array_chunk($indices, 500) as $paquet) {
$lignes = array_map($fabrique, $paquet);
DB::table($table)->insert($lignes);
// insert() en lot : LAST_INSERT_ID() renvoie l'id du PREMIER rang
// inséré par l'instruction (comportement MySQL/MariaDB documenté),
// les suivants sont consécutifs (innodb_autoinc_lock_mode par défaut).
$premier = (int) DB::getPdo()->lastInsertId();
$ids = array_merge($ids, range($premier, $premier + count($lignes) - 1));
}
return $ids;
}
}

View file

@ -4,6 +4,8 @@ namespace App\Http\Controllers;
use App\Models\Classe;
use App\Models\Correction;
use App\Models\Observation;
use App\Models\Seance;
use Illuminate\Support\Facades\Auth;
use Illuminate\View\View;
@ -11,6 +13,10 @@ use Illuminate\View\View;
* « Résultats » (séparation vitrine/application, 2026-10-13) : vue
* d'ensemble, par classe, des corrections et des observations. Le détail
* séance par séance reste dans le cockpit de chaque classe.
*
* Tout en 4 requêtes au total, quel que soit le nombre de classes du prof
* (bloc B, optimisation MariaDB, 2026-10-14) : une requête par classe pour
* les corrections et une pour les observations étaient un N+1 classique.
*/
class ResultatsController extends Controller
{
@ -18,12 +24,24 @@ class ResultatsController extends Controller
{
$prof = Auth::guard('web')->user();
$classes = $prof->classes()->whereNull('archivee_a')->orderBy('nom')->get();
$classeIds = $classes->pluck('id');
$resultats = $classes->map(function (Classe $classe) {
$corrections = Correction::whereHas('labSession', fn ($q) => $q->whereIn('seance_id', $classe->seances()->select('id')))
->latest()
->limit(50)
->get();
$classeIdParSeanceId = Seance::whereIn('classe_id', $classeIds)->pluck('classe_id', 'id');
$correctionsParClasse = Correction::whereHas('labSession', fn ($q) => $q->whereIn('seance_id', $classeIdParSeanceId->keys()))
->with('labSession:id,seance_id')
->latest()
->get()
->groupBy(fn (Correction $c): int => $classeIdParSeanceId[$c->labSession->seance_id] ?? 0);
$observationsParClasse = Observation::whereIn('classe_id', $classeIds)
->with('eleve')
->latest()
->get()
->groupBy('classe_id');
$resultats = $classes->map(function (Classe $classe) use ($correctionsParClasse, $observationsParClasse) {
$corrections = ($correctionsParClasse->get($classe->id) ?? collect())->take(50);
return [
'classe' => $classe,
@ -31,7 +49,7 @@ class ResultatsController extends Controller
'reussiteMoyenne' => $corrections->isNotEmpty()
? (int) round($corrections->avg(fn ($c) => $c->note_max > 0 ? $c->note / $c->note_max * 100 : 0))
: null,
'observations' => $classe->observations()->with('eleve')->limit(5)->get(),
'observations' => ($observationsParClasse->get($classe->id) ?? collect())->take(5),
];
});