Repository navigation
feat(install): assistant d'installation web (pays, niveaux multiples, devise, sécurité) - #343
Merged
Merged
Conversation
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.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Assistant d'installation web
Ajoute un assistant « première configuration » (façon WordPress) : sur une base vierge, l'application redirige vers
/install, guide l'opérateur en 4 étapes, puis exécute réellement l'installation et se verrouille. Aucune ligne de commande requise.Parcours (4 étapes)
Exécution (idempotente)
migrate→ création de l'école →ReferenceDataSeeder→ rattachement des types de classe aux niveaux cochés → périodes + année active → administrateur (rôle +owner_idde l'école) → réglages sécurité (.env) → verroustorage/app/installed.json. Reprise après échec sans doublon.Modèle École
schools.country(défautTG) + liste ISO viaApp\Constants\Countries(source unique, consommée aussi parCountrySeeder).School::classTypes) ; l'enumlevelgarde le cycle principal.devise) distincte de la monnaie (currency, code ISO).Sécurité (durcissement)
config:clearaprès écriture.env.session/cachesur le pilotefileavant installation (tables absentes sur base neuve).i18n & qualité
lang/{fr,en}/validation.php: messages de formulaire traduits (blocpassword+ attributs lisibles).admin/school: nettoyage des erreurs à la saisie (clearErrors) — fin de l'erreur « figée » sur la confirmation de mot de passe.Nettoyage & doc
DemoSeeder(non référencé).documentations/prise-en-main/installation-web.md, index de doc,CHANGELOG.Tests
InstallWizardTest: parcours, exécution réelle, pays, multi-niveaux, devise, propriétaire, verrou, sessions altérées, garde-fous config↔seeder. PHPStan (niveau 5, 0 erreur), Pint, tsc, ESLint verts.