T

AdamThomasandClaude Sonnet 5 6c4297b5fc Ajout de python -m app.bootstrap : instance vierge sans jeu de démo

Crée une édition + le premier compte coordination (mot de passe) + 3 créneaux
types par défaut, et affiche l'UUID à mettre dans VITE_EDITION_ID. Documenté
dans README (« Vraie instance, sans jeu de démo »).

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

2026-09-10 21:05:14 +02:00

.github/workflows

Étape 1 : squelette du projet

2026-09-09 22:19:58 +02:00

backend

Ajout de python -m app.bootstrap : instance vierge sans jeu de démo

2026-09-10 21:05:14 +02:00

deploy

Étape 10 : envoi d'emails par SMTP

2026-09-10 08:08:55 +02:00

docker/postgres-init

Étape 1 : squelette du projet

2026-09-09 22:19:58 +02:00

frontend

Config : retrait du bouton ad hoc « ajouter un créneau »

2026-09-10 21:02:21 +02:00

.env.example

Emails : robustesse SMTP + diagnostic

2026-09-10 19:31:02 +02:00

.gitignore

Étape 3 : import CSV/Excel des bénévoles et disponibilités

2026-09-09 22:37:30 +02:00

CLAUDE.md

Ajout de python -m app.bootstrap : instance vierge sans jeu de démo

2026-09-10 21:05:14 +02:00

docker-compose.yml

Étape 10 : envoi d'emails par SMTP

2026-09-10 08:08:55 +02:00

README.md

Ajout de python -m app.bootstrap : instance vierge sans jeu de démo

2026-09-10 21:05:14 +02:00

README.md

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

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).

Vraie instance, sans jeu de démo

docker compose up -d db backend
docker compose run --rm backend uv run alembic upgrade head
docker compose run --rm backend uv run python -m app.bootstrap \
  --name "Festival 2026" --start 2026-07-01 --end 2026-07-04 \
  --email coordination@monfestival.fr --password "un-mot-de-passe-solide"

La commande crée une édition vierge, le premier compte coordination (connexion par mot de passe) et 3 créneaux types par défaut, puis affiche l'UUID de l'édition. Renseigner alors dans .env :

VITE_API_MODE=http
VITE_EDITION_ID=<uuid affiché>

puis docker compose up frontend.

Jeu de démonstration (optionnel)

docker compose run --rm backend uv run python -m app.seed

120 bénévoles fictifs, 15 postes, 4 jours. Identifiants affichés en fin de commande.

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
`.github/`	Chaîne CI/CD (build → GHCR → SSH sur le VPS)