Send Administrative Notifications and Announcements to the Organisation
The admin notification dispatcher allows org admins to compose a notification message, select a target audience (all org users, by role, by chapter, or by certification status), preview the audience size, and dispatch. Push notifications are delivered via FCM; in-app notifications appear in the notification centre. A dispatch history log records all sent notifications with delivery statistics. Admins cannot send to users outside their organisation scope (enforced by RLS). The system supports both immediate send and scheduled delivery.
User Story
Acceptance Criteria
- Given I open the notification composer, when I select audience 'peer mentors with certifications expiring in 30 days', then the audience preview shows the count of recipients matching that filter
- Given I compose a notification with an empty body, when I tap Send, then the form validates and prevents dispatch with a clear error message
- Given I dispatch a notification to all coordinators in a chapter, when the delivery completes, then a dispatch record is created showing recipient count and delivery timestamp
- Given a user has opted out of push notifications in their notification settings, when I send a broadcast, then the system skips that user's FCM token but still delivers the in-app notification
- Given I schedule a notification for a future time, when that time arrives, then the notification is dispatched automatically without requiring me to be logged in
- Given I am a regional admin, when I attempt to send a notification to users outside my hierarchy scope, then the audience selector only allows selection of users within my scope
Business Value
Coordinators currently rely on personal phone lists and email to communicate operational updates to peer mentors — a fragmented approach that results in information silos, missed deadlines, and inconsistent compliance. Centralised notification dispatch ensures that critical messages (certification expiry warnings, policy changes, mandatory training) reach the right people through the same channel they already use daily, increasing message open rates and operational responsiveness. HLF specifically flagged poor follow-up communication (40% dissatisfaction) as a key problem this directly addresses.
Components
- Admin Notification Dispatcher infrastructure
- Push Notification Service infrastructure
- Notification Trigger Service service
- Notification Repository data
- FCM Token Manager infrastructure
- FCM Push Notification Sender infrastructure
- FCM Notification Dispatcher infrastructure
- Admin Row-Level Security Guard service
- Admin Data Repository data