Rendered documentation
This page renders the module Markdown and Mermaid directly from the public documentation source.
Overview#
The Postal Code Alert domain provides a geographic mass notification system that dispatches alerts to subscribers and news agencies based on postal code boundaries intersecting campaign geofences. It includes subscriber self-service with verification, webhook delivery to news agencies with retry logic, real-time dispatch progress streaming, and comprehensive compliance features.
Key Features#
- Geofence-to-postal-code matching with coverage percentage calculation
- Subscriber self-service with OTP verification and rate limiting
- News agency webhook delivery with payload signing, circuit breakers, and retry logic
- Dead letter queue with exponential backoff for failed dispatches
- Real-time SSE dispatch progress streaming with delivery statistics
- Bulk postal code and boundary polygon import
- GDPR-compliant subscriber data export
- Idempotent dispatch with advisory locking to prevent concurrent duplicates
- Per-subscriber frequency capping with configurable daily limits
- Immutable audit logging for all dispatch actions
- Delivery confirmation tracking with callback endpoints
Use Cases#
- Dispatching emergency alerts to residents within geographic zones affected by incidents
- Notifying news agencies of public safety alerts with authenticated webhook delivery
- Managing subscriber opt-in and verification for postal code-based alerting
- Monitoring dispatch progress in real time with delivery success metrics
Integration#
The Postal Code Alert domain connects with geofencing for boundary matching, notification campaigns for recipient management, and public alerts distribution. All queries are scoped by organization for multi-tenant isolation.
Last Reviewed: 2026-02-24