Volunteer Benefit Calculator
Feature Detail
Description
An interactive tool that helps peer mentors and prospective volunteers understand the concrete value of their contributions — both personal (hours saved by recipients, travel costs avoided) and societal (estimated public health system cost offset). This 'fordelskalkulator' was listed as a Phase 4 item in the roadmap. The calculator serves a dual purpose: it reinforces the value of volunteering for existing peer mentors (supporting retention) and acts as a persuasive tool for recruiting new volunteers and justifying continued organisational funding from bodies like Bufdir.
Analysis
Strengthens the value proposition of the peer mentor programme to both participants and funders. Provides shareable, concrete numbers that can support Bufdir grant applications and organisational annual reports.
Calculator logic is client-side with configurable multipliers (e.g., hourly rate equivalents) set per organisation in Supabase config. Results presented as a shareable card consistent with the Wrapped design language. No personal data leaves the device for this calculation. Ensure numeric outputs are accessible: use semantic markup, not just visual charts.
Components (207)
Shared Components
These components are reused across multiple features
User Interface (59)
Service Layer (52)
Data Layer (33)
Infrastructure (54)
User Stories (6)
As a As a Peer Mentor (Likeperson)
I want to share my calculated benefit summary as an image or text snippet via the device's native share sheet
So that I can celebrate my contribution publicly, inspire others to volunteer, and help the organization's recruitment and awareness campaigns organically
- Given a completed benefit calculation is displayed, When the peer mentor taps the share button, Then the benefit-share-service composes a shareable payload and the native OS share sheet opens within 1.5 seconds
- Given the share payload is composed, When sensitive-field-privacy-guard evaluates the content, Then no personally identifiable information (name, phone, email, personnummer) is included in the shared output
- Given the peer mentor completes a share action, When the share sheet is dismissed, Then the user is returned to the Benefit Calculator screen with their calculation still visible
- +2 more
As a As a Peer Mentor (Likeperson)
I want to see individual benefit metric tiles that break down my total calculated benefit by activity type (e.g., home visits, phone calls, group sessions)
So that I can understand which types of volunteer work contribute most to my impact score and make informed decisions about how I spend my volunteer time
- Given a completed calculation with multiple activity types, When the benefit-metric-tile components render, Then each tile displays the org-localized activity type name, count, total hours, and calculated benefit value
- Given the org has configured different multipliers for different activity types in benefit-multiplier-config-repository, When the calculation runs, Then tiles with higher-multiplier activity types show proportionally higher benefit values
- Given the screen renders on a narrow viewport (320dp width), When the tile layout adapts, Then tiles reflow to a single-column list without overflow or clipping
- +2 more
As a As a Peer Mentor (Likeperson)
I want to find and open the Benefit Calculator from the main navigation without more than two taps
So that I can quickly access my benefit summary whenever I want without having to search through menus, especially when using assistive technologies or when I have limited digital skills
- Given the peer mentor is on the home screen, When they look for the Benefit Calculator, Then a visible entry point (card, button, or navigation item) is present within the first scroll position
- Given the peer mentor taps the Benefit Calculator entry point, When navigation resolves, Then the benefit-calculator-screen loads and displays a default calculation for the current year within 3 seconds
- Given a screen reader is active, When the peer mentor navigates to the Benefit Calculator entry point, Then the accessible-bottom-navigation or labelled-navigation-bar announces the target as 'Benefit Calculator' in the organization's configured terminology
- +2 more
As a As a Peer Mentor (Likeperson)
I want to use the calculator input panel to change the time period and optionally adjust activity parameters before triggering the benefit calculation
So that I can explore my benefit contribution for different timeframes (e.g., last month, last year, all time) and understand how my efforts have grown over time
- Given the peer mentor is on the Benefit Calculator screen, When they tap a period preset in the calculator-input-panel, Then the benefit-calculator-bloc triggers recalculation and the results update within 2 seconds
- Given the peer mentor selects a custom date range, When both start and end dates are valid and the range does not exceed 3 years, Then the calculation executes and results display for that exact period
- Given an invalid date range is entered (end before start), When the peer mentor attempts to calculate, Then a plain-language inline error is shown and calculation is blocked until corrected
- +2 more
As a As a Peer Mentor (Likeperson)
I want the Benefit Calculator screen to be fully narrated by my screen reader, with all metric values and benefit results announced in clear, plain language
So that I can understand my volunteer impact even if I have a visual impairment or use assistive technology, without requiring help from another person
- Given VoiceOver or TalkBack is active, When the benefit-calculator-screen loads and calculation completes, Then the live-region-announcer announces 'Calculation complete. Your estimated volunteer benefit for [period] is [value]'
- Given a screen reader user navigates through benefit-metric-tile components, When each tile receives focus, Then the semantics label provides full context including activity type name, count, hours, and benefit value in a single coherent sentence
- Given the screen-reader-detection-service detects active assistive technology, When decorative animations are present in the results card, Then animations are suppressed or reduced to avoid distraction for screen reader users
- +2 more
As a As a Peer Mentor (Likeperson)
I want to open the Benefit Calculator and see the total estimated value my volunteer work has contributed over a selected period
So that I can understand and feel proud of the real impact my efforts have made, expressed in concrete and motivating metrics
- 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
- +2 more