ajoute les alertes Prometheus du self-healing et installe Larastan (dette de l'étape 8, 72 erreurs corrigées à la racine)

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

portail/app/Models/Classe.php

@@ -2,15 +2,17 @@
 
 namespace App\Models;
 
+use Carbon\Carbon;
+use Database\Factories\ClasseFactory;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Database\Eloquent\Relations\HasMany;
-use Illuminate\Support\Carbon;
 use Illuminate\Support\Str;
 
 class Classe extends Model
 {
+    /** @use HasFactory<ClasseFactory> */
     use HasFactory;
 
     protected $fillable = ['etablissement_id', 'user_id', 'nom', 'formation', 'code_classe'];
@@ -35,26 +37,31 @@ class Classe extends Model
         return $code;
     }
 
+    /** @return BelongsTo<Etablissement, $this> */
     public function etablissement(): BelongsTo
     {
         return $this->belongsTo(Etablissement::class);
     }
 
+    /** @return BelongsTo<User, $this> */
     public function prof(): BelongsTo
     {
         return $this->belongsTo(User::class, 'user_id');
     }
 
+    /** @return HasMany<Eleve, $this> */
     public function eleves(): HasMany
     {
         return $this->hasMany(Eleve::class);
     }
 
+    /** @return HasMany<DemandeInscription, $this> */
     public function demandesInscription(): HasMany
     {
         return $this->hasMany(DemandeInscription::class);
     }
 
+    /** @return HasMany<Seance, $this> */
     public function seances(): HasMany
     {
         return $this->hasMany(Seance::class);

portail/app/Models/Correction.php

@@ -19,6 +19,7 @@ class Correction extends Model
         'details' => 'array',
     ];
 
+    /** @return BelongsTo<LabSession, $this> */
     public function labSession(): BelongsTo
     {
         return $this->belongsTo(LabSession::class);

portail/app/Models/DemandeInscription.php

@@ -30,11 +30,13 @@ class DemandeInscription extends Model
         'code_secret_chiffre' => 'encrypted',
     ];
 
+    /** @return BelongsTo<Classe, $this> */
     public function classe(): BelongsTo
     {
         return $this->belongsTo(Classe::class);
     }
 
+    /** @return BelongsTo<Eleve, $this> */
     public function eleve(): BelongsTo
     {
         return $this->belongsTo(Eleve::class);
@@ -45,6 +47,7 @@ class DemandeInscription extends Model
         return hash('sha256', $jeton);
     }
 
+    /** @return Builder<self> */
     public function prunable(): Builder
     {
         return static::where('created_at', '<', now()->subHour());

portail/app/Models/Eleve.php

@@ -3,6 +3,7 @@
 namespace App\Models;
 
 use App\Models\Concerns\GereSessionUnique;
+use Database\Factories\EleveFactory;
 use Illuminate\Auth\Authenticatable;
 use Illuminate\Contracts\Auth\Authenticatable as AuthenticatableContract;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
@@ -12,6 +13,7 @@ use Illuminate\Database\Eloquent\Relations\HasMany;
 
 class Eleve extends Model implements AuthenticatableContract
 {
+    /** @use HasFactory<EleveFactory> */
     use Authenticatable, GereSessionUnique, HasFactory;
 
     protected $fillable = ['classe_id', 'prenom', 'nom', 'identifiant', 'code_secret', 'jeton_qr'];
@@ -27,11 +29,13 @@ class Eleve extends Model implements AuthenticatableContract
         return 'code_secret';
     }
 
+    /** @return BelongsTo<Classe, $this> */
     public function classe(): BelongsTo
     {
         return $this->belongsTo(Classe::class);
     }
 
+    /** @return HasMany<LabSession, $this> */
     public function labSessions(): HasMany
     {
         return $this->hasMany(LabSession::class);

portail/app/Models/Etablissement.php

@@ -2,21 +2,25 @@
 
 namespace App\Models;
 
+use Database\Factories\EtablissementFactory;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\HasMany;
 
 class Etablissement extends Model
 {
+    /** @use HasFactory<EtablissementFactory> */
     use HasFactory;
 
     protected $fillable = ['nom', 'ville', 'uai'];
 
+    /** @return HasMany<User, $this> */
     public function profs(): HasMany
     {
         return $this->hasMany(User::class);
     }
 
+    /** @return HasMany<Classe, $this> */
     public function classes(): HasMany
     {
         return $this->hasMany(Classe::class);

portail/app/Models/Lab.php

@@ -2,16 +2,19 @@
 
 namespace App\Models;
 
+use Database\Factories\LabFactory;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\HasMany;
 
 class Lab extends Model
 {
+    /** @use HasFactory<LabFactory> */
     use HasFactory;
 
     protected $fillable = ['identifiant', 'titre', 'niveau', 'duree_min'];
 
+    /** @return HasMany<Seance, $this> */
     public function seances(): HasMany
     {
         return $this->hasMany(Seance::class);

portail/app/Models/LabSession.php

@@ -2,7 +2,6 @@
 
 namespace App\Models;
 
-use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Database\Eloquent\Relations\HasMany;
@@ -11,8 +10,6 @@ use Illuminate\Support\Facades\DB;
 
 class LabSession extends Model
 {
-    use HasFactory;
-
     public const EN_ATTENTE = 'en_attente';
 
     // Admis par le prof : CreerStackLab est dispatché, la stack Heat se construit.
@@ -35,21 +32,25 @@ class LabSession extends Model
         'expire_a' => 'datetime',
     ];
 
+    /** @return BelongsTo<Seance, $this> */
     public function seance(): BelongsTo
     {
         return $this->belongsTo(Seance::class);
     }
 
+    /** @return BelongsTo<Eleve, $this> */
     public function eleve(): BelongsTo
     {
         return $this->belongsTo(Eleve::class);
     }
 
+    /** @return BelongsTo<Lab, $this> */
     public function lab(): BelongsTo
     {
         return $this->belongsTo(Lab::class);
     }
 
+    /** @return HasMany<LabSessionMachine, $this> */
     public function machines(): HasMany
     {
         return $this->hasMany(LabSessionMachine::class);
@@ -79,11 +80,13 @@ class LabSession extends Model
         });
     }
 
+    /** @return HasMany<Correction, $this> */
     public function corrections(): HasMany
     {
         return $this->hasMany(Correction::class);
     }
 
+    /** @return HasOne<Correction, $this> */
     public function derniereCorrection(): HasOne
     {
         return $this->hasOne(Correction::class)->latestOfMany();

portail/app/Models/LabSessionMachine.php

@@ -2,14 +2,11 @@
 
 namespace App\Models;
 
-use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 
 class LabSessionMachine extends Model
 {
-    use HasFactory;
-
     // Self-healing (SurveillanceVm) : la VM a été relancée automatiquement,
     // ou ne répond plus malgré les relances.
     public const RELANCEE = 'relancee';
@@ -22,6 +19,7 @@ class LabSessionMachine extends Model
         'sante_a' => 'datetime',
     ];
 
+    /** @return BelongsTo<LabSession, $this> */
     public function labSession(): BelongsTo
     {
         return $this->belongsTo(LabSession::class);

portail/app/Models/Seance.php

@@ -2,15 +2,16 @@
 
 namespace App\Models;
 
-use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Database\Eloquent\Relations\HasMany;
 
+/**
+ * @property-read int|null $servies_count Nombre de LabSession déjà admises/actives/terminées/expirées, uniquement
+ *   quand chargé par `withCount('labSessions as servies_count', ...)` (StockChaud::cible()).
+ */
 class Seance extends Model
 {
-    use HasFactory;
-
     public const PLANIFIEE = 'planifiee';
 
     public const SALLE_ATTENTE = 'salle_attente';
@@ -34,16 +35,19 @@ class Seance extends Model
         return $this->visio_ouverte_a !== null && $this->visio_salle !== null;
     }
 
+    /** @return BelongsTo<Classe, $this> */
     public function classe(): BelongsTo
     {
         return $this->belongsTo(Classe::class);
     }
 
+    /** @return BelongsTo<Lab, $this> */
     public function lab(): BelongsTo
     {
         return $this->belongsTo(Lab::class);
     }
 
+    /** @return HasMany<LabSession, $this> */
     public function labSessions(): HasMany
     {
         return $this->hasMany(LabSession::class);

portail/app/Models/User.php

@@ -33,11 +33,13 @@ class User extends Authenticatable
         ];
     }
 
+    /** @return BelongsTo<Etablissement, $this> */
     public function etablissement(): BelongsTo
     {
         return $this->belongsTo(Etablissement::class);
     }
 
+    /** @return HasMany<Classe, $this> */
     public function classes(): HasMany
     {
         return $this->hasMany(Classe::class);