Initial commit

docs/adr/018-service-emailing.md

@@ -0,0 +1,62 @@
+# ADR-018 : Service d'Emailing Transactionnel
+
+**Statut** : Accepté
+**Date** : 2026-01-26
+
+## Contexte
+
+RoadWave nécessite un service d'envoi d'emails transactionnels pour notifications utilisateurs, modération (strikes, suspensions), authentification (Zitadel), conformité RGPD et communications créateurs.
+
+**Volume estimé MVP** : 2000-5000 emails/mois.
+
+**Contraintes** : Souveraineté préférée (France/UE), RGPD natif, coût maîtrisé, API simple pour Go, capacité SMS future (post-MVP).
+
+## 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
+```
+
+## Estimation coûts
+
+| Phase | Utilisateurs | Emails/mois | Coût Brevo |
+|-------|--------------|-------------|------------|
+| MVP | 0-10K | ~5K/jour | **Gratuit** (< 300/jour) |
+| Growth | 10K-50K | ~10K/mois | Gratuit ou 19€/mois |
+| Scale | 50K-100K | ~100K/mois | 49€/mois |
+
+**SMS** (post-MVP) : ~0.04€/SMS France, soit ~400€/mois pour 10K inscriptions/mois.
+
+## Conséquences
+
+- Coût 0 en MVP (9000 emails/mois gratuits)
+- SMS intégré pour vérification anti-spam (post-MVP)
+- API REST simple, pas de SDK Go officiel
+- Limites quotidiennes strictes (300/jour en gratuit)
+- Migration possible vers Scaleway TEM si volume >100K emails/mois (coût optimisé)
+- Configuration DNS requise (SPF, DKIM, DMARC)