Select and View Summaries for Different Time Periods
The summary period selector allows the peer mentor to choose which time period their summary covers. Options include the current calendar year, the previous calendar year, and a rolling 6-month window. When a period is selected, the entire summary screen re-aggregates and animates to reflect the chosen timeframe. The period comparison widget shows side-by-side metrics when switching between two periods, making growth visible. For newly onboarded peer mentors with less than one year of activity, the selector adapts to show only available periods. Period selection state is persisted within the session so the peer mentor does not lose their selection when navigating away and returning.
User Story
Acceptance Criteria
- Given I am viewing my annual summary, when I tap the period selector, then I see options for the current year, previous year, and last 6 months
- Given I select a different time period, when the selection is confirmed, then the summary re-animates and all statistics update to reflect the chosen period
- Given I switch from current year to previous year, when both periods have data, then a comparison card is shown highlighting changes in total sessions, hours, and unique contacts
- Given I am a newly onboarded peer mentor with less than 12 months of activity, when I open the period selector, then only periods for which I have data are shown as selectable options
- Given I select a period and navigate to the badge shelf, when I return to the summary screen, then my period selection is preserved
- Given the selected period has very few activities, when the summary loads, then it displays honestly with appropriate context rather than showing empty or misleading charts
Business Value
Providing historical context transforms the Wrapped feature from a one-time novelty into an ongoing engagement tool. Peer mentors who can see their growth over multiple years develop a stronger sense of commitment and identity as volunteers. The half-year summary addresses the need expressed by NHF and HLF for mid-year check-ins, allowing coordinators to identify and re-engage peer mentors who are showing reduced activity before they disengage entirely. Period comparison data also feeds into coordinator dashboards for proactive team management.
Components
- Summary Period Selector ui
- Period Comparison Widget ui
- Annual Stats Aggregation Service service
- Summary Generation Service service
- Period Calculator Service service
- Wrapped Summary BLoC service
- Summary Period Repository data
- Summary Cache Repository data