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>

docs/journal.md

@@ -1025,3 +1025,25 @@ Retour d'Adam après avoir vu la coquille : du texte clair illisible par endroit
 **Suite**
 
 Adam vérifie visuellement (thème sombre, menu avatar, mobile) et me dit si autre chose cloche. Sinon : Surveillance d'examen.
+
+## 2026-10-14 — Surveillance d'examen (chantier « vrai cockpit », dernière étape)
+
+Adam confirme que le correctif du thème sombre et du menu avatar est bon, sans navigateur disponible pour le vérifier moi-même cette fois. Avant de coder la dernière fonction fictive du tableau de bord démo, j'ai demandé à Adam ce qui est acceptable de suivre pendant un examen (élèves parfois mineurs). Son choix : suivi chronométré + détection de changement d'onglet + tentative de plein écran — en étant honnête sur la limite : un navigateur ne permet pas de vraiment empêcher l'élève de sortir, seulement de le signaler.
+
+**Fait**
+
+- Une séance peut être lancée en « mode examen » avec une durée dédiée (pas celle du lab), choisie par le prof au moment de lancer. Réutilise le mécanisme d'expiration déjà en place (`labs:expirer-sessions`, `expire_a` sur `LabSession`) plutôt que d'en construire un nouveau : l'admission en mode examen pose juste `expire_a` sur la durée de l'examen au lieu de la durée du lab.
+- `evenements_examen` : un type (`changement_onglet` ou `sortie_plein_ecran`) et un horodatage, rien d'autre — pas de capture d'écran, pas de webcam (minimisation, CLAUDE.md). Le navigateur de l'élève écoute `visibilitychange` et `fullscreenchange` et signale au serveur ; un bouton propose le plein écran, jamais forcé.
+- Le prof voit, dans le cockpit de sa classe et dans la salle d'attente : un badge « Mode examen · durée », le nombre de sorties par élève, le temps restant.
+- Purge RGPD : les événements d'examen partent avec la classe (vérifié par un test).
+- 7 nouveaux tests Pest (100 au total) : durée d'examen appliquée à l'admission, un élève ne peut signaler que sur sa propre session, aucun événement possible hors mode examen, type invalide refusé, purge RGPD, JavaScript valide des deux nouveaux scripts (barre prof, page élève).
+
+**Comprendre**
+
+Le choix qui a le plus simplifié ce chantier : ne pas inventer un nouveau mécanisme de fin de session pour l'examen. `expire_a` et `labs:expirer-sessions` existaient déjà pour une autre raison (libérer les VM d'un TP normal) ; l'examen ne fait qu'y mettre une durée différente. Même vérification de temps restant côté élève (JS, toutes les 10 s) que côté prof — pas de nouveau canal de communication.
+
+**Vérifié sur le serveur réel** (prof et élève jetables, sans VM réelle créée — session de lab montée directement en base, comme pour vérifier Quiz flash, pour ne pas consommer de capacité OpenStack juste pour tester) : le prof voit bien « Mode examen · 45 min » et la colonne Sorties dans le cockpit de sa classe ; l'élève, sur sa page de lab actif, voit le bandeau temps restant ; un événement `changement_onglet` posté par l'élève apparaît aussitôt chez le prof (passé de 0 à 1, en rouge) ; un type d'événement invalide est refusé (422) ; un élève ne peut pas poster sur la session d'un autre (403, déjà couvert par les tests). Classe de test supprimée, rien touché chez Adam.
+
+**Suite**
+
+Chantier « vrai cockpit » terminé : les quatre fonctions fictives du tableau de bord démo (quiz, devoirs, observations, examen) sont maintenant réelles. Reprendre le plan du bloc A (CLAUDE.md, section 2) là où il en était.

portail/app/Console/Commands/PurgerClassesArchivees.php

@@ -11,9 +11,10 @@ use Illuminate\Support\Facades\Log;
  * RGPD (CLAUDE.md, étape 14) : supprime les classes archivées depuis
  * 90 jours, avec en cascade leurs élèves, séances, sessions de lab, machines,
  * corrections, quiz et devoirs maison (chantier « vrai cockpit »), ainsi que
- * les annonces, observations et le chat élève ↔ prof (séparation vitrine/
- * application, 2026-10-13). Le compte du prof est conservé. Le journal ne
- * garde que des identifiants et des nombres, jamais de nom d'élève.
+ * les annonces, observations, le chat élève ↔ prof (séparation vitrine/
+ * application, 2026-10-13) et les événements d'examen (2026-10-14). Le
+ * compte du prof est conservé. Le journal ne garde que des identifiants et
+ * des nombres, jamais de nom d'élève.
  *
  * Les sauvegardes chiffrées contenant encore ces données expirent d'elles-
  * mêmes au plus 4 semaines plus tard (rotation, docs/runbooks/sauvegardes.md).

portail/app/Http/Controllers/ClasseController.php

@@ -44,7 +44,7 @@ class ClasseController extends Controller
         // d'attente, la plus récemment démarrée d'abord.
         $seance = $classe->seances()
             ->whereIn('statut', [Seance::SALLE_ATTENTE, Seance::EN_COURS])
-            ->with(['lab', 'labSessions' => fn ($q) => $q->with(['eleve', 'derniereCorrection', 'machines'])])
+            ->with(['lab', 'labSessions' => fn ($q) => $q->with(['eleve', 'derniereCorrection', 'machines', 'evenementsExamen'])])
             ->latest('demarree_a')
             ->get()
             ->sortByDesc(fn ($s) => $s->statut === Seance::EN_COURS)

portail/app/Http/Controllers/EvenementExamenController.php

@@ -0,0 +1,35 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Models\EvenementExamen;
+use App\Models\LabSession;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Auth;
+
+/**
+ * Surveillance d'examen (chantier « vrai cockpit », 2026-10-14) : le
+ * navigateur de l'élève signale un changement d'onglet ou une sortie du
+ * plein écran. Jamais de capture d'écran ni de webcam — juste un type et
+ * un horodatage (CLAUDE.md : minimisation).
+ */
+class EvenementExamenController extends Controller
+{
+    public function store(Request $request, LabSession $labSession): JsonResponse
+    {
+        $eleve = Auth::guard('eleve')->user();
+        abort_if($labSession->eleve_id !== $eleve->id, 403);
+
+        $seance = $labSession->seance;
+        abort_unless($seance->mode_examen, 403);
+
+        $donnees = $request->validate([
+            'type' => ['required', 'in:'.implode(',', [EvenementExamen::CHANGEMENT_ONGLET, EvenementExamen::SORTIE_PLEIN_ECRAN])],
+        ]);
+
+        $labSession->evenementsExamen()->create($donnees);
+
+        return response()->json([], 201);
+    }
+}

portail/app/Http/Controllers/SeanceController.php

@@ -31,8 +31,12 @@ class SeanceController extends Controller
         $donnees = $request->validate([
             'lab_id' => ['required', 'exists:labs,id'],
             'prevue_a' => ['nullable', 'date_format:Y-m-d\TH:i'],
+            'mode_examen' => ['nullable', 'boolean'],
+            'duree_examen_min' => ['required_if:mode_examen,1', 'nullable', 'integer', 'min:5', 'max:300'],
         ]);
 
+        $modeExamen = $request->boolean('mode_examen');
+
         if (! empty($donnees['prevue_a'])) {
             $prevueA = Carbon::createFromFormat('Y-m-d\TH:i', $donnees['prevue_a'], config('app.fuseau_utilisateurs'))->utc();
 
@@ -44,6 +48,8 @@ class SeanceController extends Controller
                 'lab_id' => $donnees['lab_id'],
                 'statut' => Seance::PLANIFIEE,
                 'prevue_a' => $prevueA,
+                'mode_examen' => $modeExamen,
+                'duree_examen_min' => $modeExamen ? $donnees['duree_examen_min'] : null,
             ]);
 
             return redirect()->route('mes-classes.show', $classe)->with('seance_planifiee', true);
@@ -53,6 +59,8 @@ class SeanceController extends Controller
             'lab_id' => $donnees['lab_id'],
             'statut' => Seance::SALLE_ATTENTE,
             'demarree_a' => now(),
+            'mode_examen' => $modeExamen,
+            'duree_examen_min' => $modeExamen ? $donnees['duree_examen_min'] : null,
         ]);
 
         return redirect()->route('seances.attente', $seance);
@@ -74,7 +82,7 @@ class SeanceController extends Controller
         abort_if($seance->classe->user_id !== Auth::guard('web')->id(), 403);
 
         return view('seances.attente', [
-            'seance' => $seance->load(['classe', 'lab', 'labSessions.eleve', 'labSessions.machines', 'labSessions.derniereCorrection']),
+            'seance' => $seance->load(['classe', 'lab', 'labSessions.eleve', 'labSessions.machines', 'labSessions.derniereCorrection', 'labSessions.evenementsExamen']),
         ]);
     }
 
