prenoms-app/README.md

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/ :

   mkdir -p data
   cp prenoms-2024-nat.csv data/prenoms.csv
   

   Téléchargeable sur insee.fr — fichier "Prénoms par année de naissance"

2. Lancez l'application :

   docker compose up -d
   

3. Ouvrez 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)