HIGH story-mileage-reimbursement-entry-coordinator-002 3 pts
3
Story Points
High
Priority
Mileage Reimbursement Entry
Feature

User Story

As a Coordinator
I want to see the calculated reimbursement amount update live as I type in the distance or route
So that I can verify the claim is correct before submitting and avoid disputes or correction requests later

Acceptance Criteria

  • Given I am on the mileage entry form and the org rate has been loaded, When I type or adjust the distance value, Then the reimbursement amount updates in real time without requiring a separate action
  • Given the organization uses a custom per-km rate configured in the org rate config repository, When the calculation runs, Then the displayed amount reflects that organization's specific rate, not a hardcoded default
  • Given the distance field is empty or contains an invalid value, When the calculation would produce NaN or a negative result, Then the reimbursement display shows zero or a clear placeholder rather than an error
  • Given the rate data cannot be fetched (e.g., offline), When the form loads, Then a cached rate from the local distance cache is used and a subtle indicator informs the user the rate may be from cache
  • Given the calculated amount is displayed, When the user reviews the form, Then the rate breakdown (rate × distance = total) is visible to confirm the calculation basis

Business Value

Real-time feedback eliminates the most common source of reimbursement errors — mentors submitting incorrect distances because they could not verify the total before submission. This reduces coordinator correction overhead and increases mentor confidence in the system, supporting adoption among the target demographic which includes users with varying digital literacy levels.