"Pipeline email MonCMS : accusé de réception, SMTP et documentation

Publié le 2026-04-14

Ce cycle d’évolution a renforcé le flux de publication par email de MonCMS, du traitement IMAP jusqu’au retour de confirmation envoyé à l’expéditeur.

Objectif

Le besoin était simple à formuler et essentiel en pratique : après l’envoi d’un article par email, recevoir un retour automatique indiquant clairement le résultat de la publication.

Fonctionnalité implémentée

Le script de publication email envoie désormais un message de feedback dans deux cas :

• Succès : confirmation de publication avec nom de fichier généré
• Échec : message explicite avec la raison du rejet ou de l’erreur

Le message de succès inclut aussi un lien direct vers l’article publié, construit à partir du slug réel utilisé par le site.

Comportement de sécurité et de robustesse

Le traitement conserve les garde-fous déjà en place :

• Vérification de l’expéditeur via PUBLISH_WHITELIST
• Vérification de l’objet avec le token [PUBLISH]
• Validation du contenu et normalisation du frontmatter
• Rebuild explicite du site après écriture du fichier

En cas d’échec, une notification d’erreur est envoyée à l’expéditeur.

SMTP : configuration validée

La configuration SMTP a été alignée sur les paramètres du provider :

• Serveur : smtp.domaine.ext
• Port : xxx
• Sécurité : SSL/TLS
• Authentification : adresse email complète + mot de passe de la boîte

Un test SMTP minimal indépendant a confirmé que l’envoi fonctionne correctement.

Gestion des secrets

La gestion du mot de passe SMTP suit le même principe que l’IMAP :

• priorité à SMTP_PASSWORD_FILE
• fallback sur SMTP_PASSWORD

Ce choix évite le stockage de secrets en clair dans les fichiers d’environnement.

Correction importante sur les URLs

Le lien envoyé dans l’email de confirmation utilise désormais le slug final de publication (nom de fichier sans .md), ce qui garantit une URL exacte vers la page Astro générée.

Documentation mise à jour

Le README a été révisé pour supprimer les parties obsolètes et refléter le fonctionnement réel :

• flux email basé sur polling IMAP (et non Postfix pipe)
• variables SMTP/IMAP documentées
• comportement de confirmation succès/échec clarifié
• exemple d’environnement aligné avec OVH et les secrets

Résultat

Le flux complet est maintenant validé en conditions réelles :

1. envoi de l’article par email
2. publication automatique
3. rebuild du site
4. confirmation envoyée à l’expéditeur
5. lien de lecture correct inclus dans le message

Ce lot améliore à la fois l’expérience éditoriale, la traçabilité opérationnelle et la qualité de la documentation.