Advantage Calculator
Feature Detail
Description
The Advantage Calculator helps peer mentors visualize the personal and social benefits of their volunteer contributions. By drawing on logged activity data such as hours volunteered and contacts supported, the calculator produces estimated impact metrics that translate volunteer effort into concrete, shareable insights. The feature motivates continued engagement by making the return on volunteering tangible and understandable for peer mentors at all levels of digital literacy.
Sources & reasoning
Line 353 lists Advantage Calculator within Fase 3 gamification deliverables. Line 365 explicitly confirms it belongs to Achievements & Gamification and follows Fase 3, mapping to v1.1. The feature translates volunteer effort into tangible impact metrics, supporting the platform's core motivation mission across all four partner organizations.
-
docs/source/likeperson.md · line 353- Gamification / «Ditt likepersonsår» (Wrapped, badges, Advantage Calculator)
-
docs/source/likeperson.md · line 365Fordelskalkulator (Advantage Calculator) ligger inne i Achievements & Gamification-området og følger derfor Fase 3.
Analysis
Peer mentors are more likely to remain active when they can see and articulate the value of their contributions. The Advantage Calculator addresses this by translating activity data into human-readable impact metrics. For organizations, the calculator reinforces the program's value proposition during onboarding and retention conversations, giving coordinators a concrete tool for motivating disengaged volunteers. Although classified as could-have, it directly supports the platform's core mission of making volunteer effort visible and meaningful - a goal shared across all four partner organizations.
The calculator is implemented as a Flutter screen that reads aggregated activity data from the personal statistics service and applies configurable calculation rules via AdvantageCalculatorService. The initial version uses static formulas defined in configuration; future iterations may allow per-organization metric customization. No new database tables are required - the feature reads from existing activity aggregates. WCAG 2.2 AA compliance requires all input controls and result displays to be screen-reader accessible with semantic labels and sufficient color contrast.
Quality Assurance
Peer Mentor (primary)Peer Mentor
Quick UAT
- Logg inn i Meander-appen som Likeperson. Naviger til Hjem-fanen og trykk på Prestasjoner-seksjonen eller tilsvarende lenke til Fordelskalkulatoren.
- Bekreft at Fordelskalkulatoren-skjermen åpnes og viser en lasteindikator mens aktivitetsdata hentes.
- Bekreft at beregnede fordelsmålinger vises – for eksempel antall timer frivillig arbeid, antall kontakter støttet, og estimert sosial verdi.
- Trykk på Del-knappen og bekreft at systemdelingsskjermen åpnes med en forhåndsvisning av resultatene.
- Trykk Avbryt for å lukke delingsskjermen og gå tilbake til kalkulatorresultatene uten endringer.
Quick UAT — Accessibility
-
Logg inn i Meander-appen som Likeperson. Naviger til Hjem-fanen og trykk på Prestasjoner-seksjonen eller tilsvarende lenke til Fordelskalkulatoren.
- Screen reader Bunnavigasjonsfanen 'Hjem' annonseres ved fokus; Prestasjoner-lenken annonseres med rolle 'knapp' og merkelapp.
- Keyboard / focus Tab-rekkefølge: bunnnav-tabs → innholdsblokker → Prestasjoner-lenke.
- Touch target Alle bunnnav-elementer og Prestasjoner-lenken er minst 24×24 CSS-piksler.
-
Bekreft at Fordelskalkulatoren-skjermen åpnes og viser en lasteindikator mens aktivitetsdata hentes.
- Screen reader Skjermtittel 'Fordelskalkulator' annonseres ved navigasjon til ny skjerm.
- Live region 'Laster inn dine aktivitetsdata…' annonseres via polite live region under henting.
- Zoom Skjermtittel og lasteindikator er lesbare ved 200 % zoom uten overlapping.
-
Bekreft at beregnede fordelsmålinger vises – for eksempel antall timer frivillig arbeid, antall kontakter støttet, og estimert sosial verdi.
- Screen reader Hvert målingskort annonseres med merkelapp og verdi, f.eks. 'Timer frivillig arbeid: 47 timer'.
- Focus visibility Fokusrekkefølge beveger seg logisk fra øverste målingsverdi nedover kortene.
- Zoom Alle kort og verdier er lesbare og ikke avskåret ved 200 % zoom.
- Contrast Målingstekst og tallverdier oppfyller 4.5:1 kontrast mot bakgrunn; fargekoding supplert med tekstetikett.
-
Trykk på Del-knappen og bekreft at systemdelingsskjermen åpnes med en forhåndsvisning av resultatene.
- Screen reader Del-knapp annonseres som 'Del resultater, knapp'; systemdelingsskjermens tittel annonseres ved åpning.
- Focus visibility Synlig fokusring på Del-knappen; fokus flyttes til systemdelingsdialogen ved åpning.
- Touch target Del-knappen er minst 24×24 CSS-piksler.
-
Trykk Avbryt for å lukke delingsskjermen og gå tilbake til kalkulatorresultatene uten endringer.
- Screen reader Avbryt-knapp annonseres; fokus returnerer til Del-knappen på Fordelskalkulatoren-skjermen.
- Focus visibility Fokus returnerer til Del-knappen etter lukking av dialogboksen (fokushåndtering ved modallukking).
- Touch target Avbryt-knappen i systemdelingsskjermen er minst 24×24 CSS-piksler.
Role Boundaries
3 role(s) must NOT access this feature-
Organization Administrator
Skjermen finnes ikke i Admin Web Portal-navigasjonen; organisasjonsadministratorer logger ikke inn i mobilappen og har ikke tilgang til Fordelskalkulatoren.
-
Global Administrator
Skjermen finnes ikke i Admin Web Portal-navigasjonen; global administrator har ikke tilgang til mobilappens personlige statistikkskjermer.
-
Prospective Organization Representative
Ingen tilgang til mobilappen eller administratorportalen; deep-link returnerer 401.
Expected End State
Fordelskalkulatoren viser oppdaterte personlige fordelsmålinger basert på likepersonens loggede aktivitetsdata. Brukeren kan dele eller lagre resultatene.
Components (26)
Shared Components
These components are reused across multiple features
User Stories
No user stories have been generated for this feature yet.