Étape 20 : planches de badges bénévoles (PDF)

Recto personnalisable (fond image + champs positionnés : nom, poste(s)
affectés, catégorie, rôle) via un éditeur visuel glisser-déposer ; verso
fixe, la même image pour tous les bénévoles. Nouvel écran « Badges »
(COORDINATION uniquement, /badges).

Backend : modèle BadgeTemplate/BadgeField (migration 0011), génération
PDF isolée (app/badges/pdf.py, ReportLab — planches recto suivies des
planches verso correspondantes pour une impression recto-verso), route
POST /editions/{id}/badges/generate, tests (module pur + API).

Frontend : client HTTP (upload multipart, réponses binaires images/PDF),
client mock (mode démonstration), éditeur de positionnement en
millimètres (coordonnées partagées avec le backend), écran de génération
avec sélection des bénévoles et téléchargement.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

CLAUDE.md

@@ -134,6 +134,25 @@ les tables sauf les tables d'association.
   `volunteer_id` (nullable, unique).
 - **`MagicLinkToken`** : `account_id`, `token_hash` (unique), `expires_at`,
   `used_at`.
+- **`BadgeTemplate`** : recto/verso d'une édition (une ligne, créée à la
+  demande). `front_image`/`front_image_content_type` (fond du recto),
+  `back_image`/`back_image_content_type` (verso — **le même pour tous les
+  bénévoles**). Images stockées en base (`LargeBinary`), pas de volume de
+  fichiers à gérer.
+- **`BadgeField`** : un champ positionné sur le recto (`field_type` ∈
+  `FULL_NAME` / `POSITIONS` / `CATEGORY` / `ROLE`, au plus un par édition —
+  `PUT .../badges/template/fields` remplace tout), coordonnées `x_mm`/`y_mm`/
+  `width_mm`/`height_mm` en millimètres depuis le coin haut-gauche du badge
+  (format CR80, 85,6 × 54 mm), `font_size`, `align`, `bold`, `color`. Édité
+  visuellement (glisser-déposer) depuis l'écran « Badges » du front-end
+  (`frontend/src/pages/BadgesPage.tsx`), qui envoie ces mêmes millimètres.
+  `POSITIONS`/`CATEGORY` résolus depuis les affectations décidées du
+  bénévole, `ROLE` depuis son `Account.role` (`LEAD` ⇒ « Référent »).
+  `POST /editions/{id}/badges/generate` (COORDINATION, `{volunteer_ids?}` —
+  absent = tous) génère la planche PDF (`app/badges/pdf.py`, OR-Tools n'y est
+  pour rien : juste ReportLab) : pages recto personnalisées suivies, planche
+  par planche, de la page de verso correspondante (même image répétée à
+  chaque emplacement) — impression recto-verso classique.
 
 Conventions techniques :
 
@@ -170,6 +189,7 @@ Matrice appliquée par les endpoints :
 | `artists` lecture / écriture | ✔ / ✔ | ✔ / — | ✔ / — |
 | `availability` lecture / écriture | ✔ / ✔ | ✔ / — | la sienne / — |
 | `matrix`, `import`, `accounts` | ✔ / ✔ / ✔ | ✔ / — / — | — |
+| `badges` (config + génération) | ✔ | — | — |
 
 **Authentification — deux systèmes selon le compte**, une même session JWT
 HS256 (`Authorization: Bearer <jwt>`, TTL `session_ttl_hours`) à l'arrivée.
@@ -424,6 +444,7 @@ fonctions d'IA. *(L'envoi d'emails par SMTP est en place — voir § 2.)*
 │   │   ├── models/                 # tables SQLModel
 │   │   ├── validation/             # moteur pur (models, engine) + loader (base)
 │   │   ├── solver/                 # suggestions OR-Tools (models, engine, loader)
+│   │   ├── badges/                 # génération PDF des planches (pdf.py, ReportLab)
 │   │   ├── bootstrap.py            # instance vierge : édition + 1er compte
 │   │   ├── seed.py                 # jeu de démonstration (python -m app.seed)
 │   │   ├── i18n/
@@ -530,6 +551,7 @@ Aucune dépendance locale requise hors Docker.
 | 17    | Vœu de compagnon (`VolunteerCompanionWish`, 0 à N, à sens unique) : fiche bénévole, pris en compte par le solveur (bonus) et le classement par défaut | à valider |
 | 18    | Gestion des référents depuis la fiche bénévole : `PATCH /accounts` (rôle LEAD ↔ VOLUNTEER), `lead_account_id` vérifié (doit être un compte référent de l'édition) | à valider |
 | 19    | Revue de sécurité avant ouverture au public : refus de démarrer en production avec un `JWT_SECRET` par défaut/vide/court, avertissement si `EMAIL_ENABLED=false` en production, en-têtes de sécurité (nginx + Caddy), pas de jeton dans les logs d'accès du frontend, limiteur de tentatives sur `/auth/login` et `/auth/magic-link` | à valider |
+| 20    | Planches de badges bénévoles (PDF) : recto personnalisable (fond + champs nom/poste(s)/catégorie/rôle, éditeur glisser-déposer), verso fixe (même image pour tous), écran « Badges » dédié (`/badges`, COORDINATION) | à valider |
 
 **Reste hors périmètre** (modèle prêt à les accueillir) : SMS, constructeur
 de formulaire, pointage sur site, IA. Frontend : squelette + 6 écrans +