Periodic Activity Summaries
Feature Detail
Description
Automated half-year and quarterly summary notifications and in-app cards that give peer mentors and coordinators a mid-period snapshot of progress. Unlike the full Wrapped experience, these are lightweight digest cards showing key numbers: sessions held, hours contributed, and a comparison to the same period last year if data is available. Coordinators receive aggregated summaries across their team, enabling them to identify underactive or overloaded peer mentors and intervene proactively. This directly supports HLF's stated concern around inadequate follow-up of peer mentors.
Analysis
Gives coordinators actionable insight without requiring manual data exports. Supports HLF's goal of better peer mentor follow-up and NHF's need for statistical visibility per peer mentor and per coordinator.
Schedule summary generation via Supabase cron or Edge Function scheduled jobs. Push notification delivery via FCM/APNs. In-app card rendered on home screen for the relevant period. Data aggregation queries must respect organisation-level data isolation. Summaries cached locally for offline access.
Components (207)
Shared Components
These components are reused across multiple features
User Interface (59)
Service Layer (52)
Data Layer (33)
Infrastructure (54)
User Stories (12)
As a As a Peer Mentor (Likeperson)
I want to receive a push notification when my periodic activity summary has been generated
So that I am reminded to review my contributions at natural milestones (end of month, end of year) without having to manually check the app
- Given I have push notifications enabled and my summary is generated at the end of a period, when the scheduler triggers generation, then I receive a push notification within 2 hours of the period end
- Given I receive the push notification, when I tap it, then I am deep-linked directly to the periodic summary screen for that period without additional navigation steps
- Given I have disabled summary notifications in my notification preferences, when a summary is generated, then I do not receive a push notification but the summary remains accessible in the app
- +2 more
As a As a Peer Mentor (Likeperson)
I want to view a rich, animated annual summary of my entire year of peer mentor activity — similar to Spotify Wrapped
So that I experience a celebratory, emotionally resonant review of my yearly impact that reinforces my motivation and connection to the organization's mission
- Given it is after December 31st of a calendar year, when I open the app, then a prompt or notification draws my attention to my annual wrapped summary being ready
- Given I open the annual wrapped summary, when the experience begins, then I see a sequence of full-screen animated cards each revealing a key metric from my year
- Given the wrapped experience is playing, when I use a screen reader, then all content is announced sequentially and I can navigate between cards using swipe gestures without missing any information
- +3 more
As a As a Coordinator
I want to receive a push notification when my periodic activity summary has been generated
So that I am reminded to review my contributions at natural milestones (end of month, end of year) without having to manually check the app
- Given I have push notifications enabled and my summary is generated at the end of a period, when the scheduler triggers generation, then I receive a push notification within 2 hours of the period end
- Given I receive the push notification, when I tap it, then I am deep-linked directly to the periodic summary screen for that period without additional navigation steps
- Given I have disabled summary notifications in my notification preferences, when a summary is generated, then I do not receive a push notification but the summary remains accessible in the app
- +2 more
As a As a Coordinator
I want to view a rich, animated annual summary of my entire year of peer mentor activity — similar to Spotify Wrapped
So that I experience a celebratory, emotionally resonant review of my yearly impact that reinforces my motivation and connection to the organization's mission
- Given it is after December 31st of a calendar year, when I open the app, then a prompt or notification draws my attention to my annual wrapped summary being ready
- Given I open the annual wrapped summary, when the experience begins, then I see a sequence of full-screen animated cards each revealing a key metric from my year
- Given the wrapped experience is playing, when I use a screen reader, then all content is announced sequentially and I can navigate between cards using swipe gestures without missing any information
- +3 more
As a As a Peer Mentor (Likeperson)
I want to share a visual snapshot of my periodic activity summary via messaging apps or social platforms
So that I can celebrate my contribution publicly, inspire other potential peer mentors to join, and strengthen my sense of community with other volunteers
- Given I am viewing my periodic summary, when I tap the share button, then a shareable image is generated containing my activity counts, activity type breakdown, and any earned milestone badges
- Given the shareable image is generated, when I confirm sharing, then the native device share sheet opens allowing me to select any installed sharing destination
- Given the image is generated, when I inspect it, then no personally identifiable information about specific contacts is present — only aggregate metrics and anonymized statistics
- +2 more
As a As a Peer Mentor (Likeperson)
I want to compare my activity metrics between two different time periods side by side
So that I can understand whether my volunteering is growing, stable, or declining, and set informed personal goals for the next period
- Given I am viewing my periodic summary, when I activate the comparison mode, then I can select a second comparison period from the same preset options available for the primary period
- Given two periods are selected, when the comparison loads, then I see metrics for both periods displayed side by side with delta indicators (arrows and percentage change) for each metric
- Given the comparison shows a decline in a metric, when it is rendered, then the visual indicator uses a neutral color and neutral language (not alarming red or negative wording) consistent with cognitive accessibility guidelines
- +2 more
As a As a Peer Mentor (Likeperson)
I want to see if any of my recent periods had unusual activity patterns — such as an unexpectedly high or low number of sessions
So that I can reflect on what caused the change and adjust my planning for upcoming periods, or flag anomalies to my coordinator if needed
- Given I have at least 3 months of activity history, when I view a periodic summary, then any outlier period is indicated with a contextual badge or note on the summary card
- Given an outlier is detected for the current period, when I read the outlier note, then the language is supportive and explanatory (not alarming) and mentions the direction of deviation (higher or lower than usual)
- Given I have fewer than 3 months of activity history, when I view my summary, then no outlier detection note is shown as there is insufficient baseline data
- +2 more
As a As a Coordinator
I want to share a visual snapshot of my periodic activity summary via messaging apps or social platforms
So that I can celebrate my contribution publicly, inspire other potential peer mentors to join, and strengthen my sense of community with other volunteers
- Given I am viewing my periodic summary, when I tap the share button, then a shareable image is generated containing my activity counts, activity type breakdown, and any earned milestone badges
- Given the shareable image is generated, when I confirm sharing, then the native device share sheet opens allowing me to select any installed sharing destination
- Given the image is generated, when I inspect it, then no personally identifiable information about specific contacts is present — only aggregate metrics and anonymized statistics
- +2 more
As a As a Coordinator
I want to compare my activity metrics between two different time periods side by side
So that I can understand whether my volunteering is growing, stable, or declining, and set informed personal goals for the next period
- Given I am viewing my periodic summary, when I activate the comparison mode, then I can select a second comparison period from the same preset options available for the primary period
- Given two periods are selected, when the comparison loads, then I see metrics for both periods displayed side by side with delta indicators (arrows and percentage change) for each metric
- Given the comparison shows a decline in a metric, when it is rendered, then the visual indicator uses a neutral color and neutral language (not alarming red or negative wording) consistent with cognitive accessibility guidelines
- +2 more
As a As a Coordinator
I want to see if any of my recent periods had unusual activity patterns — such as an unexpectedly high or low number of sessions
So that I can reflect on what caused the change and adjust my planning for upcoming periods, or flag anomalies to my coordinator if needed
- Given I have at least 3 months of activity history, when I view a periodic summary, then any outlier period is indicated with a contextual badge or note on the summary card
- Given an outlier is detected for the current period, when I read the outlier note, then the language is supportive and explanatory (not alarming) and mentions the direction of deviation (higher or lower than usual)
- Given I have fewer than 3 months of activity history, when I view my summary, then no outlier detection note is shown as there is insufficient baseline data
- +2 more
As a As a Peer Mentor (Likeperson)
I want to view a visual summary of my activity over a selected period (monthly, quarterly, or annually)
So that I can see the tangible impact of my volunteer work, stay motivated, and feel proud of my contributions to the organization
- Given I am a logged-in peer mentor, when I navigate to the summary section, then I see a periodic summary card showing my total activities, hours, and unique contacts for the current default period
- Given I am viewing my summary, when I tap the period selector, then I can choose from preset periods (30 days, 90 days, 6 months, 1 year) or set a custom date range
- Given I select a period, when the summary loads, then all metrics (activities, hours, contacts, activity type breakdown) update to reflect the selected window
- +3 more
As a As a Coordinator
I want to view a visual summary of my activity over a selected period (monthly, quarterly, or annually)
So that I can see the tangible impact of my volunteer work, stay motivated, and feel proud of my contributions to the organization
- Given I am a logged-in peer mentor, when I navigate to the summary section, then I see a periodic summary card showing my total activities, hours, and unique contacts for the current default period
- Given I am viewing my summary, when I tap the period selector, then I can choose from preset periods (30 days, 90 days, 6 months, 1 year) or set a custom date range
- Given I select a period, when the summary loads, then all metrics (activities, hours, contacts, activity type breakdown) update to reflect the selected window
- +3 more