Update README
This commit is contained in:
@@ -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 (2010–2023)
|
- 🏆 **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)
|
||||||
|
|||||||
Reference in New Issue
Block a user