Files
benevoles/backend
AdamThomasandClaude Sonnet 5 68d42ee303
ci-cd / build-backend (push) Successful in 1m13s
ci-cd / build-frontend (push) Successful in 24s
ci-cd / deploy (push) Successful in 21s
fix: réduit la concurrence uv pour le build Docker du backend
L'échec persistait malgré un timeout à 180s : le vrai problème est la bande
passante limitée du runner CI, saturée par les 50 téléchargements uv en
parallèle (défaut) — chaque paquet n'obtenait qu'une fraction du débit et
finissait par expirer (constaté sur sqlalchemy, après 180s). Réduit
UV_CONCURRENT_DOWNLOADS à 4 pour que chaque téléchargement avance
réellement, et remonte le délai à 600s par sécurité.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-29 20:52:56 +02:00
..
2026-09-09 22:19:58 +02:00
2026-09-09 22:19:58 +02:00

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 :

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

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.