Monitor Integration Health and Receive Failure Alerts
The integration health monitor continuously checks reachability and authentication status of the connected accounting system. Coordinators see a status indicator on the integration dashboard showing last successful contact, current connection state, and any active error conditions. When an export fails or the connection drops, the app sends a notification to the coordinator. The health monitor runs periodic lightweight pings via the integration edge function and records results in the organization integration repository.
User Story
Acceptance Criteria
- Given the accounting integration is configured, when the coordinator opens the integration dashboard, then they see a health indicator showing Connected, Degraded, or Error with a last-checked timestamp
- Given the accounting system returns an authentication error during a scheduled health check, when the error is detected, then the coordinator receives an in-app notification and the dashboard shows an Error state with guidance to check credentials
- Given an export edge function call fails due to a network timeout, when the failure is logged, then the export run is marked as failed in the export-run-repository and the coordinator is notified
- Given the connection is restored after an outage, when the next health check succeeds, then the status automatically transitions back to Connected without manual intervention
- Given a coordinator dismisses a failure alert, when they later open the integration dashboard, then the failure remains visible in the health history until the underlying issue is resolved
Business Value
Silent integration failures mean reimbursements silently accumulate without being processed, leading to frustrated volunteers and cash-flow issues for organizations. Proactive health monitoring turns invisible failures into actionable alerts, protecting the reliability of the reimbursement pipeline and maintaining volunteer trust in the organization's ability to compensate them promptly.
Components
- Integration Health Monitor service
- Integration Edge Functions infrastructure
- Organization Integration Repository data
- Supabase Edge Function: Generate Export infrastructure
- Export Run Repository data
- Push Notification Service infrastructure