Corps du message compose de blocs, macros Centreon en suggestion

docs/NOTIFICATIONS.md

@@ -70,6 +70,42 @@ Un agent de transport de courrier doit être en place sur la machine : le script
 fonction `mail()` de PHP, qui passe par `sendmail`. L'adresse d'expédition se règle par la
 variable d'environnement `ENCLUME_EXPEDITEUR`, à défaut `centreon@<nom de la machine>`.
 
+## Composer le corps du message
+
+Le corps est une liste de **blocs**, dans l'ordre d'affichage. Quatre natures :
+
+| Bloc | Ce qu'il affiche |
+|---|---|
+| Macro Centreon | la valeur d'une macro, `$NOTIFICATIONAUTHOR$`, `$SERVICEPERFDATA$`, ou une macro personnalisée `$_HOSTAPPLI$` |
+| Lien cliquable | une macro contenant une URL, `$SERVICENOTESURL$` par exemple, rendue en lien |
+| Texte fixe | une consigne qui ne dépend pas de l'événement, « Appeler le 3000 si non résolu en 30 minutes » |
+| Sortie du contrôle | la sortie du plugin, mise en avant en police fixe |
+
+Les blocs se définissent séparément pour l'hôte et pour le service. Tant qu'aucun n'est
+défini, les blocs par défaut s'appliquent — et le bouton « Composer à partir des blocs par
+défaut » les recopie pour servir de point de départ.
+
+**Une macro vide à l'exécution ne produit aucune ligne.** Un message d'acquittement affichera
+donc l'auteur et son commentaire ; une notification de problème, où ces macros sont vides,
+n'affichera pas de lignes creuses.
+
+### Les macros personnalisées
+
+C'est le vrai gain par rapport à un message figé. `$_HOSTAPPLI$` ou `$_HOSTRESPONSABLE$`,
+définies comme macros sur l'hôte, produisent un message qui nomme *l'application concernée*
+et non celle du périmètre entier. L'éditeur propose une quarantaine de macros standard en
+suggestion, et accepte toute macro saisie à la main.
+
+## Voir le message avant de le déployer
+
+Dans l'éditeur, un périmètre propose **Aperçu du message, service** et **Aperçu du message,
+hôte**. Le message s'affiche tel qu'il partira, avec un incident d'exemple : sujet,
+destinataire, mise en forme complète, plus la commande Centreon correspondante.
+
+L'aperçu et le script PHP partagent le même gabarit HTML — celui-ci est écrit une seule fois
+et embarqué dans le script généré. Ce qui est montré est donc ce qui sera envoyé, et un test
+vérifie que les deux ne peuvent pas diverger.
+
 ## Le message produit
 
 Un message HTML avec un bandeau coloré selon l'état — vert rétabli, orange alerte, rouge