Track Expense Claim Approval Status in Real Time
After submitting an expense claim, peer mentors need visibility into its progress through the approval workflow. The app should display a claim status badge (submitted, pending review, approved, rejected) on each claim, show a timeline of status events, and push a notification when the status changes. Claims that were auto-approved should immediately show an approved status. Real-time updates via Supabase subscriptions should reflect coordinator actions without requiring the user to manually refresh.
User Story
Acceptance Criteria
- Given I have submitted an expense claim, when I view my expense history, then each claim shows a status badge indicating its current state
- Given I open a specific claim, when the detail view loads, then a status timeline is displayed showing each status change with timestamps
- Given a coordinator approves or rejects my claim, when the action is processed, then my app updates the claim status in real time without requiring a manual refresh
- Given my claim is auto-approved, when the submission completes, then the status immediately shows 'Approved' and no coordinator action is pending
- Given my claim is rejected, when I view the detail, then the rejection reason provided by the coordinator is displayed
- Given a status change occurs, when I have notifications enabled, then I receive a push notification informing me of the update
Business Value
Transparency in the approval process reduces the number of status inquiry messages coordinators receive and gives peer mentors confidence that their claims are being processed. Real-time status updates reinforce trust in the system and reduce the perception that submitted claims are lost, which is a common reason volunteers stop claiming reimbursement.
Components
- Expense Summary Card ui
- Claim Status Audit Timeline ui
- Claim Status Badge ui
- Claim Events Repository data
- Expense Claim Status Repository data
- Supabase Realtime Approval Subscription infrastructure
- Approval Status Notification Service service
- Expense Repository data