Skip to main content

Communication service

Transactional email for OTP, welcome, bill invites, and bulk sends. Tracks delivery logs and provider quota, accepts provider webhooks, and consumes the auth welcome-email stream. An older note described this module as a library only; the runnable service on port 8087 is the current delivery plane.

Bounded contextemail delivery
Listen port8087
PostgreSQL schemacommunication
Sourcesplick-backend/services/communication-service

Responsibilities​

  • Own its schema and Flyway migrations. Other services call HTTP or consume events. They do not join this schema.
  • Expose public routes only through Kong. Internal routes use the internal API key.
  • Publish integration facts through the transactional outbox when this service produces events. The outbox relay is the publisher.

Kong prefixes​

  • /api/v1/communication/email/preview
  • /api/v1/communication/delivery-logs
  • /api/v1/communication/email/usage
  • Provider webhooks: resend, brevo, mailjet, mailtrap, sendpulse

Public clients use http://localhost:8080/api in dev and https://api.splick.app/api in production. Kong strips the /api prefix before the upstream.

Pages in this section​