Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
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/).

## [1.1.0] — 2026-11-18

### 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