AdamThomasandClaude Sonnet 5
bb919554ff
- Fichier unique, processus en deux temps : POST /editions/{id}/import/analyze
(colonnes détectées, aperçu, mapping suggéré, demi-journées de l'édition)
puis POST /editions/{id}/import/execute (mapping validé)
- Parser CSV (délimiteur et encodage devinés, BOM) et XLSX (openpyxl),
détection XLSX par nombre magique
- Vocabulaire des valeurs de disponibilité (tri-état, accents/casse) et des
tailles de t-shirt ; compétences créées à la volée dans le référentiel
- Rapport ligne par ligne : codes de traduction + paramètres, jamais de
phrase. Doublons : upsert sur email, signalement sur (nom, prénom) sans
email, doublons intra-fichier. Mode simulation (rollback, rien de persisté)
- 40 tests : parser, valeurs, service (tous les cas), endpoints
- Dépendances : python-multipart, openpyxl
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017uUsRg7XzopkCPWimwg9ZM
40 lines
1.6 KiB
Markdown
40 lines
1.6 KiB
Markdown
# Backend — API de gestion des bénévoles
|
|
|
|
FastAPI · SQLModel · PostgreSQL · Alembic. Dépendances gérées par `uv`.
|
|
|
|
## Développement
|
|
|
|
Toujours via Docker Compose depuis la racine du dépôt :
|
|
|
|
```bash
|
|
docker compose up --build # démarre db + backend (reload actif)
|
|
docker compose run --rm backend uv run pytest
|
|
docker compose run --rm backend uv run ruff check .
|
|
```
|
|
|
|
## Migrations
|
|
|
|
```bash
|
|
docker compose run --rm backend uv run alembic revision --autogenerate -m "..."
|
|
docker compose run --rm backend uv run alembic upgrade head
|
|
```
|
|
|
|
## Structure
|
|
|
|
| Chemin | Rôle |
|
|
|---------------------|--------------------------------------------------------|
|
|
| `app/main.py` | Instance FastAPI, middlewares, routers |
|
|
| `app/config.py` | Configuration (variables d'environnement) |
|
|
| `app/db.py` | Engine SQLAlchemy + dépendance de session |
|
|
| `app/api/` | Routers HTTP |
|
|
| `app/models/` | Tables SQLModel du domaine |
|
|
| `app/validation/` | Moteur de règles d'affectation (cœur du produit) |
|
|
| `app/i18n/` | `t(key)` + `locales/fr.json` — aucun texte en dur ailleurs |
|
|
| `app/migrations/` | Alembic |
|
|
| `tests/` | pytest, base de test PostgreSQL réelle |
|
|
|
|
## Note
|
|
|
|
`uv.lock` est versionné (généré dans le conteneur). Le régénérer après toute
|
|
modification des dépendances : `docker compose run --rm backend uv lock`.
|