Receive Push Notification When Periodic Summary Is Ready
The summary scheduler runs on a configurable cadence (monthly, half-yearly, yearly) and triggers summary generation for each peer mentor. Once generation is complete, a push notification is dispatched to the peer mentor's device with a personalized preview message (e.g., 'You supported 12 people this month — see your summary!'). The notification deep-links directly to the summary screen for that period. Notification preferences must be respected, and the notification must be accessible with sufficient contrast and screen reader support.
User Story
Acceptance Criteria
- Given I have push notifications enabled and my summary is generated at the end of a period, when the scheduler triggers generation, then I receive a push notification within 2 hours of the period end
- Given I receive the push notification, when I tap it, then I am deep-linked directly to the periodic summary screen for that period without additional navigation steps
- Given I have disabled summary notifications in my notification preferences, when a summary is generated, then I do not receive a push notification but the summary remains accessible in the app
- Given the push notification is delivered, when a screen reader is active, then the notification content is fully readable and the action is clearly described
- Given the summary generation fails for technical reasons, when the scheduler retries, then notification is only sent once upon successful completion and not on failure
Business Value
Timely, personalized notifications drive re-engagement with the app at moments when peer mentors are most receptive (period boundaries). Automated reminders remove the burden of self-monitoring and create predictable engagement peaks that help coordinators gauge overall team health.
Components
- Push Notification Dispatcher infrastructure
- Summary Generation Scheduler infrastructure
- Summary Generation Service service
- Push Notification Service infrastructure
- Notification Deep Link Handler service
- Notification Preferences Repository data
- Periodic Summary Digest Card ui