@@ -107,7 +115,7 @@ class SeanceController extends Controller
             ->update([
                 'etat' => LabSession::ADMIS,
                 'raison_echec' => null,
-                'expire_a' => now()->addMinutes($labSession->lab->duree_min ?? 45),
+                'expire_a' => now()->addMinutes($seance->mode_examen ? $seance->duree_examen_min : ($labSession->lab->duree_min ?? 45)),
             ]);
 
         if ($pris === 0) {

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

portail/database/migrations/2026_10_14_150000_add_mode_examen_to_seances_table.php

@@ -0,0 +1,31 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+/**
+ * Surveillance d'examen (chantier « vrai cockpit », dernière étape,
+ * 2026-10-14) : une séance peut être lancée en mode examen, avec une
+ * durée dédiée (pas celle du lab, choisie par le prof pour l'occasion).
+ * Choix d'Adam, après discussion des options : suivi chronométré +
+ * détection de changement d'onglet + tentative de plein écran — jamais
+ * de capture d'écran ni de webcam.
+ */
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::table('seances', function (Blueprint $table) {
+            $table->boolean('mode_examen')->default(false)->after('statut');
+            $table->unsignedSmallInteger('duree_examen_min')->nullable()->after('mode_examen');
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::table('seances', function (Blueprint $table) {
+            $table->dropColumn(['mode_examen', 'duree_examen_min']);
+        });
+    }
+};

portail/database/migrations/2026_10_14_150001_create_evenements_examen_table.php

@@ -0,0 +1,29 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+/**
+ * Journal des sorties détectées pendant un examen (onglet changé, plein
+ * écran quitté) : seulement un type et un horodatage, jamais de capture
+ * d'écran ni de contenu. Minimisation (CLAUDE.md) : rien d'autre n'est
+ * collecté sur l'élève.
+ */
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::create('evenements_examen', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('lab_session_id')->constrained()->cascadeOnDelete();
+            $table->string('type')->comment('changement_onglet, sortie_plein_ecran');
+            $table->timestamps();
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::dropIfExists('evenements_examen');
+    }
+};

portail/resources/views/mes-classes/show.blade.php

@@ -153,7 +153,11 @@
             {{-- Vraies données de la séance en cours : un élève, son état, sa dernière vérification. --}}
             <section class="mt-6 rounded-lg border border-[#dadce0] bg-white" aria-labelledby="t-seance-encours">
                 <div class="flex flex-wrap items-center justify-between gap-3 border-b border-[#e3e5e8] p-4">
-                    <h2 id="t-seance-encours" class="text-lg font-extrabold">{{ $seance->lab->titre }} — {{ $seance->statut === \App\Models\Seance::EN_COURS ? 'en cours' : 'salle d\'attente' }}</h2>
+                    <h2 id="t-seance-encours" class="text-lg font-extrabold">{{ $seance->lab->titre }} — {{ $seance->statut === \App\Models\Seance::EN_COURS ? 'en cours' : 'salle d\'attente' }}
+                        @if ($seance->mode_examen)
+                            <span class="rounded-lg border border-[#A63D2A] bg-[#fce8e6] px-2 py-0.5 font-mono text-xs font-bold align-middle">Mode examen · {{ $seance->duree_examen_min }} min</span>
+                        @endif
+                    </h2>
                     <span class="flex flex-wrap gap-2">
                         <a href="{{ route('seances.attente', $seance) }}" class="inline-flex h-10 items-center rounded-lg border border-[#dadce0] px-4 text-sm font-extrabold hover:bg-[#f8f9fa]">Salle d'attente</a>
                         <a href="{{ route('seances.visio.prof', $seance) }}" class="inline-flex h-10 items-center rounded-lg bg-[#0b57d0] px-4 text-sm font-extrabold text-white">{{ $seance->visioOuverte() ? 'Rejoindre la visio' : 'Lancer la visio' }}</a>
@@ -164,7 +168,9 @@
                 @else
                     <div class="overflow-x-auto"><table class="w-full min-w-[640px] border-collapse text-left text-sm">
                         <thead class="border-b border-[#e3e5e8] bg-[#f8f9fa] font-mono text-[11px] uppercase tracking-wider">
