Étape 21 : formulaire public d'inscription des bénévoles

Retire « constructeur de formulaire » des exclusions du CLAUDE.md (§ 5) —
décision explicite prise en conversation.

Un formulaire par édition (COORDINATION choisit les champs actifs parmi
neuf : email, téléphone, vœux de poste — max 2, vœux d'artiste — un par
soir de festival, vœu de compagnon en texte libre, disponibilité/
cotisation déclaratives, photo, commentaire ; nom/prénom toujours
collectés) ouvert/fermé à volonté, avec un lien à partager
(/inscription, aucun compte requis).

Backend : FormTemplate/FormField (migration 0013), quatre nouveaux champs
sur Volunteer (photo, companion_wish_note, self_declared_available,
willing_to_pay_fee), app/api/forms.py — les deux seuls endpoints publics
de toute l'API (GET .../form/public, POST .../form/public/submit),
protégés par hCaptcha (app/forms/captcha.py, désactivé sans
HCAPTCHA_SECRET_KEY) et un filet de sécurité global par édition
(form_submission_limiter). resolve_owned_ids/set_artists/
set_wished_positions déplacés vers app/api/_common.py, partagés avec
volunteers.py.

Frontend : écran de configuration (/inscriptions) avec lien copiable et
bascule ouvert/fermé, formulaire public (/inscription, hors RequireAuth)
avec widget hCaptcha chargé dynamiquement, capture photo native
(<input capture>), vœux de poste/artiste avec les mêmes règles que le
back-end. Réponses du formulaire visibles et éditables depuis la fiche
bénévole existante (ConfigVolunteers.tsx).

Vérifié : pytest (273 passés), ruff, alembic check, tsc --noEmit, eslint,
vite build, smoke (rendu SSR de chaque écran + flux de bout en bout du
formulaire en mode démonstration) — tous verts.

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

deploy/README.md

@@ -70,6 +70,7 @@ Variables (Paramètres → Actions → Variables) :
 | `SSH_USER`            | Utilisateur SSH                                                    |
 | `DEPLOY_PATH`         | Dossier du projet sur le VPS (ex. `/opt/benevoles`)               |
 | `VITE_EDITION_ID`     | UUID de l'édition de production — **à ajouter après** l'étape 3   |
+| `VITE_HCAPTCHA_SITE_KEY` | Clé de site hCaptcha (publique) — voir étape 1, formulaire public d'inscription. Optionnelle : vide ⇒ formulaire sans vérification anti-robot |
 
 La clé publique correspondant à `SSH_KEY` doit être dans le
 `~/.ssh/authorized_keys` de `SSH_USER` sur le VPS.
@@ -100,6 +101,13 @@ SMTP_PASSWORD=<mot de passe SMTP>
 SMTP_STARTTLS=true
 SMTP_SSL=false
 SMTP_FROM=Festival <no-reply@mon-domaine.fr>
+
+# Formulaire public d'inscription (/inscription). Vide ⇒ aucune vérification
+# anti-robot (déconseillé en public) — créer un compte gratuit sur
+# https://hcaptcha.com, puis renseigner ici le secret du couple site/secret
+# (la clé de site va, elle, dans la variable Gitea VITE_HCAPTCHA_SITE_KEY —
+# voir tableau ci-dessus — car figée au build du frontend, pas modifiable ici).
+HCAPTCHA_SECRET_KEY=
 EOF
 ```
 

deploy/docker-compose.prod.yml

@@ -2,9 +2,11 @@ name: benevoles
 
 # Déployé sur le VPS. Les variables sont lues depuis un fichier .env situé à
 # côté de ce fichier (non versionné) : POSTGRES_USER, POSTGRES_PASSWORD,
-# POSTGRES_DB, JWT_SECRET, PUBLIC_BASE_URL et les variables SMTP_* / EMAIL_ENABLED.
-# BACKEND_IMAGE / FRONTEND_IMAGE sont exportées par le pipeline de déploiement
-# (.gitea/workflows/ci-cd.yml).
+# POSTGRES_DB, JWT_SECRET, PUBLIC_BASE_URL, HCAPTCHA_SECRET_KEY et les
+# variables SMTP_* / EMAIL_ENABLED. BACKEND_IMAGE / FRONTEND_IMAGE sont
+# exportées par le pipeline de déploiement (.gitea/workflows/ci-cd.yml) —
+# VITE_HCAPTCHA_SITE_KEY, elle, est figée au build de l'image frontend (voir
+# ci-cd.yml et deploy/README.md), pas modifiable ici.
 #
 # Les deux services ne publient que sur `127.0.0.1` : c'est le Caddy du VPS
 # (hors de ce compose, voir deploy/README.md) qui reçoit le trafic public et
@@ -41,6 +43,7 @@ services:
       SMTP_STARTTLS: ${SMTP_STARTTLS:-true}
       SMTP_SSL: ${SMTP_SSL:-false}
       SMTP_FROM: ${SMTP_FROM:-}
+      HCAPTCHA_SECRET_KEY: ${HCAPTCHA_SECRET_KEY:-}
       TZ: Europe/Paris
     depends_on:
       db: