Receive Scenario-Based Follow-Up Reminder Notifications
The system evaluates open assignments against configurable thresholds (e.g., 10 days with no registered activity for a contact). When a threshold is breached, a scenario-triggered push notification is dispatched to the responsible peer mentor. The notification content is built dynamically based on the scenario rule, referencing the contact and the delay. Tapping the notification navigates the user directly to the contact or assignment. Coordinators can configure the threshold rules per organisation. The reminder must not fire again for the same assignment within a cooldown period to avoid notification fatigue.
User Story
Acceptance Criteria
- Given an assignment has had no activity logged for 10 days, when the nightly scenario evaluation edge function runs, then a reminder push notification is dispatched to the assigned peer mentor
- Given the reminder notification is dispatched, when the mentor taps it, then they are deep-linked directly to the relevant contact detail screen
- Given a reminder was sent for an assignment today, when the evaluation runs again within the cooldown window (e.g., 3 days), then no duplicate reminder is sent for the same assignment
- Given a coordinator has configured a custom threshold (e.g., 7 days instead of 10), when the evaluation runs, then the custom threshold is respected for that organisation
- Given the peer mentor logs an activity for the contact after receiving the reminder, when the evaluation next runs, then the reminder timer resets and no further reminder is sent until the new threshold is exceeded
Business Value
The HLF workshop identified that 40% of peer mentors received poor follow-up satisfaction ratings. Automatic scenario-based reminders directly address this by providing a safety net that catches missed follow-ups before they become a problem. This is one of the highest-value automation features identified, as it removes the cognitive burden of tracking open assignments manually from each mentor.
Components
- Reminder Notification Card ui
- Reminder Threshold Settings UI ui
- Reminder Scheduler Service service
- Reminder Evaluation Service service
- Reminder Dispatch Service service
- Assignment Contact Tracking Repository data
- Reminder Configuration Repository data
- In-App Notification Repository data
- Assignment Reminder Cron Trigger infrastructure
- Push Notification Service infrastructure
- Scenario Prompt Notification Card ui
- Scenario Rule Engine service
- Scenario Prompt Scheduler Service service
- Scenario Rule Repository data
- Prompt History Repository data
- Scenario Evaluation Edge Function infrastructure
- Push Notification Dispatcher infrastructure
- Scenario Trigger Engine service
- Scenario Notification Content Builder service
- Scenario Edge Function Scheduler infrastructure
- Push Notification Dispatcher infrastructure
- Scenario Evaluation Configuration infrastructure