prenoms-app/README.md

Prénoms de France 🇫🇷

Application web d'exploration des prénoms INSEE.

Démarrage rapide

1. Placez le fichier INSEE dans le dossier data/ :

   mkdir -p data
   cp prenoms.csv data/
   

2. Lancez l'application :

   docker compose up --build
   

3. Ouvrez http://localhost:8080

Fonctionnalités

• 📈 Graphique d'évolution : cliquez sur un prénom pour voir ses naissances par année
• 🔍 Recherche filtrée : par début de prénom, genre, longueur, popularité, période
• 🏆 Top prénoms récents (2010–2023)
• 📊 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

prenoms-app/
├── backend/        # FastAPI + Pandas
├── frontend/       # HTML/JS + Nginx
├── data/           # Montez prenoms.csv ici
└── docker-compose.yml