AdamThomasandClaude Sonnet 5
d5f67b2701
Remplace la chaîne GitHub Actions (jamais réellement branchée : aucun remote git n'existait) par une chaîne GitLab CI/CD, et comble un manque qu'elle avait déjà : le frontend n'était jusqu'ici jamais construit ni déployé en production. - `.gitlab-ci.yml` : tests (backend + frontend) à chaque push ; sur `main`, build des images backend et frontend (registre de conteneurs GitLab) puis déploiement SSH sur le VPS (pull, migration Alembic, up -d). - `frontend/Dockerfile.prod` + `frontend/nginx.conf` : build Vite statique servi par nginx (repli SPA sur index.html). `VITE_API_MODE`/ `VITE_EDITION_ID` sont des variables de build, passées en `--build-arg` depuis la variable CI/CD `VITE_EDITION_ID`. - `deploy/docker-compose.prod.yml` : ajout du service `frontend` ; `backend` et `frontend` ne publient plus que sur `127.0.0.1` (Caddy, déjà installé sur le serveur, devient l'unique porte d'entrée publique). - `deploy/Caddyfile.benevoles` : bloc de vhost à ajouter au Caddy existant (`/api/*` vers le backend avec préfixe retiré, le reste vers le frontend). - `deploy/README.md` : runbook complet (remote GitLab, variables CI/CD, préparation du VPS, création de l'édition de production avant le premier build frontend, vhost Caddy). - CLAUDE.md et README.md mis à jour en conséquence. Vérifié : `docker compose -f deploy/docker-compose.prod.yml config`, build réel de l'image frontend de prod, / et une route SPA (/grille) répondent 200 via nginx. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017uUsRg7XzopkCPWimwg9ZM
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) |
|
|
| `.gitlab-ci.yml` | Chaîne CI/CD (tests → build → SSH sur le VPS) |
|