-                            <tr><th class="px-4 py-3 font-semibold">Élève</th><th class="px-4 py-3 font-semibold">État</th><th class="px-4 py-3 font-semibold">Dernière vérification</th><th class="px-4 py-3 font-semibold"></th></tr>
+                            <tr><th class="px-4 py-3 font-semibold">Élève</th><th class="px-4 py-3 font-semibold">État</th><th class="px-4 py-3 font-semibold">Dernière vérification</th>
+                                @if ($seance->mode_examen)<th class="px-4 py-3 font-semibold">Sorties</th>@endif
+                                <th class="px-4 py-3 font-semibold"></th></tr>
                         </thead>
                         <tbody class="divide-y divide-[#e3e5e8]">
                             @foreach ($seance->labSessions as $labSession)
@@ -195,6 +201,15 @@
                                             —
                                         @endif
                                     </td>
+                                    @if ($seance->mode_examen)
+                                        <td class="px-4 py-3 font-mono font-semibold">
+                                            @if ($labSession->evenementsExamen->isNotEmpty())
+                                                <span class="text-[#A63D2A]">{{ $labSession->evenementsExamen->count() }}</span>
+                                            @else
+                                                0
+                                            @endif
+                                        </td>
+                                    @endif
                                     <td class="px-4 py-3 text-right">
                                         @if ($labSession->etat === $etats::ACTIF)
                                             <a href="{{ route('seances.console.prof.page', [$seance, $labSession]) }}" class="font-bold underline underline-offset-4">Voir sa console</a>
@@ -414,7 +429,7 @@
             @if (session('seance_planifiee'))
                 <p class="mt-4 rounded-lg border border-[#e3e5e8] bg-[#e6f4ea] p-4 font-semibold">Séance planifiée.</p>
             @endif
-            <form action="{{ route('mes-classes.seances.store', $classe) }}" method="post" class="mt-4 flex flex-wrap items-end gap-3">
+            <form action="{{ route('mes-classes.seances.store', $classe) }}" method="post" class="mt-4 flex flex-wrap items-end gap-3" id="form-seance">
                 @csrf
                 <label class="grid gap-1 font-bold">Lab<select name="lab_id" required class="rounded-xl border border-[#c4c7c5] bg-white px-3 py-2 font-semibold">
                     @foreach (\App\Models\Lab::orderBy('titre')->get() as $lab)
@@ -422,11 +437,17 @@
                     @endforeach
                 </select></label>
                 <label class="grid gap-1 font-bold">Date et heure (facultatif)<input type="datetime-local" name="prevue_a" value="{{ old('prevue_a') }}" class="rounded-xl border border-[#c4c7c5] bg-white px-3 py-2 font-semibold"></label>
+                <label class="flex items-center gap-2 font-bold"><input type="checkbox" name="mode_examen" value="1" id="case-mode-examen"> Mode examen</label>
+                <label class="grid gap-1 font-bold" id="champ-duree-examen" hidden>Durée (minutes)<input type="number" name="duree_examen_min" min="5" max="300" value="{{ old('duree_examen_min', 60) }}" class="w-28 rounded-xl border border-[#c4c7c5] bg-white px-3 py-2 font-semibold"></label>
                 <button type="submit" class="inline-flex h-11 items-center justify-center rounded-full bg-black px-5 font-bold text-white">Ouvrir ou planifier</button>
             </form>
             @error('prevue_a')
                 <p class="mt-2 font-semibold text-[#A63D2A]">{{ $message }}</p>
             @enderror
+            @error('duree_examen_min')
+                <p class="mt-2 font-semibold text-[#A63D2A]">{{ $message }}</p>
+            @enderror
+            <p class="mt-2 text-sm font-semibold text-[#5f6368]">Mode examen : chronométré, détecte les changements d'onglet et propose le plein écran. Ça ne bloque pas vraiment l'élève — un navigateur ne le permet pas — mais tu vois les sorties.</p>
 
             @php($planifiees = $classe->seances()->where('statut', \App\Models\Seance::PLANIFIEE)->with('lab')->orderBy('prevue_a')->get())
             @if ($planifiees->isNotEmpty())
@@ -489,6 +510,10 @@
             if (!occupe) location.reload();
         }, 15000);
     @endif
