Files

jpgiannetti 35aaa105d0 docs: améliorer rendu markdown et navigation mkdocs

- Ajouter ADR-018 (librairies Go) dans TECHNICAL.md
- Transformer Shared en menu dépliable dans mkdocs (cohérence avec autres domaines)
- Corriger listes markdown (ajout lignes vides avant listes)
- Corriger line breaks dans génération BDD (étapes "Et" sur nouvelles lignes)
- Ajouter script fix-markdown-lists.sh pour corrections futures

Impacte 86 fichiers de documentation et 164 fichiers BDD générés.

2026-02-09 20:49:52 +01:00

3.4 KiB

Raw Blame History

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)

3.4 KiB Raw Blame History