Receive and Act on Scenario Prompt Notifications as a Peer Mentor (Coordinator View)
The value of a scenario prompt is largely determined by how easy it is to act on. A vague notification that drops the user on the home screen has low conversion. Coordinators configure deep-link destinations per scenario rule so that each notification payload contains a route that opens the precise screen needed. For example, an inactivity reminder deep-links to the activity registration bottom sheet with default values pre-filled; a certification expiry warning deep-links to the certification renewal screen. The deep-link handler resolves the route at tap time, handling authentication state gracefully (prompt login if session expired, then redirect).
User Story
Acceptance Criteria
- Given I am configuring a scenario rule, when I select a deep-link destination from a predefined list of valid routes, then that route is stored with the rule and included in the notification payload
- Given a peer mentor taps a scenario notification, when the app opens, then the deep-link router navigates directly to the configured destination screen without passing through the home screen
- Given the peer mentor's session has expired when they tap the notification, when authentication completes, then the app resumes navigation to the deep-link destination
- Given a deep-link destination is no longer valid (e.g., screen removed in an update), when the notification is tapped, then the app falls back gracefully to the home screen with a toast message
- Given I have not configured a deep-link for a scenario rule, when the notification is tapped, then the app opens to the notification centre screen
Business Value
Deep-link routing directly increases the action completion rate following a scenario prompt. For HLF, where activity logging compliance and certification renewals are tracked against funding requirements, every percentage point improvement in prompt-to-action conversion translates into more complete reporting data, fewer manual coordinator interventions, and stronger compliance outcomes.
Components
- Scenario Configuration Screen ui
- Scenario Deep Link Handler service
- Scenario Deep-Link Router service
- Scenario Configuration Manager service
- Scenario Rule Repository data
- Push Notification Dispatcher infrastructure
- Push Notification Dispatcher infrastructure