+    var caseModeExamen = document.getElementById('case-mode-examen');
+    if (caseModeExamen) caseModeExamen.addEventListener('change', function () {
+        document.getElementById('champ-duree-examen').hidden = !caseModeExamen.checked;
+    });
     document.querySelectorAll('[data-imprimer]').forEach(function (b) { b.addEventListener('click', function () { window.print(); }); });
     document.querySelectorAll('form[data-confirmer]').forEach(function (f) {
         f.addEventListener('submit', function (e) { if (!window.confirm(f.dataset.confirmer)) e.preventDefault(); });

portail/resources/views/seances/attente-eleve.blade.php

@@ -26,6 +26,13 @@
                 <p class="mt-4 font-semibold">Ton prof le voit et peut relancer. Cette page se mettra à jour toute seule.</p>
             </div>
         @elseif ($labSession->etat === $etats::ACTIF && $labSession->machines->isNotEmpty())
+            @if ($seance->mode_examen)
+                <div id="bandeau-examen" class="mb-4 flex flex-wrap items-center justify-between gap-3 rounded-2xl border border-[#A63D2A] bg-[#fce8e6] p-4">
+                    <p class="font-extrabold">Mode examen · temps restant : <span id="temps-restant" class="font-mono">…</span></p>
+                    <button type="button" id="bouton-plein-ecran" class="inline-flex h-10 items-center rounded-full bg-black px-4 font-bold text-white">Passer en plein écran</button>
+                </div>
+                <p class="mb-4 text-sm font-semibold text-[#5f6368]">Reste sur cette page : les changements d'onglet et les sorties du plein écran sont signalés à ton prof.</p>
+            @endif
             <h1 class="mt-2 text-3xl font-extrabold tracking-tight">Tes machines</h1>
             <div class="mt-4 flex gap-2" role="tablist">
                 @foreach ($labSession->machines as $i => $machine)
@@ -96,6 +103,43 @@
                 @endforeach
                 });
             </script>
+            @if ($seance->mode_examen)
+                <script nonce="{{ Vite::cspNonce() }}">
+                (function () {
+                    var finA = new Date(@json($labSession->expire_a?->toIso8601String()));
+                    var URL_EVENEMENT = @json(route('lab-sessions.evenements-examen', $labSession));
+                    var CSRF = @json(csrf_token());
+
+                    function signaler(type) {
+                        fetch(URL_EVENEMENT, {
+                            method: 'POST', keepalive: true,
+                            headers: { 'X-CSRF-TOKEN': CSRF, 'Content-Type': 'application/json', Accept: 'application/json' },
+                            body: JSON.stringify({ type: type }),
+                        }).catch(function () {});
+                    }
+
+                    function mettreAJourTemps() {
+                        var restantMs = finA - new Date();
+                        var affichage = document.getElementById('temps-restant');
+                        if (restantMs <= 0) { affichage.textContent = '0 min'; location.reload(); return; }
+                        affichage.textContent = Math.ceil(restantMs / 60000) + ' min';
+                    }
+                    mettreAJourTemps();
+                    setInterval(mettreAJourTemps, 10000);
+
+                    document.getElementById('bouton-plein-ecran').addEventListener('click', function () {
+                        if (document.documentElement.requestFullscreen) document.documentElement.requestFullscreen().catch(function () {});
+                    });
+
+                    document.addEventListener('visibilitychange', function () {
+                        if (document.hidden) signaler('changement_onglet');
+                    });
+                    document.addEventListener('fullscreenchange', function () {
+                        if (!document.fullscreenElement) signaler('sortie_plein_ecran');
+                    });
+                })();
+                </script>
+            @endif
         @else
             <div class="py-20 text-center">
                 <h1 class="text-4xl font-extrabold tracking-tight">Cette séance est terminée pour toi</h1>

portail/resources/views/seances/attente.blade.php

@@ -8,7 +8,11 @@
     <meta http-equiv="refresh" content="10">
     <div class="mx-auto max-w-4xl px-5 py-14 lg:px-10">
         <p class="font-mono text-sm font-semibold">{{ $seance->classe->nom }} · {{ $seance->lab->titre }}</p>
-        <h1 class="mt-1 text-4xl font-extrabold tracking-tight">Salle d'attente</h1>
+        <h1 class="mt-1 text-4xl font-extrabold tracking-tight">Salle d'attente
+            @if ($seance->mode_examen)
+                <span class="rounded-lg border border-[#A63D2A] bg-[#fce8e6] px-2 py-0.5 align-middle font-mono text-sm font-bold">Mode examen · {{ $seance->duree_examen_min }} min</span>
+            @endif
+        </h1>
         <p class="mt-2 font-semibold">La page se rafraîchit toutes les 10 secondes.</p>
         <p class="mt-4"><a href="{{ route('seances.visio.prof', $seance) }}" class="inline-flex h-11 items-center rounded-full bg-[#0b57d0] px-5 font-bold text-white">{{ $seance->visioOuverte() ? 'Retourner à la visio' : 'Visio de la classe' }}</a></p>
 
@@ -38,6 +42,12 @@
                                         </span>
                                     @endif
                                     <a href="{{ route('seances.console.prof.page', [$seance, $labSession]) }}" class="font-bold underline underline-offset-4">Voir sa console</a>
+                                    @if ($seance->mode_examen)
+                                        <span class="font-mono text-sm font-bold {{ $labSession->evenementsExamen->isNotEmpty() ? 'text-[#A63D2A]' : '' }}">{{ $labSession->evenementsExamen->count() }} sortie(s)</span>
+                                        @if ($labSession->minutesRestantes() !== null)
+                                            <span class="font-mono text-sm font-bold">{{ $labSession->minutesRestantes() }} min restantes</span>
+                                        @endif
+                                    @endif
                                     @break
                                 @case($etats::ECHEC)
                                     <span class="rounded-lg border border-[#A63D2A] bg-[#fce8e6] px-3 py-1 font-mono text-sm font-bold" title="{{ $labSession->raison_echec }}">Échec du lancement (3 essais)</span>

portail/routes/web.php

@@ -15,6 +15,7 @@ use App\Http\Controllers\DevoirController;
 use App\Http\Controllers\DevoirEleveController;
 use App\Http\Controllers\EleveTableauDeBordController;
 use App\Http\Controllers\EmploiDuTempsController;
+use App\Http\Controllers\EvenementExamenController;
 use App\Http\Controllers\InscriptionController;
 use App\Http\Controllers\MaClasseController;
 use App\Http\Controllers\MesCoursController;
@@ -140,6 +141,11 @@ Route::middleware(['auth:eleve', 'session.unique:eleve', 'maj.activite'])->group
         ->name('lab-sessions.corriger');
     Route::post('/lab-sessions/{labSession}/machines/{labSessionMachine}/console', [ConsoleController::class, 'pourEleve'])->name('console.eleve');
 
+    // Chantier « vrai cockpit », dernière étape : Surveillance d'examen.
+    Route::post('/lab-sessions/{labSession}/evenements-examen', [EvenementExamenController::class, 'store'])
+        ->middleware('throttle:20,1')
+        ->name('lab-sessions.evenements-examen');
+
     // Chantier « vrai cockpit », étape 2 : Quiz flash.
     Route::get('/quiz-flash/etat', [QuizEleveController::class, 'etat'])->name('quiz.eleve.etat');
     Route::post('/sessions-quiz/{session}/repondre', [QuizEleveController::class, 'repondre'])

portail/tests/Feature/SurveillanceExamenTest.php

