🏠 Overview › 🎯 Features ›🎯 Scenario-based Follow-up Prompts

Scenario-based Follow-up Prompts

Feature Detail

high complexity extracted Notifications & Follow-up Confidence: 100%
10
Components
198
Shared
5
User Stories
Yes
Analyzed

Description

Intelligent, context-aware push prompts that surface at relevant moments in the peer mentor workflow — for example, prompting the peer mentor to log a follow-up call three days after recording a first contact, or suggesting they check in with a contact who had flagged a difficult situation in the previous report. These prompts are scenario-driven rather than time-only, using activity metadata (contact type, reported wellbeing flags, duration) to determine relevance. Coordinators can configure which scenarios trigger prompts for their chapter. The feature is designed to reduce the emotional labour of remembering follow-up obligations and is especially relevant for HLF, where dissatisfaction with peer mentor follow-up was measured at 40%. Prompts are actionable — tapping one opens directly into the activity registration wizard with pre-filled context.

Analysis

Business Value

Directly targets the HLF finding that 40% of peer mentors felt follow-up was insufficient. Scenario-based prompts lower the cognitive load on peer mentors and increase the likelihood of timely, meaningful follow-up without requiring coordinators to micromanage.

Implementation Notes

Define scenario rules as JSON config per org (e.g., {trigger: 'first_contact_logged', delay_days: 3, prompt: '...'}). Evaluate rules in a scheduled Edge Function. Start with 3–5 hardcoded scenarios and expose config UI in Phase 3. Deep link into activity wizard via go_router with pre-filled route arguments.

Components (208)

User Interface (3)

ui Scenario Configuration Screen medium ui Scenario Prompt Detail Bottom Sheet medium ui Scenario Prompt Notification Card medium

Service Layer (4)

service Scenario Configuration Manager medium service Scenario Deep Link Handler medium service Scenario Prompt Scheduler Service high service Scenario Rule Engine high

Data Layer (2)

data Prompt History Repository medium data Scenario Rule Repository medium

Infrastructure (1)

infrastructure Scenario Evaluation Edge Function medium

Shared Components

These components are reused across multiple features

User Interface (59)

ui Role Switch Widget medium Shared ui Role-Aware Bottom Navigation medium Shared ui Activity Type Selection Screen low Shared ui Speech-to-Text Field Overlay medium Shared ui Receipt Capture Widget medium Shared ui Peer Mentor Single Selector low Shared ui Proxy Audit Badge Widget low Shared ui Export Period Picker low Shared ui Contact Card Widget low Shared ui Contact Search Bar low Shared ui Peer Mentor Card Widget low Shared ui Activity History List low Shared ui Multi-Chapter Affiliation Chip Widget medium Shared ui Certification Status Badge low Shared ui Duplicate Activity Warning Dialog medium Shared ui Mentor Multi-Select Widget medium Shared ui Map Filter Panel medium Shared ui Claim Status Badge low Shared ui Export Date Range Picker low Shared ui Custom Date Range Picker low Shared ui Duplicate Activity Warning Dialog low Shared ui Proxy Activity Form medium Shared ui Proxy Peer Mentor Selector medium Shared ui Expected Return Date Picker low Shared ui Pause Activation Screen low Shared ui Pause Status Indicator low Shared ui Admin KPI Stat Widget low Shared ui Organisation Hierarchy Navigator high Shared ui Bufdir Period Selector Widget low Shared ui Export History List medium Shared ui Activity Type Donut Chart medium Shared ui Monthly Activity Bar Chart medium Shared ui Statistics Period Filter Bar low Shared ui Statistics Summary Cards low Shared ui Notification Badge Widget low Shared ui Certificate Expiry Status Indicator low Shared ui Animated Stat Card Widget medium Shared ui In-App Notification Banner low Shared ui Accessible Modal Sheet Widget high Shared ui Live Region Announcer medium Shared ui Semantics Wrapper Widget medium Shared ui Sensitive Field Warning Dialog high Shared ui Confirm Before Submit Screen medium Shared ui Inline Contextual Help Widget low Shared ui Labelled Navigation Bar low Shared ui Plain Language Error Display low Shared ui Single-Action Screen Layout medium Shared ui Wizard Progress Indicator low Shared ui Accessible Text Style System medium Shared ui Accessible Touch Target Wrapper low Shared ui Contrast-Safe Color Palette Widget medium Shared ui Accessible Bottom Navigation Bar medium Shared ui Modal Close Button low Shared ui Persistent Back Button low Shared ui Vertical Scroll Container low Shared ui Organization Card Widget low Shared ui Terminology-Aware Text Widget low Shared ui FeatureGate Widget low Shared ui Chapter Switcher medium Shared

Service Layer (52)

