Skip to content

Develop - #346

Merged
horacioskrp merged 13 commits into
mainfrom
develop
Nov 18, 2026
Merged

horacioskrp merged 13 commits into
mainfrom
develop

Conversation

@horacioskrp

Copy link
Copy Markdown
Collaborator

📋 Description

🔗 Issue liée

Closes #

🧩 Type de changement

  • ✨ feat — Nouvelle fonctionnalité
  • 🐛 fix — Correction de bug
  • ♻️ refactor — Refactorisation (sans changement de comportement)
  • 🎨 style — Mise en forme / UI (sans logique)
  • 🧪 test — Ajout ou correction de tests
  • 📝 docs — Documentation
  • 🔧 chore — Maintenance, configuration, dépendances

✅ Checklist

  • Mes commits suivent la convention (voir CONTRIBUTING.md)
  • Les commentaires de code documentent le pourquoi, en français, là où c'est utile
  • J'ai ajouté / mis à jour les tests (php artisan test passe au vert)
  • Le build passe (npm run build)
  • J'ai ajouté la route dans resources/js/helpers/route.ts si une route a été créée
  • J'ai ajouté l'entrée de migration et l'ai exécutée (php artisan migrate)
  • La page occupe toute la largeur (w-full) et respecte le design existant
  • Pas de secret ni d'identifiant en clair dans le code

🧪 Tests effectués

📸 Captures d'écran (si UI)

📝 Notes pour la relecture

horacioskrp and others added 13 commits November 17, 2026 15:07
Assistant d'installation style WordPress, calqué sur le design de la page
de connexion (hero + DalibiLogo). Quatre étapes visibles : langue, école,
administrateur, protocole de sécurité, puis écran d'exécution.

Cette phase couvre l'ossature et l'UI ; l'exécution réelle (migrations,
seed, création école/admin, pose du verrou) arrive en Phase 2 — l'écran
'running' est pour l'instant un espace réservé.

- InstallState : source de vérité (verrou storage/app/installed.json +
  auto-cicatrisation si la base contient déjà des utilisateurs)
- RequirementsChecker : contrôle PHP/extensions/droits/APP_KEY sans base
- EnsureAppInstalled / EnsureAppNotInstalled : redirection vers/hors
  l'assistant, priorisé avant l'authentification
- Session forcée en driver 'file' avant installation (pas de base requise)
- Écrans Inertia : welcome, school, admin, security, running, requirements
- i18n FR/EN, tests fonctionnels (8) ; TestCase considère l'app installée
Branche l'orchestration réelle derrière l'écran de progression : à
l'affichage, le front déclenche POST /install/execute qui exécute le
service Installer puis redirige vers la connexion.

Service App\Support\Install\Installer :
- migrate --force (idempotent)
- création de l'école (avant le seed, pour les en-têtes/bulletins par défaut)
- db:seed ReferenceDataSeeder (rôles & permissions, catalogues) — rejouable
- découpage des périodes (trimestre/semestre) appliqué aux types de classe
- année scolaire active
- administrateur + rôle « administrateur » + matricule (sans changement de
  mot de passe imposé : il vient de le choisir)
- réglages de sécurité best-effort sur .env (APP_DEBUG, APP_URL en HTTPS),
  jamais sous tests ; choix consignés dans le verrou
- pose du verrou storage/app/installed.json

Chaque étape est idempotente (firstOrCreate/firstOrNew) : une reprise après
échec ne crée pas de doublon. En cas d'erreur, l'écran propose de relancer.

Tests : 2 nouveaux cas (garde-fou session, installation complète + verrou),
nettoyage du verrou en tearDown. Suite complète verte (515).
…durcissement sécurité

Affinements de l'assistant d'installation après la Phase 2.

Étapes
- Ordre revu : Langue → Administrateur → Sécurité → École (l'école clôt et
  déclenche l'installation). Stepper, redirections et liens « Retour » alignés.
- Le choix de la langue bascule désormais toute l'interface : l'étape écrit
  session('locale') (lue par SetLocale), les étapes suivantes suivent.

École & propriétaire
- Formulaire école calqué sur le modèle School (niveau, code, devise,
  directeur, email, téléphone, adresse, ville, région, description) ; la devise
  est un sélecteur alimenté par la constante Currencies (validation sur les codes).
- Suivi du propriétaire : migration owner_id (FK users, nullOnDelete),
  relation School::owner(), renseigné par l'Installer (= administrateur créé).

Sécurité (suite audit)
- H1 : le mot de passe de l'administrateur applique la politique de l'app
  (trait PasswordValidationRules → Password::default()).
- H2 : réglages honnêtes. 2FA retirée (non imposée, laissée au choix de chaque
  utilisateur) ; force_https réellement effectif via FORCE_HTTPS lu par
  AppServiceProvider (hors local) ; app_debug_off inchangé.

Tests : nouvel ordre, propagation de langue, owner, champs modèle, politique mdp.
Suite complète verte (516). PHPStan 0, Pint, tsc, ESLint, build OK.
… de vérité)

M2 — plus de mot de passe en clair pendant l'assistant :
- l'étape admin chiffre le mot de passe en session (Crypt::encryptString, APP_KEY) ;
  le payload de session fichier ne contient plus de secret exploitable au repos.
- execute le déchiffre juste avant de créer le compte ; une session altérée
  (déchiffrement impossible) renvoie à l'étape admin sans rien installer.
- stockage final inchangé : base de données, mot de passe haché, session purgée.

M3 — la base de données fait foi, le fichier-verrou n'est qu'un cache :
- InstallState::isInstalled() regarde d'abord la base (présence d'un utilisateur),
  puis se rabat sur installed.json uniquement si la base est injoignable.
- un verrou périmé sur une base vide ne bloque plus une réinstallation légitime.
- sonde allégée : une requête exists indexée, mémoïsée, sans Schema::hasTable.

Tests : installation avec mot de passe chiffré + Hash::check, session altérée
rejetée. Suite complète verte (517). PHPStan 0, Pint OK.
L1 — logs : en cas d'échec d'installation, journaliser le type et
l'emplacement de l'exception, mais masquer le message d'une QueryException
(il contient le SQL et ses bindings, dont l'email).

L2 — écran prérequis : ne plus afficher la version exacte de PHP lorsque le
prérequis passe (empreinte système) ; visible uniquement en cas d'échec.

L3 — throttling : limiter toutes les étapes de l'assistant (throttle:30,1) en
plus de la limite stricte propre à l'exécution (throttle:6,1).

L4 — cache de config : après écriture du .env (APP_DEBUG, FORCE_HTTPS…),
appeler config:clear pour que les nouvelles valeurs soient lues au prochain
boot (no-op sans cache ; jamais exécuté sous tests).

Suite complète verte (517). PHPStan 0, Pint OK.
Le throttle des routes d'installation (ajouté en L3) s'appuie sur le store de
cache. Avec CACHE_STORE=database, la table cache n'existe pas avant les
migrations : l'affichage de l'assistant levait une QueryException
(relation « cache » inexistante), comme le faisait la session.

AppServiceProvider bascule désormais session ET cache sur le pilote file tant
que l'application n'est pas installée (useFileStoresBeforeInstall). Après
migration, les stores database reprennent normalement.

Vérifié en live : GET /install répond 200 (plus de QueryException). 12 tests
install verts, PHPStan 0, Pint OK.
Étape « École » de l'assistant :
- Select pays (liste ISO via App\Constants\Countries, source unique du
  CountrySeeder) + colonne schools.country (défaut TG).
- Niveaux multiples : cases à cocher rattachées comme types de classe
  (School::classTypes) ; l'enum level garde le cycle principal.
- Champ devise/slogan distinct de la monnaie (currency), relibellé « Monnaie ».
- Champs groupés par logique (identité/contact/localisation/pédagogie), sans
  card ; cartes de niveaux de dimension uniforme.

Autres :
- Messages d'erreur de formulaire traduits : lang/{fr,en}/validation.php
  (bloc password + attributs lisibles).
- admin/school : nettoyage des erreurs à la saisie (clearErrors) — fin de
  l'erreur « figée » sur la confirmation de mot de passe.
- Suppression du seeder obsolète DemoSeeder (non référencé).
- Documentation : README (section assistant web), page dédiée
  installation-web.md, index de doc, CHANGELOG.

Tests : InstallWizardTest (pays, multi-niveaux, devise, garde-fous
config/seeder) ; PHPStan, Pint, ESLint OK.
…oad filigrane)

- F1: gate la route timetable.export avec can:view_timetable (alignée sur ses
  voisines) — l'export PDF d'emploi du temps n'était soumis à aucune permission
  et classId n'est pas scopé (lecture cross-école).
- F2: neutralise l'injection de formule CSV dans SituationController::export
  (helper csvCell) — matricule/nom/prénom/classe/n° facture sont préfixés d'une
  apostrophe s'ils commencent par = + - @ \t \r.
- NV1: restreint l'upload du filigrane (watermark_image) à mimes jpg,jpeg,png,webp
  comme le logo, pour écarter le SVG sur le disque public media (XSS stocké).
…F2, NV1)

- F1: TimetableTest::export_forbidden_without_view_timetable_permission
  (Comptabilité → 403 sur timetable.export).
- F2: SituationExportTest — préfixage des cellules dangereuses (=/@) dans
  l'export CSV, non-altération des valeurs normales, et 403 sans view_finances.
- NV1: DocumentHeaderTest — rejet d'un filigrane SVG, acceptation d'un PNG.
feat(install): assistant d'installation web (pays, niveaux multiples, devise, sécurité)
fix(sécurité): correctifs audit — authz export EDT, injection CSV, upload filigrane
chore(release): fige la version 1.1.0
@horacioskrp
horacioskrp merged commit 1f41c26 into main Nov 18, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant