diff --git a/CHANGELOG.md b/CHANGELOG.md index 1023347..f8996d7 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,6 +4,32 @@ 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/). +## [Non publié] + +### Ajouté +- **Assistant d'installation web** (« première configuration » façon WordPress) : écrans + **Langue → Administrateur → Sécurité → École**, puis exécution réelle de l'installation + (migration, données de référence de production, création de l'école/administrateur/année active, + réglages de sécurité) et **verrouillage** de l'application. Étapes **idempotentes**, base comme + source de vérité de l'état « installé ». Voir + [`documentations/prise-en-main/installation-web.md`](documentations/prise-en-main/installation-web.md). +- **École** : sélection du **pays** (liste ISO via `App\Constants\Countries`), **niveaux multiples** + rattachés comme types de classe (un établissement peut cumuler plusieurs cycles), et distinction + explicite entre **monnaie** (`currency`, code ISO) et **devise/slogan** (`devise`, exergue). +- **Fichiers de langue de validation** `lang/{fr,en}/validation.php` : messages d'erreur de + formulaire traduits (dont le bloc `password`) avec libellés d'attributs lisibles. + +### Sécurité +- Durcissement de l'assistant d'installation : mot de passe administrateur appliquant la politique + de l'app et **chiffré en session** jusqu'à l'exécution, **limitation de débit** des routes, + **masquage du SQL** dans les journaux d'erreur, purge du cache de configuration après écriture du + `.env`, et **base de données** comme source de vérité de l'état installé (le fichier-verrou n'est + qu'un cache). + +### Supprimé +- Seeder de démonstration obsolète `DemoSeeder` (non référencé ; le jeu de démo est produit par + `DefaultUsersSeeder` + `StudentTestSeeder` + `DocumentTemplateSeeder`). + ## [1.0.2] — 2026-11-13 ### Ajouté diff --git a/README.md b/README.md index cc52163..6a8b940 100644 --- a/README.md +++ b/README.md @@ -48,10 +48,11 @@ chaque section, aligné sur les indicateurs de l'annuaire statistique / carte sc ### Gestion des établissements -- Support multi-écoles (primaire, collège, lycée) -- Paramétrage par établissement : nom, code, devise, terme (ex. « République Togolaise ») +- Support multi-écoles (maternelle, primaire, collège, lycée, lycée technique) +- **Niveaux multiples par école** : un établissement peut cumuler plusieurs cycles (rattachés comme **types de classe**) +- Paramétrage par établissement : nom, code, **pays**, **monnaie** (code ISO, ex. XOF), **devise / slogan** (ex. « Travail - Liberté - Patrie », distincte de la monnaie), terme (ex. « République Togolaise »), ministère de tutelle - Upload du logo de l'école (image, avec prévisualisation) -- Années académiques et périodes (trimestres) +- Années académiques et périodes (**trimestres / semestres**) - Types de classes et niveaux configurables ### Gestion des utilisateurs & rôles @@ -262,15 +263,30 @@ DB_USERNAME=postgres DB_PASSWORD=votre_mot_de_passe ``` -### 4. Base de données +### 4. Première configuration — assistant d'installation web (recommandé) + +Une fois le `.env` renseigné (connexion base + `APP_KEY`) et le serveur lancé (étape 5), ouvrez **`/install`**. L'assistant « première configuration » prend tout en charge, **sans ligne de commande** : + +1. **Langue** — fixe la langue de l'assistant **et** de l'application (FR / EN). +2. **Administrateur** — compte principal ; le mot de passe applique la politique de l'app (min. 12 caractères, casse mixte, chiffres, symboles, vérifié contre les fuites connues en production). +3. **Sécurité** — HTTPS forcé, mode debug coupé, journalisation Sentry (la **2FA reste facultative**, activable par chaque utilisateur). +4. **École** — identité de l'établissement : nom, code, **pays**, **monnaie**, **devise/slogan**, directeur, contacts, localisation et **niveaux** (un ou plusieurs cycles). + +À la validation, l'assistant exécute **réellement** l'installation : `migrate`, données de référence de production (`ReferenceDataSeeder`), création de l'école, de l'administrateur et de l'année scolaire active, application des réglages de sécurité, puis **pose d'un verrou** (`storage/app/installed.json`). Chaque étape est **idempotente** (une reprise après interruption ne crée pas de doublon) et l'assistant **se verrouille** une fois l'application installée. + +> 📖 Détails complets : [`documentations/prise-en-main/installation-web.md`](documentations/prise-en-main/installation-web.md). + +### 4 bis. Base de données — installation en ligne de commande (alternative) + +Pour un déploiement automatisé (CI, Docker, provisioning) ou pour contourner l'assistant, appliquez le schéma et les données de référence manuellement : ```bash php artisan migrate php artisan db:seed --class=ReferenceDataSeeder # données de référence (rôles, classes, matières…) -php artisan db:seed --class=DemoSeeder # optionnel : jeu de démonstration complet (élèves, notes, finances…) +php artisan db:seed # optionnel (hors production) : comptes de test + élèves fictifs + modèles de documents ``` -### 4 bis. Lien de stockage des fichiers +### 4 ter. Lien de stockage des fichiers ```bash php artisan storage:link # requis pour servir les fichiers uploadés (logos…) diff --git a/app/Constants/Countries.php b/app/Constants/Countries.php new file mode 100644 index 0000000..c2c2feb --- /dev/null +++ b/app/Constants/Countries.php @@ -0,0 +1,303 @@ + + */ + public static function all(): array + { + return [ + 'AF' => 'Afghanistan', + 'AL' => 'Albania', + 'DZ' => 'Algeria', + 'AS' => 'American Samoa', + 'AD' => 'Andorra', + 'AO' => 'Angola', + 'AI' => 'Anguilla', + 'AQ' => 'Antarctica', + 'AG' => 'Antigua and Barbuda', + 'AR' => 'Argentina', + 'AM' => 'Armenia', + 'AW' => 'Aruba', + 'AU' => 'Australia', + 'AT' => 'Austria', + 'AZ' => 'Azerbaijan', + 'BS' => 'Bahamas', + 'BH' => 'Bahrain', + 'BD' => 'Bangladesh', + 'BB' => 'Barbados', + 'BY' => 'Belarus', + 'BE' => 'Belgium', + 'BZ' => 'Belize', + 'BJ' => 'Benin', + 'BM' => 'Bermuda', + 'BT' => 'Bhutan', + 'BO' => 'Bolivia', + 'BA' => 'Bosnia and Herzegovina', + 'BW' => 'Botswana', + 'BV' => 'Bouvet Island', + 'BR' => 'Brazil', + 'IO' => 'British Indian Ocean Territory', + 'BN' => 'Brunei Darussalam', + 'BG' => 'Bulgaria', + 'BF' => 'Burkina Faso', + 'BI' => 'Burundi', + 'KH' => 'Cambodia', + 'CM' => 'Cameroon', + 'CA' => 'Canada', + 'CV' => 'Cape Verde', + 'KY' => 'Cayman Islands', + 'CF' => 'Central African Republic', + 'TD' => 'Chad', + 'CL' => 'Chile', + 'CN' => 'China', + 'CX' => 'Christmas Island', + 'CC' => 'Cocos (Keeling) Islands', + 'CO' => 'Colombia', + 'KM' => 'Comoros', + 'CD' => 'Democratic Republic of the Congo', + 'CG' => 'Republic of Congo', + 'CK' => 'Cook Islands', + 'CR' => 'Costa Rica', + 'HR' => 'Croatia (Hrvatska)', + 'CU' => 'Cuba', + 'CY' => 'Cyprus', + 'CZ' => 'Czech Republic', + 'DK' => 'Denmark', + 'DJ' => 'Djibouti', + 'DM' => 'Dominica', + 'DO' => 'Dominican Republic', + 'TL' => 'East Timor', + 'EC' => 'Ecuador', + 'EG' => 'Egypt', + 'SV' => 'El Salvador', + 'GQ' => 'Equatorial Guinea', + 'ER' => 'Eritrea', + 'EE' => 'Estonia', + 'ET' => 'Ethiopia', + 'FK' => 'Falkland Islands (Malvinas)', + 'FO' => 'Faroe Islands', + 'FJ' => 'Fiji', + 'FI' => 'Finland', + 'FR' => 'France', + 'FX' => 'France, Metropolitan', + 'GF' => 'French Guiana', + 'PF' => 'French Polynesia', + 'TF' => 'French Southern Territories', + 'GA' => 'Gabon', + 'GM' => 'Gambia', + 'GE' => 'Georgia', + 'DE' => 'Germany', + 'GH' => 'Ghana', + 'GI' => 'Gibraltar', + 'GG' => 'Guernsey', + 'GR' => 'Greece', + 'GL' => 'Greenland', + 'GD' => 'Grenada', + 'GP' => 'Guadeloupe', + 'GU' => 'Guam', + 'GT' => 'Guatemala', + 'GN' => 'Guinea', + 'GW' => 'Guinea-Bissau', + 'GY' => 'Guyana', + 'HT' => 'Haiti', + 'HM' => 'Heard and Mc Donald Islands', + 'HN' => 'Honduras', + 'HK' => 'Hong Kong', + 'HU' => 'Hungary', + 'IS' => 'Iceland', + 'IN' => 'India', + 'IM' => 'Isle of Man', + 'ID' => 'Indonesia', + 'IR' => 'Iran (Islamic Republic of)', + 'IQ' => 'Iraq', + 'IE' => 'Ireland', + 'IL' => 'Israel', + 'IT' => 'Italy', + 'CI' => 'Ivory Coast', + 'JE' => 'Jersey', + 'JM' => 'Jamaica', + 'JP' => 'Japan', + 'JO' => 'Jordan', + 'KZ' => 'Kazakhstan', + 'KE' => 'Kenya', + 'KI' => 'Kiribati', + 'KP' => 'Korea, Democratic People\'s Republic of', + 'KR' => 'Korea, Republic of', + 'XK' => 'Kosovo', + 'KW' => 'Kuwait', + 'KG' => 'Kyrgyzstan', + 'LA' => 'Lao People\'s Democratic Republic', + 'LV' => 'Latvia', + 'LB' => 'Lebanon', + 'LS' => 'Lesotho', + 'LR' => 'Liberia', + 'LY' => 'Libyan Arab Jamahiriya', + 'LI' => 'Liechtenstein', + 'LT' => 'Lithuania', + 'LU' => 'Luxembourg', + 'MO' => 'Macau', + 'MK' => 'North Macedonia', + 'MG' => 'Madagascar', + 'MW' => 'Malawi', + 'MY' => 'Malaysia', + 'MV' => 'Maldives', + 'ML' => 'Mali', + 'MT' => 'Malta', + 'MH' => 'Marshall Islands', + 'MQ' => 'Martinique', + 'MR' => 'Mauritania', + 'MU' => 'Mauritius', + 'YT' => 'Mayotte', + 'MX' => 'Mexico', + 'FM' => 'Micronesia, Federated States of', + 'MD' => 'Moldova, Republic of', + 'MC' => 'Monaco', + 'MN' => 'Mongolia', + 'ME' => 'Montenegro', + 'MS' => 'Montserrat', + 'MA' => 'Morocco', + 'MZ' => 'Mozambique', + 'MM' => 'Myanmar', + 'NA' => 'Namibia', + 'NR' => 'Nauru', + 'NP' => 'Nepal', + 'NL' => 'Netherlands', + 'AN' => 'Netherlands Antilles', + 'NC' => 'New Caledonia', + 'NZ' => 'New Zealand', + 'NI' => 'Nicaragua', + 'NE' => 'Niger', + 'NG' => 'Nigeria', + 'NU' => 'Niue', + 'NF' => 'Norfolk Island', + 'MP' => 'Northern Mariana Islands', + 'NO' => 'Norway', + 'OM' => 'Oman', + 'PK' => 'Pakistan', + 'PW' => 'Palau', + 'PS' => 'Palestine', + 'PA' => 'Panama', + 'PG' => 'Papua New Guinea', + 'PY' => 'Paraguay', + 'PE' => 'Peru', + 'PH' => 'Philippines', + 'PN' => 'Pitcairn', + 'PL' => 'Poland', + 'PT' => 'Portugal', + 'PR' => 'Puerto Rico', + 'QA' => 'Qatar', + 'RE' => 'Reunion', + 'RO' => 'Romania', + 'RU' => 'Russian Federation', + 'RW' => 'Rwanda', + 'KN' => 'Saint Kitts and Nevis', + 'LC' => 'Saint Lucia', + 'VC' => 'Saint Vincent and the Grenadines', + 'WS' => 'Samoa', + 'SM' => 'San Marino', + 'ST' => 'Sao Tome and Principe', + 'SA' => 'Saudi Arabia', + 'SN' => 'Senegal', + 'RS' => 'Serbia', + 'SC' => 'Seychelles', + 'SL' => 'Sierra Leone', + 'SG' => 'Singapore', + 'SK' => 'Slovakia', + 'SI' => 'Slovenia', + 'SB' => 'Solomon Islands', + 'SO' => 'Somalia', + 'ZA' => 'South Africa', + 'GS' => 'South Georgia South Sandwich Islands', + 'SS' => 'South Sudan', + 'ES' => 'Spain', + 'LK' => 'Sri Lanka', + 'SH' => 'St. Helena', + 'PM' => 'St. Pierre and Miquelon', + 'SD' => 'Sudan', + 'SR' => 'Suriname', + 'SJ' => 'Svalbard and Jan Mayen Islands', + 'SZ' => 'Eswatini', + 'SE' => 'Sweden', + 'CH' => 'Switzerland', + 'SY' => 'Syrian Arab Republic', + 'TW' => 'Taiwan', + 'TJ' => 'Tajikistan', + 'TZ' => 'Tanzania, United Republic of', + 'TH' => 'Thailand', + 'TG' => 'Togo', + 'TK' => 'Tokelau', + 'TO' => 'Tonga', + 'TT' => 'Trinidad and Tobago', + 'TN' => 'Tunisia', + 'TR' => 'Turkey', + 'TM' => 'Turkmenistan', + 'TC' => 'Turks and Caicos Islands', + 'TV' => 'Tuvalu', + 'UG' => 'Uganda', + 'UA' => 'Ukraine', + 'AE' => 'United Arab Emirates', + 'GB' => 'United Kingdom', + 'US' => 'United States', + 'UM' => 'United States minor outlying islands', + 'UY' => 'Uruguay', + 'UZ' => 'Uzbekistan', + 'VU' => 'Vanuatu', + 'VA' => 'Vatican City State', + 'VE' => 'Venezuela', + 'VN' => 'Vietnam', + 'VG' => 'Virgin Islands (British)', + 'VI' => 'Virgin Islands (U.S.)', + 'WF' => 'Wallis and Futuna Islands', + 'EH' => 'Western Sahara', + 'YE' => 'Yemen', + 'ZM' => 'Zambia', + 'ZW' => 'Zimbabwe', + ]; + } + + /** Codes ISO valides (pour la validation). */ + public static function codes(): array + { + return array_keys(self::all()); + } + + /** Nom lisible d'un code pays (repli sur le code si inconnu). */ + public static function name(?string $code): string + { + $code = $code ?: self::DEFAULT; + + return self::all()[$code] ?? $code; + } + + /** + * Options pour un select, triées par nom. + * + * @return array + */ + public static function options(): array + { + $all = self::all(); + asort($all); + + return array_map( + static fn (string $code): array => ['code' => $code, 'name' => $all[$code]], + array_keys($all), + ); + } +} diff --git a/app/Http/Controllers/Install/InstallController.php b/app/Http/Controllers/Install/InstallController.php new file mode 100644 index 0000000..41b9d55 --- /dev/null +++ b/app/Http/Controllers/Install/InstallController.php @@ -0,0 +1,235 @@ +passes()) { + return redirect('/install/requirements'); + } + + return Inertia::render('install/welcome', [ + 'locales' => Locales::options(), + 'current' => session('install.language.locale', config('install.defaults.locale')), + ]); + } + + public function storeLanguage(Request $request): RedirectResponse + { + $validated = $request->validate([ + 'locale' => ['required', 'string', 'in:'.implode(',', Locales::codes())], + ]); + + // On mémorise le choix pour l'installation ET sous la clé « locale » + // standard : le middleware SetLocale l'applique alors à toutes les étapes + // suivantes et à l'ensemble de l'interface (invité, avant connexion). + session([ + 'install.language' => $validated, + 'locale' => $validated['locale'], + ]); + app()->setLocale($validated['locale']); + + return redirect('/install/admin'); + } + + /** Étape 4 (dernière) — École. Déclenche l'installation. */ + public function school(): Response + { + return Inertia::render('install/school', [ + 'defaults' => config('install.defaults'), + 'currencies' => Currencies::options(), + 'countries' => Countries::options(), + 'levels' => array_keys((array) config('install.levels')), + 'values' => session('install.school'), + ]); + } + + public function storeSchool(Request $request): RedirectResponse + { + $levelKeys = array_keys((array) config('install.levels')); + + // Champs calqués sur le modèle School (colonnes réelles de la table « schools »). + $validated = $request->validate([ + 'name' => ['required', 'string', 'max:255'], + // Niveaux/cycles : une école peut en cocher un ou plusieurs. Rattachés + // comme « types de classe » après le seed (cf. Installer::attachClassTypes). + 'levels' => ['nullable', 'array'], + 'levels.*' => ['string', 'in:'.implode(',', $levelKeys)], + 'code' => ['nullable', 'string', 'max:50'], + // « devise » = slogan/exergue de l'école (ex. « Travail - Liberté - Patrie »), + // distincte de « currency » (monnaie, code ISO). + 'devise' => ['nullable', 'string', 'max:500'], + 'currency' => ['nullable', 'string', 'in:'.implode(',', Currencies::codes())], + 'principal' => ['nullable', 'string', 'max:255'], + 'email' => ['nullable', 'email', 'max:255'], + 'phone' => ['nullable', 'string', 'max:50'], + 'address' => ['nullable', 'string', 'max:255'], + 'city' => ['nullable', 'string', 'max:120'], + 'region' => ['nullable', 'string', 'max:120'], + 'country' => ['nullable', 'string', 'in:'.implode(',', Countries::codes())], + 'po_box' => ['nullable', 'string', 'max:50'], + 'description' => ['nullable', 'string', 'max:1000'], + 'timezone' => ['nullable', 'string', 'max:64'], + 'academic_year_start' => ['nullable', 'string', 'max:20'], + 'period_type' => ['nullable', 'string', 'max:30'], + ]); + + session(['install.school' => $validated]); + + return redirect('/install/run'); + } + + /** Étape 2 — Administrateur. */ + public function admin(): Response + { + return Inertia::render('install/admin', [ + 'values' => array_diff_key((array) session('install.admin', []), ['password' => '', 'password_confirmation' => '']), + ]); + } + + public function storeAdmin(Request $request): RedirectResponse + { + $validated = $request->validate([ + 'firstname' => ['required', 'string', 'max:255'], + 'lastname' => ['required', 'string', 'max:255'], + 'email' => ['required', 'email', 'max:255'], + // H1 : le compte le plus privilégié applique la politique mdp de l'app + // (Password::default() : min 12, casse mixte, chiffres, symboles, uncompromised en prod). + 'password' => $this->passwordRules(), + ]); + + // M2 : le mot de passe ne doit jamais transiter en clair dans la session + // (payload fichier non chiffré au repos). On le chiffre ici (APP_KEY) ; il + // n'est déchiffré qu'à l'exécution, puis purgé. La base reste l'unique + // stockage final, en haché. + $validated['password'] = Crypt::encryptString($validated['password']); + session(['install.admin' => $validated]); + + return redirect('/install/security'); + } + + /** Étape 3 — Protocole de sécurité. */ + public function security(): Response + { + return Inertia::render('install/security', [ + 'defaults' => config('install.security_defaults'), + 'values' => session('install.security'), + ]); + } + + public function storeSecurity(Request $request): RedirectResponse + { + $validated = $request->validate([ + 'force_https' => ['boolean'], + 'app_debug_off' => ['boolean'], + 'enable_sentry' => ['boolean'], + 'password_policy' => ['nullable', 'string', 'in:strong,medium'], + ]); + + session(['install.security' => $validated]); + + return redirect('/install/school'); + } + + /** + * Écran de progression. L'exécution réelle est déclenchée par le front + * (POST /install/execute) dès l'affichage, puis la page redirige vers /login. + */ + public function run(): Response + { + return Inertia::render('install/running'); + } + + /** + * Exécute l'installation à partir des données accumulées en session. + * + * Idempotent et protégé : en cas d'échec, l'utilisateur revient à l'écran de + * progression avec un message et peut relancer sans créer de doublon. + */ + public function execute(Request $request, Installer $installer): RedirectResponse + { + // Garde-fou : sans les étapes essentielles, on renvoie l'utilisateur au début. + if (! session()->has('install.school') || ! session()->has('install.admin')) { + return redirect('/install'); + } + + // M2 : déchiffrement du mot de passe juste avant de le consommer. Une session + // altérée (déchiffrement impossible) renvoie à l'étape administrateur. + $admin = (array) session('install.admin', []); + if (isset($admin['password'])) { + try { + $admin['password'] = Crypt::decryptString((string) $admin['password']); + } catch (DecryptException) { + return redirect('/install/admin'); + } + } + + $payload = [ + 'locale' => session('install.language.locale', config('install.defaults.locale')), + 'school' => (array) session('install.school', []), + 'admin' => $admin, + 'security' => (array) session('install.security', []), + ]; + + try { + $installer->run($payload); + } catch (Throwable $e) { + // L1 : journaliser le type et l'emplacement, mais jamais le message d'une + // QueryException (il contient le SQL et ses bindings — email, etc.). + Log::error('Échec de l\'installation web', [ + 'type' => $e::class, + 'at' => $e->getFile().':'.$e->getLine(), + 'message' => $e instanceof QueryException ? '[requête base masquée]' : $e->getMessage(), + ]); + + return back()->withErrors([ + 'install' => __('install.running.error'), + ]); + } + + // Nettoyage : ne pas conserver les données d'installation (dont le mot de passe). + $request->session()->forget(['install.language', 'install.school', 'install.admin', 'install.security']); + + return redirect('/login')->with('status', __('install.running.done')); + } + + /** Écran dédié aux prérequis non satisfaits. */ + public function requirements(RequirementsChecker $requirements): Response + { + return Inertia::render('install/requirements', [ + 'requirements' => $requirements->check(), + 'passes' => $requirements->passes(), + ]); + } +} diff --git a/app/Http/Middleware/EnsureAppInstalled.php b/app/Http/Middleware/EnsureAppInstalled.php new file mode 100644 index 0000000..10f185c --- /dev/null +++ b/app/Http/Middleware/EnsureAppInstalled.php @@ -0,0 +1,32 @@ +state->isInstalled()) { + return $next($request); + } + + // Déjà dans l'assistant : on laisse passer. + if ($request->is('install', 'install/*')) { + return $next($request); + } + + return redirect('/install'); + } +} diff --git a/app/Http/Middleware/EnsureAppNotInstalled.php b/app/Http/Middleware/EnsureAppNotInstalled.php new file mode 100644 index 0000000..751e2fc --- /dev/null +++ b/app/Http/Middleware/EnsureAppNotInstalled.php @@ -0,0 +1,27 @@ +state->isInstalled()) { + return redirect('/login'); + } + + return $next($request); + } +} diff --git a/app/Models/School.php b/app/Models/School.php index 39a88fa..d513e88 100644 --- a/app/Models/School.php +++ b/app/Models/School.php @@ -20,6 +20,7 @@ use Illuminate\Database\Eloquent\Concerns\HasUuids; use Illuminate\Database\Eloquent\Factories\HasFactory; use Illuminate\Database\Eloquent\Model; +use Illuminate\Database\Eloquent\Relations\BelongsTo; use Illuminate\Database\Eloquent\Relations\BelongsToMany; use Illuminate\Database\Eloquent\Relations\HasMany; use Illuminate\Database\Eloquent\Relations\HasOne; @@ -40,6 +41,7 @@ class School extends Model 'ministry', 'address', 'region', + 'country', 'city', 'po_box', 'phone', @@ -48,6 +50,7 @@ class School extends Model 'description', 'active', 'portal_enabled', + 'owner_id', ]; protected $casts = [ @@ -115,4 +118,14 @@ public function activeGradingConfig(): ?GradingConfig { return $this->gradingConfigs()->where('is_active', true)->first(); } + + /** + * Propriétaire de l'établissement (administrateur à l'origine de l'installation). + * + * @return BelongsTo + */ + public function owner(): BelongsTo + { + return $this->belongsTo(User::class, 'owner_id'); + } } diff --git a/app/Providers/AppServiceProvider.php b/app/Providers/AppServiceProvider.php index bfc495d..400e426 100644 --- a/app/Providers/AppServiceProvider.php +++ b/app/Providers/AppServiceProvider.php @@ -10,6 +10,7 @@ use App\Observers\SchoolObserver; use App\Observers\StudentObserver; use App\Observers\UserObserver; +use App\Support\Install\InstallState; use Carbon\CarbonImmutable; use Illuminate\Support\Facades\Date; use Illuminate\Support\Facades\DB; @@ -24,7 +25,8 @@ class AppServiceProvider extends ServiceProvider */ public function register(): void { - // + // État d'installation partagé et mémoïsé pour toute la requête. + $this->app->singleton(InstallState::class); } /** @@ -33,13 +35,37 @@ public function register(): void public function boot(): void { $this->configureDefaults(); + $this->useFileStoresBeforeInstall(); $this->registerObservers(); - if (app()->environment('production')) { + // HTTPS forcé en production, ou lorsque l'assistant d'installation l'a activé + // (FORCE_HTTPS=true) — jamais en local pour ne pas casser le dev en http. + if (app()->environment('production') || (config('install.force_https') && ! app()->environment('local'))) { URL::forceScheme('https'); } } + /** + * Avant installation, les stores par défaut « database » (session ET cache) ne + * peuvent pas fonctionner : ni la table `sessions` ni la table `cache` n'existent + * encore. On bascule donc ces deux stores sur le pilote « file » le temps de + * l'assistant — avant que StartSession ou le rate limiter (middleware `throttle` + * des routes d'installation, qui s'appuie sur le cache) ne les résolvent. + */ + protected function useFileStoresBeforeInstall(): void + { + if (app()->runningInConsole()) { + return; + } + + if (! $this->app->make(InstallState::class)->isInstalled()) { + config([ + 'session.driver' => 'file', + 'cache.default' => 'file', + ]); + } + } + /** * Register model observers. */ diff --git a/app/Support/Install/InstallState.php b/app/Support/Install/InstallState.php new file mode 100644 index 0000000..27b697e --- /dev/null +++ b/app/Support/Install/InstallState.php @@ -0,0 +1,142 @@ +override !== null) { + return $this->override; + } + + if ($this->installed !== null) { + return $this->installed; + } + + // M3 : la base de données fait foi quand elle est joignable ; le fichier-verrou + // n'est qu'un cache. Une base déjà peuplée = application installée (et on + // (re)pose le cache si besoin). Un verrou périmé sur une base vide ne bloque + // donc plus une nouvelle installation légitime. + if ($this->databaseHasUsers()) { + if (! File::exists($this->lockPath())) { + $this->lock(['healed' => true]); + } + + return $this->installed = true; + } + + // Repli : base injoignable (clone neuf, ou panne momentanée). On se fie alors + // au fichier-verrou s'il est présent. + if (File::exists($this->lockPath())) { + return $this->installed = true; + } + + return $this->installed = false; + } + + /** Force l'état (tests). Passer null pour rétablir la détection normale. */ + public function fake(?bool $installed): void + { + $this->override = $installed; + $this->installed = null; + } + + /** + * Pose le verrou d'installation avec quelques métadonnées. + * + * @param array $meta + */ + public function lock(array $meta = []): void + { + $payload = array_merge([ + 'installed_at' => now()->toIso8601String(), + 'version' => $this->appVersion(), + 'locale' => config('app.locale'), + ], $meta); + + File::ensureDirectoryExists(dirname($this->lockPath())); + File::put($this->lockPath(), json_encode($payload, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE)); + + $this->installed = true; + } + + /** + * Métadonnées du verrou, ou null si absent. + * + * @return array|null + */ + public function meta(): ?array + { + if (! File::exists($this->lockPath())) { + return null; + } + + $decoded = json_decode((string) File::get($this->lockPath()), true); + + return is_array($decoded) ? $decoded : null; + } + + /** Retire le verrou (tests / réinstallation volontaire). */ + public function unlock(): void + { + File::delete($this->lockPath()); + $this->installed = null; + } + + /** Chemin absolu du fichier-verrou. */ + public function lockPath(): string + { + return storage_path('app/'.config('install.lock_file', 'installed.json')); + } + + /** + * Sonde allégée : la table users contient-elle au moins une ligne ? + * + * Une seule requête `exists` (indexée, peu coûteuse) exécutée au plus une fois + * par requête (résultat mémoïsé). Si la table est absente (clone neuf) ou la base + * injoignable, la requête lève une exception interceptée → false, sans erreur. + */ + private function databaseHasUsers(): bool + { + try { + return DB::table('users')->exists(); + } catch (Throwable) { + return false; + } + } + + private function appVersion(): string + { + $path = base_path('package.json'); + + if (File::exists($path)) { + return (string) (json_decode((string) File::get($path))->version ?? '—'); + } + + return '—'; + } +} diff --git a/app/Support/Install/Installer.php b/app/Support/Install/Installer.php new file mode 100644 index 0000000..dc362aa --- /dev/null +++ b/app/Support/Install/Installer.php @@ -0,0 +1,384 @@ +, admin?: array, security?: array} $payload + */ + public function run(array $payload): void + { + $locale = Locales::isValid($payload['locale'] ?? null) ? (string) $payload['locale'] : Locales::DEFAULT; + $schoolInput = (array) ($payload['school'] ?? []); + $adminInput = (array) ($payload['admin'] ?? []); + $security = $this->normalizeSecurity((array) ($payload['security'] ?? [])); + + app()->setLocale($locale); + + // 1. Schéma de base de données (idempotent : rien à migrer si déjà à jour). + Artisan::call('migrate', ['--force' => true]); + + // 2. École — créée avant le seed : les en-têtes et bulletins par défaut + // (DocumentHeaderSeeder, BulletinTemplateSeeder) itèrent sur les écoles existantes. + $school = $this->ensureSchool($schoolInput); + + // 3. Données de référence de production (rôles & permissions, catalogues, + // en-têtes/bulletins par école). Entièrement idempotent, exécuté APRÈS la + // création de l'école pour que les seeders « par école » s'appliquent. + Artisan::call('db:seed', ['--class' => ReferenceDataSeeder::class, '--force' => true]); + + // 3bis. Cycles cochés → types de classe rattachés à l'école (après le seed, + // une fois les ClassroomType posés). Vrai support « multi-niveaux ». + $this->attachClassTypes($school, (array) ($schoolInput['levels'] ?? [])); + + // 4. Découpage des périodes (trimestre / semestre) appliqué aux types de classe. + $this->applyPeriodSystem($schoolInput['period_type'] ?? null); + + // 5. Année scolaire active. + $this->ensureAcademicYear($schoolInput['academic_year_start'] ?? null); + + // 6. Administrateur — après le seed : le rôle « administrateur » existe désormais. + $admin = $this->ensureAdministrator($adminInput, $locale); + + // 7. Propriétaire de l'établissement = administrateur à l'origine de l'installation. + if ($admin !== null && $school->owner_id !== $admin->id) { + $school->owner_id = $admin->id; + $school->save(); + } + + // 8. Réglages de sécurité (best-effort sur le fichier .env). + $this->applySecurity($security); + + // 9. Verrou : l'application est désormais installée. + $this->state->lock([ + 'locale' => $locale, + 'school' => $school->name, + 'owner' => $admin?->email, + 'timezone' => (string) ($schoolInput['timezone'] ?? config('install.defaults.timezone')), + 'security' => $security, + ]); + } + + /** + * @param array $input + */ + private function ensureSchool(array $input): School + { + $name = trim((string) ($input['name'] ?? '')) ?: 'Mon établissement'; + $code = trim((string) ($input['code'] ?? '')) ?: $this->generateSchoolCode($name); + + // L'enum `level` ne stocke qu'une valeur ; le vrai « multi-niveaux » est porté + // par les types de classe rattachés (cf. attachClassTypes). On dérive ici le + // niveau principal à partir des cycles cochés (le plus bas présent). + $level = $this->deriveLevel((array) ($input['levels'] ?? [])); + + // Champs facultatifs calqués sur le modèle School. « devise » (slogan/exergue) + // est distincte de « currency » (monnaie, code ISO). + $optional = []; + foreach (['devise', 'currency', 'country', 'principal', 'email', 'phone', 'address', 'city', 'region', 'po_box', 'description'] as $field) { + $value = trim((string) ($input[$field] ?? '')); + if ($value !== '') { + $optional[$field] = $value; + } + } + $optional['currency'] = $optional['currency'] ?? Currencies::DEFAULT; + $optional['country'] = $optional['country'] ?? Countries::DEFAULT; + + return School::firstOrCreate( + ['code' => $code], + array_merge([ + 'name' => $name, + 'level' => $level, + 'active' => true, + ], $optional), + ); + } + + /** + * Niveau principal (colonne enum `level`) déduit des cycles cochés. + * Priorité au cycle le plus bas présent ; « primaire » par défaut. + * + * @param array $levels slugs issus de config('install.levels') + */ + private function deriveLevel(array $levels): string + { + if (in_array('maternelle', $levels, true) || in_array('primaire', $levels, true)) { + return 'primaire'; + } + + if (in_array('college', $levels, true)) { + return 'college'; + } + + if (in_array('lycee', $levels, true) || in_array('lycee_technique', $levels, true)) { + return 'lycee'; + } + + return 'primaire'; + } + + /** + * Rattache à l'école les types de classe correspondant aux cycles cochés. + * Appelé APRÈS le seed (les ClassroomType existent alors). Idempotent : sync() + * fixe exactement l'ensemble sélectionné, sans doublon de pivot. + * + * @param array $levels slugs issus de config('install.levels') + */ + private function attachClassTypes(School $school, array $levels): void + { + $map = (array) config('install.levels'); + + // slugs cochés → noms canoniques de ClassroomType (ClassTypeSeeder). + $names = []; + foreach ($levels as $slug) { + if (isset($map[$slug])) { + $names[] = $map[$slug]; + } + } + + if ($names === []) { + return; // aucun cycle coché : on ne touche pas au pivot. + } + + $ids = DB::table('classroom_types')->whereIn('name', $names)->pluck('id')->all(); + + if ($ids !== []) { + $school->classTypes()->sync($ids); + } + } + + private function generateSchoolCode(string $name): string + { + $base = (string) Str::of($name)->ascii()->upper()->replaceMatches('/[^A-Z0-9]/', '')->substr(0, 8); + + return $base !== '' ? $base : 'ECOLE'; + } + + /** Applique le système de périodes aux types de classe (mono-école). */ + private function applyPeriodSystem(mixed $periodType): void + { + $map = [ + 'trimester' => 'trimestre', + 'trimestre' => 'trimestre', + 'semester' => 'semestre', + 'semestre' => 'semestre', + ]; + + $system = $map[strtolower((string) $periodType)] ?? null; + + if ($system === null) { + return; + } + + DB::table('classroom_types')->update([ + 'period_system' => $system, + 'updated_at' => now(), + ]); + } + + private function ensureAcademicYear(mixed $startDate): void + { + $start = $this->parseDate($startDate) ?? $this->defaultYearStart(); + $end = $start->copy()->addYear()->subDay(); + $year = $start->year.'-'.$end->year; + + $created = AcademicYear::firstOrCreate( + ['year' => $year], + [ + 'start_date' => $start->toDateString(), + 'end_date' => $end->toDateString(), + 'active' => false, + ], + ); + + // Garantir qu'exactement une année soit active. + if (! AcademicYear::query()->where('active', true)->exists()) { + $created->update(['active' => true]); + } + } + + /** + * @param array $input + */ + private function ensureAdministrator(array $input, string $locale): ?User + { + $email = strtolower(trim((string) ($input['email'] ?? ''))); + + if ($email === '') { + return null; // garde-fou : l'email est validé en amont par l'assistant. + } + + $user = User::firstOrNew(['email' => $email]); + + $user->firstname = trim((string) ($input['firstname'] ?? $user->firstname)); + $user->lastname = trim((string) ($input['lastname'] ?? $user->lastname)); + $user->locale = $locale; + // L'administrateur vient de choisir son mot de passe : pas de changement imposé. + $user->must_change_password = false; + $user->email_verified_at = $user->email_verified_at ?? Carbon::now(); + + if (! empty($input['password'])) { + $user->password = (string) $input['password']; // casté « hashed » par le modèle. + } + + // Colonnes NOT NULL à renseigner à la création (jamais écrasées sur reprise). + if (! $user->exists) { + $user->gender = 'other'; + $user->natricule = app(MatriculeService::class)->generateUserMatricule(Roles::ADMINISTRATOR); + } + + $user->save(); + $user->syncRoles([Roles::ADMINISTRATOR]); + + return $user; + } + + /** + * Normalise les réglages de sécurité (valeurs par défaut sûres). + * + * NB : la 2FA n'est volontairement pas imposée (choix de chaque utilisateur). + * + * @param array $input + * @return array{force_https: bool, app_debug_off: bool, enable_sentry: bool, password_policy: string} + */ + private function normalizeSecurity(array $input): array + { + $defaults = (array) config('install.security_defaults'); + + return [ + 'force_https' => (bool) ($input['force_https'] ?? $defaults['force_https'] ?? true), + 'app_debug_off' => (bool) ($input['app_debug_off'] ?? $defaults['app_debug_off'] ?? true), + 'enable_sentry' => (bool) ($input['enable_sentry'] ?? $defaults['enable_sentry'] ?? false), + 'password_policy' => in_array($input['password_policy'] ?? null, ['strong', 'medium'], true) + ? (string) $input['password_policy'] + : (string) ($defaults['password_policy'] ?? 'strong'), + ]; + } + + /** + * Applique les réglages de sécurité qui ont un effet runtime via .env. + * + * Best-effort : si .env est absent ou non inscriptible, on n'échoue pas + * l'installation (les choix restent consignés dans le verrou). + * + * @param array{force_https: bool, app_debug_off: bool, enable_sentry: bool, password_policy: string} $security + */ + private function applySecurity(array $security): void + { + $changes = []; + + if ($security['app_debug_off']) { + $changes['APP_DEBUG'] = 'false'; + } + + // force_https réellement effectif : FORCE_HTTPS est lu par AppServiceProvider + // (hors local) pour appeler URL::forceScheme('https'). On aligne aussi APP_URL. + $changes['FORCE_HTTPS'] = $security['force_https'] ? 'true' : 'false'; + if ($security['force_https']) { + $changes['APP_URL'] = $this->httpsUrl((string) config('app.url')); + } + + $this->writeEnv($changes); + } + + private function httpsUrl(string $url): string + { + $url = trim($url) ?: 'http://localhost'; + + return (string) preg_replace('#^http://#i', 'https://', $url); + } + + /** + * Écrit/renseigne des clés dans le fichier .env (best-effort). + * + * @param array $changes + */ + private function writeEnv(array $changes): void + { + // Jamais de mutation du .env sous tests (évite tout effet de bord sur le dépôt). + if (app()->runningUnitTests()) { + return; + } + + try { + $path = base_path('.env'); + + if (! File::exists($path) || ! File::isWritable($path)) { + return; + } + + $content = (string) File::get($path); + + foreach ($changes as $key => $value) { + $line = $key.'='.$value; + $pattern = '/^'.preg_quote($key, '/').'=.*$/m'; + + $content = preg_match($pattern, $content) + ? (string) preg_replace($pattern, $line, $content) + : rtrim($content, "\n")."\n".$line."\n"; + } + + File::put($path, $content); + + // L4 : si la config est en cache, les nouvelles valeurs .env (APP_DEBUG, + // FORCE_HTTPS…) ne seraient pas lues. On purge le cache pour qu'elles + // prennent effet dès le prochain boot (no-op si aucun cache). + Artisan::call('config:clear'); + } catch (Throwable) { + // Best-effort : un .env non modifiable ne doit pas faire échouer l'installation. + } + } + + private function parseDate(mixed $value): ?Carbon + { + $value = trim((string) $value); + + if ($value === '') { + return null; + } + + try { + return Carbon::parse($value)->startOfDay(); + } catch (Throwable) { + return null; + } + } + + /** Rentrée par défaut : 1er septembre de l'année scolaire courante. */ + private function defaultYearStart(): Carbon + { + $now = Carbon::now(); + $year = $now->month >= 9 ? $now->year : $now->year - 1; + + return Carbon::create($year, 9, 1)->startOfDay(); + } +} diff --git a/app/Support/Install/RequirementsChecker.php b/app/Support/Install/RequirementsChecker.php new file mode 100644 index 0000000..e27eb38 --- /dev/null +++ b/app/Support/Install/RequirementsChecker.php @@ -0,0 +1,104 @@ + + */ + public function check(): array + { + return [ + ...$this->phpRequirement(), + ...$this->extensionRequirements(), + ...$this->writableRequirements(), + ...$this->appKeyRequirement(), + ]; + } + + public function passes(): bool + { + foreach ($this->check() as $requirement) { + if (! $requirement['ok']) { + return false; + } + } + + return true; + } + + /** @return list */ + private function phpRequirement(): array + { + $min = (string) config('install.min_php', '8.3.0'); + $ok = version_compare(PHP_VERSION, $min, '>='); + + return [[ + 'key' => 'php', + 'label' => 'PHP >= '.$min, + 'ok' => $ok, + // L2 : ne pas divulguer la version exacte quand tout va bien (empreinte + // système) ; on ne l'affiche que si le prérequis échoue, pour aider à corriger. + 'hint' => $ok ? 'OK' : 'Version actuelle : '.PHP_VERSION, + ]]; + } + + /** @return list */ + private function extensionRequirements(): array + { + $out = []; + + foreach ((array) config('install.required_extensions', []) as $ext) { + $ok = extension_loaded($ext); + $out[] = [ + 'key' => 'ext:'.$ext, + 'label' => 'Extension '.$ext, + 'ok' => $ok, + 'hint' => $ok ? 'Chargée' : 'Manquante', + ]; + } + + return $out; + } + + /** @return list */ + private function writableRequirements(): array + { + $out = []; + + foreach ((array) config('install.writable_paths', []) as $path) { + $full = base_path($path); + $ok = File::isDirectory($full) && File::isWritable($full); + $out[] = [ + 'key' => 'writable:'.$path, + 'label' => $path.' inscriptible', + 'ok' => $ok, + 'hint' => $ok ? 'OK' : 'Donnez les droits en écriture', + ]; + } + + return $out; + } + + /** @return list */ + private function appKeyRequirement(): array + { + $ok = (string) config('app.key') !== ''; + + return [[ + 'key' => 'app_key', + 'label' => 'Clé d\'application (APP_KEY)', + 'ok' => $ok, + 'hint' => $ok ? 'Définie' : 'Lancez : php artisan key:generate', + ]]; + } +} diff --git a/bootstrap/app.php b/bootstrap/app.php index 15c3e25..fbbd277 100644 --- a/bootstrap/app.php +++ b/bootstrap/app.php @@ -1,5 +1,7 @@ alias([ + 'install.guard' => EnsureAppNotInstalled::class, + ]); + + // La redirection « non installé » doit précéder l'authentification, sinon + // une route protégée renverrait vers /login avant d'atteindre l'assistant. + // La liste de priorité cible l'interface, pas la classe concrète. + $middleware->prependToPriorityList( + before: \Illuminate\Contracts\Auth\Middleware\AuthenticatesRequests::class, + prepend: EnsureAppInstalled::class, + ); }) ->withExceptions(function (Exceptions $exceptions): void { // Capture des exceptions vers Sentry/GlitchTip. No-op si SENTRY_LARAVEL_DSN est vide. diff --git a/config/install.php b/config/install.php new file mode 100644 index 0000000..0c3ba32 --- /dev/null +++ b/config/install.php @@ -0,0 +1,81 @@ + '8.3.0', + + 'required_extensions' => [ + 'pdo_pgsql', + 'mbstring', + 'openssl', + 'ctype', + 'json', + 'fileinfo', + 'gd', + 'zip', + ], + + // Dossiers devant être inscriptibles par le serveur web. + 'writable_paths' => [ + 'storage', + 'bootstrap/cache', + ], + + // Fichier-verrou (relatif à storage/app/). Sa présence = application installée. + 'lock_file' => 'installed.json', + + // Forçage HTTPS piloté par l'assistant (écrit FORCE_HTTPS dans .env). Appliqué + // par AppServiceProvider hors environnement local (en production, HTTPS est déjà + // forcé). Lu ici pour rester compatible avec `config:cache`. + 'force_https' => (bool) env('FORCE_HTTPS', false), + + // Valeurs par défaut proposées dans l'étape « École ». + 'defaults' => [ + 'locale' => Locales::DEFAULT, + 'currency' => Currencies::DEFAULT, + 'country' => Countries::DEFAULT, + 'timezone' => 'Africa/Lome', + ], + + // Niveaux / cycles proposés à l'étape « École ». Une école peut en cocher + // un, deux ou davantage : ils sont rattachés comme « types de classe » + // (relation School::classTypes via la table pivot class_type_school). + // + // Clé = slug stable (envoyé par le formulaire, libellé traduit côté front) ; + // valeur = nom EXACT du ClassroomType tel que posé par ClassTypeSeeder — c'est + // par ce nom que l'Installer retrouve le type semé pour l'attacher à l'école. + // Toute modification doit rester synchronisée avec ClassTypeSeeder + // (garde-fou : InstallWizardTest::class_types_config_matches_seeder). + 'levels' => [ + 'maternelle' => 'Maternelle (Préscolaire)', + 'primaire' => 'Primaire (EPP)', + 'college' => 'Collège (Secondaire 1)', + 'lycee' => 'Lycée (Secondaire 2)', + 'lycee_technique' => 'Lycée Technique', + ], + + // Réglages de sécurité pré-cochés à l'étape « Protocole de sécurité ». + // La 2FA n'est volontairement PAS imposée (choix laissé à chaque utilisateur). + 'security_defaults' => [ + 'force_https' => true, + 'app_debug_off' => true, + 'password_policy' => 'strong', + 'enable_sentry' => false, + ], +]; diff --git a/database/migrations/2026_11_17_000001_add_owner_id_to_schools_table.php b/database/migrations/2026_11_17_000001_add_owner_id_to_schools_table.php new file mode 100644 index 0000000..9957e8a --- /dev/null +++ b/database/migrations/2026_11_17_000001_add_owner_id_to_schools_table.php @@ -0,0 +1,37 @@ +uuid('owner_id')->nullable()->after('active'); + $table->foreign('owner_id')->references('id')->on('users')->nullOnDelete(); + }); + } + + public function down(): void + { + if (! Schema::hasColumn('schools', 'owner_id')) { + return; + } + + Schema::table('schools', function (Blueprint $table) { + $table->dropForeign(['owner_id']); + $table->dropColumn('owner_id'); + }); + } +}; diff --git a/database/migrations/2026_11_17_000002_add_country_to_schools_table.php b/database/migrations/2026_11_17_000002_add_country_to_schools_table.php new file mode 100644 index 0000000..b0ed329 --- /dev/null +++ b/database/migrations/2026_11_17_000002_add_country_to_schools_table.php @@ -0,0 +1,28 @@ +string('country', 2)->default('TG')->after('region'); + } + }); + } + + public function down(): void + { + Schema::table('schools', function (Blueprint $table) { + if (Schema::hasColumn('schools', 'country')) { + $table->dropColumn('country'); + } + }); + } +}; diff --git a/database/seeders/CountrySeeder.php b/database/seeders/CountrySeeder.php index 6367c9c..3cfc33e 100644 --- a/database/seeders/CountrySeeder.php +++ b/database/seeders/CountrySeeder.php @@ -2,6 +2,7 @@ namespace Database\Seeders; +use App\Constants\Countries; use App\Models\Country; use Illuminate\Database\Seeder; use Illuminate\Support\Str; @@ -11,259 +12,19 @@ class CountrySeeder extends Seeder /** * Liste ISO des pays. Idempotent et sûr en prod : upsert par `code` * (aucun truncate, UUID stables entre exécutions, compatible PostgreSQL). + * + * La liste provient de App\Constants\Countries (source unique, également + * utilisée sans base par l'assistant d'installation). */ public function run(): void { $now = now(); - $countries = [ - ['name' => 'Afghanistan', 'code' => 'AF'], - ['name' => 'Albania', 'code' => 'AL'], - ['name' => 'Algeria', 'code' => 'DZ'], - ['name' => 'American Samoa', 'code' => 'AS'], - ['name' => 'Andorra', 'code' => 'AD'], - ['name' => 'Angola', 'code' => 'AO'], - ['name' => 'Anguilla', 'code' => 'AI'], - ['name' => 'Antarctica', 'code' => 'AQ'], - ['name' => 'Antigua and Barbuda', 'code' => 'AG'], - ['name' => 'Argentina', 'code' => 'AR'], - ['name' => 'Armenia', 'code' => 'AM'], - ['name' => 'Aruba', 'code' => 'AW'], - ['name' => 'Australia', 'code' => 'AU'], - ['name' => 'Austria', 'code' => 'AT'], - ['name' => 'Azerbaijan', 'code' => 'AZ'], - ['name' => 'Bahamas', 'code' => 'BS'], - ['name' => 'Bahrain', 'code' => 'BH'], - ['name' => 'Bangladesh', 'code' => 'BD'], - ['name' => 'Barbados', 'code' => 'BB'], - ['name' => 'Belarus', 'code' => 'BY'], - ['name' => 'Belgium', 'code' => 'BE'], - ['name' => 'Belize', 'code' => 'BZ'], - ['name' => 'Benin', 'code' => 'BJ'], - ['name' => 'Bermuda', 'code' => 'BM'], - ['name' => 'Bhutan', 'code' => 'BT'], - ['name' => 'Bolivia', 'code' => 'BO'], - ['name' => 'Bosnia and Herzegovina', 'code' => 'BA'], - ['name' => 'Botswana', 'code' => 'BW'], - ['name' => 'Bouvet Island', 'code' => 'BV'], - ['name' => 'Brazil', 'code' => 'BR'], - ['name' => 'British Indian Ocean Territory', 'code' => 'IO'], - ['name' => 'Brunei Darussalam', 'code' => 'BN'], - ['name' => 'Bulgaria', 'code' => 'BG'], - ['name' => 'Burkina Faso', 'code' => 'BF'], - ['name' => 'Burundi', 'code' => 'BI'], - ['name' => 'Cambodia', 'code' => 'KH'], - ['name' => 'Cameroon', 'code' => 'CM'], - ['name' => 'Canada', 'code' => 'CA'], - ['name' => 'Cape Verde', 'code' => 'CV'], - ['name' => 'Cayman Islands', 'code' => 'KY'], - ['name' => 'Central African Republic', 'code' => 'CF'], - ['name' => 'Chad', 'code' => 'TD'], - ['name' => 'Chile', 'code' => 'CL'], - ['name' => 'China', 'code' => 'CN'], - ['name' => 'Christmas Island', 'code' => 'CX'], - ['name' => 'Cocos (Keeling) Islands', 'code' => 'CC'], - ['name' => 'Colombia', 'code' => 'CO'], - ['name' => 'Comoros', 'code' => 'KM'], - ['name' => 'Democratic Republic of the Congo', 'code' => 'CD'], - ['name' => 'Republic of Congo', 'code' => 'CG'], - ['name' => 'Cook Islands', 'code' => 'CK'], - ['name' => 'Costa Rica', 'code' => 'CR'], - ['name' => 'Croatia (Hrvatska)', 'code' => 'HR'], - ['name' => 'Cuba', 'code' => 'CU'], - ['name' => 'Cyprus', 'code' => 'CY'], - ['name' => 'Czech Republic', 'code' => 'CZ'], - ['name' => 'Denmark', 'code' => 'DK'], - ['name' => 'Djibouti', 'code' => 'DJ'], - ['name' => 'Dominica', 'code' => 'DM'], - ['name' => 'Dominican Republic', 'code' => 'DO'], - ['name' => 'East Timor', 'code' => 'TL'], - ['name' => 'Ecuador', 'code' => 'EC'], - ['name' => 'Egypt', 'code' => 'EG'], - ['name' => 'El Salvador', 'code' => 'SV'], - ['name' => 'Equatorial Guinea', 'code' => 'GQ'], - ['name' => 'Eritrea', 'code' => 'ER'], - ['name' => 'Estonia', 'code' => 'EE'], - ['name' => 'Ethiopia', 'code' => 'ET'], - ['name' => 'Falkland Islands (Malvinas)', 'code' => 'FK'], - ['name' => 'Faroe Islands', 'code' => 'FO'], - ['name' => 'Fiji', 'code' => 'FJ'], - ['name' => 'Finland', 'code' => 'FI'], - ['name' => 'France', 'code' => 'FR'], - ['name' => 'France, Metropolitan', 'code' => 'FX'], - ['name' => 'French Guiana', 'code' => 'GF'], - ['name' => 'French Polynesia', 'code' => 'PF'], - ['name' => 'French Southern Territories', 'code' => 'TF'], - ['name' => 'Gabon', 'code' => 'GA'], - ['name' => 'Gambia', 'code' => 'GM'], - ['name' => 'Georgia', 'code' => 'GE'], - ['name' => 'Germany', 'code' => 'DE'], - ['name' => 'Ghana', 'code' => 'GH'], - ['name' => 'Gibraltar', 'code' => 'GI'], - ['name' => 'Guernsey', 'code' => 'GG'], - ['name' => 'Greece', 'code' => 'GR'], - ['name' => 'Greenland', 'code' => 'GL'], - ['name' => 'Grenada', 'code' => 'GD'], - ['name' => 'Guadeloupe', 'code' => 'GP'], - ['name' => 'Guam', 'code' => 'GU'], - ['name' => 'Guatemala', 'code' => 'GT'], - ['name' => 'Guinea', 'code' => 'GN'], - ['name' => 'Guinea-Bissau', 'code' => 'GW'], - ['name' => 'Guyana', 'code' => 'GY'], - ['name' => 'Haiti', 'code' => 'HT'], - ['name' => 'Heard and Mc Donald Islands', 'code' => 'HM'], - ['name' => 'Honduras', 'code' => 'HN'], - ['name' => 'Hong Kong', 'code' => 'HK'], - ['name' => 'Hungary', 'code' => 'HU'], - ['name' => 'Iceland', 'code' => 'IS'], - ['name' => 'India', 'code' => 'IN'], - ['name' => 'Isle of Man', 'code' => 'IM'], - ['name' => 'Indonesia', 'code' => 'ID'], - ['name' => 'Iran (Islamic Republic of)', 'code' => 'IR'], - ['name' => 'Iraq', 'code' => 'IQ'], - ['name' => 'Ireland', 'code' => 'IE'], - ['name' => 'Israel', 'code' => 'IL'], - ['name' => 'Italy', 'code' => 'IT'], - ['name' => 'Ivory Coast', 'code' => 'CI'], - ['name' => 'Jersey', 'code' => 'JE'], - ['name' => 'Jamaica', 'code' => 'JM'], - ['name' => 'Japan', 'code' => 'JP'], - ['name' => 'Jordan', 'code' => 'JO'], - ['name' => 'Kazakhstan', 'code' => 'KZ'], - ['name' => 'Kenya', 'code' => 'KE'], - ['name' => 'Kiribati', 'code' => 'KI'], - ['name' => 'Korea, Democratic People\'s Republic of', 'code' => 'KP'], - ['name' => 'Korea, Republic of', 'code' => 'KR'], - ['name' => 'Kosovo', 'code' => 'XK'], - ['name' => 'Kuwait', 'code' => 'KW'], - ['name' => 'Kyrgyzstan', 'code' => 'KG'], - ['name' => 'Lao People\'s Democratic Republic', 'code' => 'LA'], - ['name' => 'Latvia', 'code' => 'LV'], - ['name' => 'Lebanon', 'code' => 'LB'], - ['name' => 'Lesotho', 'code' => 'LS'], - ['name' => 'Liberia', 'code' => 'LR'], - ['name' => 'Libyan Arab Jamahiriya', 'code' => 'LY'], - ['name' => 'Liechtenstein', 'code' => 'LI'], - ['name' => 'Lithuania', 'code' => 'LT'], - ['name' => 'Luxembourg', 'code' => 'LU'], - ['name' => 'Macau', 'code' => 'MO'], - ['name' => 'North Macedonia', 'code' => 'MK'], - ['name' => 'Madagascar', 'code' => 'MG'], - ['name' => 'Malawi', 'code' => 'MW'], - ['name' => 'Malaysia', 'code' => 'MY'], - ['name' => 'Maldives', 'code' => 'MV'], - ['name' => 'Mali', 'code' => 'ML'], - ['name' => 'Malta', 'code' => 'MT'], - ['name' => 'Marshall Islands', 'code' => 'MH'], - ['name' => 'Martinique', 'code' => 'MQ'], - ['name' => 'Mauritania', 'code' => 'MR'], - ['name' => 'Mauritius', 'code' => 'MU'], - ['name' => 'Mayotte', 'code' => 'YT'], - ['name' => 'Mexico', 'code' => 'MX'], - ['name' => 'Micronesia, Federated States of', 'code' => 'FM'], - ['name' => 'Moldova, Republic of', 'code' => 'MD'], - ['name' => 'Monaco', 'code' => 'MC'], - ['name' => 'Mongolia', 'code' => 'MN'], - ['name' => 'Montenegro', 'code' => 'ME'], - ['name' => 'Montserrat', 'code' => 'MS'], - ['name' => 'Morocco', 'code' => 'MA'], - ['name' => 'Mozambique', 'code' => 'MZ'], - ['name' => 'Myanmar', 'code' => 'MM'], - ['name' => 'Namibia', 'code' => 'NA'], - ['name' => 'Nauru', 'code' => 'NR'], - ['name' => 'Nepal', 'code' => 'NP'], - ['name' => 'Netherlands', 'code' => 'NL'], - ['name' => 'Netherlands Antilles', 'code' => 'AN'], - ['name' => 'New Caledonia', 'code' => 'NC'], - ['name' => 'New Zealand', 'code' => 'NZ'], - ['name' => 'Nicaragua', 'code' => 'NI'], - ['name' => 'Niger', 'code' => 'NE'], - ['name' => 'Nigeria', 'code' => 'NG'], - ['name' => 'Niue', 'code' => 'NU'], - ['name' => 'Norfolk Island', 'code' => 'NF'], - ['name' => 'Northern Mariana Islands', 'code' => 'MP'], - ['name' => 'Norway', 'code' => 'NO'], - ['name' => 'Oman', 'code' => 'OM'], - ['name' => 'Pakistan', 'code' => 'PK'], - ['name' => 'Palau', 'code' => 'PW'], - ['name' => 'Palestine', 'code' => 'PS'], - ['name' => 'Panama', 'code' => 'PA'], - ['name' => 'Papua New Guinea', 'code' => 'PG'], - ['name' => 'Paraguay', 'code' => 'PY'], - ['name' => 'Peru', 'code' => 'PE'], - ['name' => 'Philippines', 'code' => 'PH'], - ['name' => 'Pitcairn', 'code' => 'PN'], - ['name' => 'Poland', 'code' => 'PL'], - ['name' => 'Portugal', 'code' => 'PT'], - ['name' => 'Puerto Rico', 'code' => 'PR'], - ['name' => 'Qatar', 'code' => 'QA'], - ['name' => 'Reunion', 'code' => 'RE'], - ['name' => 'Romania', 'code' => 'RO'], - ['name' => 'Russian Federation', 'code' => 'RU'], - ['name' => 'Rwanda', 'code' => 'RW'], - ['name' => 'Saint Kitts and Nevis', 'code' => 'KN'], - ['name' => 'Saint Lucia', 'code' => 'LC'], - ['name' => 'Saint Vincent and the Grenadines', 'code' => 'VC'], - ['name' => 'Samoa', 'code' => 'WS'], - ['name' => 'San Marino', 'code' => 'SM'], - ['name' => 'Sao Tome and Principe', 'code' => 'ST'], - ['name' => 'Saudi Arabia', 'code' => 'SA'], - ['name' => 'Senegal', 'code' => 'SN'], - ['name' => 'Serbia', 'code' => 'RS'], - ['name' => 'Seychelles', 'code' => 'SC'], - ['name' => 'Sierra Leone', 'code' => 'SL'], - ['name' => 'Singapore', 'code' => 'SG'], - ['name' => 'Slovakia', 'code' => 'SK'], - ['name' => 'Slovenia', 'code' => 'SI'], - ['name' => 'Solomon Islands', 'code' => 'SB'], - ['name' => 'Somalia', 'code' => 'SO'], - ['name' => 'South Africa', 'code' => 'ZA'], - ['name' => 'South Georgia South Sandwich Islands', 'code' => 'GS'], - ['name' => 'South Sudan', 'code' => 'SS'], - ['name' => 'Spain', 'code' => 'ES'], - ['name' => 'Sri Lanka', 'code' => 'LK'], - ['name' => 'St. Helena', 'code' => 'SH'], - ['name' => 'St. Pierre and Miquelon', 'code' => 'PM'], - ['name' => 'Sudan', 'code' => 'SD'], - ['name' => 'Suriname', 'code' => 'SR'], - ['name' => 'Svalbard and Jan Mayen Islands', 'code' => 'SJ'], - ['name' => 'Eswatini', 'code' => 'SZ'], - ['name' => 'Sweden', 'code' => 'SE'], - ['name' => 'Switzerland', 'code' => 'CH'], - ['name' => 'Syrian Arab Republic', 'code' => 'SY'], - ['name' => 'Taiwan', 'code' => 'TW'], - ['name' => 'Tajikistan', 'code' => 'TJ'], - ['name' => 'Tanzania, United Republic of', 'code' => 'TZ'], - ['name' => 'Thailand', 'code' => 'TH'], - ['name' => 'Togo', 'code' => 'TG'], - ['name' => 'Tokelau', 'code' => 'TK'], - ['name' => 'Tonga', 'code' => 'TO'], - ['name' => 'Trinidad and Tobago', 'code' => 'TT'], - ['name' => 'Tunisia', 'code' => 'TN'], - ['name' => 'Turkey', 'code' => 'TR'], - ['name' => 'Turkmenistan', 'code' => 'TM'], - ['name' => 'Turks and Caicos Islands', 'code' => 'TC'], - ['name' => 'Tuvalu', 'code' => 'TV'], - ['name' => 'Uganda', 'code' => 'UG'], - ['name' => 'Ukraine', 'code' => 'UA'], - ['name' => 'United Arab Emirates', 'code' => 'AE'], - ['name' => 'United Kingdom', 'code' => 'GB'], - ['name' => 'United States', 'code' => 'US'], - ['name' => 'United States minor outlying islands', 'code' => 'UM'], - ['name' => 'Uruguay', 'code' => 'UY'], - ['name' => 'Uzbekistan', 'code' => 'UZ'], - ['name' => 'Vanuatu', 'code' => 'VU'], - ['name' => 'Vatican City State', 'code' => 'VA'], - ['name' => 'Venezuela', 'code' => 'VE'], - ['name' => 'Vietnam', 'code' => 'VN'], - ['name' => 'Virgin Islands (British)', 'code' => 'VG'], - ['name' => 'Virgin Islands (U.S.)', 'code' => 'VI'], - ['name' => 'Wallis and Futuna Islands', 'code' => 'WF'], - ['name' => 'Western Sahara', 'code' => 'EH'], - ['name' => 'Yemen', 'code' => 'YE'], - ['name' => 'Zambia', 'code' => 'ZM'], - ['name' => 'Zimbabwe', 'code' => 'ZW'], - ]; + $countries = array_map( + static fn (string $code, string $name): array => ['name' => $name, 'code' => $code], + array_keys(Countries::all()), + array_values(Countries::all()), + ); // Normalisation des anciens codes non-ISO déjà présents en base (renomme en // conservant l'UUID ; si le code cible existe déjà, on retire le doublon). diff --git a/database/seeders/DemoSeeder.php b/database/seeders/DemoSeeder.php deleted file mode 100644 index 8dca323..0000000 --- a/database/seeders/DemoSeeder.php +++ /dev/null @@ -1,2104 +0,0 @@ - 28, - 'CE2' => 30, - 'CM2' => 32, - '6ème' => 35, - '3ème' => 30, - 'Tle D' => 25, - ]; - - /** Effectif plancher pour toute classe non listée dans CLASS_SIZES. */ - private const MIN_CLASS_SIZE = 20; - - /** - * Années passées à générer pour l'onglet « Comparaisons » : sans historique, - * les tendances pluriannuelles n'ont qu'un point. Chaque ligne fixe les cibles - * agrégées de l'année (en %), avec une progression volontaire vers l'année - * courante (effectif et réussite en hausse, redoublement et abandon en baisse). - */ - private const HISTORY = [ - ['year' => '2023-2024', 'effectif' => 360, 'pass' => 63, 'recovery' => 69, 'redoublement' => 15, 'abandon' => 7, 'admission' => 70], - ['year' => '2024-2025', 'effectif' => 440, 'pass' => 67, 'recovery' => 73, 'redoublement' => 12, 'abandon' => 5, 'admission' => 76], - ]; - - /** Programme par cycle : code matière => coefficient. */ - private const CURRICULUM = [ - 'primaire' => [ - 'FRAN' => 4, 'MATH' => 4, 'EST' => 2, 'HG' => 2, - 'ECM' => 1, 'ANG' => 2, 'EPS' => 1, 'AC' => 1, - ], - 'college' => [ - 'FRAN' => 4, 'MATH' => 4, 'ANG' => 3, 'SVT' => 2, - 'SP' => 2, 'HG' => 3, 'ECM' => 1, 'ALL' => 2, 'EPS' => 1, - ], - 'lycee' => [ - 'MATH' => 5, 'SP' => 5, 'SVT' => 5, 'FRAN' => 2, - 'ANG' => 2, 'HG' => 2, 'PHILO' => 2, 'EPS' => 1, - ], - ]; - - /** Épreuves d'une période : type de référence et coefficient. */ - private const EXAMS = [ - ['type' => 'Interrogation', 'coefficient' => 1], - ['type' => 'Devoir', 'coefficient' => 2], - ['type' => 'Composition', 'coefficient' => 3], - ]; - - private Generator $faker; - - private School $school; - - private AcademicYear $year; - - private CarbonImmutable $today; - - /** @var Collection */ - private Collection $periods; - - /** @var Collection */ - private Collection $classes; - - /** @var array */ - private array $teacherIds = []; - - /** @var array>>|null */ - private ?array $localites = null; - - /** - * Poids de recrutement hors Grand Lomé, par région. - * Le Maritime domine, puis les régions par éloignement croissant : c'est le - * sens réel des migrations internes vers la capitale. - */ - private const REGION_WEIGHTS = [ - 'Maritime' => 40, - 'Plateaux' => 25, - 'Centrale' => 15, - 'Kara' => 12, - 'Savanes' => 8, - ]; - - public function run(): void - { - if (app()->environment('production')) { - $this->command?->warn('DemoSeeder ignoré : données de démonstration interdites en production.'); - - return; - } - - $this->faker = Faker::create('fr_FR'); - $this->faker->seed(self::SEED); - mt_srand(self::SEED); - - $this->today = CarbonImmutable::now(); - - if (! $this->resolveContext()) { - return; - } - - $this->step('Âges attendus des classes', fn () => $this->seedExpectedAges()); - $this->step('Barème et modèle de bulletin', fn () => $this->seedGradingConfig()); - $this->step('Enseignants', fn () => $this->seedTeachers()); - $this->step('Élèves et inscriptions', fn () => $this->seedStudentsAndEnrollments()); - $this->step('Programme et affectations', fn () => $this->seedCurriculum()); - $this->step('Évaluations', fn () => $this->seedEvaluations()); - $this->step('Notes', fn () => $this->seedMarks()); - $this->step('Moyennes par matière', fn () => $this->seedSubjectGrades()); - $this->step('Bourses', fn () => $this->seedScholarships()); - $this->step('Frais, factures et paiements', fn () => $this->seedFinance()); - $this->step('Présences', fn () => $this->seedAttendance()); - $this->step('Emploi du temps', fn () => $this->seedTimetable()); - $this->step('Calendrier scolaire', fn () => $this->seedCalendar()); - $this->step('Personnel et paie', fn () => $this->seedPayroll()); - $this->step('Dossiers courants', fn () => $this->seedCasework()); - $this->step('Bulletins', fn () => $this->seedReportCards()); - $this->step('Années passées (comparaisons)', fn () => $this->seedHistory()); - - $this->command?->newLine(); - $this->command?->info('Jeu de démonstration prêt.'); - } - - /* ------------------------------------------------------------------ */ - /* Contexte */ - /* ------------------------------------------------------------------ */ - - /** - * École, année active, périodes et classes de la démo : sans ce socle - * (posé par les seeders de référence) rien ne peut être rattaché. - */ - private function resolveContext(): bool - { - $school = School::query()->first(); - $year = AcademicYear::query()->where('active', true)->first() - ?? AcademicYear::query()->latest('start_date')->first(); - - if (! $school || ! $year) { - $this->command?->error('DemoSeeder : école ou année académique manquante. Lancez db:seed au préalable.'); - - return false; - } - - $this->school = $school; - $this->year = $year; - - $this->periods = AcademicPeriod::query() - ->where('academic_year_id', $year->id) - ->orderBy('start_date') - ->get(); - - if ($this->periods->isEmpty()) { - $this->command?->error('DemoSeeder : aucune période académique pour l\'année active.'); - - return false; - } - - // Toutes les classes actives : chacune doit être peuplée pour la démo. - $this->classes = Classroom::query() - ->with('type') - ->where('active', true) - ->get(); - - if ($this->classes->isEmpty()) { - $this->command?->error('DemoSeeder : aucune classe active (ClassroomSeeder).'); - - return false; - } - - return true; - } - - /** Cycle d'une classe, tel que référencé par self::CURRICULUM. */ - private function cycleOf(Classroom $class): string - { - $type = Str::lower($class->type->name ?? ''); - - return match (true) { - str_contains($type, 'primaire'), str_contains($type, 'maternelle') => 'primaire', - str_contains($type, 'collège') => 'college', - default => 'lycee', - }; - } - - /** - * Effectif visé d'une classe : valeur dédiée si définie, sinon un plancher de - * 20 avec une légère variation déterministe (20 à 24) pour éviter des classes - * toutes identiques. - */ - private function targetSize(Classroom $class): int - { - return self::CLASS_SIZES[$class->code] ?? self::MIN_CLASS_SIZE + (crc32((string) $class->code) % 5); - } - - private function step(string $label, callable $work): void - { - $this->command?->line(" - {$label}..."); - $work(); - } - - /* ------------------------------------------------------------------ */ - /* Géographie togolaise */ - /* ------------------------------------------------------------------ */ - - /** - * Divisions administratives réelles du Togo, extraites de Togonou : - * 5 régions, 40 préfectures et un échantillon de localités par préfecture. - * - * @return array>> - */ - private function localites(): array - { - if ($this->localites !== null) { - return $this->localites; - } - - $path = database_path('data/togo-localites.json'); - - if (! is_file($path)) { - $this->command?->warn('togo-localites.json introuvable : les élèves seront créés sans origine géographique.'); - - return $this->localites = []; - } - - return $this->localites = json_decode(file_get_contents($path), true)['regions'] ?? []; - } - - /** - * Origine géographique d'un élève. - * - * L'établissement est à Lomé, son recrutement l'est aussi : deux élèves sur - * trois viennent du Grand Lomé (Golfe et Agoè-Nyivé), le reste du pays selon - * des poids décroissants avec l'éloignement. Un tirage uniforme sur les 40 - * préfectures donnerait une école dont un quart des élèves vient des Savanes. - * - * @return array{region: string, prefecture: string, ville: string}|null - */ - private function origin(): ?array - { - $regions = $this->localites(); - - if ($regions === []) { - return null; - } - - if ($this->faker->boolean(65) && isset($regions['Maritime'])) { - $region = 'Maritime'; - $prefecture = $this->faker->randomElement( - array_values(array_intersect(['Golfe', 'Agoè-Nyivé'], array_keys($regions['Maritime']))) - ?: array_keys($regions['Maritime']) - ); - } else { - $region = $this->weighted(array_intersect_key(self::REGION_WEIGHTS, $regions)); - $prefecture = $this->faker->randomElement(array_keys($regions[$region])); - } - - $villes = $regions[$region][$prefecture] ?? []; - - return [ - 'region' => $region, - 'prefecture' => $prefecture, - 'ville' => $villes === [] ? $prefecture : $this->faker->randomElement($villes), - ]; - } - - /** - * Tirage pondéré. - * - * @param array $weights - */ - private function weighted(array $weights): string - { - $roll = $this->faker->numberBetween(1, max(array_sum($weights), 1)); - - foreach ($weights as $key => $weight) { - $roll -= $weight; - - if ($roll <= 0) { - return $key; - } - } - - return array_key_first($weights); - } - - /** Adresse à la togolaise : quartier et repère, plutôt qu'un numéro de rue. */ - private function address(string $ville): string - { - return 'Quartier '.$ville.', '.$this->faker->randomElement([ - 'face à l\'école primaire', - 'près du marché', - 'derrière la station', - 'non loin du dispensaire', - 'à côté de la pharmacie', - 'en face du terrain de football', - 'près du château d\'eau', - ]); - } - - /* ------------------------------------------------------------------ */ - /* Noms togolais */ - /* ------------------------------------------------------------------ */ - - /** - * Prénoms masculins togolais : d'abord les prénoms « jour de naissance » - * éwé/mina (majorité dans le sud et à Lomé), puis des prénoms courants, - * quelques prénoms du Nord et musulmans, et une minorité de prénoms chrétiens - * — reflet du métissage réel des registres d'état civil. - */ - private const FIRST_NAMES_MALE = [ - 'Kossi', 'Kossivi', 'Koffi', 'Kodjo', 'Kodzo', 'Komlan', 'Kokou', 'Koku', - 'Yao', 'Yaovi', 'Komi', 'Kwami', 'Mensah', 'Sena', 'Selom', 'Elom', 'Edem', - 'Etsé', 'Mawuli', 'Mawuko', 'Mawulom', 'Sitsopé', 'Delali', 'Senyo', - 'Worlanyo', 'Dodji', 'Kekeli', 'Elolo', 'Enyo', 'Sedem', 'Amevor', 'Fofo', - 'Essohanam', 'Essowè', 'Bawa', 'Kpatcha', 'Wiyao', 'Nadjombe', 'Tchalim', - 'Abalo', 'Ouro-Djeri', 'Ibrahim', 'Moussa', 'Salifou', 'Zakari', 'Aboubakar', - 'Emmanuel', 'Innocent', 'Prosper', 'Firmin', 'Célestin', 'Sylvain', - ]; - - /** Prénoms féminins togolais, même logique que la liste masculine. */ - private const FIRST_NAMES_FEMALE = [ - 'Akossiwa', 'Afiwa', 'Afiavi', 'Ablavi', 'Abla', 'Adjovi', 'Adjo', 'Adzoa', - 'Akouvi', 'Akou', 'Akoua', 'Akuvi', 'Ayaba', 'Ayawavi', 'Ama', 'Amivi', 'Ami', - 'Enyonam', 'Elolo', 'Delali', 'Senam', 'Sena', 'Akpene', 'Akpédjé', 'Sitsopé', - 'Mawunyo', 'Mawusi', 'Yayra', 'Woelali', 'Kafui', 'Essohana', 'Massan', 'Tchaa', - 'Abira', 'Fatimata', 'Aminata', 'Aïcha', 'Ramatou', 'Latifa', 'Salamatou', - 'Rafiatou', 'Zenabou', 'Delphine', 'Honorine', 'Perpétue', 'Bernadette', - 'Philomène', 'Georgette', 'Véronique', - ]; - - /** - * Noms de famille togolais : patronymes éwé/mina et guin, quelques noms du Nord - * (kabyè, tem), et des noms de familles afro-brésiliennes de Lomé (de Souza, - * d'Almeida...) bien réelles. Écrits en capitales à l'usage, comme sur les - * registres officiels. - */ - private const SURNAMES = [ - 'Adjaho', 'Agbeko', 'Agbodjan', 'Agbenou', 'Akakpo', 'Akoto', 'Amegan', - 'Amenumey', 'Ametepe', 'Amouzou', 'Anani', 'Apedo', 'Assih', 'Assignon', - 'Atsou', 'Ayité', 'Bedou', 'Dogbe', 'Dossou', 'Djondo', 'Edorh', 'Gbedemah', - 'Kougblenou', 'Kouma', 'Lawson', 'Mensah', 'Nyamadi', 'Sossou', 'Tay', - 'Tettey', 'Tossou', 'Zinsou', 'Bawara', 'Boukari', 'Djobo', 'Eklou', 'Folivi', - 'Kpatcha', 'Natchaba', 'Palanga', 'Tchangai', 'Tchani', 'Aholou', 'Attiogbé', - 'Ayassou', 'Gakpe', 'Hodabalo', 'Lokossou', 'Segbedji', 'Vigan', 'Amoussou', - 'Bassah', 'Danyo', 'Fiawoo', 'Koffigan', 'Sogadji', 'de Souza', 'd\'Almeida', - 'de Medeiros', 'Santos', 'Johnson', 'Ajavon', 'Aithnard', 'Quist', 'Vovor', - ]; - - /** Prénom togolais correspondant au sexe. */ - private function togoFirstName(string $gender): string - { - return $this->faker->randomElement( - $gender === 'female' ? self::FIRST_NAMES_FEMALE : self::FIRST_NAMES_MALE, - ); - } - - /** Nom de famille togolais (casse d'origine ; capitaliser à l'affichage si besoin). */ - private function togoSurname(): string - { - return $this->faker->randomElement(self::SURNAMES); - } - - /* ------------------------------------------------------------------ */ - /* Socle pédagogique */ - /* ------------------------------------------------------------------ */ - - /** - * Âge normal attendu par classe (l'entrée en CP1 se fait vers 6 ans). Alimente - * le calcul du sur-âge (retard scolaire) des statistiques, resté vide sans lui. - * Idempotent : ne touche que les classes dont l'âge attendu n'est pas renseigné. - */ - private function seedExpectedAges(): void - { - $ages = [ - 'PS' => 3, 'MS' => 4, 'GS' => 5, - 'CP1' => 6, 'CP2' => 7, 'CE1' => 8, 'CE2' => 9, 'CM1' => 10, 'CM2' => 11, - '6ème' => 12, '5ème' => 13, '4ème' => 14, '3ème' => 15, - '2nd A' => 16, '2nd S' => 16, '1ère A4' => 17, '1ère D' => 17, '1ère C' => 17, - 'Tle A4' => 18, 'Tle D' => 18, 'Tle C' => 18, - ]; - - foreach ($ages as $code => $age) { - Classroom::query()->where('code', $code)->whereNull('expected_age')->update(['expected_age' => $age]); - } - } - - /** - * Barème de notation et modèle de bulletin. - * Sans configuration active, moyennes et bulletins n'ont aucune règle de calcul. - */ - private function seedGradingConfig(): void - { - // Les quatre mentions standard (Passable → Très bien) plutôt que le schéma - // « honneurs » par défaut : c'est ce que la répartition des mentions des - // statistiques agrège, et ce que porte un bulletin togolais courant. - $mentions = [ - ['label' => 'Très bien', 'min' => 16], - ['label' => 'Bien', 'min' => 14], - ['label' => 'Assez bien', 'min' => 12], - ['label' => 'Passable', 'min' => 10], - ]; - - GradingConfig::updateOrCreate( - ['school_id' => $this->school->id, 'classroom_type_id' => null], - [ - 'name' => 'Barème par défaut', - 'is_active' => true, - 'passing_score' => 10, - 'default_max_score' => 20, - 'class_weight' => 1, - 'comp_weight' => 1, - 'round_precision' => 2, - 'mentions' => $mentions, - ], - ); - - $hasTemplate = BulletinTemplate::query() - ->where('school_id', $this->school->id) - ->whereNull('classroom_type_id') - ->exists(); - - if (! $hasTemplate) { - $this->call(BulletinTemplateSeeder::class); - } - } - - /** Corps enseignant : comptes utilisateurs + rôle, réutilisés par les affectations. */ - private function seedTeachers(): void - { - $existing = User::query()->role('enseignant')->pluck('id')->all(); - - for ($i = count($existing); $i < 14; $i++) { - // Le sexe est tiré d'abord : le prénom en découle, sinon la liste des - // enseignants affiche des « Pauline » déclarées masculines. - $gender = $this->faker->randomElement(['male', 'female']); - $firstname = $this->togoFirstName($gender); - $lastname = Str::upper($this->togoSurname()); - - $user = User::create([ - 'firstname' => $firstname, - 'lastname' => $lastname, - 'email' => 'prof'.($i + 1).'@dalibi.tg', - 'gender' => $gender, - 'telephone' => '+228 9'.$this->faker->numerify('# ## ## ##'), - 'address' => $this->address($this->origin()['ville'] ?? 'Lomé'), - 'password' => Hash::make('password123'), - 'is_demo' => true, - 'email_verified_at' => now(), - ]); - - $user->assignRole('enseignant'); - $existing[] = $user->id; - } - - $this->teacherIds = $existing; - } - - /* ------------------------------------------------------------------ */ - /* Élèves et inscriptions */ - /* ------------------------------------------------------------------ */ - - /** - * Complète l'effectif de chaque classe jusqu'à la cible. - * Les élèves déjà présents mais non inscrits sont récupérés avant d'en créer - * de nouveaux : une base à moitié semée ne produit pas de doublons. - */ - private function seedStudentsAndEnrollments(): void - { - $enrolledBy = User::query()->role('administrateur')->value('id') ?? User::query()->value('id'); - $sequence = Enrollment::query()->count(); - - $orphans = Student::query() - ->whereNotIn('id', Enrollment::query()->select('student_id')) - ->get() - ->all(); - - foreach ($this->classes as $class) { - $target = $this->targetSize($class); - $current = Enrollment::query() - ->where('class_id', $class->id) - ->where('academic_year_id', $this->year->id) - ->count(); - - for ($i = $current; $i < $target; $i++) { - $student = array_pop($orphans) ?? $this->createStudent($class); - - Enrollment::create([ - 'school_id' => $this->school->id, - 'student_id' => $student->id, - 'class_id' => $class->id, - 'academic_year_id' => $this->year->id, - 'enrollment_code' => 'INS-'.$this->year->year.'-'.str_pad((string) (++$sequence), 4, '0', STR_PAD_LEFT), - 'enrolled_by' => $enrolledBy, - 'enrollment_date' => $this->year->start_date, - 'status' => Enrollment::STATUS_ACTIVE, - 'academic_status' => 'en_cours', - ]); - } - } - } - - /** Élève complet : compte, dossier administratif, parents et fiche médicale. */ - private function createStudent(Classroom $class): Student - { - $gender = $this->faker->randomElement(['male', 'female']); - $firstname = $this->togoFirstName($gender); - $lastname = Str::upper($this->togoSurname()); - - // L'âge suit le niveau : un CP1 de 17 ans décrédibiliserait toute la démo. - $age = match ($this->cycleOf($class)) { - 'primaire' => $this->faker->numberBetween(6, 11), - 'college' => $this->faker->numberBetween(12, 15), - default => $this->faker->numberBetween(16, 19), - }; - $seq = Student::query()->count() + 1; - - $origin = $this->origin(); - $ville = $origin['ville'] ?? 'Lomé'; - - // Beaucoup d'élèves scolarisés à Lomé sont nés à l'intérieur du pays : - // un quart se voit attribuer une autre localité de naissance. - $naissance = $this->faker->boolean(25) ? ($this->origin()['ville'] ?? $ville) : $ville; - - $user = User::create([ - 'firstname' => $firstname, - 'lastname' => $lastname, - 'email' => 'eleve'.$seq.'@dalibi.tg', - 'gender' => $gender, - 'birth_date' => $this->today->subYears($age)->toDateString(), - 'telephone' => '+228 9'.$this->faker->numerify('# ## ## ##'), - 'address' => $this->address($ville), - 'password' => Hash::make('password123'), - 'is_demo' => true, - 'email_verified_at' => now(), - ]); - - $student = Student::create([ - 'user_id' => $user->id, - 'matricule' => 'DEM'.str_pad((string) $seq, 4, '0', STR_PAD_LEFT), - 'firstname' => $firstname, - 'lastname' => $lastname, - 'gender' => $gender, - 'birth_date' => $this->today->subYears($age)->toDateString(), - 'place_of_birth' => $naissance, - 'nationality' => 'Togolaise', - 'address' => $this->address($ville), - 'city' => $ville, - 'region' => $origin['region'] ?? null, - 'prefecture' => $origin['prefecture'] ?? null, - 'phone' => '+228 9'.$this->faker->numerify('# ## ## ##'), - 'email' => 'eleve'.$seq.'@dalibi.tg', - 'active' => true, - ]); - - StudentInformation::create([ - 'student_id' => $student->id, - 'birth_certificate_number' => 'ACT-'.$this->faker->unique()->numberBetween(100000, 999999), - 'birth_certificate_issue_date' => $this->today->subYears($age)->addMonths(2)->toDateString(), - 'birth_certificate_issue_place' => 'Lomé', - 'admission_type' => $this->faker->randomElement(['new', 'transfer', 're_admission']), - ]); - - StudentParent::create([ - 'student_id' => $student->id, - 'father_firstname' => $this->togoFirstName('male'), - 'father_lastname' => $lastname, - 'father_profession' => $this->faker->randomElement(['Enseignant', 'Commerçant', 'Agriculteur', 'Fonctionnaire', 'Chauffeur', 'Menuisier', 'Infirmier']), - 'father_phone' => '+228 9'.$this->faker->numerify('# ## ## ##'), - 'mother_firstname' => $this->togoFirstName('female'), - 'mother_lastname' => Str::upper($this->togoSurname()), - 'mother_profession' => $this->faker->randomElement(['Commerçante', 'Couturière', 'Enseignante', 'Infirmière', 'Coiffeuse', 'Secrétaire']), - 'mother_phone' => '+228 9'.$this->faker->numerify('# ## ## ##'), - 'email' => 'parent'.$seq.'@dalibi.tg', - ]); - - StudentMedicalInfo::create([ - 'student_id' => $student->id, - 'blood_group' => $this->faker->randomElement(['A+', 'A-', 'B+', 'B-', 'AB+', 'O+', 'O-']), - 'allergies' => $this->faker->optional(0.2)->randomElement(['Arachides', 'Poussière', 'Pollen', 'Fruits de mer']), - 'vaccinations' => 'DTC-Polio-Hib-HepB', - 'emergency_contact_name' => Str::upper($this->togoSurname()).' '.$this->togoFirstName($this->faker->randomElement(['male', 'female'])), - 'emergency_contact_phone' => '+228 9'.$this->faker->numerify('# ## ## ##'), - ]); - - return $student; - } - - /* ------------------------------------------------------------------ */ - /* Programme */ - /* ------------------------------------------------------------------ */ - - /** Matières de chaque classe + professeur titulaire par matière. */ - private function seedCurriculum(): void - { - $subjects = Subject::query()->get()->keyBy('code'); - $slot = 0; - - foreach ($this->classes as $class) { - foreach (self::CURRICULUM[$this->cycleOf($class)] as $code => $coefficient) { - $subject = $subjects->get($code); - - if (! $subject) { - continue; - } - - ClassSubject::firstOrCreate( - [ - 'class_id' => $class->id, - 'subject_id' => $subject->id, - 'academic_year_id' => $this->year->id, - ], - ['coefficient' => $coefficient, 'group' => 'obligatoire'], - ); - - SubjectAssignment::firstOrCreate( - [ - 'class_id' => $class->id, - 'subject_id' => $subject->id, - 'academic_year_id' => $this->year->id, - ], - [ - 'teacher_id' => $this->teacherIds[$slot++ % max(count($this->teacherIds), 1)], - 'active' => true, - ], - ); - } - } - } - - /* ------------------------------------------------------------------ */ - /* Évaluations et notes */ - /* ------------------------------------------------------------------ */ - - /** - * Garantit la catégorie des types d'évaluation, dont dépend le calcul - * Classe/Compo du bulletin : la « Composition » doit être en catégorie - * `composition`, l'interrogation et le devoir en `continu`. Sans cela la - * colonne Compo du bulletin reste vide et la composition est diluée dans la - * note de classe. Défensif : les données de référence peuvent avoir dérivé. - */ - private function ensureEvaluationTypeCategories(): void - { - EvaluationType::query()->where('name', 'Composition')->update(['category' => 'composition']); - EvaluationType::query()->whereIn('name', ['Interrogation', 'Devoir'])->update(['category' => 'continu']); - } - - /** - * Une interrogation, un devoir et une composition par matière et par période. - * Les épreuves passées sont marquées « completed » ; la composition de la - * période courante reste planifiée — une démo montre aussi du travail en cours. - */ - private function seedEvaluations(): void - { - $this->ensureEvaluationTypeCategories(); - - $types = EvaluationType::query()->get()->keyBy('name'); - $classSubjects = ClassSubject::query() - ->whereIn('class_id', $this->classes->pluck('id')) - ->where('academic_year_id', $this->year->id) - ->get(); - - foreach ($this->periods as $period) { - $start = CarbonImmutable::parse($period->start_date); - $end = CarbonImmutable::parse($period->end_date); - - // Contrôle continu réparti sur la partie écoulée de la période, composition - // en fin de période : dans le trimestre en cours celle-ci reste donc à venir. - $horizon = $end->min($this->today); - $span = max((int) $start->diffInDays($horizon), 1); - - foreach (self::EXAMS as $index => $exam) { - $type = $types->get($exam['type']); - - if (! $type) { - continue; - } - - $date = $index === 2 - ? $end - : $start->addDays((int) round($span * ($index === 0 ? 0.3 : 0.7))); - - $template = EvaluationTemplate::firstOrCreate( - [ - 'academic_period_id' => $period->id, - 'evaluation_type_id' => $type->id, - 'name' => $exam['type'].' — '.$period->name, - ], - [ - 'coefficient' => $exam['coefficient'], - 'max_score' => 20, - 'date' => $date->toDateString(), - ], - ); - - $isPast = $date->lessThanOrEqualTo($this->today); - - foreach ($classSubjects as $classSubject) { - Evaluation::firstOrCreate( - [ - 'evaluation_template_id' => $template->id, - 'class_subject_id' => $classSubject->id, - ], - [ - 'date' => $date->toDateString(), - 'status' => $isPast ? 'completed' : 'scheduled', - ], - ); - } - } - } - } - - /** - * Notes des épreuves déjà passées. - * - * Chaque élève reçoit un niveau propre, stable d'une matière à l'autre : sans - * cela le classement serait un tirage au sort et les bulletins n'auraient aucun - * sens. Environ 3 % d'absences pour que la colonne « absent » ne soit pas vide. - */ - private function seedMarks(): void - { - $enteredBy = User::query()->role('enseignant')->value('id') ?? User::query()->value('id'); - - foreach ($this->classes as $class) { - $studentIds = Enrollment::query() - ->where('class_id', $class->id) - ->where('academic_year_id', $this->year->id) - ->active() - ->pluck('student_id') - ->all(); - - if ($studentIds === []) { - continue; - } - - // Niveau propre à l'élève (moyenne visée), réparti autour de 11.5/20. - $levels = []; - foreach ($studentIds as $studentId) { - $levels[$studentId] = min(18.5, max(4.0, 11.5 + $this->gaussian() * 3.0)); - } - - $evaluations = Evaluation::query() - ->whereIn('class_subject_id', ClassSubject::query() - ->where('class_id', $class->id) - ->where('academic_year_id', $this->year->id) - ->select('id')) - ->where('status', 'completed') - ->pluck('id') - ->all(); - - foreach (array_chunk($evaluations, 20) as $chunk) { - $rows = []; - $known = DB::table('marks') - ->whereIn('evaluation_id', $chunk) - ->get(['evaluation_id', 'student_id']) - ->map(fn ($r) => $r->evaluation_id.'|'.$r->student_id) - ->flip(); - - foreach ($chunk as $evaluationId) { - foreach ($studentIds as $studentId) { - if ($known->has($evaluationId.'|'.$studentId)) { - continue; - } - - $absent = $this->faker->boolean(3); - $score = $absent ? null : round(min(20, max(0, $levels[$studentId] + $this->gaussian() * 2.2)), 2); - - $rows[] = [ - 'id' => (string) Str::uuid7(), - 'evaluation_id' => $evaluationId, - 'student_id' => $studentId, - 'score' => $score, - 'absent' => $absent, - 'created_by' => $enteredBy, - 'created_at' => now(), - 'updated_at' => now(), - ]; - } - } - - foreach (array_chunk($rows, 500) as $batch) { - DB::table('marks')->insert($batch); - } - } - } - } - - /** Tirage normal centré réduit (Box-Muller) : des notes qui se répartissent en cloche. */ - private function gaussian(): float - { - $u1 = max(mt_rand() / mt_getrandmax(), 1e-9); - $u2 = mt_rand() / mt_getrandmax(); - - return sqrt(-2 * log($u1)) * cos(2 * M_PI * $u2); - } - - /** - * Moyenne consolidée par matière et par période, dérivée des notes saisies. - * - * L'écran « Notes » lit la table `grades`, distincte des notes d'épreuves : - * sans cette consolidation il resterait vide alors que les bulletins, eux, - * se calculent depuis les évaluations. La moyenne est pondérée par le - * coefficient de l'épreuve, comme le fait la saisie manuelle. - */ - private function seedSubjectGrades(): void - { - $computed = DB::table('marks as m') - ->join('evaluations as e', 'e.id', '=', 'm.evaluation_id') - ->join('evaluation_templates as et', 'et.id', '=', 'e.evaluation_template_id') - ->whereNotNull('m.score') - ->where('m.absent', false) - ->groupBy('m.student_id', 'e.class_subject_id', 'et.academic_period_id') - ->selectRaw('m.student_id, e.class_subject_id, et.academic_period_id, - round(sum(m.score * et.coefficient) / nullif(sum(et.coefficient), 0), 2) as score') - ->get(); - - $known = DB::table('grades') - ->get(['student_id', 'class_subject_id', 'academic_period_id']) - ->map(fn ($g) => $g->student_id.'|'.$g->class_subject_id.'|'.$g->academic_period_id) - ->flip(); - - $rows = []; - foreach ($computed as $row) { - $key = $row->student_id.'|'.$row->class_subject_id.'|'.$row->academic_period_id; - - if ($known->has($key) || $row->score === null) { - continue; - } - - $rows[] = [ - 'id' => (string) Str::uuid7(), - 'student_id' => $row->student_id, - 'class_subject_id' => $row->class_subject_id, - 'academic_period_id' => $row->academic_period_id, - 'score' => $row->score, - 'created_at' => now(), - 'updated_at' => now(), - ]; - } - - foreach (array_chunk($rows, 500) as $batch) { - DB::table('grades')->insert($batch); - } - } - - /* ------------------------------------------------------------------ */ - /* Dossiers courants */ - /* ------------------------------------------------------------------ */ - - /** - * Les demandes et pièces qui font la vie quotidienne d'un établissement : - * justificatifs d'absence, réclamations de notes, inscriptions aux examens - * officiels, primes du personnel et documents délivrés. Chacun de ces écrans - * resterait vide sans quoi la démonstration s'arrêterait aux gros modules. - */ - private function seedCasework(): void - { - $this->seedAbsencePermissions(); - $this->seedNoteReclamations(); - $this->seedExamRegistrations(); - $this->seedAllowances(); - $this->seedDocumentIssuances(); - $this->seedFiledDocuments(); - } - - /** - * Archives et pièces du dossier élève. - * - * Ces deux modules servent de vrais fichiers en téléchargement : une ligne - * sans fichier sur le disque produirait un 404 dès le premier clic. Chaque - * entrée est donc accompagnée d'un PDF réellement écrit sur le disque - * « secure », hors du dossier public comme en exploitation. - */ - private function seedFiledDocuments(): void - { - $archivist = User::query()->role('administrateur')->value('id') ?? User::query()->value('id'); - $tags = DocumentTag::query()->get(); - - $dossiers = [ - ['category' => 'juridique', 'title' => 'Arrêté d\'ouverture de l\'établissement', 'tag' => 'Juridique'], - ['category' => 'juridique', 'title' => 'Statuts de l\'établissement', 'tag' => 'Juridique'], - ['category' => 'rh', 'title' => 'Convention collective du personnel', 'tag' => 'Ressources humaines'], - ['category' => 'rh', 'title' => 'Règlement intérieur du personnel', 'tag' => 'Contrat'], - ['category' => 'comptable', 'title' => 'Rapport financier '.$this->year->year, 'tag' => 'Comptable'], - ['category' => 'comptable', 'title' => 'Budget prévisionnel '.$this->year->year, 'tag' => 'Comptable'], - ['category' => 'pedagogique', 'title' => 'Programmes officiels — cycle primaire', 'tag' => 'Pédagogique'], - ['category' => 'pedagogique', 'title' => 'Projet d\'établissement', 'tag' => 'Pédagogique'], - ['category' => 'courrier', 'title' => 'Correspondance — Inspection de Lomé Golfe', 'tag' => 'Courrier'], - ['category' => 'administratif', 'title' => 'Rapport d\'inspection pédagogique', 'tag' => 'Inspection'], - ]; - - foreach ($dossiers as $index => $dossier) { - if (ArchivedDocument::query()->where('title', $dossier['title'])->exists()) { - continue; - } - - $archivedAt = $this->today->subDays($this->faker->numberBetween(10, 300)); - $path = 'archives/demo-'.Str::slug($dossier['title']).'.pdf'; - $size = $this->writePdf($path, $dossier['title'], $this->school->name); - - $document = ArchivedDocument::create([ - 'reference' => 'ARC-'.$archivedAt->format('Y').'-'.str_pad((string) ($index + 1), 4, '0', STR_PAD_LEFT), - 'title' => $dossier['title'], - 'description' => 'Document de référence classé aux archives de l\'établissement.', - 'category' => $dossier['category'], - 'path' => $path, - 'disk' => 'secure', - 'original_name' => Str::slug($dossier['title']).'.pdf', - 'mime' => 'application/pdf', - 'size' => $size, - 'retention_until' => $archivedAt->addYears(10)->toDateString(), - 'archived_by' => $archivist, - 'archived_at' => $archivedAt, - ]); - - if ($tag = $tags->firstWhere('name', $dossier['tag'])) { - $document->tags()->sync([$tag->id]); - } - } - - if (StudentDocument::query()->exists()) { - return; - } - - $pieces = ['Acte de naissance', 'Certificat de scolarité antérieure', 'Photo d\'identité', 'Carnet de vaccination']; - $students = Student::query() - ->whereIn('id', Enrollment::query()->where('academic_year_id', $this->year->id)->active()->select('student_id')) - ->inRandomOrder() - ->limit(15) - ->get(); - - foreach ($students as $student) { - foreach ($this->faker->randomElements($pieces, $this->faker->numberBetween(1, 3)) as $piece) { - $path = $student->storageFolder().'/documents/'.Str::slug($piece).'.pdf'; - $size = $this->writePdf($path, $piece, $student->lastname.' '.$student->firstname); - - StudentDocument::create([ - 'student_id' => $student->id, - 'name' => $piece, - 'path' => $path, - 'original_name' => Str::slug($piece).'.pdf', - 'mime' => 'application/pdf', - 'size' => $size, - 'uploaded_by' => $archivist, - ]); - } - } - } - - /** Écrit un PDF de démonstration sur le disque « secure » et retourne sa taille. */ - private function writePdf(string $path, string $title, string $subtitle): int - { - // Police interne (Helvetica) plutôt que DejaVu Sans : cette dernière est - // embarquée dans chaque fichier et ferait passer une page de 6 Ko à 850 Ko, - // soit ~38 Mo de pièces de démonstration à sauvegarder pour rien. - $html = '' - .'

DOCUMENT DE DÉMONSTRATION

' - .'

'.e($title).'

' - .'

'.e($subtitle).'

' - .'
' - .'

Contenu fictif généré par DemoSeeder. ' - .'Ce fichier existe pour que le téléchargement fonctionne pendant la démonstration.

' - .''; - - $content = Pdf::loadHTML($html)->output(); - Storage::disk('secure')->put($path, $content); - - return strlen($content); - } - - /** Justificatifs d'absence, répartis sur les trois états du circuit de validation. */ - private function seedAbsencePermissions(): void - { - if (AbsencePermission::query()->exists()) { - return; - } - - $reviewer = User::query()->role('directeur')->value('id') ?? User::query()->value('id'); - $parent = User::query()->role('secrétariat')->value('id') ?? $reviewer; - - // On part des élèves réellement absents : un justificatif sans absence - // correspondante serait incohérent au moindre recoupement. - $absences = DB::table('attendance_records as ar') - ->join('attendances as a', 'a.id', '=', 'ar.attendance_id') - ->whereIn('ar.status', ['absent', 'excused']) - ->inRandomOrder() - ->limit(24) - ->get(['ar.student_id', 'a.date']); - - foreach ($absences as $index => $absence) { - $start = CarbonImmutable::parse($absence->date); - $status = match ($index % 5) { - 0, 1, 2 => 'approved', - 3 => 'pending', - default => 'rejected', - }; - - $reason = $this->faker->randomElement(['medical', 'medical', 'familial', 'autre']); - - AbsencePermission::create([ - 'student_id' => $absence->student_id, - 'requested_by' => $parent, - 'reviewed_by' => $status === 'pending' ? null : $reviewer, - 'start_date' => $start->toDateString(), - 'end_date' => $start->addDays($this->faker->numberBetween(0, 3))->toDateString(), - 'reason' => $reason, - 'description' => match ($reason) { - 'medical' => 'Consultation médicale, certificat fourni.', - 'familial' => 'Événement familial hors de Lomé.', - default => 'Motif communiqué par la famille.', - }, - 'status' => $status, - 'review_comment' => $status === 'rejected' ? 'Justificatif non transmis dans les délais.' : null, - 'reviewed_at' => $status === 'pending' ? null : $start->addDays(2), - ]); - } - } - - /** Réclamations de notes : quelques contestations, dont certaines déjà arbitrées. */ - private function seedNoteReclamations(): void - { - if (NoteReclamation::query()->exists()) { - return; - } - - $reviewer = User::query()->role('directeur')->value('id') ?? User::query()->value('id'); - - $marks = DB::table('marks') - ->whereNotNull('score') - ->where('score', '<', 10) - ->inRandomOrder() - ->limit(12) - ->get(['evaluation_id', 'student_id', 'score']); - - foreach ($marks as $index => $mark) { - $status = match ($index % 4) { - 0, 1 => 'pending', - 2 => 'approved', - default => 'rejected', - }; - - $requested = min(20, (float) $mark->score + $this->faker->randomFloat(1, 1, 4)); - - NoteReclamation::create([ - 'evaluation_id' => $mark->evaluation_id, - 'student_id' => $mark->student_id, - 'requested_by' => $reviewer, - 'reason' => $this->faker->randomElement([ - 'Une question corrigée comme fausse alors que la réponse est juste.', - 'Total des points erroné sur la copie.', - 'Une page de la copie n\'a pas été corrigée.', - ]), - 'original_score' => $mark->score, - 'requested_score' => $requested, - 'status' => $status, - 'reviewed_by' => $status === 'pending' ? null : $reviewer, - 'reviewed_at' => $status === 'pending' ? null : now()->subDays($this->faker->numberBetween(1, 20)), - 'corrected_score' => $status === 'approved' ? $requested : null, - 'correction_note' => match ($status) { - 'approved' => 'Erreur de report confirmée, note rectifiée.', - 'rejected' => 'Correction vérifiée, barème correctement appliqué.', - default => null, - }, - ]); - } - } - - /** Inscriptions aux examens officiels enregistrés, pour la classe concernée. */ - /** - * Examens officiels de l'année en cours (CEPD, BEPC, BAC), avec leurs résultats : - * les élèves des classes d'examen (CM2, 3ème, Terminale) sont inscrits puis - * admis / échoués / absents selon un taux d'admission plausible par examen. - */ - private function seedExamRegistrations(): void - { - $blueprint = [ - ['type' => 'cepd', 'name' => 'CEPD', 'class' => 'CM2', 'center' => 'EPP Tokoin', 'admis' => 88, 'serie' => null], - ['type' => 'bepc', 'name' => 'BEPC', 'class' => '3ème', 'center' => 'CEG Tokoin', 'admis' => 78, 'serie' => null], - ['type' => 'bac', 'name' => 'BAC II', 'class' => 'Tle D', 'center' => 'Lycée de Tokoin', 'admis' => 72, 'serie' => 'D'], - ]; - $examYear = (int) substr($this->year->year, 5, 4); - - // Idempotent : si des résultats existent déjà pour l'année, on ne refait rien. - // Sinon, on repart propre (efface d'éventuelles inscriptions « à blanc »). - $existingExamIds = OfficialExam::query()->where('academic_year_id', $this->year->id)->pluck('id'); - if (OfficialExamRegistration::query()->whereIn('official_exam_id', $existingExamIds)->whereIn('status', ['admis', 'echoue', 'absent'])->exists()) { - return; - } - OfficialExamRegistration::query()->whereIn('official_exam_id', $existingExamIds)->delete(); - - foreach ($blueprint as $b) { - $class = $this->classes->firstWhere('code', $b['class']); - - if (! $class) { - continue; - } - - $exam = OfficialExam::updateOrCreate( - ['type' => $b['type'], 'year' => $examYear, 'academic_year_id' => $this->year->id], - [ - 'school_id' => $this->school->id, - 'name' => $b['name'], - 'session' => 'normale', - 'exam_date' => $examYear.'-06-15', - 'center' => $b['center'], - 'status' => 'termine', - 'class_id' => $class->id, - ], - ); - - $studentIds = Enrollment::query() - ->where('academic_year_id', $this->year->id) - ->where('class_id', $class->id) - ->active() - ->pluck('student_id'); - - $rows = []; - foreach ($studentIds as $index => $studentId) { - $draw = $this->faker->numberBetween(1, 100); - [$status, $average, $mention] = match (true) { - $draw <= 3 => ['absent', null, null], - $draw <= $b['admis'] + 3 => ['admis', $avg = round($this->faker->randomFloat(2, 10, 17), 2), $this->historyMention($avg)], - default => ['echoue', round($this->faker->randomFloat(2, 6, 9.75), 2), null], - }; - - $rows[] = [ - 'id' => (string) Str::uuid7(), - 'official_exam_id' => $exam->id, - 'student_id' => $studentId, - 'registration_number' => Str::upper($b['type']).'-'.$examYear.'-'.str_pad((string) ($index + 1), 4, '0', STR_PAD_LEFT), - 'serie' => $b['serie'], - 'status' => $status, - 'average' => $average, - 'mention' => $mention, - 'created_at' => now(), - 'updated_at' => now(), - ]; - } - - foreach (array_chunk($rows, 500) as $chunk) { - DB::table('official_exam_registrations')->insert($chunk); - } - } - } - - /** Primes et retenues individuelles du personnel. */ - private function seedAllowances(): void - { - if (EmployeeAllowance::query()->exists()) { - return; - } - - $author = User::query()->role('administrateur')->value('id') ?? User::query()->value('id'); - $employees = EmployeeProfile::query()->inRandomOrder()->limit(8)->get(); - - $catalogue = [ - ['type' => 'earning', 'label' => 'Indemnité de logement', 'mode' => EmployeeAllowance::MODE_FIXED, 'amount' => 25000], - ['type' => 'earning', 'label' => 'Prime de responsabilité', 'mode' => EmployeeAllowance::MODE_PERCENT_BASE, 'amount' => 10], - ['type' => 'earning', 'label' => 'Heures supplémentaires', 'mode' => EmployeeAllowance::MODE_FIXED, 'amount' => 18000], - ['type' => 'deduction', 'label' => 'Avance sur salaire', 'mode' => EmployeeAllowance::MODE_FIXED, 'amount' => 30000], - ]; - - foreach ($employees as $index => $employee) { - $line = $catalogue[$index % count($catalogue)]; - - EmployeeAllowance::create([ - 'employee_profile_id' => $employee->id, - 'type' => $line['type'], - 'label' => $line['label'], - 'mode' => $line['mode'], - 'amount' => $line['amount'], - 'reason' => $line['type'] === 'deduction' ? 'Remboursement échelonné sur trois mois.' : null, - 'starts_on' => $this->today->startOfMonth()->subMonths(3)->toDateString(), - 'active' => true, - 'created_by' => $author, - ]); - } - } - - /** Documents délivrés aux familles (certificats, attestations). */ - private function seedDocumentIssuances(): void - { - if (DocumentIssuance::query()->exists()) { - return; - } - - $templates = DocumentTemplate::query()->get(); - $issuedBy = User::query()->role('secrétariat')->value('id') ?? User::query()->value('id'); - - if ($templates->isEmpty()) { - return; - } - - $students = Student::query() - ->whereIn('id', Enrollment::query()->where('academic_year_id', $this->year->id)->active()->select('student_id')) - ->inRandomOrder() - ->limit(20) - ->get(); - - foreach ($students as $index => $student) { - $template = $templates[$index % $templates->count()]; - $issuedAt = $this->today->subDays($this->faker->numberBetween(1, 120)); - - DocumentIssuance::create([ - 'template_id' => $template->id, - 'student_id' => $student->id, - 'reference_number' => 'DOC-'.$issuedAt->format('Y').'-'.str_pad((string) ($index + 1), 4, '0', STR_PAD_LEFT), - 'issued_by' => $issuedBy, - 'payload' => [ - 'eleve' => $student->lastname.' '.$student->firstname, - 'matricule' => $student->matricule, - ], - 'issued_at' => $issuedAt, - ]); - } - } - - /* ------------------------------------------------------------------ */ - /* Bourses et facturation */ - /* ------------------------------------------------------------------ */ - - /** Quelques boursiers : la remise alimente la ligne DISCOUNT des factures. */ - private function seedScholarships(): void - { - $scholarships = Scholarship::query()->pluck('id')->all(); - - if ($scholarships === []) { - return; - } - - $candidates = Enrollment::query() - ->where('academic_year_id', $this->year->id) - ->active() - ->inRandomOrder() - ->limit(18) - ->pluck('student_id'); - - foreach ($candidates as $studentId) { - StudentScholarship::firstOrCreate( - [ - 'student_id' => $studentId, - 'academic_year_id' => $this->year->id, - ], - [ - 'scholarship_id' => $this->faker->randomElement($scholarships), - 'start_date' => $this->year->start_date, - 'number_of_year' => 1, - ], - ); - } - } - - /** - * Barème de frais par classe, puis une facture par inscription. - * - * Le règlement passe par InvoiceService : reçus, écritures de caisse et statut - * de facture suivent la même logique qu'une saisie réelle au guichet. La - * répartition (soldé / partiel / impayé) donne des impayés à montrer. - */ - private function seedFinance(): void - { - $this->seedFeeStructures(); - - $invoices = app(InvoiceService::class); - $cashier = User::query()->role('comptabilité')->value('id') ?? User::query()->value('id'); - - $enrollments = Enrollment::query() - ->with('student') - ->whereIn('class_id', $this->classes->pluck('id')) - ->where('academic_year_id', $this->year->id) - ->whereNotIn('id', Invoice::query()->select('enrollment_id')) - ->get(); - - foreach ($enrollments as $enrollment) { - $invoice = $invoices->createFromEnrollment($enrollment); - - if ((float) $invoice->total <= 0) { - continue; - } - - // 55 % soldé, 30 % partiel, 15 % impayé : un recouvrement crédible. - $draw = $this->faker->numberBetween(1, 100); - $share = match (true) { - $draw <= 55 => 1.0, - $draw <= 85 => $this->faker->randomFloat(2, 0.25, 0.8), - default => 0.0, - }; - - if ($share === 0.0) { - continue; - } - - $method = $this->faker->randomElement(['CASH', 'CASH', 'MOBILE_MONEY', 'MOBILE_MONEY', 'BANK_TRANSFER', 'CHEQUE']); - $paidAt = CarbonImmutable::parse($this->year->start_date) - ->addDays($this->faker->numberBetween(0, max(1, (int) CarbonImmutable::parse($this->year->start_date)->diffInDays($this->today)))); - - $invoices->recordPayment($invoice, [ - 'amount' => round((float) $invoice->total * $share, 2), - 'payment_method' => $method, - 'paid_by' => $enrollment->student?->lastname.' '.$enrollment->student?->firstname, - 'paid_at' => $paidAt->toDateString(), - 'created_by' => $cashier, - 'reference_number' => $method === 'CASH' ? null : Str::upper(Str::random(10)), - ]); - } - } - - /** Frais par classe : inscription + écolage, montants croissants selon le cycle. */ - private function seedFeeStructures(): void - { - $categories = FeeCategorie::query()->get()->keyBy('name'); - - foreach ($this->classes as $class) { - $ecolage = match ($this->cycleOf($class)) { - 'primaire' => 90000, - 'college' => 135000, - default => 180000, - }; - - $amounts = [ - 'Inscription' => 15000, - 'Écolage' => $ecolage, - 'Cantine' => 45000, - ]; - - foreach ($amounts as $name => $amount) { - $category = $categories->get($name); - - if (! $category) { - continue; - } - - FeeStructure::firstOrCreate( - [ - 'academic_year_id' => $this->year->id, - 'fee_category_id' => $category->id, - 'class_id' => $class->id, - ], - ['amount' => $amount], - ); - } - } - } - - /* ------------------------------------------------------------------ */ - /* Présences */ - /* ------------------------------------------------------------------ */ - - /** - * Appel du matin sur les huit dernières semaines de cours. - * Taux de présence ~92 %, avec retards et absences justifiées pour que les - * statistiques d'assiduité et le bloc « absences » du bulletin soient parlants. - */ - private function seedAttendance(): void - { - $period = $this->periods->firstWhere('is_current', true) ?? $this->periods->last(); - $author = User::query()->role('secrétariat')->value('id') ?? User::query()->value('id'); - - $start = CarbonImmutable::parse($period->start_date)->max($this->today->subWeeks(8)); - $end = $this->today->min(CarbonImmutable::parse($period->end_date)); - - foreach ($this->classes as $class) { - $studentIds = Enrollment::query() - ->where('class_id', $class->id) - ->where('academic_year_id', $this->year->id) - ->active() - ->pluck('student_id') - ->all(); - - if ($studentIds === []) { - continue; - } - - for ($day = $start; $day->lessThanOrEqualTo($end); $day = $day->addDay()) { - if ($day->isWeekend()) { - continue; - } - - $attendance = Attendance::firstOrCreate( - [ - 'class_id' => $class->id, - 'academic_period_id' => $period->id, - 'date' => $day->toDateString(), - 'session' => 'matin', - ], - ['recorded_by' => $author], - ); - - if ($attendance->records()->exists()) { - continue; - } - - $rows = []; - foreach ($studentIds as $studentId) { - $draw = $this->faker->numberBetween(1, 100); - [$status, $late] = match (true) { - $draw <= 92 => ['present', null], - $draw <= 96 => ['late', $this->faker->numberBetween(5, 40)], - $draw <= 98 => ['excused', null], - default => ['absent', null], - }; - - $rows[] = [ - 'id' => (string) Str::uuid7(), - 'attendance_id' => $attendance->id, - 'student_id' => $studentId, - 'status' => $status, - 'minutes_late' => $late, - 'created_at' => now(), - 'updated_at' => now(), - ]; - } - - DB::table('attendance_records')->insert($rows); - } - } - } - - /* ------------------------------------------------------------------ */ - /* Emploi du temps */ - /* ------------------------------------------------------------------ */ - - /** Grille hebdomadaire : les matières de la classe réparties du lundi au vendredi. */ - private function seedTimetable(): void - { - $slots = [['07:00', '09:00'], ['09:15', '11:15'], ['11:30', '12:30'], ['15:00', '17:00']]; - - foreach ($this->classes as $class) { - $assignments = SubjectAssignment::query() - ->where('class_id', $class->id) - ->where('academic_year_id', $this->year->id) - ->get(); - - if ($assignments->isEmpty()) { - continue; - } - - $cursor = 0; - foreach (range(1, 5) as $day) { - foreach ($slots as [$from, $to]) { - // Le mercredi après-midi reste libre, comme dans la plupart des établissements. - if ($day === 3 && $from === '15:00') { - continue; - } - - $assignment = $assignments[$cursor++ % $assignments->count()]; - - TimetableSlot::firstOrCreate( - [ - 'class_id' => $class->id, - 'day_of_week' => $day, - 'start_time' => $from, - ], - [ - 'school_id' => $this->school->id, - 'academic_year_id' => $this->year->id, - 'end_time' => $to, - 'subject_id' => $assignment->subject_id, - 'teacher_id' => $assignment->teacher_id, - 'room' => 'Salle '.$class->code, - ], - ); - } - } - } - } - - /* ------------------------------------------------------------------ */ - /* Calendrier scolaire */ - /* ------------------------------------------------------------------ */ - - /** - * Calendrier de l'année : jalons pédagogiques calés sur les périodes réelles - * (compositions, conseils de classe, remise des bulletins, congés), fêtes - * légales togolaises et sessions d'examens officiels déjà enregistrées. - * - * Les dates sont dérivées des périodes plutôt qu'écrites en dur : si l'année - * de démonstration change, le calendrier suit au lieu de pointer à côté. - */ - private function seedCalendar(): void - { - $author = User::query()->role('administrateur')->value('id') ?? User::query()->value('id'); - $first = $this->periods->first(); - $last = $this->periods->last(); - - $events = [[ - 'title' => 'Rentrée scolaire '.$this->year->year, - 'description' => 'Accueil des élèves et reprise des cours.', - 'type' => 'event', - 'start_date' => $first->start_date, - 'color' => '#2a78d6', - ], [ - 'title' => 'Réunion de rentrée des parents', - 'description' => 'Présentation de l\'équipe pédagogique et du règlement intérieur.', - 'type' => 'meeting', - 'start_date' => CarbonImmutable::parse($first->start_date)->addWeek(), - 'start_time' => '15:00', - 'end_time' => '17:00', - 'all_day' => false, - ], [ - 'title' => 'Journée portes ouvertes', - 'description' => 'Visite de l\'établissement et rencontre avec les enseignants.', - 'type' => 'event', - 'start_date' => CarbonImmutable::parse($first->start_date)->addMonths(2), - ]]; - - // Événements du mois courant : le calendrier s'ouvre sur le mois d'aujourd'hui. - // Sans eux il paraîtrait vide alors que l'année en compte partout ailleurs — et - // on ne verrait donc aucun marquage à l'ouverture. - $now = $this->today; - $events = array_merge($events, [ - [ - 'title' => 'Réunion de coordination pédagogique', - 'description' => 'Point d\'étape du trimestre avec les enseignants.', - 'type' => 'meeting', - 'start_date' => $now->subDays(2), - 'start_time' => '16:00', - 'end_time' => '18:00', - 'all_day' => false, - 'color' => '#7c3aed', - ], - [ - 'title' => 'Journée sportive inter-classes', - 'description' => 'Compétitions sportives entre les classes.', - 'type' => 'event', - 'start_date' => $now->addDays(4), - 'color' => '#2a78d6', - ], - [ - 'title' => 'Devoirs surveillés du mois', - 'description' => 'Série de devoirs surveillés dans toutes les classes.', - 'type' => 'exam', - 'start_date' => $now->addDays(8), - 'end_date' => $now->addDays(11), - 'color' => '#eb6834', - ], - [ - 'title' => 'Sortie pédagogique', - 'description' => 'Visite éducative encadrée par les enseignants.', - 'type' => 'event', - 'start_date' => $now->addDays(14), - 'color' => '#2a78d6', - ], - [ - 'title' => 'Réunion parents-professeurs', - 'description' => 'Rencontre individuelle des familles et des enseignants.', - 'type' => 'meeting', - 'start_date' => $now->addDays(18), - 'start_time' => '15:00', - 'end_time' => '18:00', - 'all_day' => false, - 'color' => '#7c3aed', - ], - ]); - - // Jalons de fin de période : composition, conseil, bulletins, congés. - foreach ($this->periods as $period) { - $end = CarbonImmutable::parse($period->end_date); - - $events[] = [ - 'title' => 'Compositions — '.$period->name, - 'description' => 'Épreuves de synthèse de fin de période.', - 'type' => 'exam', - 'start_date' => $end->subWeek(), - 'end_date' => $end->subDays(3), - 'color' => '#eb6834', - ]; - - $events[] = [ - 'title' => 'Conseils de classe — '.$period->name, - 'description' => 'Délibérations et appréciations par classe.', - 'type' => 'meeting', - 'start_date' => $end->addDays(3), - 'start_time' => '08:00', - 'end_time' => '13:00', - 'all_day' => false, - ]; - - $events[] = [ - 'title' => 'Remise des bulletins — '.$period->name, - 'description' => 'Réception des parents et remise des bulletins.', - 'type' => 'meeting', - 'start_date' => $end->addDays(7), - ]; - - $events[] = [ - 'title' => 'Congés de fin de '.Str::lower($period->name), - 'type' => 'holiday', - 'start_date' => $end->addDays(8), - 'end_date' => $end->addDays(20), - 'color' => '#1baf7a', - ]; - } - - foreach ($this->nationalHolidays($first->start_date, $last->end_date) as $date => $title) { - $events[] = [ - 'title' => $title, - 'type' => 'holiday', - 'start_date' => $date, - 'color' => '#1baf7a', - ]; - } - - // Sessions officielles déjà saisies dans le module Examens. - foreach (DB::table('official_exams')->where('academic_year_id', $this->year->id)->get() as $exam) { - $events[] = [ - 'title' => 'Examen officiel — '.$exam->name.' (session '.$exam->session.')', - 'description' => 'Centre : '.$exam->center, - 'type' => 'exam', - 'start_date' => $exam->exam_date, - 'color' => '#eb6834', - ]; - } - - foreach ($events as $event) { - CalendarEvent::firstOrCreate( - [ - // La date fait partie de la clé : une fête légale revient d'une - // année civile à l'autre sous le même intitulé. - 'title' => $event['title'], - 'start_date' => CarbonImmutable::parse($event['start_date'])->toDateString(), - 'academic_year_id' => $this->year->id, - ], - [ - 'description' => $event['description'] ?? null, - 'type' => $event['type'], - 'end_date' => isset($event['end_date']) ? CarbonImmutable::parse($event['end_date'])->toDateString() : null, - 'all_day' => $event['all_day'] ?? true, - 'start_time' => $event['start_time'] ?? null, - 'end_time' => $event['end_time'] ?? null, - 'color' => $event['color'] ?? null, - 'created_by' => $author, - ], - ); - } - } - - /** - * Jours fériés togolais tombant dans l'intervalle donné. - * - * @return array date ISO => libellé - */ - private function nationalHolidays(string $from, string $to): array - { - $start = CarbonImmutable::parse($from); - $end = CarbonImmutable::parse($to); - - $fixed = [ - '01-01' => 'Jour de l\'An', - '01-13' => 'Fête de la Libération nationale', - '04-27' => 'Fête de l\'Indépendance', - '05-01' => 'Fête du Travail', - '06-21' => 'Journée des Martyrs', - '08-15' => 'Assomption', - '11-01' => 'Toussaint', - '12-25' => 'Noël', - ]; - - $holidays = []; - - foreach (range($start->year, $end->year) as $year) { - foreach ($fixed as $dayMonth => $title) { - $date = CarbonImmutable::parse($year.'-'.$dayMonth); - - if ($date->between($start, $end)) { - $holidays[$date->toDateString()] = $title; - } - } - } - - return $holidays; - } - - /* ------------------------------------------------------------------ */ - /* Personnel et paie */ - /* ------------------------------------------------------------------ */ - - /** - * Fiches employés pour tout le personnel, puis les cycles de paie des trois - * derniers mois : le plus ancien payé, le précédent validé, le courant en - * brouillon — les trois états du module se voient d'un coup d'œil. - */ - private function seedPayroll(): void - { - $this->seedPayrollSettings(); - - $grade = SalaryGrade::firstOrCreate( - ['name' => 'Enseignant certifié'], - ['category' => 'Enseignement', 'echelon' => '1', 'base_amount' => 145000, 'active' => true, 'sort_order' => 1], - ); - - SalaryComponent::firstOrCreate( - ['name' => 'Indemnité de transport'], - ['code' => 'TRANSP', 'type' => 'earning', 'default_amount' => 15000, 'is_default' => true, 'active' => true, 'sort_order' => 1], - ); - - SalaryComponent::firstOrCreate( - ['name' => 'Prime de rendement'], - ['code' => 'PRIME', 'type' => 'earning', 'default_amount' => 20000, 'is_default' => true, 'active' => true, 'sort_order' => 2], - ); - - // Le personnel, c'est-à-dire les comptes porteurs d'un rôle qui ne sont pas - // le compte d'accès d'un élève. - $staff = User::query() - ->whereHas('roles') - ->whereNotIn('id', Student::query()->whereNotNull('user_id')->select('user_id')) - ->get(); - - $number = EmployeeProfile::query()->count(); - - foreach ($staff as $user) { - if (EmployeeProfile::query()->where('user_id', $user->id)->exists()) { - continue; - } - - $isTeacher = $user->hasRole('enseignant'); - - EmployeeProfile::create([ - 'user_id' => $user->id, - 'employee_number' => 'EMP'.str_pad((string) (++$number), 3, '0', STR_PAD_LEFT), - 'job_title' => $isTeacher ? 'Enseignant' : ($user->getRoleNames()->first() ?? 'Personnel'), - 'department' => $isTeacher ? 'Pédagogie' : 'Administration', - 'contract_type' => $this->faker->randomElement(['CDI', 'CDI', 'CDD']), - 'hire_date' => $this->today->subYears($this->faker->numberBetween(1, 12))->toDateString(), - 'base_salary' => $isTeacher ? $this->faker->numberBetween(130, 190) * 1000 : $this->faker->numberBetween(150, 260) * 1000, - 'payment_method' => $this->faker->randomElement(['MOBILE_MONEY', 'BANK_TRANSFER']), - 'momo_number' => '+228 9'.$this->faker->numerify('# ## ## ##'), - 'cnss_number' => 'CNSS'.$this->faker->numerify('#######'), - 'status' => 'active', - 'salary_grade_id' => $isTeacher ? $grade->id : null, - ]); - } - - $payroll = app(PayrollService::class); - $cash = DB::table('cash_accounts')->where('type', 'BANK')->value('id'); - - foreach ([3, 2, 1] as $offset) { - $month = $this->today->subMonths($offset); - - $exists = PayRun::query() - ->where('period_month', $month->month) - ->where('period_year', $month->year) - ->where('status', '!=', PayRun::CANCELLED) - ->exists(); - - if ($exists) { - continue; - } - - $run = $payroll->generate($month->month, $month->year, 'Paie '.$month->translatedFormat('F Y')); - - if ($offset >= 2) { - $payroll->validate($run); - } - - if ($offset === 3 && $cash) { - $payroll->pay($run->fresh(), $cash); - } - } - } - - /** - * Active les retenues légales togolaises : CNSS (4 % salarié / 17,5 % employeur) - * et ITS par tranches. Sans elles, brut et net sont égaux sur tous les bulletins - * de paie — le module s'afficherait, mais ne démontrerait rien. - */ - private function seedPayrollSettings(): void - { - $settings = PayrollSetting::current(); - - if ($settings->cnss_enabled && $settings->its_enabled) { - return; - } - - $settings->update([ - 'cnss_enabled' => true, - 'cnss_employee_rate' => 4, - 'cnss_employer_rate' => 17.5, - 'its_enabled' => true, - 'its_brackets' => [ - ['up_to' => 60000, 'rate' => 0.5], - ['up_to' => 150000, 'rate' => 7], - ['up_to' => 300000, 'rate' => 15], - ['up_to' => 500000, 'rate' => 25], - ['up_to' => 800000, 'rate' => 30], - ['up_to' => null, 'rate' => 35], - ], - ]); - - SalaryComponent::firstOrCreate( - ['name' => 'Avance sur salaire'], - ['code' => 'AVANCE', 'type' => 'deduction', 'default_amount' => 0, 'is_default' => false, 'active' => true, 'sort_order' => 10], - ); - } - - /* ------------------------------------------------------------------ */ - /* Bulletins */ - /* ------------------------------------------------------------------ */ - - /** - * Bulletins figés de la première période pour toutes les classes de la démo. - * La période courante reste ouverte : on peut la générer en direct pendant - * la démonstration sans écraser un résultat déjà validé. - */ - private function seedReportCards(): void - { - $period = $this->periods->first(); - $author = User::query()->role('administrateur')->value('id') ?? User::query()->value('id'); - - if (! $period || ! $author) { - return; - } - - $builder = app(ReportCardBuilder::class); - - foreach ($this->classes as $class) { - $builder->build($class, $period, $this->year, null, false, $author); - } - } - - /* ------------------------------------------------------------------ */ - /* Années passées (onglet Comparaisons) */ - /* ------------------------------------------------------------------ */ - - /** - * Génère des années scolaires révolues avec juste ce qu'il faut pour alimenter - * les tendances pluriannuelles : inscriptions (statuts décidés → taux de - * redoublement/abandon), factures (recouvrement), bulletins verrouillés - * (réussite) et un examen officiel (admission). Les valeurs suivent les cibles - * de {@see self::HISTORY}. Insertions directes, sans repasser par tout le - * pipeline d'évaluation — inutile pour des agrégats d'archive. - */ - private function seedHistory(): void - { - $studentIds = Student::query()->pluck('id')->all(); - $students = Student::query()->get(['id', 'lastname', 'firstname'])->keyBy('id'); - $classIds = $this->classes->pluck('id')->all(); - $classe3e = $this->classes->firstWhere('code', '3ème') ?? $this->classes->first(); - $author = User::query()->role('administrateur')->value('id') ?? User::query()->value('id'); - - if ($studentIds === [] || $classIds === []) { - return; - } - - foreach (self::HISTORY as $h) { - if (AcademicYear::query()->where('year', $h['year'])->exists()) { - continue; // idempotent - } - - $start = (int) substr($h['year'], 0, 4); - - $year = AcademicYear::create([ - 'year' => $h['year'], - 'start_date' => $start.'-09-15', - 'end_date' => ($start + 1).'-07-10', - 'active' => false, - ]); - - $period = AcademicPeriod::create([ - 'name' => 'Bilan annuel', - 'type' => 'trimestre', - 'weight' => 1, - 'start_date' => $start.'-09-15', - 'end_date' => ($start + 1).'-07-10', - 'is_current' => false, - 'academic_year_id' => $year->id, - ]); - - $cohort = collect($studentIds)->shuffle()->take(min($h['effectif'], count($studentIds)))->values(); - - $enrollRows = []; - $invRows = []; - $rcRows = []; - - foreach ($cohort as $i => $sid) { - $n = $i + 1; - $classId = $classIds[$n % count($classIds)]; - $enrollId = (string) Str::uuid7(); - $invId = (string) Str::uuid7(); - [$total, $paid, $invStatus] = $this->historyInvoice($h); - $average = $this->historyAverage($h); - $st = $students->get($sid); - - $enrollRows[] = [ - 'id' => $enrollId, - 'school_id' => $this->school->id, - 'student_id' => $sid, - 'class_id' => $classId, - 'academic_year_id' => $year->id, - 'enrollment_code' => 'HINS-'.$start.'-'.str_pad((string) $n, 4, '0', STR_PAD_LEFT), - 'enrolled_by' => $author, - 'enrollment_date' => $start.'-09-15', - 'status' => Enrollment::STATUS_ACTIVE, - 'academic_status' => $this->historyStatus($h), - 'created_at' => now(), - 'updated_at' => now(), - ]; - - $invRows[] = [ - 'id' => $invId, - 'enrollment_id' => $enrollId, - 'invoice_number' => 'HINV-'.$start.'-'.str_pad((string) $n, 4, '0', STR_PAD_LEFT), - 'subtotal' => $total, - 'discount_amount' => 0, - 'total' => $total, - 'amount_paid' => $paid, - 'amount_remaining' => $total - $paid, - 'status' => $invStatus, - 'issued_at' => $start.'-10-01', - 'created_at' => now(), - 'updated_at' => now(), - ]; - - $rcRows[] = [ - 'id' => (string) Str::uuid7(), - 'student_id' => $sid, - 'academic_period_id' => $period->id, - 'class_id' => $classId, - 'academic_year_id' => $year->id, - 'reference' => 'HRC-'.$start.'-'.str_pad((string) $n, 4, '0', STR_PAD_LEFT), - 'average' => $average, - 'rank' => null, - 'mention' => $this->historyMention($average), - 'payload' => json_encode([ - 'historique' => true, - 'student' => ['name' => trim(($st->lastname ?? '').' '.($st->firstname ?? ''))], - 'average' => $average, - ], JSON_UNESCAPED_UNICODE), - 'locked_at' => now(), - 'generated_by' => $author, - 'created_at' => now(), - 'updated_at' => now(), - ]; - } - - foreach (array_chunk($enrollRows, 500) as $chunk) { - DB::table('enrollments')->insert($chunk); - } - foreach (array_chunk($invRows, 500) as $chunk) { - DB::table('invoices')->insert($chunk); - } - foreach (array_chunk($rcRows, 500) as $chunk) { - DB::table('report_cards')->insert($chunk); - } - - // Examen officiel de fin d'année + admissions (taux cible). - $exam = OfficialExam::create([ - 'school_id' => $this->school->id, - 'type' => 'bepc', - 'name' => 'BEPC '.($start + 1), - 'year' => $start + 1, - 'session' => 'normale', - 'exam_date' => ($start + 1).'-06-15', - 'center' => 'Lycée de Tokoin', - 'status' => 'termine', - 'academic_year_id' => $year->id, - 'class_id' => $classe3e->id, - ]); - - $regRows = []; - foreach ($cohort->take(60) as $j => $sid) { - $admis = $this->faker->numberBetween(1, 100) <= $h['admission']; - $regRows[] = [ - 'id' => (string) Str::uuid7(), - 'official_exam_id' => $exam->id, - 'student_id' => $sid, - 'registration_number' => 'BEPC-'.($start + 1).'-'.str_pad((string) ($j + 1), 4, '0', STR_PAD_LEFT), - 'status' => $admis ? 'admis' : 'echoue', - 'created_at' => now(), - 'updated_at' => now(), - ]; - } - DB::table('official_exam_registrations')->insert($regRows); - } - } - - /** Statut de fin d'année, tiré pour approcher les taux cibles de l'année. */ - private function historyStatus(array $h): string - { - $roll = $this->faker->numberBetween(1, 100); - - return match (true) { - $roll <= $h['abandon'] => 'abandon', - $roll <= $h['abandon'] + 3 => 'transfere', - $roll <= $h['abandon'] + 3 + $h['redoublement'] => 'non_valide', - default => 'valide', - }; - } - - /** - * Facture d'archive : montant fixe, part payée tirée autour du taux de - * recouvrement cible pour que l'agrégat de l'année tombe juste. - * - * @return array{0: int, 1: int, 2: string} - */ - private function historyInvoice(array $h): array - { - $total = 150000; - $share = min(1.0, max(0.0, $h['recovery'] / 100 + $this->gaussian() * 0.18)); - $paid = (int) round($total * $share); - - $status = $paid >= $total ? 'PAID' : ($paid > 0 ? 'PARTIALLY_PAID' : 'ISSUED'); - - return [$total, $paid, $status]; - } - - /** Moyenne d'archive : au-dessus ou en dessous de 10 selon le taux de réussite cible. */ - private function historyAverage(array $h): float - { - return $this->faker->numberBetween(1, 100) <= $h['pass'] - ? round($this->faker->randomFloat(2, 10, 16.5), 2) - : round($this->faker->randomFloat(2, 4, 9.75), 2); - } - - /** Mention d'archive, dérivée de la moyenne (schéma examens officiels). */ - private function historyMention(float $average): string - { - return match (true) { - $average >= 16 => 'tres_bien', - $average >= 14 => 'bien', - $average >= 12 => 'assez_bien', - $average >= 10 => 'passable', - default => '', - }; - } -} diff --git a/documentations/README.md b/documentations/README.md index cb665f6..4d5116a 100644 --- a/documentations/README.md +++ b/documentations/README.md @@ -7,6 +7,7 @@ Documentation technique de **Dalibi** — logiciel libre de gestion scolaire. Légende : ✅ disponible · 🚧 à rédiger. ## 🚀 Prise en main +- ✅ [Assistant d'installation web](prise-en-main/installation-web.md) — première configuration (langue, admin, sécurité, école) - ✅ [Configuration `.env`](prise-en-main/configuration-env.md) - 🚧 Installation locale — voir le [README](../README.md) - 🚧 Premiers pas — créer une école, une année, un premier élève diff --git a/documentations/exploitation/deploiement.md b/documentations/exploitation/deploiement.md index 28414d6..7cd479a 100644 --- a/documentations/exploitation/deploiement.md +++ b/documentations/exploitation/deploiement.md @@ -52,8 +52,8 @@ Si c'est une nouvelle installation: # Créer les rôles et permissions php artisan db:seed --class=RolesAndPermissionsSeeder -# Créer les données de démonstration -php artisan db:seed --class=SchoolDemoSeeder +# Créer les données de démonstration (hors production : comptes de test, élèves fictifs…) +php artisan db:seed ``` ### Étape 5: Cache (production uniquement) diff --git a/documentations/prise-en-main/installation-web.md b/documentations/prise-en-main/installation-web.md new file mode 100644 index 0000000..cb080b5 --- /dev/null +++ b/documentations/prise-en-main/installation-web.md @@ -0,0 +1,93 @@ +# Assistant d'installation web + +Dalibi fournit un **assistant d'installation** façon « première configuration » (comme WordPress) : +sur une base vierge, il applique le schéma, pose les données de référence de production, crée +l'établissement, l'administrateur et l'année scolaire active, applique les réglages de sécurité, +puis **verrouille** l'application. Aucune ligne de commande n'est requise. + +## Prérequis + +- Le fichier `.env` renseigné : connexion base de données + `APP_KEY` (`php artisan key:generate`). +- Le serveur lancé (`php artisan serve` et `npm run dev`, ou un build de production). + +> Avant installation, l'application bascule automatiquement les stores `session` et `cache` sur le +> pilote **`file`** : les tables `sessions` et `cache` n'existent pas encore sur une base neuve. + +## Accès + +Tant que l'application n'est pas installée, **toute requête est redirigée vers `/install`**. Ouvrez +simplement la racine du site : l'assistant démarre. + +## Les étapes + +| # | Étape | Contenu | +|---|-------|---------| +| 1 | **Langue** | Fixe la langue de l'assistant **et** de l'application (FR / EN). Les écrans suivants et toute l'interface basculent immédiatement. | +| 2 | **Administrateur** | Compte principal (prénom, nom, e-mail, mot de passe). Le mot de passe applique la **politique de l'app** : min. 12 caractères, casse mixte, chiffres, symboles, et vérification contre les fuites connues (HaveIBeenPwned) en production. | +| 3 | **Sécurité** | HTTPS forcé (hors environnement local), mode debug coupé en production, journalisation des erreurs (Sentry). La **2FA n'est pas imposée** : chaque utilisateur l'active dans ses réglages. | +| 4 | **École** | Identité de l'établissement, regroupée par sections : **Identité** (nom, code, monnaie, devise/slogan), **Direction & contact** (directeur, e-mail, téléphone), **Localisation** (pays, région, ville, boîte postale, adresse), **Organisation pédagogique** (niveaux, année académique, découpage des périodes, description). | + +### Monnaie, devise et pays + +Trois notions distinctes, souvent confondues : + +- **Monnaie** (`currency`) — code ISO de la devise monétaire (ex. `XOF` pour le FCFA), pour l'affichage des montants. +- **Devise / slogan** (`devise`) — l'exergue de l'école (ex. « Travail - Liberté - Patrie »), affichée sur les documents officiels. +- **Pays** (`country`) — code ISO 3166-1 du pays de l'établissement (défaut : Togo). La liste provient de `App\Constants\Countries` (source unique, également utilisée par le `CountrySeeder`). + +### Niveaux multiples + +Une école peut cocher **un ou plusieurs cycles** (maternelle, primaire, collège, lycée, lycée +technique). Ils sont rattachés comme **types de classe** (relation `School::classTypes`) après le +seed. La colonne `level` conserve le cycle principal (le plus bas coché) pour compatibilité. + +## Exécution + +À la validation de la dernière étape, l'assistant lance l'installation réelle, dans cet ordre : + +1. `migrate --force` — schéma de base de données. +2. Création de l'**école** (champs du modèle `School`). +3. `db:seed --class=ReferenceDataSeeder` — rôles & permissions, catalogues, pays, types de classe, en-têtes/bulletins par défaut. +4. Rattachement des **types de classe** correspondant aux niveaux cochés. +5. Découpage des périodes (trimestre / semestre), **année scolaire active**. +6. Création de l'**administrateur** (rôle `administrateur`), défini comme **propriétaire** (`owner_id`) de l'école. +7. Application des réglages de **sécurité** (écriture best-effort dans `.env`). +8. Pose du **verrou** (`storage/app/installed.json`). + +Chaque étape est **idempotente** (migrations et seeders rejouables, créations via +`firstOrCreate`/`firstOrNew`) : en cas d'échec, l'écran de progression propose de **relancer** sans +créer de doublon. + +## Verrouillage + +Une fois installée, l'application **se verrouille** : toute visite de `/install` redirige vers la +connexion. + +> La **source de vérité** de l'état « installé » est la **base** (présence d'utilisateurs). Le +> fichier-verrou `storage/app/installed.json` n'est qu'un **cache**, reconstruit automatiquement +> s'il manque alors que la base contient déjà des données. + +Pour **réinstaller** (environnement de test) : videz la base (ou `php artisan migrate:fresh`) et +supprimez `storage/app/installed.json`. + +## Durcissement de sécurité + +L'assistant intègre plusieurs protections : + +- Le mot de passe administrateur applique `Password::default()` (politique de l'app). +- Le mot de passe **ne transite jamais en clair** en session : il est chiffré (`APP_KEY`) jusqu'à + l'exécution, puis purgé ; la base reste l'unique stockage final, en haché. +- Les routes de l'assistant sont **limitées en débit** (`throttle`). +- Les journaux d'erreur **masquent** le SQL et ses bindings (pas de fuite d'e-mail ou de données). +- Après écriture du `.env`, le cache de configuration est purgé (`config:clear`). + +## Alternative en ligne de commande + +Pour un déploiement automatisé (CI, Docker, provisioning), contournez l'assistant : + +```bash +php artisan migrate +php artisan db:seed --class=ReferenceDataSeeder +``` + +Créez ensuite l'administrateur et l'école depuis l'application, ou via vos propres seeders. diff --git a/lang/en/install.php b/lang/en/install.php new file mode 100644 index 0000000..729a257 --- /dev/null +++ b/lang/en/install.php @@ -0,0 +1,100 @@ + 'Dalibi setup', + 'hero_title' => 'Welcome to Dalibi', + 'hero_subtitle' => 'Let\'s set up your school in a few steps', + + 'steps' => [ + 'language' => 'Language', + 'school' => 'School', + 'admin' => 'Administrator', + 'security' => 'Security', + ], + + 'common' => [ + 'back' => 'Back', + 'continue' => 'Continue', + 'install' => 'Install', + 'optional' => 'optional', + ], + + 'welcome' => [ + 'title' => 'Choose a language', + 'description' => 'Select the application language', + ], + + 'school' => [ + 'title' => 'Your school', + 'description' => 'Final step: your school identity, then installation starts', + 'group_identity' => 'Identity', + 'group_contact' => 'Management & contact', + 'group_location' => 'Location', + 'group_pedagogy' => 'Academic organization', + 'name' => 'School name', + 'levels' => 'Levels offered', + 'levels_hint' => 'Tick one or more cycles taught by the school.', + 'level_options' => [ + 'maternelle' => 'Kindergarten', + 'primaire' => 'Primary', + 'college' => 'Middle school', + 'lycee' => 'High school', + 'lycee_technique' => 'Technical high school', + ], + 'code' => 'Code', + 'devise' => 'Motto', + 'devise_ph' => 'e.g. Work - Freedom - Homeland', + 'currency' => 'Currency', + 'principal' => 'Principal / Head', + 'email' => 'Email', + 'phone' => 'Phone', + 'address' => 'Address', + 'city' => 'City', + 'region' => 'Region', + 'country' => 'Country', + 'po_box' => 'PO box', + 'description' => 'Description', + 'timezone' => 'Timezone', + 'academic_year_start' => 'Academic year — start', + 'period_type' => 'Period breakdown', + 'period_trimester' => 'Trimesters', + 'period_semester' => 'Semesters', + ], + + 'admin' => [ + 'title' => 'Administrator account', + 'description' => 'The main management account', + 'firstname' => 'First name', + 'lastname' => 'Last name', + 'email' => 'Email', + 'password' => 'Password', + 'password_confirmation' => 'Confirmation', + ], + + 'security' => [ + 'title' => 'Security protocol', + 'description' => 'Recommended settings — adjustable', + 'app_debug_off' => 'Debug mode disabled (production)', + 'force_https' => 'Force HTTPS (outside local)', + 'password_policy' => 'Password policy: strong', + 'enable_sentry' => 'Error logging (Sentry)', + 'two_factor_note' => 'Two-factor authentication stays optional — each user can enable it in their settings.', + 'lock_note' => 'The installer locks itself after installation.', + ], + + 'requirements' => [ + 'title' => 'System requirements', + 'description' => 'Some requirements must be met before installing', + 'recheck' => 'Re-check', + 'all_good' => 'All requirements are satisfied.', + ], + + 'running' => [ + 'title' => 'Installation in progress', + 'description' => 'Migration, reference data and account creation', + 'working' => 'Please wait, do not close this page…', + 'error' => 'Installation failed. Check the database and permissions, then try again.', + 'retry' => 'Try again', + 'done' => 'Installation complete. Sign in with the administrator account.', + ], +]; diff --git a/lang/en/validation.php b/lang/en/validation.php new file mode 100644 index 0000000..8eedc0c --- /dev/null +++ b/lang/en/validation.php @@ -0,0 +1,223 @@ + 'The :attribute field must be accepted.', + 'accepted_if' => 'The :attribute field must be accepted when :other is :value.', + 'active_url' => 'The :attribute field must be a valid URL.', + 'after' => 'The :attribute field must be a date after :date.', + 'after_or_equal' => 'The :attribute field must be a date after or equal to :date.', + 'alpha' => 'The :attribute field must only contain letters.', + 'alpha_dash' => 'The :attribute field must only contain letters, numbers, dashes, and underscores.', + 'alpha_num' => 'The :attribute field must only contain letters and numbers.', + 'any_of' => 'The :attribute field is invalid.', + 'array' => 'The :attribute field must be an array.', + 'ascii' => 'The :attribute field must only contain single-byte alphanumeric characters and symbols.', + 'before' => 'The :attribute field must be a date before :date.', + 'before_or_equal' => 'The :attribute field must be a date before or equal to :date.', + 'between' => [ + 'array' => 'The :attribute field must have between :min and :max items.', + 'file' => 'The :attribute field must be between :min and :max kilobytes.', + 'numeric' => 'The :attribute field must be between :min and :max.', + 'string' => 'The :attribute field must be between :min and :max characters.', + ], + 'boolean' => 'The :attribute field must be true or false.', + 'can' => 'The :attribute field contains an unauthorized value.', + 'confirmed' => 'The :attribute field confirmation does not match.', + 'contains' => 'The :attribute field is missing a required value.', + 'current_password' => 'The password is incorrect.', + 'date' => 'The :attribute field must be a valid date.', + 'date_equals' => 'The :attribute field must be a date equal to :date.', + 'date_format' => 'The :attribute field must match the format :format.', + 'decimal' => 'The :attribute field must have :decimal decimal places.', + 'declined' => 'The :attribute field must be declined.', + 'declined_if' => 'The :attribute field must be declined when :other is :value.', + 'different' => 'The :attribute field and :other must be different.', + 'digits' => 'The :attribute field must be :digits digits.', + 'digits_between' => 'The :attribute field must be between :min and :max digits.', + 'dimensions' => 'The :attribute field has invalid image dimensions.', + 'distinct' => 'The :attribute field has a duplicate value.', + 'doesnt_contain' => 'The :attribute field must not contain any of the following: :values.', + 'doesnt_end_with' => 'The :attribute field must not end with one of the following: :values.', + 'doesnt_start_with' => 'The :attribute field must not start with one of the following: :values.', + 'email' => 'The :attribute field must be a valid email address.', + 'encoding' => 'The :attribute field must be encoded in :encoding.', + 'ends_with' => 'The :attribute field must end with one of the following: :values.', + 'enum' => 'The selected :attribute is invalid.', + 'exists' => 'The selected :attribute is invalid.', + 'extensions' => 'The :attribute field must have one of the following extensions: :values.', + 'file' => 'The :attribute field must be a file.', + 'filled' => 'The :attribute field must have a value.', + 'gt' => [ + 'array' => 'The :attribute field must have more than :value items.', + 'file' => 'The :attribute field must be greater than :value kilobytes.', + 'numeric' => 'The :attribute field must be greater than :value.', + 'string' => 'The :attribute field must be greater than :value characters.', + ], + 'gte' => [ + 'array' => 'The :attribute field must have :value items or more.', + 'file' => 'The :attribute field must be greater than or equal to :value kilobytes.', + 'numeric' => 'The :attribute field must be greater than or equal to :value.', + 'string' => 'The :attribute field must be greater than or equal to :value characters.', + ], + 'hex_color' => 'The :attribute field must be a valid hexadecimal color.', + 'image' => 'The :attribute field must be an image.', + 'in' => 'The selected :attribute is invalid.', + 'in_array' => 'The :attribute field must exist in :other.', + 'in_array_keys' => 'The :attribute field must contain at least one of the following keys: :values.', + 'integer' => 'The :attribute field must be an integer.', + 'ip' => 'The :attribute field must be a valid IP address.', + 'ipv4' => 'The :attribute field must be a valid IPv4 address.', + 'ipv6' => 'The :attribute field must be a valid IPv6 address.', + 'json' => 'The :attribute field must be a valid JSON string.', + 'list' => 'The :attribute field must be a list.', + 'lowercase' => 'The :attribute field must be lowercase.', + 'lt' => [ + 'array' => 'The :attribute field must have less than :value items.', + 'file' => 'The :attribute field must be less than :value kilobytes.', + 'numeric' => 'The :attribute field must be less than :value.', + 'string' => 'The :attribute field must be less than :value characters.', + ], + 'lte' => [ + 'array' => 'The :attribute field must not have more than :value items.', + 'file' => 'The :attribute field must be less than or equal to :value kilobytes.', + 'numeric' => 'The :attribute field must be less than or equal to :value.', + 'string' => 'The :attribute field must be less than or equal to :value characters.', + ], + 'mac_address' => 'The :attribute field must be a valid MAC address.', + 'max' => [ + 'array' => 'The :attribute field must not have more than :max items.', + 'file' => 'The :attribute field must not be greater than :max kilobytes.', + 'numeric' => 'The :attribute field must not be greater than :max.', + 'string' => 'The :attribute field must not be greater than :max characters.', + ], + 'max_digits' => 'The :attribute field must not have more than :max digits.', + 'mimes' => 'The :attribute field must be a file of type: :values.', + 'mimetypes' => 'The :attribute field must be a file of type: :values.', + 'min' => [ + 'array' => 'The :attribute field must have at least :min items.', + 'file' => 'The :attribute field must be at least :min kilobytes.', + 'numeric' => 'The :attribute field must be at least :min.', + 'string' => 'The :attribute field must be at least :min characters.', + ], + 'min_digits' => 'The :attribute field must have at least :min digits.', + 'missing' => 'The :attribute field must be missing.', + 'missing_if' => 'The :attribute field must be missing when :other is :value.', + 'missing_unless' => 'The :attribute field must be missing unless :other is :value.', + 'missing_with' => 'The :attribute field must be missing when :values is present.', + 'missing_with_all' => 'The :attribute field must be missing when :values are present.', + 'multiple_of' => 'The :attribute field must be a multiple of :value.', + 'not_in' => 'The selected :attribute is invalid.', + 'not_regex' => 'The :attribute field format is invalid.', + 'numeric' => 'The :attribute field must be a number.', + 'password' => [ + 'letters' => 'The :attribute field must contain at least one letter.', + 'mixed' => 'The :attribute field must contain at least one uppercase and one lowercase letter.', + 'numbers' => 'The :attribute field must contain at least one number.', + 'symbols' => 'The :attribute field must contain at least one symbol.', + 'uncompromised' => 'The given :attribute has appeared in a data leak. Please choose a different :attribute.', + ], + 'present' => 'The :attribute field must be present.', + 'present_if' => 'The :attribute field must be present when :other is :value.', + 'present_unless' => 'The :attribute field must be present unless :other is :value.', + 'present_with' => 'The :attribute field must be present when :values is present.', + 'present_with_all' => 'The :attribute field must be present when :values are present.', + 'prohibited' => 'The :attribute field is prohibited.', + 'prohibited_if' => 'The :attribute field is prohibited when :other is :value.', + 'prohibited_if_accepted' => 'The :attribute field is prohibited when :other is accepted.', + 'prohibited_if_declined' => 'The :attribute field is prohibited when :other is declined.', + 'prohibited_unless' => 'The :attribute field is prohibited unless :other is in :values.', + 'prohibits' => 'The :attribute field prohibits :other from being present.', + 'regex' => 'The :attribute field format is invalid.', + 'required' => 'The :attribute field is required.', + 'required_array_keys' => 'The :attribute field must contain entries for: :values.', + 'required_if' => 'The :attribute field is required when :other is :value.', + 'required_if_accepted' => 'The :attribute field is required when :other is accepted.', + 'required_if_declined' => 'The :attribute field is required when :other is declined.', + 'required_unless' => 'The :attribute field is required unless :other is in :values.', + 'required_with' => 'The :attribute field is required when :values is present.', + 'required_with_all' => 'The :attribute field is required when :values are present.', + 'required_without' => 'The :attribute field is required when :values is not present.', + 'required_without_all' => 'The :attribute field is required when none of :values are present.', + 'same' => 'The :attribute field must match :other.', + 'size' => [ + 'array' => 'The :attribute field must contain :size items.', + 'file' => 'The :attribute field must be :size kilobytes.', + 'numeric' => 'The :attribute field must be :size.', + 'string' => 'The :attribute field must be :size characters.', + ], + 'starts_with' => 'The :attribute field must start with one of the following: :values.', + 'string' => 'The :attribute field must be a string.', + 'timezone' => 'The :attribute field must be a valid timezone.', + 'unique' => 'The :attribute has already been taken.', + 'uploaded' => 'The :attribute failed to upload.', + 'uppercase' => 'The :attribute field must be uppercase.', + 'url' => 'The :attribute field must be a valid URL.', + 'ulid' => 'The :attribute field must be a valid ULID.', + 'uuid' => 'The :attribute field must be a valid UUID.', + + /* + |-------------------------------------------------------------------------- + | Custom Validation Language Lines + |-------------------------------------------------------------------------- + | + | Here you may specify custom validation messages for attributes using the + | convention "attribute.rule" to name the lines. This makes it quick to + | specify a specific custom language line for a given attribute rule. + | + */ + + 'custom' => [ + 'attribute-name' => [ + 'rule-name' => 'custom-message', + ], + ], + + /* + |-------------------------------------------------------------------------- + | Custom Validation Attributes + |-------------------------------------------------------------------------- + | + | The following language lines are used to swap our attribute placeholder + | with something more reader friendly such as "E-Mail Address" instead + | of "email". This simply helps us make our message more expressive. + | + */ + + 'attributes' => [ + 'firstname' => 'first name', + 'lastname' => 'last name', + 'email' => 'email', + 'password' => 'password', + 'password_confirmation' => 'password confirmation', + 'current_password' => 'current password', + 'name' => 'name', + 'code' => 'code', + 'currency' => 'currency', + 'principal' => 'principal', + 'phone' => 'phone', + 'address' => 'address', + 'city' => 'city', + 'region' => 'region', + 'po_box' => 'PO box', + 'description' => 'description', + 'level' => 'level', + 'locale' => 'language', + 'period_type' => 'period type', + 'academic_year_start' => 'academic year start', + 'timezone' => 'timezone', + 'password_policy' => 'password policy', + ], + +]; diff --git a/lang/fr/install.php b/lang/fr/install.php new file mode 100644 index 0000000..29baf78 --- /dev/null +++ b/lang/fr/install.php @@ -0,0 +1,100 @@ + 'Installation de Dalibi', + 'hero_title' => 'Bienvenue sur Dalibi', + 'hero_subtitle' => 'Configurons votre établissement en quelques étapes', + + 'steps' => [ + 'language' => 'Langue', + 'school' => 'École', + 'admin' => 'Administrateur', + 'security' => 'Sécurité', + ], + + 'common' => [ + 'back' => 'Retour', + 'continue' => 'Continuer', + 'install' => 'Installer', + 'optional' => 'optionnel', + ], + + 'welcome' => [ + 'title' => 'Choix de la langue', + 'description' => 'Sélectionnez la langue de l\'application', + ], + + 'school' => [ + 'title' => 'Votre établissement', + 'description' => 'Dernière étape : l\'identité de l\'école, puis l\'installation démarre', + 'group_identity' => 'Identité', + 'group_contact' => 'Direction & contact', + 'group_location' => 'Localisation', + 'group_pedagogy' => 'Organisation pédagogique', + 'name' => 'Nom de l\'école', + 'levels' => 'Niveaux proposés', + 'levels_hint' => 'Cochez un ou plusieurs cycles enseignés par l\'établissement.', + 'level_options' => [ + 'maternelle' => 'Maternelle', + 'primaire' => 'Primaire', + 'college' => 'Collège', + 'lycee' => 'Lycée', + 'lycee_technique' => 'Lycée technique', + ], + 'code' => 'Code', + 'devise' => 'Devise (slogan)', + 'devise_ph' => 'Ex : Travail - Liberté - Patrie', + 'currency' => 'Monnaie', + 'principal' => 'Directeur / Chef d\'établissement', + 'email' => 'Email', + 'phone' => 'Téléphone', + 'address' => 'Adresse', + 'city' => 'Ville', + 'region' => 'Région', + 'country' => 'Pays', + 'po_box' => 'Boîte postale', + 'description' => 'Description', + 'timezone' => 'Fuseau horaire', + 'academic_year_start' => 'Année académique — début', + 'period_type' => 'Découpage des périodes', + 'period_trimester' => 'Trimestres', + 'period_semester' => 'Semestres', + ], + + 'admin' => [ + 'title' => 'Compte administrateur', + 'description' => 'Le compte principal de gestion', + 'firstname' => 'Prénom', + 'lastname' => 'Nom', + 'email' => 'Email', + 'password' => 'Mot de passe', + 'password_confirmation' => 'Confirmation', + ], + + 'security' => [ + 'title' => 'Protocole de sécurité', + 'description' => 'Réglages recommandés — ajustables', + 'app_debug_off' => 'Mode debug désactivé (production)', + 'force_https' => 'HTTPS forcé (hors environnement local)', + 'password_policy' => 'Politique de mot de passe : fort', + 'enable_sentry' => 'Journalisation des erreurs (Sentry)', + 'two_factor_note' => 'La double authentification reste facultative, activable par chaque utilisateur dans ses réglages.', + 'lock_note' => 'L\'assistant se verrouille après l\'installation.', + ], + + 'requirements' => [ + 'title' => 'Prérequis système', + 'description' => 'Certains prérequis doivent être satisfaits avant l\'installation', + 'recheck' => 'Revérifier', + 'all_good' => 'Tous les prérequis sont satisfaits.', + ], + + 'running' => [ + 'title' => 'Installation en cours', + 'description' => 'Migration, données de référence et création des comptes', + 'working' => 'Veuillez patienter, ne fermez pas cette page…', + 'error' => 'L\'installation a échoué. Vérifiez la base de données et les droits, puis réessayez.', + 'retry' => 'Réessayer', + 'done' => 'Installation terminée. Connectez-vous avec le compte administrateur.', + ], +]; diff --git a/lang/fr/validation.php b/lang/fr/validation.php new file mode 100644 index 0000000..b7610c5 --- /dev/null +++ b/lang/fr/validation.php @@ -0,0 +1,215 @@ + 'Le champ :attribute doit être accepté.', + 'accepted_if' => 'Le champ :attribute doit être accepté quand :other vaut :value.', + 'active_url' => 'Le champ :attribute doit être une URL valide.', + 'after' => 'Le champ :attribute doit être une date postérieure au :date.', + 'after_or_equal' => 'Le champ :attribute doit être une date postérieure ou égale au :date.', + 'alpha' => 'Le champ :attribute ne doit contenir que des lettres.', + 'alpha_dash' => 'Le champ :attribute ne doit contenir que des lettres, des chiffres, des tirets et des underscores.', + 'alpha_num' => 'Le champ :attribute ne doit contenir que des lettres et des chiffres.', + 'any_of' => 'Le champ :attribute est invalide.', + 'array' => 'Le champ :attribute doit être un tableau.', + 'ascii' => 'Le champ :attribute ne doit contenir que des caractères alphanumériques et des symboles sur un octet.', + 'before' => 'Le champ :attribute doit être une date antérieure au :date.', + 'before_or_equal' => 'Le champ :attribute doit être une date antérieure ou égale au :date.', + 'between' => [ + 'array' => 'Le champ :attribute doit contenir entre :min et :max éléments.', + 'file' => 'Le champ :attribute doit peser entre :min et :max kilo-octets.', + 'numeric' => 'Le champ :attribute doit être compris entre :min et :max.', + 'string' => 'Le champ :attribute doit contenir entre :min et :max caractères.', + ], + 'boolean' => 'Le champ :attribute doit être vrai ou faux.', + 'can' => 'Le champ :attribute contient une valeur non autorisée.', + 'confirmed' => 'La confirmation du champ :attribute ne correspond pas.', + 'contains' => 'Il manque une valeur obligatoire dans le champ :attribute.', + 'current_password' => 'Le mot de passe est incorrect.', + 'date' => 'Le champ :attribute doit être une date valide.', + 'date_equals' => 'Le champ :attribute doit être une date égale au :date.', + 'date_format' => 'Le champ :attribute doit respecter le format :format.', + 'decimal' => 'Le champ :attribute doit comporter :decimal décimales.', + 'declined' => 'Le champ :attribute doit être refusé.', + 'declined_if' => 'Le champ :attribute doit être refusé quand :other vaut :value.', + 'different' => 'Les champs :attribute et :other doivent être différents.', + 'digits' => 'Le champ :attribute doit comporter :digits chiffres.', + 'digits_between' => 'Le champ :attribute doit comporter entre :min et :max chiffres.', + 'dimensions' => 'Le champ :attribute a des dimensions d\'image invalides.', + 'distinct' => 'Le champ :attribute a une valeur en double.', + 'doesnt_contain' => 'Le champ :attribute ne doit contenir aucune des valeurs suivantes : :values.', + 'doesnt_end_with' => 'Le champ :attribute ne doit pas se terminer par l\'une des valeurs suivantes : :values.', + 'doesnt_start_with' => 'Le champ :attribute ne doit pas commencer par l\'une des valeurs suivantes : :values.', + 'email' => 'Le champ :attribute doit être une adresse e-mail valide.', + 'encoding' => 'Le champ :attribute doit être encodé en :encoding.', + 'ends_with' => 'Le champ :attribute doit se terminer par l\'une des valeurs suivantes : :values.', + 'enum' => 'Le champ :attribute sélectionné est invalide.', + 'exists' => 'Le champ :attribute sélectionné est invalide.', + 'extensions' => 'Le champ :attribute doit avoir l\'une des extensions suivantes : :values.', + 'file' => 'Le champ :attribute doit être un fichier.', + 'filled' => 'Le champ :attribute doit avoir une valeur.', + 'gt' => [ + 'array' => 'Le champ :attribute doit contenir plus de :value éléments.', + 'file' => 'Le champ :attribute doit peser plus de :value kilo-octets.', + 'numeric' => 'Le champ :attribute doit être supérieur à :value.', + 'string' => 'Le champ :attribute doit contenir plus de :value caractères.', + ], + 'gte' => [ + 'array' => 'Le champ :attribute doit contenir au moins :value éléments.', + 'file' => 'Le champ :attribute doit peser au moins :value kilo-octets.', + 'numeric' => 'Le champ :attribute doit être supérieur ou égal à :value.', + 'string' => 'Le champ :attribute doit contenir au moins :value caractères.', + ], + 'hex_color' => 'Le champ :attribute doit être une couleur hexadécimale valide.', + 'image' => 'Le champ :attribute doit être une image.', + 'in' => 'Le champ :attribute sélectionné est invalide.', + 'in_array' => 'Le champ :attribute doit exister dans :other.', + 'in_array_keys' => 'Le champ :attribute doit contenir au moins l\'une des clés suivantes : :values.', + 'integer' => 'Le champ :attribute doit être un entier.', + 'ip' => 'Le champ :attribute doit être une adresse IP valide.', + 'ipv4' => 'Le champ :attribute doit être une adresse IPv4 valide.', + 'ipv6' => 'Le champ :attribute doit être une adresse IPv6 valide.', + 'json' => 'Le champ :attribute doit être une chaîne JSON valide.', + 'list' => 'Le champ :attribute doit être une liste.', + 'lowercase' => 'Le champ :attribute doit être en minuscules.', + 'lt' => [ + 'array' => 'Le champ :attribute doit contenir moins de :value éléments.', + 'file' => 'Le champ :attribute doit peser moins de :value kilo-octets.', + 'numeric' => 'Le champ :attribute doit être inférieur à :value.', + 'string' => 'Le champ :attribute doit contenir moins de :value caractères.', + ], + 'lte' => [ + 'array' => 'Le champ :attribute ne doit pas contenir plus de :value éléments.', + 'file' => 'Le champ :attribute doit peser au plus :value kilo-octets.', + 'numeric' => 'Le champ :attribute doit être inférieur ou égal à :value.', + 'string' => 'Le champ :attribute doit contenir au plus :value caractères.', + ], + 'mac_address' => 'Le champ :attribute doit être une adresse MAC valide.', + 'max' => [ + 'array' => 'Le champ :attribute ne doit pas contenir plus de :max éléments.', + 'file' => 'Le champ :attribute ne doit pas peser plus de :max kilo-octets.', + 'numeric' => 'Le champ :attribute ne doit pas être supérieur à :max.', + 'string' => 'Le champ :attribute ne doit pas contenir plus de :max caractères.', + ], + 'max_digits' => 'Le champ :attribute ne doit pas comporter plus de :max chiffres.', + 'mimes' => 'Le champ :attribute doit être un fichier de type : :values.', + 'mimetypes' => 'Le champ :attribute doit être un fichier de type : :values.', + 'min' => [ + 'array' => 'Le champ :attribute doit contenir au moins :min éléments.', + 'file' => 'Le champ :attribute doit peser au moins :min kilo-octets.', + 'numeric' => 'Le champ :attribute doit être au moins égal à :min.', + 'string' => 'Le champ :attribute doit contenir au moins :min caractères.', + ], + 'min_digits' => 'Le champ :attribute doit comporter au moins :min chiffres.', + 'missing' => 'Le champ :attribute doit être absent.', + 'missing_if' => 'Le champ :attribute doit être absent quand :other vaut :value.', + 'missing_unless' => 'Le champ :attribute doit être absent sauf si :other vaut :value.', + 'missing_with' => 'Le champ :attribute doit être absent quand :values est présent.', + 'missing_with_all' => 'Le champ :attribute doit être absent quand :values sont présents.', + 'multiple_of' => 'Le champ :attribute doit être un multiple de :value.', + 'not_in' => 'Le champ :attribute sélectionné est invalide.', + 'not_regex' => 'Le format du champ :attribute est invalide.', + 'numeric' => 'Le champ :attribute doit être un nombre.', + 'password' => [ + 'letters' => 'Le champ :attribute doit contenir au moins une lettre.', + 'mixed' => 'Le champ :attribute doit contenir au moins une majuscule et une minuscule.', + 'numbers' => 'Le champ :attribute doit contenir au moins un chiffre.', + 'symbols' => 'Le champ :attribute doit contenir au moins un symbole.', + 'uncompromised' => 'Ce :attribute est apparu dans une fuite de données. Veuillez en choisir un autre.', + ], + 'present' => 'Le champ :attribute doit être présent.', + 'present_if' => 'Le champ :attribute doit être présent quand :other vaut :value.', + 'present_unless' => 'Le champ :attribute doit être présent sauf si :other vaut :value.', + 'present_with' => 'Le champ :attribute doit être présent quand :values est présent.', + 'present_with_all' => 'Le champ :attribute doit être présent quand :values sont présents.', + 'prohibited' => 'Le champ :attribute est interdit.', + 'prohibited_if' => 'Le champ :attribute est interdit quand :other vaut :value.', + 'prohibited_if_accepted' => 'Le champ :attribute est interdit quand :other est accepté.', + 'prohibited_if_declined' => 'Le champ :attribute est interdit quand :other est refusé.', + 'prohibited_unless' => 'Le champ :attribute est interdit sauf si :other est dans :values.', + 'prohibits' => 'Le champ :attribute interdit la présence de :other.', + 'regex' => 'Le format du champ :attribute est invalide.', + 'required' => 'Le champ :attribute est obligatoire.', + 'required_array_keys' => 'Le champ :attribute doit contenir des entrées pour : :values.', + 'required_if' => 'Le champ :attribute est obligatoire quand :other vaut :value.', + 'required_if_accepted' => 'Le champ :attribute est obligatoire quand :other est accepté.', + 'required_if_declined' => 'Le champ :attribute est obligatoire quand :other est refusé.', + 'required_unless' => 'Le champ :attribute est obligatoire sauf si :other est dans :values.', + 'required_with' => 'Le champ :attribute est obligatoire quand :values est présent.', + 'required_with_all' => 'Le champ :attribute est obligatoire quand :values sont présents.', + 'required_without' => 'Le champ :attribute est obligatoire quand :values n\'est pas présent.', + 'required_without_all' => 'Le champ :attribute est obligatoire quand aucun de :values n\'est présent.', + 'same' => 'Les champs :attribute et :other doivent correspondre.', + 'size' => [ + 'array' => 'Le champ :attribute doit contenir :size éléments.', + 'file' => 'Le champ :attribute doit peser :size kilo-octets.', + 'numeric' => 'Le champ :attribute doit être égal à :size.', + 'string' => 'Le champ :attribute doit contenir :size caractères.', + ], + 'starts_with' => 'Le champ :attribute doit commencer par l\'une des valeurs suivantes : :values.', + 'string' => 'Le champ :attribute doit être une chaîne de caractères.', + 'timezone' => 'Le champ :attribute doit être un fuseau horaire valide.', + 'unique' => 'La valeur du champ :attribute est déjà utilisée.', + 'uploaded' => 'Le téléversement du champ :attribute a échoué.', + 'uppercase' => 'Le champ :attribute doit être en majuscules.', + 'url' => 'Le champ :attribute doit être une URL valide.', + 'ulid' => 'Le champ :attribute doit être un ULID valide.', + 'uuid' => 'Le champ :attribute doit être un UUID valide.', + + /* + |-------------------------------------------------------------------------- + | Messages de validation personnalisés + |-------------------------------------------------------------------------- + */ + + 'custom' => [ + 'attribute-name' => [ + 'rule-name' => 'custom-message', + ], + ], + + /* + |-------------------------------------------------------------------------- + | Noms d'attributs lisibles + |-------------------------------------------------------------------------- + | + | Remplace le nom technique du champ par un libellé plus lisible dans les + | messages (« adresse e-mail » au lieu de « email »). + | + */ + + 'attributes' => [ + 'firstname' => 'prénom', + 'lastname' => 'nom', + 'email' => 'adresse e-mail', + 'password' => 'mot de passe', + 'password_confirmation' => 'confirmation du mot de passe', + 'current_password' => 'mot de passe actuel', + 'name' => 'nom', + 'code' => 'code', + 'currency' => 'devise', + 'principal' => 'directeur', + 'phone' => 'téléphone', + 'address' => 'adresse', + 'city' => 'ville', + 'region' => 'région', + 'po_box' => 'boîte postale', + 'description' => 'description', + 'level' => 'niveau', + 'locale' => 'langue', + 'period_type' => 'découpage des périodes', + 'academic_year_start' => 'début d\'année académique', + 'timezone' => 'fuseau horaire', + 'password_policy' => 'politique de mot de passe', + ], + +]; diff --git a/resources/js/components/install-stepper.tsx b/resources/js/components/install-stepper.tsx new file mode 100644 index 0000000..5051a11 --- /dev/null +++ b/resources/js/components/install-stepper.tsx @@ -0,0 +1,50 @@ +import { Check } from 'lucide-react'; +import { useTranslation } from '@/helpers/i18n'; + +const STEPS = ['language', 'admin', 'security', 'school'] as const; + +export type InstallStep = (typeof STEPS)[number]; + +export default function InstallStepper({ current }: Readonly<{ current: InstallStep }>) { + const { t } = useTranslation(); + const currentIndex = STEPS.indexOf(current); + + return ( +
    + {STEPS.map((step, index) => { + const done = index < currentIndex; + const active = index === currentIndex; + + return ( +
  1. +
    + + {done ? : index + 1} + + + {t(`install.steps.${step}`)} + +
    + {index < STEPS.length - 1 && ( +
  2. + ); + })} +
+ ); +} diff --git a/resources/js/layouts/install/install-layout.tsx b/resources/js/layouts/install/install-layout.tsx new file mode 100644 index 0000000..7e3d8ae --- /dev/null +++ b/resources/js/layouts/install/install-layout.tsx @@ -0,0 +1,52 @@ +import DalibiLogo from '@/components/dalibi-logo'; +import InstallStepper, { type InstallStep } from '@/components/install-stepper'; +import { useTranslation } from '@/helpers/i18n'; + +/** + * Layout de l'assistant d'installation — reprend la mise en page de la page de + * connexion (image à gauche, contenu à droite) et ajoute le fil des étapes. + */ +export default function InstallLayout({ + children, + title, + description, + step, +}: Readonly<{ + children: React.ReactNode; + title: string; + description: string; + step?: InstallStep; +}>) { + const { t } = useTranslation(); + + return ( +
+ {/* Section image - 50% */} +
+ Dalibi +
+
+

{t('install.hero_title')}

+

{t('install.hero_subtitle')}

+
+
+ + {/* Section formulaire - 50% */} +
+
+
+
+ + {step && } +
+

{title}

+

{description}

+
+
+ {children} +
+
+
+
+ ); +} diff --git a/resources/js/pages/install/admin.tsx b/resources/js/pages/install/admin.tsx new file mode 100644 index 0000000..ded0ed7 --- /dev/null +++ b/resources/js/pages/install/admin.tsx @@ -0,0 +1,167 @@ +import { Form, Head, Link } from '@inertiajs/react'; +import { ArrowLeft, ArrowRight, Eye, EyeOff } from 'lucide-react'; +import { useState } from 'react'; +import InputError from '@/components/input-error'; +import PasswordStrength from '@/components/password-strength'; +import { Button } from '@/components/ui/button'; +import { Input } from '@/components/ui/input'; +import { Label } from '@/components/ui/label'; +import { Spinner } from '@/components/ui/spinner'; +import { useTranslation } from '@/helpers/i18n'; +import InstallLayout from '@/layouts/install/install-layout'; + +type Props = { + values?: { firstname?: string; lastname?: string; email?: string } | null; +}; + +export default function InstallAdmin({ values }: Readonly) { + const { t } = useTranslation(); + const v = values ?? {}; + const [password, setPassword] = useState(''); + const [show, setShow] = useState(false); + + return ( + + + +
+ {({ processing, errors, clearErrors }) => ( +
+
+
+ + clearErrors('firstname')} + /> + +
+
+ + clearErrors('lastname')} + /> + +
+
+ +
+ + clearErrors('email')} + /> + +
+ +
+ +
+ { + setPassword(e.target.value); + // La confirmation est revalidée côté serveur avec le mot de passe : + // on efface les deux erreurs dès qu'on retouche l'un ou l'autre. + clearErrors( + 'password', + 'password_confirmation', + ); + }} + /> + +
+ + +
+ +
+ + + clearErrors( + 'password', + 'password_confirmation', + ) + } + /> + +
+ +
+ + +
+
+ )} +
+
+ ); +} diff --git a/resources/js/pages/install/requirements.tsx b/resources/js/pages/install/requirements.tsx new file mode 100644 index 0000000..949fe72 --- /dev/null +++ b/resources/js/pages/install/requirements.tsx @@ -0,0 +1,66 @@ +import { Head, Link } from '@inertiajs/react'; +import { ArrowRight, CheckCircle2, RefreshCw, XCircle } from 'lucide-react'; +import { Button } from '@/components/ui/button'; +import { useTranslation } from '@/helpers/i18n'; +import InstallLayout from '@/layouts/install/install-layout'; + +type Requirement = { key: string; label: string; ok: boolean; hint: string }; + +type Props = { + requirements: Requirement[]; + passes: boolean; +}; + +export default function InstallRequirements({ requirements, passes }: Readonly) { + const { t } = useTranslation(); + + return ( + + + +
+
    + {requirements.map((req) => ( +
  • + + {req.ok ? ( + + ) : ( + + )} + {req.label} + + {req.hint} +
  • + ))} +
+ + {passes && ( +

+ {t('install.requirements.all_good')} +

+ )} + +
+ + {passes && ( + + )} +
+
+
+ ); +} diff --git a/resources/js/pages/install/running.tsx b/resources/js/pages/install/running.tsx new file mode 100644 index 0000000..c0497d2 --- /dev/null +++ b/resources/js/pages/install/running.tsx @@ -0,0 +1,94 @@ +import { Head, router, usePage } from '@inertiajs/react'; +import { AlertTriangle, Loader2, RefreshCw } from 'lucide-react'; +import { useEffect, useRef, useState } from 'react'; +import { Button } from '@/components/ui/button'; +import { useTranslation } from '@/helpers/i18n'; +import InstallLayout from '@/layouts/install/install-layout'; + +export default function InstallRunning() { + const { t } = useTranslation(); + const { errors } = usePage().props as unknown as { errors: Record }; + const failed = Boolean(errors?.install); + + // Progression simulée : l'exécution est « silencieuse à la fin » (une seule + // requête POST), la barre rassure l'utilisateur pendant le traitement. + const [progress, setProgress] = useState(8); + const started = useRef(false); + + const execute = () => { + router.post( + '/install/execute', + {}, + { + preserveScroll: true, + onStart: () => setProgress(12), + }, + ); + }; + + useEffect(() => { + if (started.current || failed) { + return; + } + started.current = true; + execute(); + }, [failed]); + + useEffect(() => { + if (failed) { + return; + } + const id = setInterval(() => { + setProgress((p) => (p < 90 ? p + Math.max(1, Math.round((90 - p) / 12)) : p)); + }, 600); + + return () => clearInterval(id); + }, [failed]); + + return ( + + + +
+
+ {failed ? ( + + ) : ( + + )} +
+
+
+
+
+
+ + {failed ? ( + <> +

+ {errors.install} +

+ + + ) : ( +

{t('install.running.working')}

+ )} +
+ + ); +} diff --git a/resources/js/pages/install/school.tsx b/resources/js/pages/install/school.tsx new file mode 100644 index 0000000..2dcbce8 --- /dev/null +++ b/resources/js/pages/install/school.tsx @@ -0,0 +1,380 @@ +import { Form, Head, Link } from '@inertiajs/react'; +import { ArrowLeft } from 'lucide-react'; +import type { ReactNode } from 'react'; +import InputError from '@/components/input-error'; +import { Button } from '@/components/ui/button'; +import { Input } from '@/components/ui/input'; +import { Label } from '@/components/ui/label'; +import { Spinner } from '@/components/ui/spinner'; +import { useTranslation } from '@/helpers/i18n'; +import InstallLayout from '@/layouts/install/install-layout'; + +type Currency = { code: string; label: string; symbol: string }; +type Country = { code: string; name: string }; + +type Props = { + defaults: { + locale: string; + currency: string; + country: string; + timezone: string; + }; + currencies: Currency[]; + countries: Country[]; + levels: string[]; + values?: (Record & { levels?: string[] }) | null; +}; + +const selectClass = + 'h-9 w-full rounded-md border border-input bg-transparent px-3 py-1 text-sm shadow-sm'; + +/** Regroupe des champs de même logique sous un intitulé discret (sans card). */ +function Section({ + title, + children, +}: Readonly<{ title: string; children: ReactNode }>) { + return ( +
+

+ {title} +

+ {children} +
+ ); +} + +export default function InstallSchool({ + defaults, + currencies, + countries, + levels, + values, +}: Readonly) { + const { t } = useTranslation(); + const v = values ?? {}; + const selectedLevels = v.levels ?? ['primaire']; + + return ( + + + +
+ {({ processing, errors, clearErrors }) => ( +
{ + // Délégation : efface l'erreur du champ dès qu'on le modifie + // (sinon le message resterait figé jusqu'au prochain envoi). + const name = ( + e.target as HTMLInputElement + ).name?.replace('[]', ''); + if (name) { + clearErrors(name as keyof typeof errors); + } + }} + > + {/* 1. Identité de l'établissement */} +
+
+ + + +
+ +
+
+ + + +
+
+ + + +
+
+ + {/* Devise = slogan/exergue de l'école (distincte de la monnaie). */} +
+ + + +
+
+ + {/* 2. Direction & contact */} +
+
+ + + +
+ +
+
+ + + +
+
+ + + +
+
+
+ + {/* 3. Localisation */} +
+
+
+ + + +
+
+ + + +
+
+ +
+
+ + + +
+
+ + + +
+
+ +
+ + + +
+
+ + {/* 4. Organisation pédagogique (niveaux en bas, regroupés avec l'année & les périodes) */} +
+
+ +
+ {levels.map((slug) => { + const checked = + selectedLevels.includes(slug); + return ( + + ); + })} +
+

+ {t('install.school.levels_hint')} +

+ +
+ +
+
+ + + +
+
+ + + +
+
+ +
+ +