service Authentication Service medium Shared service Authentication Session Manager medium Shared service Biometric Authentication Service medium Shared service Biometric Authentication Service medium Shared service Biometric Authentication Service medium Shared service Permission Checker Service medium Shared service Role State Manager medium Shared service No-Access Route Guard low Shared service Activity Type Metadata Resolver low Shared service Chapter Scope Resolver medium Shared service Organisation Hierarchy Resolver medium Shared service Coordinator Notification Service medium Shared service Duplicate Activity Detection Service high Shared service Mentor Filter Service low Shared service Receipt Threshold Validator low Shared service Approval Status Notification Service medium Shared service Threshold Evaluation Service medium Shared service Declaration Encryption Service high Shared service Organization Feature Flag Service low Shared service Participant Deduplication Service high Shared service Reporting Period Service medium Shared service Activity Attribution Service low Shared service Proxy Duplicate Detection Service medium Shared service Pause Management Service medium Shared service Pause Notification Service medium Shared service Admin Export Service medium Shared service Admin Row-Level Security Guard high Shared service Organisation Hierarchy Service high Shared service User Management Service high Shared service Role Access Validator low Shared service Peer Mentor Stats Aggregator medium Shared service Push Notification Dispatcher medium Shared service Notification Preference Service low Shared service Scenario Deep-Link Router medium Shared service Scenario Notification Content Builder medium Shared service Badge Criteria Integration medium Shared service Activity Summary Aggregator low Shared service Focus Management Service medium Shared service Screen Reader Detection Service medium Shared service Sensitive Field Privacy Guard high Shared service Plain Language Content Service medium Shared service Wizard State Manager medium Shared service Tab State Manager medium Shared service Organization Route Guard medium Shared service Tenant Context Service high Shared service Label Key Resolver Service low Shared service Organization Labels Notifier medium Shared service FeatureFlagProvider (Riverpod) medium Shared service Access Scope Service high Shared service Hierarchy Aggregation Service high Shared service Hierarchy Service high Shared service Unit Assignment Service medium Shared

Data Layer (33)

data Authentication Repository low Shared data Auth Token Store low Shared data Secure Session Storage low Shared data Activity Type Cache Provider medium Shared data Receipt Storage Adapter medium Shared data Proxy Contact List Provider low Shared data Contact Repository medium Shared data Contact Detail Repository medium Shared data Peer Mentor Repository low Shared data Mentor Status Repository low Shared data Contact Chapter Repository medium Shared data Contact Cache Sync Repository low Shared data Organisation Rate Configuration Repository low Shared data Multi-Organization Data Isolator medium Shared data Bufdir Aggregation Repository low Shared data Report File Storage Client low Shared data Certification Status Repository low Shared data Peer Mentor Status Repository medium Shared data Statistics Cache Manager low Shared data In-App Notification Repository low Shared data Pause Status Record Repository low Shared data Activity Aggregation Repository medium Shared data Notification Preferences Repository low Shared data Scenario Notification Repository medium Shared data Sensitive Field Configuration low Shared data Error Message Registry low Shared data Help Content Registry low Shared data Wizard Draft Repository low Shared data Design Token Provider medium Shared data Organization Repository medium Shared data Terminology Local Cache Adapter low Shared data Organization Unit Repository high Shared data Unit Assignment Repository medium Shared

Infrastructure (54)

infrastructure Keyboard-Aware Layout Utility low Shared infrastructure Supabase Auth Client low Shared infrastructure Deep Link / OAuth Redirect Handler medium Shared infrastructure Secure Storage Adapter low Shared infrastructure Supabase Session Manager medium Shared infrastructure URL Launcher Utility low Shared infrastructure Local Storage Adapter low Shared infrastructure Supabase Activity Client low Shared infrastructure Organization Labels Provider low Shared infrastructure Supabase Client low Shared infrastructure Organisation Field Config Loader medium Shared infrastructure Speech-to-Text Adapter medium Shared infrastructure File Download Handler low Shared infrastructure Duplicate Reviewed Flag Middleware low Shared infrastructure Contact RLS Query Builder low Shared infrastructure Contact Form Validator low Shared infrastructure Design Token Theme low Shared infrastructure Organization Labels Provider low Shared infrastructure Supabase Client Provider low Shared infrastructure Search Debounce Utility low Shared infrastructure Expense Type Analytics Tracker low Shared infrastructure Receipt Image Picker Integration low Shared infrastructure CSV / JSON File Generator medium Shared infrastructure Coordinator Role Guard low Shared infrastructure Nightly Job Scheduler medium Shared infrastructure Supabase RLS Policy Configuration high Shared infrastructure Export File Storage Adapter low Shared infrastructure Supabase Storage Adapter low Shared infrastructure Peer Mentor Pause Management Service medium Shared infrastructure Push Notification Service medium Shared infrastructure fl_chart Adapter medium Shared infrastructure Push Notification Service low Shared infrastructure FCM Push Notification Sender medium Shared infrastructure FCM Notification Dispatcher medium Shared infrastructure Push Notification Dispatcher medium Shared infrastructure Supabase Realtime Subscription Service medium Shared infrastructure Organisation Data Isolation Guard low Shared infrastructure Push Notification Dispatcher medium Shared infrastructure Deep Link Handler medium Shared infrastructure QR Code Generator low Shared infrastructure Share Sheet Bridge low Shared infrastructure Semantics Service Facade medium Shared infrastructure Accessibility Design Token Enforcer medium Shared infrastructure Accessible Theme Builder medium Shared infrastructure Navigation Route Configuration medium Shared infrastructure Accessibility Live Region Announcer low Shared infrastructure Feature Flag Provider low Shared infrastructure Secure Storage Adapter low Shared infrastructure Supabase RLS Tenant Scope Configurator medium Shared infrastructure Label Key Registry low Shared infrastructure Terminology Riverpod Providers low Shared infrastructure WCAG Semantics Label Resolver low Shared infrastructure Feature Flag Key Constants low Shared infrastructure RLS Policy Manager high Shared

