# 🇸🇳 Mon Panier Sénégal — Observatoire Citoyen de l'Inflation (ANSD 20 Ans)
> **Application Web Progressive (PWA) complète et autonome** conçue pour le hackathon des 20 ans de l'**Agence Nationale de la Statistique et de la Démographie (ANSD)** du Sénégal.
---
## 🌟 Présentation du Projet
**Mon Panier Sénégal** permet à tout citoyen sénégalais de :
- 📈 **Suivre l'évolution du coût de la vie** par région et par catégorie de dépense à partir des données statistiques publiques officielles (IHPC).
- ⚖️ **Comparer sa région à la moyenne nationale** via des visualisations graphiques interactives (Recharts).
- 🛒 **Simuler l'impact réel de l'inflation sur son budget familial** (comparatif aujourd'hui vs il y a 6 et 12 mois avec surcoût en FCFA).
- 🔔 **Définir des alertes personnalisées** pour être prévenu dès qu'un poste de dépense critique dépasse un seuil d'augmentation défini.
- 📂 **Consulter et exporter les séries statistiques en Open Data (CSV)** librement sans nécessiter de compte.
- 🛡️ **Superviser l'observatoire via un panneau d'administration** dédié aux analystes de l'ANSD.
---
## 🛠️ Stack Technique
- **Frontend** : React 18, TypeScript, Vite, TailwindCSS (thème institutionnel sénégalais), Recharts, React Router, Lucide Icons, Vite PWA.
- **Backend** : Node.js, Express, TypeScript, Prisma ORM, PostgreSQL, Zod (validation stricte), Bcryptjs, JWT, Helmet, Express Rate Limit.
- **Data Module** : Script d'ingestion automatisé CSV/API, templates `/data/imports/`, 24 mois de données IHPC de démonstration réalistes.
- **Qualité & Tests** : Vitest (11 tests automatisés validés), architecture propre et modulaire.
- **Déploiement** : Docker multi-stage, Docker Compose, prêt pour Render, Railway et VPS.
---
## 📁 Architecture du Monorepo
```
mon-panier-senegal/
├── backend/ # API REST Express + TypeScript + Prisma
│ ├── prisma/ # Schéma Prisma & Script de seed (24 mois d'indices)
│ ├── src/
│ │ ├── controllers/ # Contrôleur …