View Calculated Personal Volunteer Benefit Summary
Peer mentors invest significant time and energy into supporting others, but that contribution is often invisible. This story allows a peer mentor to navigate to the Benefit Calculator screen and immediately see a rich summary of their calculated benefit — combining hours contributed, activities completed, and a multiplier-based value estimate. The screen loads data from the activity summary aggregator, applies org-configured multipliers, and displays the result in a visually engaging benefit results card. The calculation reflects the configured period (default: current year) and supports offline-cached data for resilience. The result is expressed in multiple dimensions: estimated societal value, hours contributed, and number of people supported.
User Story
Acceptance Criteria
- Given the peer mentor navigates to the Benefit Calculator screen, When the screen loads, Then the benefit-calculator-screen displays a benefit-results-card with total estimated value, hours contributed, and people supported
- Given activity data exists for the selected period, When the benefit-calculation-service processes the aggregated data, Then the result reflects all completed activities multiplied by the org-configured benefit-multiplier-config-repository values
- Given no network connection is available, When the peer mentor opens the calculator, Then previously cached calculation results are displayed with a subtle offline indicator
- Given the peer mentor has zero registered activities for the period, When the screen loads, Then a friendly empty state is shown encouraging them to register their first activity
- Given the calculation completes successfully, When the benefit-results-card renders, Then all benefit-metric-tile components display with accessible labels and WCAG 2.2 AA compliant contrast ratios
Business Value
Volunteer retention is a critical challenge for all three organizations. Showing peer mentors the concrete societal and personal value of their contributions increases intrinsic motivation, reduces churn, and supports recruitment narratives. A visible, shareable benefit calculation transforms invisible labor into recognized impact — directly supporting the organizations' fundraising, advocacy, and volunteer program sustainability goals.
Components
- Benefit Calculator Screen ui
- Benefit Results Card ui
- Benefit Metric Tile ui
- Benefit Calculation Service service
- Activity Summary Aggregator service
- Benefit Multiplier Config Repository data
- Benefit Calculation Result Model data
- Benefit Calculator BLoC infrastructure