# ADR-016 : Service d'Emailing Transactionnel

**Statut** : Accepté
**Date** : 2026-01-26

## Contexte

RoadWave nécessite un service d'envoi d'emails **techniques uniquement** (pas de notifications sociales, alertes marketing, promotions).

**Périmètre strict** :
- ✅ **Authentification** : Vérification email (inscription), réinitialisation mot de passe, changement email
- ✅ **Sécurité** : Alertes connexion inhabituelle, changement password
- ✅ **Modération** : Strikes, suspensions, bannissements
- ✅ **RGPD** : Confirmation suppression compte, export données
- ❌ **Pas de notifications sociales** (écoutes, likes, commentaires, nouveaux abonnés)
- ❌ **Pas d'alertes marketing** (nouvelles sorties, recommandations personnalisées)
- ❌ **Pas de newsletters/promotions**

**Justification** : Gérer un service d'emailing complet (notifications, newsletters, segmentation) est un produit à part entière (délivrabilité, spam, désabonnements, conformité). RoadWave se concentre sur le strict minimum technique pour réduire la complexité et les coûts.

**Volume estimé MVP** : 2800-3500 emails/mois (~93-116 emails/jour en régime stable).

**Contraintes** : Souveraineté préférée (France/UE), RGPD natif, coût maîtrisé, API simple pour Go.

## Décision

**Brevo (ex-Sendinblue)** comme service d'emailing transactionnel et SMS.

## Alternatives considérées

| Service | Localisation | Prix gratuit | Prix 100K emails/mois | SMS disponible |
|---------|--------------|--------------|----------------------|----------------|
| **Brevo** | 🇫🇷 France | 300 emails/jour (~9K/mois) | ~49€ | ✅ Oui |
| Scaleway TEM | 🇫🇷 France | 300 emails/mois | ~25€ | ❌ Non |
| Mailjet | 🇫🇷 France | 200 emails/jour (~6K/mois) | ~50-100€ | ❌ Non |
| Postal | 🏠 Self-hosted | Illimité (coût VPS) | ~20-50€ | ❌ Non |

## Justification

- **Plan gratuit généreux** : 300 emails/jour (9000/mois) vs 300/mois chez Scaleway → coût 0 en MVP
- **SMS natif** : Vérification anti-spam post-MVP (emails temporaires)
- **Souverain français** : Hébergé France/UE, RGPD natif
- **CRM intégré** : Gestion contacts, segmentation pour newsletters futures
- **Simplicité** : API REST standard, SDK disponibles, documentation complète

## Architecture

```
Backend Go → Brevo API REST → Utilisateurs
              ├── Emails transactionnels
              ├── Templates HTML
              ├── Webhooks (bounces, opens)
              └── [Post-MVP] SMS
```

## Projection de coûts

| Phase | Users | Emails/jour | Coût Brevo |
|-------|-------|-------------|------------|
| **MVP** | 0-10K | ~93/jour | **Gratuit** ✅ (< 300/jour) |
| **Growth** | 10K-50K | ~467/jour | 19€/mois (Lite) |
| **Scale** | 50K-100K | ~933/jour | 49€/mois (Business) |

**Calcul** : ~0.28 emails/user/mois (vérification, reset password, sécurité, modération)

**Gestion pics** : Rate limiting 250 emails/h, Redis queue, upgrade temporaire si > 300/jour sur 3+ jours

## Conséquences

- Coût MVP : 0€ (93 emails/jour << 300/jour gratuit)
- Rate limiting requis en cas de pic inscription (> 300/jour)
- Configuration DNS (SPF, DKIM, DMARC) pour délivrabilité
- Wrapper Go custom (pas de SDK officiel)
- **Aucun email** pour interactions sociales (à communiquer dans UX)
- **Aucun email** pour paiements créateurs (Mangopay gère, dashboard in-app suffit)
