AdamThomasandClaude Sonnet 5
09d7d70076
- Monorepo backend/ + frontend/ + deploy/ - Backend FastAPI/SQLModel/Alembic/uv qui démarre (health check, config, i18n, base de test PostgreSQL, pytest) - docker-compose de développement (db + backend hot-reload) - Chaîne CI/CD GitHub Actions : lint + tests, build image, push GHCR, déploiement SSH sur le VPS à chaque push main - CLAUDE.md : vocabulaire du domaine, conventions, commandes Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017uUsRg7XzopkCPWimwg9ZM
37 lines
1.1 KiB
Markdown
37 lines
1.1 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
|
|
```
|
|
|
|
- API : http://localhost:8000
|
|
- Documentation interactive : http://localhost:8000/docs
|
|
|
|
## 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 (étape ultérieure) |
|
|
| `deploy/` | Configuration de déploiement production |
|
|
| `.github/` | Chaîne CI/CD (build → GHCR → SSH sur le VPS) |
|