# Gestion des bénévoles

Application web de gestion des bénévoles pour un festival associatif.
Backend FastAPI + PostgreSQL, frontend React (à venir), déploiement Docker
Compose auto-hébergé.

Voir [`CLAUDE.md`](./CLAUDE.md) pour le vocabulaire du domaine, l'arborescence
et les conventions.

## Démarrage rapide

```bash
cp .env.example .env
docker compose up --build
```

- API : http://localhost:8000
- Documentation interactive : http://localhost:8000/docs

## Tests

```bash
docker compose run --rm backend uv run pytest
```

La base de test (`benevoles_test`) est créée automatiquement au premier
démarrage du conteneur PostgreSQL.

## Structure

| Dossier      | Rôle                                             |
|--------------|-------------------------------------------------|
| `backend/`   | API FastAPI, modèle SQLModel, migrations Alembic |
| `frontend/`  | Interface React + Vite + TS + Tailwind (étape ultérieure) |
| `deploy/`    | Configuration de déploiement production          |
| `.github/`   | Chaîne CI/CD (build → GHCR → SSH sur le VPS)     |