I am building a central notification dispatch system that is responsible for sending different kinds of notifications to the end customer. It relies on multiple third party APIs for sending the actual email/SMS notifications. At a high level architecture of the system is shown below.
NotificationSender exposes both REST and messaging interface for accepting consumer requests. Consumers here refer to the services that need to send the notification. This is what notification system does:
- It accepts requests from upstream services and stores that in the Postgres database after doing validation. The notification event is written to the Postgres database in
ENQUEUEDstate. It is returns back HTTP 202
ACCEPTEDto the upstream services if the request is valid else it returns HTTP 400
- At a predefined frequency a poller that is part of the NotificationDispacther polls the Postgres database for new notification events i.e. events in
ENQUEUEDstate. For now, it respects insertion time order.
- If enqueued events are found then it processes them and sends actual notifications using the downstream SMS and Email services.
- After processing the events it change state of the events to processed