48 lines
1.1 KiB
Markdown
48 lines
1.1 KiB
Markdown
# Prénoms de France 🇫🇷
|
||
|
||
Application web d'exploration des prénoms INSEE.
|
||
|
||
## Démarrage rapide
|
||
|
||
1. **Placez le fichier INSEE** dans le dossier `data/` :
|
||
```
|
||
mkdir -p data
|
||
cp prenoms.csv data/
|
||
```
|
||
|
||
2. **Lancez l'application** :
|
||
```bash
|
||
docker compose up --build
|
||
```
|
||
|
||
3. **Ouvrez** [http://localhost:8080](http://localhost:8080)
|
||
|
||
## Fonctionnalités
|
||
|
||
- 📈 **Graphique d'évolution** : cliquez sur un prénom pour voir ses naissances par année
|
||
- 🔍 **Recherche filtrée** : par début de prénom, genre, longueur, popularité, période
|
||
- 🏆 **Top prénoms** récents (2010–2023)
|
||
- 📊 **Statistiques globales** : total de naissances, nombre de prénoms, période couverte
|
||
|
||
## Format du fichier INSEE
|
||
|
||
```
|
||
sexe;prenom;periode;valeur
|
||
1;AABAN;2018;5
|
||
```
|
||
|
||
- `sexe` : 1 = Masculin, 2 = Féminin
|
||
- `prenom` : en majuscules (les prénoms rares `_PRENOMS_RARES` sont filtrés)
|
||
- `periode` : année
|
||
- `valeur` : nombre de naissances
|
||
|
||
## Structure
|
||
|
||
```
|
||
prenoms-app/
|
||
├── backend/ # FastAPI + Pandas
|
||
├── frontend/ # HTML/JS + Nginx
|
||
├── data/ # Montez prenoms.csv ici
|
||
└── docker-compose.yml
|
||
```
|