Files

jpgiannetti b6b926b233 docs: résoudre incohérences #13 et #14 (emails + K8s)

Résolution de 2 incohérences MODERATE (reste 1/9) :

#13 - Emails techniques uniquement (ADR-018)
- Périmètre strict : auth, sécurité, modération, RGPD uniquement
- Pas de notifications sociales/marketing/newsletters
- Projection coûts : 93 emails/jour en MVP → gratuit
- Condensé : 112 → 75 lignes

#14 - Kubernetes roadmap clarifiée (ADR-001, ADR-017)
- ADR-001 : K8s = bonus scalabilité future, pas raison principale
- Go choisi pour simplicité, écosystème, performance
- ADR-017 : Roadmap 3 phases avec triggers métriques
  - MVP (0-20K) : VPS + Docker Compose (~14€)
  - Croissance (20-100K) : Scaleway managé (~100€)
  - Scale (100K+) : Kubernetes (~500€)
- Condensé : 137 → 65 lignes

INCONSISTENCIES-ANALYSIS.md :
- 8/9 MODERATE traités (6 résolus, 1 annulé, 1 documenté)
- 1 MODERATE restant : #15 (Unlike Manuel)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

2026-02-01 12:19:13 +01:00

3.4 KiB

Raw Blame History

ADR-018 : 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)

3.4 KiB Raw Blame History