Receive Push Notification When Impact Summary Is Ready
When the Impact Summary Trigger Service generates a new summary for a user, it dispatches a push notification via the Push Notification Gateway. Simultaneously, an Impact Summary Notification Card appears in the Notifications screen, showing a teaser headline (e.g., 'Your 2025 year in review is ready!') and a call-to-action button that deep-links directly to the Impact Summary Screen. The notification respects the user's notification preferences and only fires if push notifications are enabled.
User Story
Acceptance Criteria
- Given a new impact summary is generated for a user, when the trigger service completes, then a push notification is dispatched within 5 minutes
- Given the user taps the push notification, when the app opens, then the Impact Summary Screen is shown directly without requiring additional navigation
- Given the user opens the Notifications screen, when a new impact summary is available, then an Impact Summary Notification Card appears at the top of the list with a 'View Summary' call-to-action
- Given the user has disabled push notifications in settings, when a summary is generated, then no push notification is sent but the in-app notification card is still shown
- Given the notification card has been viewed and the summary has been opened, when the user returns to the Notifications screen, then the card is marked as read
Business Value
Discovery is critical for engagement features — a summary that users never find delivers zero retention value. Push notification delivery ensures near-universal awareness of the new summary, dramatically increasing the percentage of volunteers who engage with the recognition experience and converting a passive feature into an active engagement moment.
Components
- Impact Summary Notification Card ui
- Impact Summary Trigger Service service
- Push Notification Service service
- Push Notification Gateway infrastructure
- Notifications Screen ui
- Impact Summary Repository data