Skip to content

Module: cis-emailer

cis-emailer is the dedicated asynchronous notification and document generation library module for the CIS platform.

[!NOTE] cis-emailer is an internal library submodule (project(":cis-emailer")) embedded directly into cis-api. It does not expose standalone REST endpoints or listen on an HTTP port; its services are invoked directly by domain services within cis-api.


Capabilities

  1. Email Template Rendering:
  2. Compiles dynamic HTML emails using Thymeleaf templates.
  3. Automatically injects environment banners (e.g., [DEV], [UAT]) based on active Spring profiles to avoid confusing end users during testing.
  4. PDF Attachment Generation:
  5. Converts HTML receipts, certificates, and cadastral acknowledgement notices into PDF attachments using Flying Saucer (XHTML renderer).
  6. Transport Resilience:
  7. Robust error handling wrapping JavaMailSender.
  8. In local development, dispatches emails to Mailpit (localhost:1025) for zero-risk inspection.