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