Jeu mobile de puzzle chimique narratif (offline-first) pour l'apprentissage de la chimie en classe de 3ème au Burkina Faso. Développé avec Flutter et Django pour le Hackathon HGE 2026 (Team Mirror).
# ZAMSMA
**Zamsma** (« apprends-moi » en mooré) est un jeu de puzzle chimique narratif **offline-first**, destiné aux élèves du secondaire au Burkina Faso. Il met la Taxonomie de Bloom au service de l'apprentissage de la chimie — sans jamais la nommer.
> *« Valence » est le nom de travail historique du projet : il reste celui des dépôts (`valence_app`, `valence_backend`).*
## Structure du dépôt
- `valence_app/` — Application mobile **Flutter** (offline-first : BLoC + GetIt + Hive). Voir valence_app/README.md.
- `valence_backend/` — API REST **Django 5 + DRF** (auth, catalogue de jeu, progression, social, synchro). Voir valence_backend/README.md.
- `docs/` — Documentation par thème (`specs/`, `design/`, `guides/`, `business/`, `reference/`, `archive/`). Index : docs/README.md.
- `design_assets/` — Médias de design bruts (personas, fonds, badges, cristaux, maquettes Stitch).
Document de référence courant : **CDC v5.3** → docs/specs/zamsma_cdc_v5_3.md.
## Démarrage rapide (local)
Environnement complet (PostgreSQL 15 + Redis 7 + Django) via Docker :
```bash
docker-compose up --build
```
Pour lancer chaque partie séparément, voir les README du backend et de l'app.
## Stack
Flutter (Dart) · Django 5 + DRF · PostgreSQL (Supabase) · Redis · JWT · Rive · Nearby Connections (défi LAN) · Hébergement Render.