Files
AdamThomasandClaude Sonnet 5 82088f3b0c É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>
2026-09-21 20:24:32 +02:00

90 lines
3.4 KiB
Python

from functools import lru_cache
from pydantic import model_validator
from pydantic_settings import BaseSettings, SettingsConfigDict
# Valeur de développement uniquement (versionnée dans `.env.example`) : un
# secret connu de quiconque lit le dépôt ne protège plus rien. Voir le
# contrôle dans `Settings.check_production_secrets`.
_DEV_JWT_SECRET = "dev-insecure-secret-change-me-please-32b"
_MIN_JWT_SECRET_LENGTH = 32
class Settings(BaseSettings):
"""Configuration applicative, alimentée par l'environnement."""
model_config = SettingsConfigDict(
env_file=".env", env_file_encoding="utf-8", extra="ignore"
)
environment: str = "development"
database_url: str = (
"postgresql+psycopg://benevoles:benevoles@localhost:5432/benevoles"
)
test_database_url: str = (
"postgresql+psycopg://benevoles:benevoles@localhost:5432/benevoles_test"
)
# Authentification (lien magique + session JWT). Secret >= 32 octets.
jwt_secret: str = _DEV_JWT_SECRET
magic_link_ttl_minutes: int = 30
session_ttl_hours: int = 12
# URL publique du frontend, pour construire les liens des emails.
public_base_url: str = "http://localhost:5173"
magic_link_path: str = "/connexion"
# Envoi d'emails (SMTP). Ne jamais mettre de vraies valeurs ici : elles
# vivent dans .env (non versionné) ou l'environnement.
# email_enabled=False ⇒ les envois sont seulement journalisés (dev, tests).
email_enabled: bool = False
smtp_host: str = "localhost"
smtp_port: int = 587
smtp_user: str = ""
smtp_password: str = ""
smtp_starttls: bool = True
smtp_ssl: bool = False
# Beaucoup de fournisseurs (OVH…) exigent une From = boîte authentifiée
# (ou un alias validé). En cas de rejet, mettre SMTP_FROM = SMTP_USER.
smtp_from: str = "Festival des bénévoles <no-reply@example.test>"
# Formulaire public d'inscription (`app/api/forms.py`). Secret hCaptcha
# seulement (la clé de site est publique, elle vit côté front-end en
# VITE_HCAPTCHA_SITE_KEY, figée au build). None ⇒ vérification
# désactivée (dev/tests uniquement, voir `app/forms/captcha.py`).
hcaptcha_secret_key: str | None = None
log_level: str = "INFO"
cors_origins: list[str] = ["http://localhost:5173"]
@property
def is_production(self) -> bool:
return self.environment == "production"
@model_validator(mode="after")
def check_production_secrets(self) -> "Settings":
"""Un secret JWT par défaut, vide ou trop court n'importe pas en dev
(confort), mais en production il permettrait de forger un jeton pour
n'importe quel compte (y compris COORDINATION) — donc de fabriquer
soi-même un jeton valide sans jamais s'authentifier. On refuse de
démarrer plutôt que de tourner silencieusement sans protection."""
if not self.is_production:
return self
if (
not self.jwt_secret
or self.jwt_secret == _DEV_JWT_SECRET
or len(self.jwt_secret) < _MIN_JWT_SECRET_LENGTH
):
raise ValueError(
"JWT_SECRET manquant, par défaut ou trop court (>= "
f"{_MIN_JWT_SECRET_LENGTH} caractères) en production. "
"Générer une vraie valeur : openssl rand -hex 32"
)
return self
@lru_cache
def get_settings() -> Settings:
return Settings()