Receive Scenario-Based Contextual Reminders for Peer Mentor Follow-Up
Beyond time-based reminders, coordinators benefit from scenario-based triggers that reflect actual workflow events. For example: a peer mentor logs an activity but no post-session report is submitted within 2 days; a way-forward task is due but not marked complete; or a peer mentor's certification is about to expire while they have active assignments. These scenario triggers should be configurable by the coordinator and generate targeted notifications that explain exactly what is missing and link directly to the incomplete item. HLF specifically requested scenario-based push messages to address the 40% dissatisfaction rate with follow-up.
User Story
Acceptance Criteria
- Given a peer mentor logs an activity with an associated contact, when 48 hours pass without a post-session report being submitted, then the coordinator receives a notification identifying the peer mentor and the missing report
- Given the coordinator taps the notification, when the deep link resolves, then the app navigates to the specific peer mentor's pending report or contact detail where the report should be filed
- Given a way-forward task has a due date and is not marked complete, when the due date passes, then a reminder is dispatched to both the peer mentor and the coordinator
- Given a coordinator opens the scenario settings screen, when they view available scenario triggers, then each scenario has a toggle to enable/disable it and a description of when it fires
- Given a scenario trigger fires, when it is displayed in the notification centre, then it is visually distinct from generic reminders, clearly labelling the scenario type (e.g., 'Missing report' or 'Overdue task')
Business Value
HLF survey data shows 40% of peer mentors were dissatisfied with coordinator follow-up. Scenario-based reminders move the system beyond simple time-triggers to intelligent workflow monitoring, catching gaps in documentation and task completion automatically. This directly addresses HLF's explicit requirement and reduces the manual supervisory burden on coordinators managing large teams.
Components
- Scenario Rule Engine service
- Scenario Prompt Scheduler Service service
- Scenario Configuration Manager service
- Scenario Evaluation Edge Function infrastructure
- Scenario Prompt Notification Card ui
- Scenario Deep Link Handler service
- Scenario Rule Repository data
- Push Notification Dispatcher infrastructure
- Reminder Dispatch Service service