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
1.8 KiB
1.8 KiB
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 pour le vocabulaire du domaine, l'arborescence
et les conventions.
Démarrage rapide
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 downarrête tout ·make logssuit 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 :
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
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) |