Thanks for joining.
", ) ``` ### Envoi d'email avec template ```go // Préparer les données du template templateData := map[string]interface{}{ "Username": "john_doe", "ResetURL": "http://localhost:5173/reset-password?token=abc123", } // Enqueue le job jobWorker.EnqueueEmailJobWithTemplate( "user@example.com", "Reset your Veza password", "password_reset", // Nom du template (sans .html) templateData, ) ``` ### Depuis AuthService (exemple : Password Reset) Le `AuthService` utilise automatiquement le Job Worker pour envoyer les emails de reset : ```go // Dans internal/core/auth/service.go s.jobWorker.EnqueueEmailJobWithTemplate( user.Email, "Reset your Veza password", "password_reset", templateData, ) ``` ## 📝 Templates Email ### Structure des templates Les templates sont des fichiers HTML dans `templates/email/` avec l'extension `.html`. **Exemple : `templates/email/password_reset.html`** ```htmlHello {{.Username}},
Click here to reset: Reset Password
``` ### Variables disponibles Les variables sont passées via `templateData` dans `EnqueueEmailJobWithTemplate`. **Template `password_reset.html`** : - `{{.Username}}` - Nom d'utilisateur - `{{.ResetURL}}` - URL de reset avec token **Template `welcome.html`** : - `{{.Username}}` - Nom d'utilisateur - `{{.VerifyURL}}` - URL de vérification email ## 🧪 Tests ### Tests unitaires ```bash # Tests du module email go test ./internal/email/... -v # Tests du job worker go test ./internal/workers/... -v ``` ### Tests d'intégration avec MailHog 1. **Démarrer MailHog** (en développement) : ```bash # Via Docker docker run -d -p 1025:1025 -p 8025:8025 mailhog/mailhog # Ou installer MailHog localement # https://github.com/mailhog/MailHog ``` 2. **Configurer les variables d'environnement** : ```bash MAILHOG_HOST=localhost MAILHOG_PORT=1025 ``` 3. **Démarrer le backend** : ```bash cd veza-backend-api go run cmd/api/main.go ``` 4. **Vérifier les emails dans MailHog** : Ouvrir http://localhost:8025 dans votre navigateur pour voir les emails reçus. ### Test manuel : Envoyer un email de reset ```bash # Via curl curl -X POST http://localhost:8080/api/v1/auth/password/reset-request \ -H "Content-Type: application/json" \ -d '{"email": "test@example.com"}' ``` Vérifier dans MailHog que l'email a été reçu. ## 🔧 Configuration avancée ### Paramètres du Job Worker Le Job Worker est configuré dans `internal/config/config.go` : ```go config.JobWorker = workers.NewJobWorker( config.Database.GormDB, jobService, logger, 100, // queueSize - Taille de la queue 3, // workers - Nombre de workers parallèles 3, // maxRetries - Nombre maximum de tentatives config.EmailSender, ) ``` ### Variables d'environnement | Variable | Description | Défaut | Requis | |----------|-------------|--------|--------| | `SMTP_HOST` | Serveur SMTP | `localhost` (dev) | Production: Oui | | `SMTP_PORT` | Port SMTP | `1025` (dev) | Production: Oui | | `SMTP_USERNAME` | Utilisateur SMTP | - | Production: Oui | | `SMTP_PASSWORD` | Mot de passe SMTP | - | Production: Oui | | `SMTP_FROM` | Email expéditeur | - | Production: Oui | | `SMTP_FROM_NAME` | Nom expéditeur | - | Non | | `EMAIL_TEMPLATE_DIR` | Répertoire des templates | `templates/email` | Non | | `FRONTEND_URL` | URL du frontend (pour liens) | `http://localhost:5173` | Non | ## 📊 Monitoring ### Statistiques du worker ```go stats := jobWorker.GetStats() // Retourne: // - queue_size: Nombre de jobs en attente // - workers: Nombre de workers actifs // - max_retries: Nombre maximum de retries ``` ### Logs Le système log toutes les opérations importantes : - **Enqueue** : `Job enqueued` (DEBUG) - **Processing** : `Processing job` (INFO) - **Success** : `Job executed successfully` (INFO) - **Error** : `Job execution failed` (ERROR) - **Retry** : `Retrying job` (INFO) - **Final failure** : `Job permanently failed` (ERROR) ## 🐛 Dépannage ### Emails non envoyés 1. **Vérifier la configuration SMTP** : ```bash echo $SMTP_HOST echo $SMTP_PORT ``` 2. **Vérifier les logs** : - Chercher `Job execution failed` dans les logs - Vérifier les erreurs SMTP 3. **Tester la connexion SMTP** : ```bash telnet $SMTP_HOST $SMTP_PORT ``` ### Template non trouvé 1. **Vérifier le chemin** : ```bash ls -la templates/email/ ``` 2. **Vérifier la variable d'environnement** : ```bash echo $EMAIL_TEMPLATE_DIR ``` 3. **Vérifier les logs** : - Chercher `Failed to read template file` dans les logs ### Queue pleine Si la queue est pleine, les nouveaux jobs sont rejetés avec un warning : ``` Job queue full, dropping job ``` **Solution** : Augmenter la taille de la queue dans `config.go` : ```go workers.NewJobWorker(..., 200, ...) // Augmenter queueSize ``` ## 🔐 Sécurité 1. **Secrets SMTP** : Ne jamais commiter les credentials SMTP dans le code 2. **Validation email** : Les emails sont validés avant envoi 3. **Rate limiting** : Le système de rate limiting s'applique aussi aux endpoints qui envoient des emails 4. **Logs** : Les emails ne sont jamais loggés en clair (seulement les métadonnées) ## 🚀 Production ### Checklist avant déploiement - [ ] Variables SMTP configurées et testées - [ ] Templates email créés et testés - [ ] MailHog désactivé (pas de fallback en prod) - [ ] Monitoring configuré (logs, métriques) - [ ] Tests d'intégration passés - [ ] Documentation à jour ### Recommandations 1. **Utiliser un service SMTP professionnel** : - SendGrid - Mailgun - AWS SES - Postmark 2. **Monitoring** : - Surveiller la taille de la queue - Alerter sur les échecs répétés - Tracer les temps d'envoi 3. **Scalabilité** : - Augmenter le nombre de workers si nécessaire - Considérer une queue persistante (Redis, RabbitMQ) pour haute charge ## 📚 Références - [Go SMTP Package](https://pkg.go.dev/net/smtp) - [Go Templates](https://pkg.go.dev/html/template) - [MailHog Documentation](https://github.com/mailhog/MailHog) ## 🔄 Évolutions futures - [ ] Support de plusieurs providers SMTP (SendGrid, Mailgun) - [ ] Queue persistante (Redis, RabbitMQ) - [ ] Dead letter queue pour les échecs définitifs - [ ] Métriques Prometheus - [ ] Dashboard de monitoring - [ ] Support des pièces jointes - [ ] Support du format texte + HTML