ajoute la surveillance d'examen (chantier vrai cockpit, dernière étape)

Une séance peut être lancée en mode examen avec une durée dédiée.
Réutilise le mécanisme d'expiration déjà en place (labs:expirer-sessions,
expire_a) plutôt que d'en construire un nouveau. Le navigateur de
l'élève signale les changements d'onglet et les sorties de plein écran
(evenements_examen : un type et un horodatage, rien d'autre - pas de
capture d'écran ni de webcam) ; le prof voit le compte par élève et le
temps restant dans le cockpit de sa classe et la salle d'attente.

Choix d'Adam après discussion des options (suivi chronométré simple /
+ détection d'onglet / + tentative de plein écran) : la troisième,
honnêtement présentée - un navigateur ne permet pas de vraiment
empêcher de sortir, seulement de le signaler.

Avec cette étape, les quatre fonctions fictives du tableau de bord
démo (quiz, devoirs, observations, examen) sont maintenant réelles.

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

portail/app/Models/EvenementExamen.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+/**
+ * Sortie détectée pendant un examen (changement d'onglet, plein écran
+ * quitté) : jamais de capture d'écran ni de webcam.
+ */
+class EvenementExamen extends Model
+{
+    public const CHANGEMENT_ONGLET = 'changement_onglet';
+
+    public const SORTIE_PLEIN_ECRAN = 'sortie_plein_ecran';
+
+    protected $table = 'evenements_examen';
+
+    protected $fillable = ['lab_session_id', 'type'];
+
+    /** @return BelongsTo<LabSession, $this> */
+    public function labSession(): BelongsTo
+    {
+        return $this->belongsTo(LabSession::class);
+    }
+}

portail/app/Models/LabSession.php

@@ -91,4 +91,20 @@ class LabSession extends Model
     {
         return $this->hasOne(Correction::class)->latestOfMany();
     }
+
+    /** @return HasMany<EvenementExamen, $this> */
+    public function evenementsExamen(): HasMany
+    {
+        return $this->hasMany(EvenementExamen::class)->latest();
+    }
+
+    /** Nul si la session n'expire jamais ou si l'expiration est déjà passée. */
+    public function minutesRestantes(): ?int
+    {
+        if ($this->expire_a === null || $this->expire_a->isPast()) {
+            return null;
+        }
+
+        return (int) ceil(now()->diffInSeconds($this->expire_a) / 60);
+    }
 }

portail/app/Models/Seance.php

@@ -20,7 +20,7 @@ class Seance extends Model
 
     public const TERMINEE = 'terminee';
 
-    protected $fillable = ['classe_id', 'lab_id', 'statut', 'prevue_a', 'demarree_a', 'terminee_a', 'visio_ouverte_a', 'visio_salle', 'visio_chat'];
+    protected $fillable = ['classe_id', 'lab_id', 'statut', 'prevue_a', 'demarree_a', 'terminee_a', 'visio_ouverte_a', 'visio_salle', 'visio_chat', 'mode_examen', 'duree_examen_min'];
 
     protected $casts = [
         'prevue_a' => 'datetime',
@@ -28,6 +28,7 @@ class Seance extends Model
         'terminee_a' => 'datetime',
         'visio_ouverte_a' => 'datetime',
         'visio_chat' => 'boolean',
+        'mode_examen' => 'boolean',
     ];
 
     public function visioOuverte(): bool