Files

T

AdamThomasandClaude Sonnet 5 b268e308ab É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

2026-09-10 08:08:55 +02:00

docker-compose.prod.yml

Étape 10 : envoi d'emails par SMTP

2026-09-10 08:08:55 +02:00

README.md

Étape 10 : envoi d'emails par SMTP

2026-09-10 08:08:55 +02:00

README.md

Déploiement

Le workflow .github/workflows/deploy.yml se déclenche sur chaque push sur main :

build de l'image backend ;
push sur ghcr.io/<owner>/<repo>-backend (tags latest et sha-<commit>) ;
copie de deploy/docker-compose.prod.yml sur le VPS par SSH ;
docker compose -f docker-compose.prod.yml pull && up -d.

Secrets GitHub Actions requis

Secret	Description
`SSH_HOST`	Hôte du VPS
`SSH_USER`	Utilisateur SSH
`SSH_KEY`	Clé privée SSH (format OpenSSH)
`DEPLOY_PATH`	Dossier du projet sur le VPS (ex. `/opt/benevoles`)
`GHCR_TOKEN`	PAT avec scope `read:packages`, pour que le VPS tire l'image

Préparation du VPS (une fois)

mkdir -p /opt/benevoles
cd /opt/benevoles
cat > .env <<'EOF'
POSTGRES_USER=benevoles
POSTGRES_PASSWORD=<mot de passe fort>
POSTGRES_DB=benevoles
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

Le workflow dépose docker-compose.prod.yml dans ce dossier et l'utilise tel quel.