@@ -0,0 +1,126 @@
+<?php
+
+use App\Models\Classe;
+use App\Models\Eleve;
+use App\Models\EvenementExamen;
+use App\Models\Lab;
+use App\Models\LabSession;
+use App\Models\Seance;
+use App\Services\Labs\StockChaud;
+use Illuminate\Support\Facades\Process;
+use Illuminate\Support\Facades\Queue;
+
+function labSessionEnAttenteExamen(int $dureeExamenMin = 60): LabSession
+{
+    $classe = Classe::factory()->create();
+    $lab = Lab::factory()->create(['identifiant' => '08-deux-lan-routeur']);
+    $seance = Seance::create([
+        'classe_id' => $classe->id,
+        'lab_id' => $lab->id,
+        'statut' => Seance::SALLE_ATTENTE,
+        'demarree_a' => now(),
+        'mode_examen' => true,
+        'duree_examen_min' => $dureeExamenMin,
+    ]);
+    $eleve = Eleve::factory()->create(['classe_id' => $classe->id]);
+
+    return LabSession::create(['seance_id' => $seance->id, 'eleve_id' => $eleve->id, 'lab_id' => $lab->id, 'etat' => LabSession::EN_ATTENTE]);
+}
+
+test("admettre un élève en mode examen utilise la durée de l'examen, pas celle du lab", function () {
+    Queue::fake();
+    $this->mock(StockChaud::class, function ($stock) {
+        $stock->shouldReceive('prendre')->once()->andReturn(null);
+    });
+    $session = labSessionEnAttenteExamen(dureeExamenMin: 90);
+
+    admettre($this, $session)->assertRedirect();
+
+    $session->refresh();
+    expect(now()->diffInMinutes($session->expire_a))->toBeGreaterThan(85)
+        ->and(now()->diffInMinutes($session->expire_a))->toBeLessThanOrEqual(90);
+});
+
+test("un élève signale un événement d'examen sur sa propre session", function () {
+    $session = labSessionEnAttenteExamen();
+    $session->update(['etat' => LabSession::ACTIF]);
+
+    eleve($this, $session->eleve)
+        ->postJson(route('lab-sessions.evenements-examen', $session), ['type' => 'changement_onglet'])
+        ->assertCreated();
+
+    expect($session->evenementsExamen()->count())->toBe(1)
+        ->and($session->evenementsExamen()->first()->type)->toBe(EvenementExamen::CHANGEMENT_ONGLET);
+});
+
+test("un élève ne peut pas signaler un événement sur la session d'un autre élève", function () {
+    $session = labSessionEnAttenteExamen();
+    $intrus = Eleve::factory()->create();
+
+    eleve($this, $intrus)
+        ->postJson(route('lab-sessions.evenements-examen', $session), ['type' => 'changement_onglet'])
+        ->assertForbidden();
+
+    expect($session->evenementsExamen()->count())->toBe(0);
+});
+
+test("pas d'événement d'examen possible sur une séance normale (mode examen désactivé)", function () {
+    $session = sessionEnAttente();
+    $session->update(['etat' => LabSession::ACTIF]);
+
+    eleve($this, $session->eleve)
+        ->postJson(route('lab-sessions.evenements-examen', $session), ['type' => 'changement_onglet'])
+        ->assertForbidden();
+});
+
+test('type invalide refusé', function () {
+    $session = labSessionEnAttenteExamen();
+    $session->update(['etat' => LabSession::ACTIF]);
+
+    eleve($this, $session->eleve)
+        ->postJson(route('lab-sessions.evenements-examen', $session), ['type' => 'webcam_allumee'])
+        ->assertUnprocessable();
+});
+
+test('purger une classe archivée supprime aussi les événements d’examen', function () {
+    $session = labSessionEnAttenteExamen();
+    $session->update(['etat' => LabSession::TERMINE]);
+    $session->evenementsExamen()->create(['type' => EvenementExamen::SORTIE_PLEIN_ECRAN]);
+
+    $classe = $session->seance->classe;
+    $classe->forceFill(['archivee_a' => now()->subDays(91)])->save();
+    $this->artisan('classes:purger-archivees');
+
+    expect(EvenementExamen::count())->toBe(0);
+});
+
+test('les scripts en ligne du mode examen (barre prof et page élève) sont du JavaScript valide', function () {
+    if (Process::run('node --version')->failed()) {
+        $this->markTestSkipped('Node absent');
+    }
+
+    $session = labSessionEnAttenteExamen();
+    $session->update(['etat' => LabSession::ACTIF]);
+    $session->machines()->create(['nom' => 'pc-a', 'instance_id' => 'uuid-a']);
+
+    $pages = [
+        fn () => prof($this, $session->seance->classe->prof)->get(route('mes-classes.show', $session->seance->classe)),
+        fn () => eleve($this, $session->eleve)->get(route('seances.eleve.attente', $session->seance)),
+    ];
+
+    $erreurs = [];
+    foreach ($pages as $i => $visite) {
+        preg_match_all('#<script(?![^>]*\bsrc=)[^>]*>(.*?)</script>#s', $visite()->getContent(), $scripts);
+        foreach ($scripts[1] as $j => $code) {
+            $fichier = tempnam(sys_get_temp_dir(), 'js').'.js';
+            file_put_contents($fichier, $code);
+            $resultat = Process::run(['node', '--check', $fichier]);
+            unlink($fichier);
+            if ($resultat->failed()) {
+                $erreurs[] = "page {$i} script {$j} : ".strtok($resultat->errorOutput(), "\n");
+            }
+        }
+    }
+
+    expect($erreurs)->toBe([]);
+});