52 lines
1.8 KiB
Markdown
52 lines
1.8 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
|
|
make demo # base + backend + frontend, jeu de démonstration chargé
|
|
make blank # idem, mais édition vierge + 1er compte coordination
|
|
```
|
|
|
|
- Frontend : http://localhost:5173
|
|
- API : http://localhost:8000 · Docs : http://localhost:8000/docs
|
|
- `make down` arrête tout · `make logs` suit les logs du backend
|
|
|
|
Chaque commande construit les images, applique les migrations, prépare les
|
|
données, bascule le frontend sur l'API réelle (`.env`) et affiche les
|
|
identifiants de connexion.
|
|
|
|
**`make blank`** accepte des paramètres :
|
|
|
|
```bash
|
|
make blank EMAIL=moi@festival.fr PASSWORD=mon-mot-de-passe-solide \
|
|
NAME="Festival 2026" START=2026-07-01 END=2026-07-04
|
|
```
|
|
|
|
Le jeu de démo : 120 bénévoles fictifs, 15 postes, 4 jours. L'édition vierge :
|
|
une édition + un compte coordination (mot de passe) + 3 créneaux types.
|
|
|
|
## 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 (compose, Caddy, runbook) |
|
|
| `.gitea/workflows/` | Chaîne CI/CD (tests → build → SSH sur le VPS) |
|