Notifications

Le problème qu'elle supprime

Un e-mail envoyé dans une transaction annulée ne se rattrape pas.

Ce qu'elle fait

Décisions et compromis

1. 01

   Nous avons choisi

   Un événement, publié par l'outbox du producteur.

   Nous avons refusé

   Un endpoint HTTP synchrone « envoie un e-mail ».

   Parce que

   Pas d'e-mail pour un changement annulé ; une panne SMTP retarde le courrier au lieu de faire échouer les inscriptions ; une relivraison n'est envoyée qu'une fois (dédupliquée par messageId).

   Ce que cela vous coûte

   RabbitMQ entre votre application et le service.

2. 02

   Nous avons choisi

   Des gabarits texte sur disque, un fichier par gabarit et par langue, repli sur en, un dossier que vous pouvez pointer ailleurs sans recompiler.

   Nous avons refusé

   Un moteur de gabarits HTML, pour l'instant.

   Parce que

   Un gabarit qu'une personne non développeuse peut modifier, et rien à rendre qui puisse casser.

   Ce que cela vous coûte

   Texte brut uniquement aujourd'hui.

3. 03

   Nous avons choisi

   Des webhooks uniquement vers des hôtes en liste blanche (vide = pas de webhook).

   Nous avons refusé

   N'importe quelle URL envoyée par le demandeur.

   Parce que

   Un webhook ouvert est une falsification de requête côté serveur (SSRF) qui attend son heure.

   Ce que cela vous coûte

   Vous déclarez les hôtes.

En code

@Transactional
public Order confirm(Order order) {
  Order confirmed = orders.save(order.confirmed());
  // Not an SMTP call: an event in the same transaction. The service renders and delivers it.
  events.publish(NotificationRouting.NOTIFICATION_REQUESTED, 1,
      new NotificationRequest(Channel.EMAIL, confirmed.email(), "order-confirmed", "fr-FR",
          Map.of("order", confirmed.number())));
  return confirmed;
}

// templates/order-confirmed/fr.txt — first line "Subject: …", then {{order}}; "en" is the fallback.
// SMS (Twilio) and WEBHOOK (allow-listed hosts) are the same request with another Channel.

L'adopter

<dependency>
  <groupId>com.krizaka</groupId>
  <artifactId>krizaka-notifications-api</artifactId>
  <version>0.1.0</version>
</dependency>
<!-- the service itself: ./mvnw -pl krizaka-notifications-service -am spring-boot:run (port 8097) -->