ajoute Quiz flash (chantier vrai cockpit, étape 2) : QCM et vrai/faux, lancé en direct, indépendant d'une séance de lab

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

portail/app/Models/ChoixQuestionQuiz.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class ChoixQuestionQuiz extends Model
+{
+    protected $table = 'choix_questions_quiz';
+
+    protected $fillable = ['question_quiz_id', 'texte', 'est_correct', 'ordre'];
+
+    protected $casts = [
+        'est_correct' => 'boolean',
+    ];
+
+    /** @return BelongsTo<QuestionQuiz, $this> */
+    public function question(): BelongsTo
+    {
+        return $this->belongsTo(QuestionQuiz::class, 'question_quiz_id');
+    }
+}

portail/app/Models/Classe.php

@@ -67,6 +67,12 @@ class Classe extends Model
         return $this->hasMany(Seance::class);
     }
 
+    /** @return HasMany<Quiz, $this> */
+    public function quizzes(): HasMany
+    {
+        return $this->hasMany(Quiz::class)->latest();
+    }
+
     public function estArchivee(): bool
     {
         return $this->archivee_a !== null;

portail/app/Models/QuestionQuiz.php

@@ -0,0 +1,48 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+
+class QuestionQuiz extends Model
+{
+    public const QCM = 'qcm';
+
+    public const VRAI_FAUX = 'vrai_faux';
+
+    protected $table = 'questions_quiz';
+
+    protected $fillable = ['quiz_id', 'enonce', 'type', 'ordre', 'reponse_vrai_faux'];
+
+    protected $casts = [
+        'reponse_vrai_faux' => 'boolean',
+    ];
+
+    /** @return BelongsTo<Quiz, $this> */
+    public function quiz(): BelongsTo
+    {
+        return $this->belongsTo(Quiz::class);
+    }
+
+    /** @return HasMany<ChoixQuestionQuiz, $this> */
+    public function choix(): HasMany
+    {
+        return $this->hasMany(ChoixQuestionQuiz::class)->orderBy('ordre');
+    }
+
+    /**
+     * Vrai si $choixId (QCM) ou $reponseVraiFaux (vrai/faux) est la bonne
+     * réponse à cette question. Un seul des deux arguments compte, selon
+     * le type de la question.
+     */
+    public function estCorrecte(?int $choixId, ?bool $reponseVraiFaux): bool
+    {
+        if ($this->type === self::VRAI_FAUX) {
+            return $reponseVraiFaux !== null && $reponseVraiFaux === $this->reponse_vrai_faux;
+        }
+
+        return $choixId !== null && $this->choix()->where('id', $choixId)->where('est_correct', true)->exists();
+    }
+}

portail/app/Models/Quiz.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+
+/**
+ * Banque de questions réutilisable, propre à une classe (chantier « vrai
+ * cockpit », étape 2 — 2026-10-13). Lancé en direct par SessionQuiz.
+ */
+class Quiz extends Model
+{
+    protected $fillable = ['classe_id', 'titre'];
+
+    /** @return BelongsTo<Classe, $this> */
+    public function classe(): BelongsTo
+    {
+        return $this->belongsTo(Classe::class);
+    }
+
+    /** @return HasMany<QuestionQuiz, $this> */
+    public function questions(): HasMany
+    {
+        return $this->hasMany(QuestionQuiz::class)->orderBy('ordre');
+    }
+
+    /** @return HasMany<SessionQuiz, $this> */
+    public function sessions(): HasMany
+    {
+        return $this->hasMany(SessionQuiz::class);
+    }
+}

portail/app/Models/ReponseQuiz.php

@@ -0,0 +1,37 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class ReponseQuiz extends Model
+{
+    protected $table = 'reponses_quiz';
+
+    protected $fillable = ['session_quiz_id', 'question_quiz_id', 'eleve_id', 'choix_question_quiz_id', 'reponse_vrai_faux', 'correcte', 'repondu_a'];
+
+    protected $casts = [
+        'reponse_vrai_faux' => 'boolean',
+        'correcte' => 'boolean',
+        'repondu_a' => 'datetime',
+    ];
+
+    /** @return BelongsTo<SessionQuiz, $this> */
+    public function session(): BelongsTo
+    {
+        return $this->belongsTo(SessionQuiz::class, 'session_quiz_id');
+    }
+
+    /** @return BelongsTo<QuestionQuiz, $this> */
+    public function question(): BelongsTo
+    {
+        return $this->belongsTo(QuestionQuiz::class, 'question_quiz_id');
+    }
+
+    /** @return BelongsTo<Eleve, $this> */
+    public function eleve(): BelongsTo
+    {
+        return $this->belongsTo(Eleve::class);
+    }
+}

portail/app/Models/SessionQuiz.php

@@ -0,0 +1,96 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+
+/**
+ * Lancement en direct d'un Quiz (chantier « vrai cockpit », étape 2).
+ * Indépendant d'une séance de lab : les élèves de la classe la voient
+ * apparaître sur leur tableau de bord dès qu'elle passe en_cours.
+ */
+class SessionQuiz extends Model
+{
+    public const EN_ATTENTE = 'en_attente';
+
+    public const EN_COURS = 'en_cours';
+
+    public const TERMINEE = 'terminee';
+
+    protected $table = 'sessions_quiz';
+
+    protected $fillable = ['quiz_id', 'statut', 'question_quiz_courante_id', 'demarree_a', 'terminee_a'];
+
+    protected $casts = [
+        'demarree_a' => 'datetime',
+        'terminee_a' => 'datetime',
+    ];
+
+    /** @return BelongsTo<Quiz, $this> */
+    public function quiz(): BelongsTo
+    {
+        return $this->belongsTo(Quiz::class);
+    }
+
+    /** @return BelongsTo<QuestionQuiz, $this> */
+    public function questionCourante(): BelongsTo
+    {
+        return $this->belongsTo(QuestionQuiz::class, 'question_quiz_courante_id');
+    }
+
+    /** @return HasMany<ReponseQuiz, $this> */
+    public function reponses(): HasMany
+    {
+        return $this->hasMany(ReponseQuiz::class);
+    }
+
+    /**
+     * Passe à la question suivante du quiz (dans l'ordre), ou termine la
+     * session s'il n'y en a plus. Idempotent : rejouable sans effet si déjà
+     * terminée.
+     */
+    public function passerALaQuestionSuivante(): void
+    {
+        if ($this->statut === self::TERMINEE) {
+            return;
+        }
+
+        $questions = $this->quiz->questions;
+        $indiceActuel = $this->question_quiz_courante_id
+            ? $questions->search(fn ($q) => $q->id === $this->question_quiz_courante_id)
+            : -1;
+        $suivante = $questions->get($indiceActuel + 1);
+
+        if ($suivante) {
+            $this->forceFill(['statut' => self::EN_COURS, 'question_quiz_courante_id' => $suivante->id])->save();
+        } else {
+            $this->terminer();
+        }
+    }
+
+    public function terminer(): void
+    {
+        if ($this->statut !== self::TERMINEE) {
+            $this->forceFill(['statut' => self::TERMINEE, 'terminee_a' => now()])->save();
+        }
+    }
+
+    /**
+     * Décompte des réponses à la question en cours, pour le panneau du
+     * prof : combien d'élèves ont déjà répondu, combien ont juste.
+     *
+     * @return array{repondu: int, correctes: int}
+     */
+    public function decompteQuestionCourante(): array
+    {
+        if (! $this->question_quiz_courante_id) {
+            return ['repondu' => 0, 'correctes' => 0];
+        }
+
+        $reponses = $this->reponses->where('question_quiz_id', $this->question_quiz_courante_id);
+
+        return ['repondu' => $reponses->count(), 'correctes' => $reponses->where('correcte', true)->count()];
+    }
+}