Initial commit

2026-03-14 09:33:12 +01:00
commit 9fc4e15d3f
8 changed files with 712884 additions and 0 deletions
@@ -0,0 +1,47 @@
+# 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** :
+   ```bash
+   docker compose up --build
+   ```
+
+3. **Ouvrez** [http://localhost:8080](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
+```