Emergency system Gabon
# HEC Emergency Fund
Digital approval pipeline for human–elephant conflict (HEC) compensation claims in Gabon.
- **Backend**: Django 5 + DRF + SimpleJWT + django-otp + Celery + Redis
- **Frontend**: React 18 + TypeScript + Vite + Redux Toolkit + RTK Query + Tailwind + shadcn/ui
- **Database**: PostgreSQL 16 (prod) / SQLite (dev)
- **Object store**: S3-compatible (MinIO local · Wasabi prod)
- **Locales**: `en`, `fr` (bilingual, default `fr`)
- **Currency**: XAF (FCFA)
- **Style**: WildCover-inspired — dark dense dashboard, olive/orange earth palette, soft chip variant, dashed dividers, frosted header
See `hec-master.md` for the full specification.
## Quick start (Docker)
```bash
cp .env.example .env # fill in DB_PASSWORD, SECRET_KEY, etc.
docker compose up --build # backend, db, redis, celery, nginx-front
```
The backend exposes ` ` the frontend ` ` (nginx).
## Quick start (local dev)
```bash
cd backend
python -m venv .venv
.venv/Scripts/python -m pip install -r requirements.txt
.venv/Scripts/python manage.py migrate
.venv/Scripts/python manage.py seed_demo_data
.venv/Scripts/python manage.py runserver 0.0.0.0:8000
cd ../frontend
npm install
npx vite --port 3001
```
See `docs/process_flow.md` for the Mermaid diagram, `docs/user_and_claims_journey.md` for the API flows, and `docs/production_database.md` for the production setup.
---
## Case types
| Code | Label (en / fr) | Default ceiling (XAF) | SLA | First-aid eligible |
| --- | --- | --- | --- | --- |
| `MEDICAL` | Medical (injury) / Médical (blessure) | 2,000,000 | 48 h | yes (urgent) |
| `BURIAL` | Burial (death) / Funéraire (décès) | 3,000,000 | 72 h | no |
| `CROP_DAMAGE` | Crop damage / Dégâts aux cultures | 400,000 | 7 d | no |
CROP_DAMAGE covers elephant raids on subsistence fields (cassava, plantain, maize,
groundnut, cocoyam). The CB must attach a photo of the damage and report the
estimated area and loss (capped at the 400 000 XAF ceiling).
---
## FormDefinitions — why they exist
` …