Plateforme numérique officielle de recensement et de services à la diaspora malienne — infrastructure publique d'État, MVP Phase 1
# Plateforme Numérique de Recensement et de Services à la Diaspora Malienne
Infrastructure publique de l'État malien — recensement volontaire, services consulaires dématérialisés, communication officielle, aide d'urgence.
**Statut :** Phase 1 MVP — fonctionnel en local (golden path).
**Documents de référence (à lire avant toute contribution) :**
- `cadrage_diaspora_mali.md` — cadrage stratégique, juridique, institutionnel
- `spezifikation.md` — spécification technique figée v1.0 (21 sections, 10 modules)
- `claude.md` — conventions de code, garde-fous, workflow
- `PARCOURS.md` — scénarios de démonstration golden path
---
## Stack
| Couche | Technologie |
|---|---|
| Backend | Python 3.12 + FastAPI + SQLAlchemy 2.0 + Pydantic v2 |
| BDD | PostgreSQL 16 (`pgcrypto`, `pg_trgm`, `citext`) + Redis 7 + MinIO |
| IAM | Keycloak 24 (realms users + admins, prêts pour Phase 2+) |
| Auth Phase 1 | JWT local signé par l'API (HS256) — Keycloak en standby |
| Tâches async | Celery (broker Redis) — utilisé pour les exports en Phase 2 |
| Web | Vite + React 18 + TS + Tailwind + TanStack Query/Router + Zustand |
| Admin | App séparée (port 5174), même stack que web, déploiement isolé |
| Mobile | Expo SDK 51 + Expo Router |
| Monorepo | Turborepo + pnpm — `apps/api` géré via `uv` (Python) |
Source de vérité contrats API : **Pydantic → OpenAPI → openapi-typescript → `@diaspora/api-client`**
---
## Périmètre Phase 1 MVP
| Module | Statut |
|---|---|
| 1 — Inscription & KYC (mock auto-approve en dev) | ✅ |
| 2 — Profil & localisation | ✅ |
| 3 — Cartographie anonymisée (k-anonymity ≥ 10) | ✅ |
| 9 — Espace personnel (portabilité + effacement) | ✅ |
| 10 — Back-office minimal (file KYC + audit + stats) | ✅ |
| Audit immuable HMAC chaîné | ✅ |
| Consentement granulaire (8 finalités) | ✅ |
| 4, 5, 6, 7, 8 — autres modules | Phase 2+ |
---
## Démarrage rapide
Voir `PARCOURS.md` pour les scénarios complets.
```bash
# Infrastructure (Postgres, Redis, MinIO, Keycloak, MailHog)
p …