Access Benefit Calculator via Accessible Navigation Path
The Benefit Calculator must be discoverable and reachable through the standard app navigation with minimal cognitive effort. It should be accessible from the home screen via a visible entry point (e.g., a stat card or quick-action button) and from the Work or Tools tab. The accessible-bottom-navigation and labelled-navigation-bar components must include properly labelled navigation targets. For screen reader users, the navigation path must be announced clearly. The route is protected by a role-route-guard ensuring only peer mentor and coordinator roles can access it. The benefit-calculator-bloc initializes with the default period (current year) on first load, so the peer mentor sees immediately relevant data without having to configure anything first.
User Story
Acceptance Criteria
- 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
- Given a user with a role other than peer mentor or coordinator attempts to access the calculator route directly, When the role-route-guard evaluates the request, Then the user is redirected to the no-access screen with a plain-language explanation
- Given the benefit-calculator-bloc initializes for the first time, When no prior period selection is stored, Then the default period is set to the current calendar year and the calculation starts automatically
Business Value
Feature discoverability is the first barrier to engagement. If peer mentors cannot find the Benefit Calculator within two taps, adoption rates drop significantly — especially among older or less digitally confident users, who are a core demographic for NHF and HLF. Ensuring the feature is reachable through the primary navigation with accessible labels and correct role-gating means the right users can access it immediately without friction, maximizing the motivational and retention impact the feature is designed to deliver.
Components
- Benefit Calculator Screen ui
- Benefit Calculator BLoC infrastructure
- Accessible Bottom Navigation ui
- Labelled Navigation Bar ui
- Role-Based Route Guard infrastructure
- Organization Labels Provider infrastructure
- Benefit Calculation Service service
- Benefit Calculation Result Model data