- 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
49 lines
1.7 KiB
Markdown
49 lines
1.7 KiB
Markdown
# Déploiement
|
|
|
|
Le workflow [`.github/workflows/deploy.yml`](../.github/workflows/deploy.yml)
|
|
se déclenche sur **chaque push sur `main`** :
|
|
|
|
1. build de l'image `backend` ;
|
|
2. push sur `ghcr.io/<owner>/<repo>-backend` (tags `latest` et `sha-<commit>`) ;
|
|
3. copie de `deploy/docker-compose.prod.yml` sur le VPS par SSH ;
|
|
4. `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)
|
|
|
|
```bash
|
|
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.
|