Skip to content
26 changes: 26 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -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é
Expand Down
28 changes: 22 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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…)
Expand Down
303 changes: 303 additions & 0 deletions app/Constants/Countries.php
Original file line number Diff line number Diff line change
@@ -0,0 +1,303 @@
<?php

namespace App\Constants;

/**
* Liste ISO 3166-1 des pays (code alpha-2 → nom), source unique de vérité.
*
* Consommée sans toucher la base par l'assistant d'installation (le select pays
* de l'étape « École ») ET par le CountrySeeder qui peuple la table `countries`.
* Garder les deux synchronisés : ne pas dupliquer la liste ailleurs.
*/
class Countries
{
/** Code par défaut (Togo). */
public const DEFAULT = 'TG';

/**
* Tous les pays : code ISO alpha-2 → nom.
*
* @return array<string, string>
*/
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<int, array{code: string, name: string}>
*/
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),
);
}
}
Loading
Loading