Étape 1 : squelette du projet

- Monorepo backend/ + frontend/ + deploy/
- Backend FastAPI/SQLModel/Alembic/uv qui démarre (health check, config,
  i18n, base de test PostgreSQL, pytest)
- docker-compose de développement (db + backend hot-reload)
- Chaîne CI/CD GitHub Actions : lint + tests, build image, push GHCR,
  déploiement SSH sur le VPS à chaque push main
- CLAUDE.md : vocabulaire du domaine, conventions, commandes

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017uUsRg7XzopkCPWimwg9ZM

README.md

@@ -0,0 +1,36 @@
+# 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)     |