55 lines
1.7 KiB
Markdown
55 lines
1.7 KiB
Markdown
# Prénoms stats
|
|
|
|
Application web d'exploration des prénoms français, basée sur les données INSEE.
|
|
|
|
## Démarrage rapide
|
|
|
|
1. **Placez le fichier INSEE** dans le dossier `data/` :
|
|
```bash
|
|
mkdir -p data
|
|
cp prenoms-2024-nat.csv data/prenoms.csv
|
|
```
|
|
> Téléchargeable sur [insee.fr](https://www.insee.fr/fr/statistiques/8595130#titre-bloc-4) — fichier "Fichier national (France y compris Mayotte depuis 2012)"
|
|
|
|
2. **Lancez l'application** :
|
|
```bash
|
|
docker compose up -d
|
|
```
|
|
|
|
3. **Ouvrez** [http://localhost:8070](http://localhost:8070)
|
|
|
|
## Fonctionnalités
|
|
|
|
- 🔍 **Explorer** — graphique d'évolution, carte de chaleur par décennie, statistiques, tendance, comparaison de deux prénoms, partage par URL
|
|
- ✨ **Trouver** — recherche filtrée par genre, popularité, longueur, initiale, période
|
|
- 🏆 **Classement** — tous les prénoms triés par nombre de naissances, paginés, filtrables
|
|
|
|
## Structure
|
|
|
|
```
|
|
prenoms-app/
|
|
├── data/ # Placez prenoms.csv ici (non versionné)
|
|
├── main.py # Backend FastAPI + Pandas
|
|
├── index.html # Frontend HTML/JS/CSS (fichier unique)
|
|
├── nginx.conf # Reverse proxy vers le backend
|
|
└── docker-compose.yml
|
|
```
|
|
|
|
## Stack technique
|
|
|
|
- **Backend** : FastAPI + Pandas + Uvicorn (Python 3.11)
|
|
- **Frontend** : HTML/CSS/JS vanilla + Chart.js
|
|
- **Infrastructure** : Docker Compose, Nginx
|
|
|
|
## Format du fichier INSEE
|
|
|
|
```
|
|
sexe;prenom;periode;valeur
|
|
1;GABRIEL;2023;5285
|
|
```
|
|
|
|
- `sexe` : 1 = Masculin, 2 = Féminin
|
|
- `prenom` : en majuscules (`_PRENOMS_RARES` est filtré automatiquement)
|
|
- `periode` : année de naissance
|
|
- `valeur` : nombre de naissances (arrondi par multiples de 5 par l'INSEE)
|