User Stories (5)

Review Scenario Prompt History and Delivery Effectiveness
medium 5 pts

As a As a Peer Mentor (Likeperson)

I want to view a history of all scenario-triggered prompts that have been sent, including which peer mentors received them, when they were delivered, and whether any action was taken in response

So that I can assess the effectiveness of my configured scenarios, identify peer mentors who are repeatedly triggered by the same conditions without responding, and refine my follow-up strategy accordingly

Acceptance Criteria
  • Given I am on the scenario configuration screen, when I tap on a specific scenario rule, then I see a detail view with the full prompt history for that rule including mentor names, delivery timestamps, and read status
  • Given the prompt history list is displayed, when I filter by a specific peer mentor, then I see all scenarios that have been triggered for that mentor in chronological order
  • Given a mentor has received a scenario prompt and subsequently logged an activity, when I view the prompt history, then the record shows a 'responded' indicator linked to the follow-up action
  • +2 more
View Full Story →
Build and Preview Scenario Notification Content Before Activation
medium 5 pts

As a As a Peer Mentor (Likeperson)

I want to compose the notification title and body for each scenario rule using a content builder that supports dynamic placeholders (e.g., mentor name, days since last activity, certification expiry date) and preview how the message will appear on a device before activating the rule

So that I can ensure scenario notifications are personalized, clearly worded, and action-oriented before they reach peer mentors — preventing confusing or generic messages that would undermine trust in the notification system

Acceptance Criteria
  • Given I am editing a scenario rule, when I open the notification content section, then I see a text editor with a placeholder insertion toolbar listing available dynamic fields (name, days inactive, certification expiry, etc.)
  • Given I insert a placeholder into the message body, when I view the preview, then the placeholder is replaced with realistic sample data appropriate to the placeholder type
  • Given I submit a message template that exceeds the 100-character push notification title limit, when I try to save, then a validation error is shown indicating the title must be shortened
  • +2 more
View Full Story →
Schedule Scenario Evaluations at Optimal Times to Minimize Disruption
medium 8 pts

As a As a Peer Mentor (Likeperson)

I want to configure when scenario evaluation edge functions run and when resulting notifications are delivered — for example, restricting delivery to weekday business hours and avoiding evaluation runs during peak app usage times

So that peer mentors receive prompts at times when they are likely to be available to respond, reducing notification fatigue and respecting the voluntary nature of peer mentoring work

Acceptance Criteria
  • Given I am configuring a scenario rule, when I set an evaluation frequency (e.g., daily) and a delivery window (e.g., weekdays 09:00–17:00), then those constraints are saved and applied to the edge function schedule
  • Given an evaluation runs and a condition is met outside the configured delivery window, when the delivery window opens, then the queued notification is sent at the start of the next valid window
  • Given I configure a blackout period (e.g., holiday freeze), when the delivery window would normally open, then no notifications are sent during the blackout and they are discarded rather than queued
  • +2 more
View Full Story →
Receive and Act on Scenario Prompt Notifications as a Peer Mentor (Coordinator View)
high 5 pts

As a As a Peer Mentor (Likeperson)

I want to monitor which scenario prompts my peer mentors receive and configure deep-link routing so that each prompt takes the recipient directly to the most relevant in-app action

So that peer mentors experience a frictionless response flow — tapping a notification immediately opens the correct screen (e.g., activity registration, certification renewal, or contact detail) — maximizing the likelihood that the prompted action is completed

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
  • +2 more
View Full Story →
Configure Scenario Rules for Automated Peer Mentor Follow-up
high 8 pts

As a As a Peer Mentor (Likeperson)

I want to define scenario-based rules that automatically trigger follow-up prompts for peer mentors based on specific conditions such as inactivity periods, upcoming certification expiry, or absence of reported contact

So that peer mentors receive timely, contextually relevant reminders that reduce administrative overhead on me while ensuring no mentor goes unsupported or unmonitored for extended periods

Acceptance Criteria
  • Given I am logged in as a coordinator, when I navigate to the scenario configuration screen, then I see a list of all existing scenario rules with their active/inactive status
  • Given I create a new scenario rule, when I define a trigger condition (e.g., inactivity threshold in days), message content, and target role, then the rule is saved and the scheduler is updated to evaluate it on the next cycle
  • Given a scenario rule is active, when the evaluation edge function runs and the condition is met for a peer mentor, then a push notification is dispatched to that mentor within the configured delivery window
  • +2 more
View Full Story →