Étape 10 : envoi d'emails par SMTP

- app/email/ : sender (smtplib, STARTTLS ou SSL, connexion réutilisée pour un
  lot) + templates (rendu, textes dans locales/fr.json). EMAIL_ENABLED=false
  (défaut) ⇒ journalisé seulement, sans destinataire ni corps (RGPD).
- Lien magique : POST .../auth/magic-link envoie désormais l'email
  (PUBLIC_BASE_URL + magic_link_path + ?token=). Helper app/auth/magic_link.py
  partagé. Sans SMTP, le jeton non nominatif reste journalisé pour le dev.
- Récapitulatif de planning : POST /editions/{id}/notifications/planning
  (COORDINATION). subject/body sont des modèles ({prenom}, {nom}, {nb_creneaux},
  {nb_heures}, {creneaux}, {lien_connexion} → lien magique personnel émis).
  Cible tous les bénévoles avec email ou une liste. Envoi en BackgroundTasks.
- Config : PUBLIC_BASE_URL, EMAIL_ENABLED, SMTP_* ; .env.example,
  docker-compose (dev + prod), deploy/README.
- 9 tests (sender activé/désactivé, rendu, notifications : contenu, gabarit par
  défaut, lien magique embarqué, sous-ensemble, réservé COORDINATION).
  137 tests au total ; ruff + alembic check verts.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017uUsRg7XzopkCPWimwg9ZM

deploy/README.md

@@ -27,7 +27,20 @@ cat > .env <<'EOF'
 POSTGRES_USER=benevoles
 POSTGRES_PASSWORD=<mot de passe fort>
 POSTGRES_DB=benevoles
-JWT_SECRET=<secret fort>
+JWT_SECRET=<secret fort ; openssl rand -hex 32>
+PUBLIC_BASE_URL=https://benevoles.mon-festival.fr
+
+# Emails (récapitulatifs de planning + liens de connexion). Laisser
+# EMAIL_ENABLED=false tant que le SMTP n'est pas prêt : les emails sont alors
+# seulement journalisés.
+EMAIL_ENABLED=true
+SMTP_HOST=smtp.mon-festival.fr
+SMTP_PORT=587
+SMTP_USER=no-reply@mon-festival.fr
+SMTP_PASSWORD=<mot de passe SMTP>
+SMTP_STARTTLS=true
+SMTP_SSL=false
+SMTP_FROM=Festival <no-reply@mon-festival.fr>
 EOF
 ```
 

deploy/docker-compose.prod.yml

@@ -2,7 +2,8 @@ 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. BACKEND_IMAGE est exporté par le workflow de déploiement.
+# POSTGRES_DB, JWT_SECRET, PUBLIC_BASE_URL et les variables SMTP_* / EMAIL_ENABLED.
+# BACKEND_IMAGE est exporté par le workflow de déploiement.
 
 services:
   db:
@@ -26,6 +27,15 @@ services:
       DATABASE_URL: postgresql+psycopg://${POSTGRES_USER}:${POSTGRES_PASSWORD}@db:5432/${POSTGRES_DB}
       ENVIRONMENT: production
       JWT_SECRET: ${JWT_SECRET}
+      PUBLIC_BASE_URL: ${PUBLIC_BASE_URL}
+      EMAIL_ENABLED: ${EMAIL_ENABLED:-false}
+      SMTP_HOST: ${SMTP_HOST:-}
+      SMTP_PORT: ${SMTP_PORT:-587}
+      SMTP_USER: ${SMTP_USER:-}
+      SMTP_PASSWORD: ${SMTP_PASSWORD:-}
+      SMTP_STARTTLS: ${SMTP_STARTTLS:-true}
+      SMTP_SSL: ${SMTP_SSL:-false}
+      SMTP_FROM: ${SMTP_FROM:-}
       TZ: Europe/Paris
     depends_on:
       db: