Update README

This commit is contained in:
2026-03-14 09:37:34 +01:00
parent 5cc5a93c42
commit 6e128b2ee7
+32 -25
View File
@@ -1,47 +1,54 @@
# Prénoms de France 🇫🇷 # Prénoms stats
Application web d'exploration des prénoms INSEE. Application web d'exploration des prénoms français, basée sur les données INSEE.
## Démarrage rapide ## Démarrage rapide
1. **Placez le fichier INSEE** dans le dossier `data/` : 1. **Placez le fichier INSEE** dans le dossier `data/` :
``` ```bash
mkdir -p data mkdir -p data
cp prenoms.csv data/ cp prenoms-2024-nat.csv data/prenoms.csv
``` ```
> Téléchargeable sur [insee.fr](https://www.insee.fr/fr/statistiques/7633685) — fichier "Prénoms par année de naissance"
2. **Lancez l'application** : 2. **Lancez l'application** :
```bash ```bash
docker compose up --build docker compose up -d
``` ```
3. **Ouvrez** [http://localhost:8080](http://localhost:8080) 3. **Ouvrez** [http://localhost:8070](http://localhost:8070)
## Fonctionnalités ## Fonctionnalités
- 📈 **Graphique d'évolution** : cliquez sur un prénom pour voir ses naissances par année - 🔍 **Explorer** — graphique d'évolution, carte de chaleur par décennie, statistiques, tendance, comparaison de deux prénoms, partage par URL
- 🔍 **Recherche filtrée** : par début de prénom, genre, longueur, popularité, période - **Trouver** — recherche filtrée par genre, popularité, longueur, initiale, période
- 🏆 **Top prénoms** récents (20102023) - 🏆 **Classement** — tous les prénoms triés par nombre de naissances, paginés, filtrables
- 📊 **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 ## Structure
``` ```
prenoms-app/ prenoms-app/
├── backend/ # FastAPI + Pandas ├── data/ # Placez prenoms.csv ici (non versionné)
├── frontend/ # HTML/JS + Nginx ├── main.py # Backend FastAPI + Pandas
├── data/ # Montez prenoms.csv ici ├── index.html # Frontend HTML/JS/CSS (fichier unique)
├── nginx.conf # Reverse proxy vers le backend
└── docker-compose.yml └── 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)