Receive Notification When Annual Summary is Ready
When the nightly scheduler runs the annual summary generation job (typically at the beginning of a new year, or at configurable intervals like mid-year), a push notification is dispatched to each peer mentor with a personalized message highlighting a key stat from their summary (e.g., 'Your 2025 impact is ready! You completed 47 sessions this year.'). Tapping the notification deep-links directly to the wrapped summary screen. The notification timing and message content are configurable per organization. Peer mentors who have opted out of notifications do not receive this. The summary generation is triggered server-side and runs asynchronously, with each peer mentor's notification dispatched only after their individual summary has been successfully generated.
User Story
Acceptance Criteria
- Given my annual summary has been generated, when the notification is dispatched, then I receive a push notification with a personalized stat highlight from my summary
- Given I tap the push notification, when the app opens, then I am deep-linked directly to my annual summary screen without needing to navigate manually
- Given I have opted out of push notifications in the app settings, when the annual summary is generated, then I do not receive a push notification but the summary is still accessible in-app
- Given the summary generation job runs, when my individual summary is not yet ready, then the push notification is not sent until generation completes successfully
- Given my organization has configured a custom notification message template, when the notification is sent, then the message uses the organization-specific template with my personalized stats inserted
- Given I am a screen reader user and I receive the notification, when I focus on the notification, then the notification text is fully readable and meaningful without requiring visual context
Business Value
The timing of recognition is as important as the recognition itself. A well-timed, personalized notification transforms the Wrapped summary from a passive feature into a proactive engagement moment that re-activates peer mentors at the start of a new year. For organizations managing hundreds of volunteers, automated and personalized outreach at scale is operationally infeasible through manual coordination — the scheduler enables this at zero marginal cost per notification. This directly addresses HLF's finding that 40% of peer mentors were unsatisfied with follow-up, by ensuring every active peer mentor receives a personal acknowledgment of their annual contribution.
Components
- Push Notification Dispatcher infrastructure
- Summary Generation Scheduler infrastructure
- Annual Stats Aggregation Service service
- Summary Generation Service service
- Annual Summary Repository data
- Wrapped Summary Screen ui
- Wrapped Summary BLoC service
- Organisation Data Isolation Guard infrastructure