Files
benevoles/backend
AdamThomasandClaude Sonnet 5 579ea5d9db Badges : format dérivé de l'image importée, postes avec horaire et référent
- Le format du badge n'est plus fixé à CR80 : il est déduit des pixels de
  l'image du recto à l'import (résolution supposée 300 dpi,
  app/badges/pdf.py:image_size_mm), stocké sur BadgeTemplate (migration
  0012). L'éditeur (BadgesPage.tsx) et la génération PDF s'alignent sur ce
  format réel ; CR80 reste le repère par défaut tant qu'aucune image n'est
  importée. Le verso est ajusté sans déformation (preserveAspectRatio).

- Le champ « Postes affectés » liste désormais une ligne par créneau
  (triées chronologiquement) : nom du poste + horaire, et le référent du
  poste s'il y en a un et que ce n'est pas le bénévole badgé lui-même.
  Texte multi-lignes pris en charge par la génération PDF (découpe sur
  `\n`, hauteur de ligne calculée en mm) et par l'aperçu de l'éditeur.

- Corrige au passage un bug d'unités dans le positionnement vertical du
  texte (police en points confondue avec des millimètres).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-20 20:35:11 +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.