AdamThomasandClaude Sonnet 5
66746b80e4
- Nouveau service `frontend` (build ./frontend, Vite --host sur 5173, bind mount + volume nommé frontend_node_modules, depends_on backend). - VITE_API_MODE=mock par défaut (aucun backend requis) ; VITE_API_TARGET pointe sur le service backend pour le mode http. - .env.example : VITE_API_MODE / VITE_EDITION_ID. - frontend/.dockerignore ; README : URL http://localhost:5173. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01AwswqSChc3Rwtu61pRXiY2
42 lines
1.3 KiB
Markdown
42 lines
1.3 KiB
Markdown
# 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
|
|
```
|
|
|
|
- Frontend : http://localhost:5173
|
|
- API : http://localhost:8000
|
|
- Documentation interactive : http://localhost:8000/docs
|
|
|
|
Le frontend démarre en mode `mock` (jeu de démonstration en mémoire, aucun
|
|
backend requis). Pour le brancher sur l'API réelle : `VITE_API_MODE=http` et
|
|
`VITE_EDITION_ID=<uuid>` dans `.env` (voir `frontend/README.md`).
|
|
|
|
## 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 (service `frontend`) |
|
|
| `deploy/` | Configuration de déploiement production |
|
|
| `.github/` | Chaîne CI/CD (build → GHCR → SSH sur le VPS) |
|