Develop

.github/workflows/ci.yml

@@ -52,6 +52,43 @@ jobs:
       - name: Lancer la suite de tests
         run: php artisan test
 
+  static-analysis:
+    name: Analyse statique (PHPStan)
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Configurer PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.3'
+          extensions: pdo_sqlite, sqlite3, mbstring, zip, gd, intl, bcmath
+          coverage: none
+
+      # `.env` doit exister AVANT composer install : le script post-autoload-dump
+      # (`package:discover`) boote l'application.
+      - name: Préparer l'environnement
+        run: |
+          cp .env.example .env
+          touch database/database.sqlite
+
+      - name: Cache des dépendances Composer
+        uses: actions/cache@v4
+        with:
+          path: vendor
+          key: composer-${{ hashFiles('composer.lock') }}
+          restore-keys: composer-
+
+      - name: Installer les dépendances
+        run: composer install --no-interaction --prefer-dist --no-progress
+
+      - name: Générer la clé applicative
+        run: php artisan key:generate
+
+      - name: Lancer PHPStan
+        run: composer analyse
+
   frontend:
     name: Front (types & build)
     runs-on: ubuntu-latest

CHANGELOG.md

@@ -4,6 +4,30 @@ Toutes les évolutions notables de **Dalibi** sont consignées ici.
 Le format suit [Keep a Changelog](https://keepachangelog.com/fr/1.1.0/) et le versionnage
 respecte [SemVer](https://semver.org/lang/fr/).
 
+## [1.0.2] — 2026-11-13
+
+### Ajouté
+- **Internationalisation (i18n)** : bascule complète **français / anglais** de l'ensemble
+  des modules (interface, écrans et composants partagés), avec fichiers de langue dédiés
+  et partage des traductions côté client via Inertia.
+
+### Sécurité
+- Montée des dépendances résorbant **67 avis de sécurité** (`composer audit` désormais
+  vierge), dont le **bypass d'authentification TokenGuard** de Laravel
+  ([CVE-2026-114509](https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2026-114509),
+  critique — pertinent pour l'auth par jeton du portail) : Laravel 12.72, Symfony 7.4.23,
+  Guzzle 7.16, CommonMark 2.10, dompdf 3.1.6, ainsi que les montées majeures
+  phpoffice/phpspreadsheet 5 et maatwebsite/excel 4.
+
+### Qualité & documentation
+- **Analyse statique** : intégration de **PHPStan / Larastan niveau 5** avec étape CI
+  dédiée, puis résorption **intégrale de la dette** (463 → 0 erreur, sans fichier
+  *baseline*) — typage générique des relations Eloquent, formes des résultats d'agrégats,
+  authentification multi-modèle du portail (élève / tuteur).
+- Corrections de **bugs réels** mis au jour par l'analyse : contrainte `withSum` ignorée
+  sur les totaux de caisse, libellé d'archive d'élève vide, positionnement de colonne en
+  migration, comparaison d'identifiant UUID, accès nullsafe rétablis sur les seeders.
+
 ## [1.0.1] — 2026-10-11
 
 ### Ajouté

app/Concerns/Auditable.php

@@ -3,7 +3,6 @@
 namespace App\Concerns;
 
 use App\Models\AuditLog;
-use Illuminate\Database\Eloquent\Model;
 
 /**
  * Enregistre automatiquement les créations / modifications / suppressions
@@ -16,9 +15,9 @@ trait Auditable
 {
     public static function bootAuditable(): void
     {
-        static::created(fn (Model $model) => $model->recordAudit('created', null, $model->auditableAttributes()));
+        static::created(fn (self $model) => $model->recordAudit('created', null, $model->auditableAttributes()));
 
-        static::updated(function (Model $model): void {
+        static::updated(function (self $model): void {
             $changed = array_keys($model->getChanges());
             $keys = array_diff($changed, $model->auditExcluded());
             if ($keys === []) {
@@ -31,7 +30,7 @@ public static function bootAuditable(): void
             $model->recordAudit('updated', $old, $new);
         });
 
-        static::deleted(fn (Model $model) => $model->recordAudit('deleted', $model->auditableAttributes(), null));
+        static::deleted(fn (self $model) => $model->recordAudit('deleted', $model->auditableAttributes(), null));
     }
 
     /** Champs exclus du journal (secrets et bruit). */

app/Console/Commands/GenerateStudentMatricule.php

@@ -3,8 +3,8 @@
 namespace App\Console\Commands;
 
 use App\Models\Student;
-use App\Services\MatriculeService;
 use Illuminate\Console\Command;
+use Illuminate\Database\Eloquent\Collection;
 
 class GenerateStudentMatricule extends Command
 {
@@ -13,10 +13,10 @@ class GenerateStudentMatricule extends Command
      *
      * @var string
      */
-    protected $signature = 'matricule:generate-student 
+    protected $signature = 'matricule:generate-student
                             {--class-id= : ID de la classe}
                             {--all : Générer pour tous les élèves}
-                            {--registration : Générer aussi les numéros d\'enregistrement}
+                            {--matricule : Générer aussi les matricules des élèves}
                             {--force : Forcer la régénération}';
 
     /**
@@ -31,10 +31,9 @@ class GenerateStudentMatricule extends Command
      */
     public function handle(): int
     {
-        $matriculeService = app(MatriculeService::class);
+        $withStudentMatricule = (bool) $this->option('matricule');
 
         if ($this->option('all')) {
-            // Générer pour tous les élèves
             $students = Student::all();
 
             if ($students->isEmpty()) {
@@ -44,28 +43,7 @@ public function handle(): int
             }
 
             $this->info("Génération des matricules pour {$students->count()} élèves...");
-
-            $progressBar = $this->output->createProgressBar($students->count());
-            $progressBar->start();
-
-            foreach ($students as $student) {
-                // Générer matricule de l'utilisateur
-                if (! $student->user->natricule) {
-                    $student->user->natricule = $student->user->generateMatricule();
-                    $student->user->save();
-                }
-
-                // Générer numéro d'enregistrement
-                if (! $student->registration_number) {
-                    $student->registration_number = $student->generateRegistrationNumber();
-                    $student->save();
-                }
-
-                $progressBar->advance();
-            }
-
-            $progressBar->finish();
-            $this->newLine();
+            $this->backfillMatricules($students, $withStudentMatricule);
             $this->info('✅ Matricules générés avec succès!');
 
             return 0;
@@ -88,18 +66,32 @@ public function handle(): int
         }
 
         $this->info("Génération pour {$students->count()} élèves...");
+        $this->backfillMatricules($students, $withStudentMatricule);
+        $this->info('✅ Matricules générés avec succès!');
 
+        return 0;
+    }
+
+    /**
+     * Génère les matricules manquants pour un lot d'élèves.
+     *
+     * @param  Collection<int, Student>  $students
+     */
+    private function backfillMatricules(Collection $students, bool $withStudentMatricule): void
+    {
         $progressBar = $this->output->createProgressBar($students->count());
         $progressBar->start();
 
         foreach ($students as $student) {
+            // Matricule du compte utilisateur associé.
             if (! $student->user->natricule) {
                 $student->user->natricule = $student->user->generateMatricule();
                 $student->user->save();
             }
 
-            if (! $student->registration_number) {
-                $student->registration_number = $student->generateRegistrationNumber();
+            // Matricule de l'élève (optionnel, via --matricule).
+            if ($withStudentMatricule && empty($student->matricule)) {
+                $student->matricule = $student->generateMatricule();
                 $student->save();
             }
 
@@ -108,8 +100,5 @@ public function handle(): int
 
         $progressBar->finish();
         $this->newLine();
-        $this->info('✅ Matricules générés avec succès!');
-
-        return 0;
     }
 }

app/Constants/Locales.php

@@ -0,0 +1,60 @@
+<?php
+
+namespace App\Constants;
+
+/**
+ * Langues prises en charge par l'application (interface).
+ *
+ * Ajouter une langue = ajouter une entrée ici + les fichiers `lang/{code}/*.php`.
+ */
+class Locales
+{
+    /** Code de la langue par défaut. */
+    public const DEFAULT = 'fr';
+
+    /**
+     * @return array<string, array{label: string, flag: string}>
+     */
+    public static function all(): array
+    {
+        return [
+            'fr' => ['label' => 'Français', 'flag' => '🇫🇷'],
+            'en' => ['label' => 'English', 'flag' => '🇬🇧'],
+        ];
+    }
+
+    /** Codes valides (pour la validation). */
+    public static function codes(): array
+    {
+        return array_keys(self::all());
+    }
+
+    /** Le code est-il une langue prise en charge ? */
+    public static function isValid(?string $code): bool
+    {
+        return $code !== null && array_key_exists($code, self::all());
+    }
+
+    /** Libellé lisible d'un code (repli sur le code). */
+    public static function label(?string $code): string
+    {
+        $code = $code ?: self::DEFAULT;
+
+        return self::all()[$code]['label'] ?? $code;
+    }
+
+    /**
+     * Options prêtes pour un sélecteur côté frontend.
+     *
+     * @return array<int, array{code: string, label: string, flag: string}>
+     */
+    public static function options(): array
+    {
+        $out = [];
+        foreach (self::all() as $code => $def) {
+            $out[] = ['code' => $code, 'label' => $def['label'], 'flag' => $def['flag']];
+        }
+
+        return $out;
+    }
+}

app/Exports/StatisticsExport.php

@@ -3,10 +3,11 @@
 namespace App\Exports;
 
 use Illuminate\Support\Collection;
+use Maatwebsite\Excel\Concerns\Export;
 use Maatwebsite\Excel\Concerns\WithMultipleSheets;
 
 /** Construit un classeur Excel multi-feuilles à partir des données d'une section. */
-class StatisticsExport implements WithMultipleSheets
+class StatisticsExport implements Export, WithMultipleSheets
 {
     private const METHOD_LABELS = [
         'CASH' => 'Espèces',

app/Http/Controllers/Administration/SubjectAssignmentController.php

@@ -91,8 +91,8 @@ public function statistics(Request $request): Response
         $assignments = $selected
             ? $this->teacherAssignments($teacherId, $yearFilter)->map(fn ($a) => [
                 'id' => $a->id,
-                'subject' => $a->subject?->name ?? '—',
-                'classroom' => $a->classroom?->name ?? '—',
+                'subject' => $a->subject->name ?? '—',
+                'classroom' => $a->classroom->name ?? '—',
                 'active' => (bool) $a->active,
             ])
             : collect();
@@ -143,7 +143,7 @@ public function exportStatistics(Request $request)
             'assignments' => $this->teacherAssignments($teacher->id, $yearId),
         ])->setPaper('a4', 'portrait');
 
-        return $pdf->stream('affectations-'.Str::slug(trim($teacher->firstname.' '.$teacher->lastname).'-'.($year?->year ?? '')).'.pdf');
+        return $pdf->stream('affectations-'.Str::slug(trim($teacher->firstname.' '.$teacher->lastname).'-'.($year->year ?? '')).'.pdf');
     }
 
     /** Identifiant de l'année académique active (la plus récente marquée active). */
@@ -170,7 +170,7 @@ private function teacherAssignments(string $teacherId, string $yearId): Collecti
             ->where('teacher_id', $teacherId)
             ->where('academic_year_id', $yearId)
             ->get()
-            ->sortBy(fn ($a) => ($a->subject?->name ?? '').' '.($a->classroom?->name ?? ''))
+            ->sortBy(fn ($a) => ($a->subject->name ?? '').' '.($a->classroom->name ?? ''))
             ->values();
     }
 

app/Http/Controllers/Api/ApiController.php

@@ -18,6 +18,9 @@ abstract class ApiController extends Controller
      */
     protected function accessibleStudents(Request $request): Collection
     {
+        // Ces routes API authentifient un élève ou un tuteur (gardes Sanctum
+        // dédiées), jamais le User par défaut supposé par l'analyse statique.
+        /** @var Student|Guardian|null $user */
         $user = $request->user();
 
         if ($user instanceof Student) {
@@ -38,6 +41,7 @@ protected function accessibleStudents(Request $request): Collection
      */
     protected function resolveStudent(Request $request, string $studentId): Student
     {
+        /** @var Student|Guardian|null $user */
         $user = $request->user();
 
         if ($user instanceof Student) {

app/Http/Controllers/Api/V1/AuthController.php

@@ -39,6 +39,8 @@ public function login(LoginRequest $request): JsonResponse
 
     public function me(Request $request): JsonResponse
     {
+        // Portail parent/élève : le principal authentifié est un tuteur ou un élève.
+        /** @var Guardian|Student $user */
         $user = $request->user();
         $type = $user instanceof Guardian ? 'guardian' : 'student';
 
@@ -47,7 +49,9 @@ public function me(Request $request): JsonResponse
 
     public function logout(Request $request): JsonResponse
     {
-        $request->user()->currentAccessToken()->delete();
+        /** @var Guardian|Student $user */
+        $user = $request->user();
+        $user->currentAccessToken()->delete();
 
         return response()->json(['message' => 'Déconnecté.']);
     }

app/Http/Controllers/Api/V1/ChildrenController.php

@@ -16,6 +16,7 @@ public function index(Request $request): AnonymousResourceCollection
     {
         $withActiveEnrollment = ['enrollments' => fn ($q) => $q->where('status', Enrollment::STATUS_ACTIVE)->with('classroom:id,name')];
 
+        /** @var Student|Guardian $user */
         $user = $request->user();
 
         if ($user instanceof Student) {

app/Http/Controllers/Api/V1/DashboardController.php

@@ -45,7 +45,7 @@ public function index(Request $request): JsonResponse
                 'id' => $e->id,
                 'title' => $e->title,
                 'type' => $e->type,
-                'start_date' => $e->start_date?->format('Y-m-d'),
+                'start_date' => $e->start_date->format('Y-m-d'),
             ]);
 
         return response()->json([

app/Http/Controllers/Archives/ArchiveController.php

@@ -16,8 +16,6 @@
 
 class ArchiveController extends Controller
 {
-    private const TYPES = ['student' => Student::class, 'classroom' => Classroom::class];
-
     private function authorizeManage(Request $request): void
     {
         // Socle de sécurité : les routes portent déjà la permission fine (create/edit/
@@ -234,9 +232,12 @@ private function linkLabel(ArchivedDocument $d): ?string
             return null;
         }
 
-        return match ($d->documentable_type) {
-            Student::class => 'Élève : '.$d->documentable->name,
-            Classroom::class => 'Classe : '.$d->documentable->name,
+        $linked = $d->documentable;
+
+        return match (true) {
+            // Un élève n'a pas de colonne « name » : on compose nom + prénom.
+            $linked instanceof Student => 'Élève : '.trim($linked->firstname.' '.$linked->lastname),
+            $linked instanceof Classroom => 'Classe : '.$linked->name,
             default => null,
         };
     }