Receive Real-Time Notifications for Claims Requiring Approval
When a peer mentor submits an expense claim that exceeds the automatic approval threshold, the system must notify all coordinators responsible for that peer mentor's chapter or organizational unit. Notifications must be actionable — tapping the notification deep-links directly to the claim detail screen. The notification must clearly identify the claimant and the claim amount so the coordinator can triage urgency without opening the app. In-app notification badges on the queue tab must also increment to reflect the pending count.
User Story
Acceptance Criteria
- Given a peer mentor submits an expense claim above the threshold, when the claim is persisted, then a push notification is sent to all coordinators associated with that peer mentor's organizational unit within 30 seconds
- Given the coordinator receives the push notification, when they tap it, then the app opens directly to the claim detail screen for that specific claim
- Given a push notification is sent, when the coordinator views it, then the notification text includes the peer mentor's name and the total claim amount
- Given the coordinator has the app open, when a new claim is submitted, then an in-app banner notification appears and the attestation queue tab badge increments
- Given a claim is auto-approved below threshold, when it is processed, then no push notification is sent to coordinators for that claim
Business Value
Prompt notification of pending approvals directly reduces the reimbursement cycle time, which is a key factor in peer mentor satisfaction and retention. Without proactive notification, claims can sit unreviewed for days, creating frustration among volunteer peer mentors who may have paid out-of-pocket expenses and are awaiting reimbursement.
Components
- Approval Status Notification Service service
- Push Notification Service infrastructure
- Notification Deep Link Handler service
- Supabase Realtime Approval Subscription infrastructure
- Threshold Evaluation Service service
- Notification Badge Widget ui
- FCM Token Manager infrastructure
Dependencies
- Review Pending Expense Claims Queue critical