Skip to main content

Notification Lifecycle

Business Purpose​

Make each event's path and terminal processing outcome understandable to business, QA and support stakeholders.

Actors​

Originating modules, the notification consumer, recipient and preference data owners, channel providers, recipients and support operators.

Business Flow​

Duplicate events stop without creating a second message. Stale events are treated as processed. For accepted events, each distinct channel is evaluated independently, so one channel may send while another is suppressed or fails.

Responsibilities​

Event producers supply stable event identifiers, occurrence time, tenant and payload. Service owners keep resolver mappings and templates aligned. Support uses audit stages to identify where a message stopped.

Business Rules​

Processing outcomes include processed, duplicate, stale, no template, no recipient, suppressed and failed. If any message records are created, the event outcome becomes processed even when all created messages later fail delivery.

Integrations​

Event consumption is restricted to mapped event types. Recipient data, templates, preferences and channel senders participate in processing; audit and processed-event records provide traceability.

Limitations​

The event-level “processed” outcome is not a delivery-success indicator. An unexpected infrastructure failure can cause reprocessing, while the idempotency record prevents duplicate completed work.

Requires Confirmation​

Confirm the accepted event-age policy, business handling for partially delivered events, reconciliation frequency and which failures require human escalation.

Source References​

  • microservices/src/notification-service/Application/NotificationDispatcher.cs
  • microservices/src/notification-service/Messaging/NotificationEventConsumer.cs
  • microservices/src/notification-service/Messaging/NotificationEventEnvelope.cs

See Also​

Keywords​

Lifecycle, duplicate, stale, suppression, processing outcome.

Revision Information​

Draft; reviewed 2026-07-21; next quarterly review 2026-10-21.