How getcollectrx/collect-rx works
CollectRx is a dental-practice SaaS for automating insurance-carrier follow-up, not patient collections or payment negotiation. The main workflow is practice CSV intake, claim validation and import, work prioritization, carrier follow-up, then recording outcomes and managing recovery. The product also supports pre-treatment eligibility estimates, practice dashboards, account access and SaaS billing. The README identifies Collect-RX-main as canonical and CSV as the supported intake; the root src stack is a prototype. Some UI-to-API and unsampled subsystem connections are therefore left unverified.
Main entry points: priorityEngine.ts Priority scoring · adapter.ts Carrier adapter · rulesEngine.ts Scheduled orchestration · pmsImportPipeline.ts Claim import
Components 18
Practice app
- CSV intake
Collect-RX-main/src/pages/CsvImportPage.tsx - Practice dashboard
Collect-RX-main/src/pages/Dashboard.tsx
Claims workflow
- Claim import
Collect-RX-main/src/server/pms/pmsImportPipeline.ts - Work queue
Collect-RX-main/src/server/services/workQueueService.ts - Priority scoring
Collect-RX-main/src/server/services/priorityEngine.ts - Call outcomes
Collect-RX-main/src/outcome/processor.ts - Claim recovery
Collect-RX-main/src/server/recovery/recoveryLoopService.ts - Pre-visit estimates
Collect-RX-main/src/services/eligibility/engine.ts
Follow-up automation
- Desk dispatch
Collect-RX-main/src/server/frontDesk/queueEngine.ts - Carrier adapter
Collect-RX-main/src/carriers/adapter.ts - Voice calls
Collect-RX-main/src/vapi/client.ts - Scheduled orchestration
Collect-RX-main/src/server/rulesEngine.ts
Platform services
- Authentication
Collect-RX-main/src/server/routes/authRoutes.ts - Billing tiers
Collect-RX-main/src/billing/tiers.ts - PostgreSQL data
Collect-RX-main/src/server/db/rlsContext.ts - Audit logging
Collect-RX-main/src/server/audit/auditLog.ts - PHI vault
Collect-RX-main/src/pii-vault.ts
Other components
- Practice staff
Connections 19
- Practice staff → CSV intake: uploads CSV
- CSV intake → Claim import: submits claims
- Claim import → Work queue: syncs work items
Collect-RX-main/src/server/pms/pmsImportPipeline.ts - Claim import → PostgreSQL data: imports claims
Collect-RX-main/src/server/pms/pmsImportPipeline.ts - Work queue → Priority scoring: uses priority
Collect-RX-main/src/server/services/workQueueService.ts - Scheduled orchestration → Priority scoring: syncs scheduling
Collect-RX-main/src/server/rulesEngine.ts - Scheduled orchestration → Work queue: syncs work
Collect-RX-main/src/server/rulesEngine.ts - Desk dispatch → Carrier adapter: dispatch checks
Collect-RX-main/src/server/frontDesk/queueEngine.ts - Desk dispatch → Voice calls: dispatches calls
Collect-RX-main/src/server/frontDesk/queueEngine.ts - Scheduled orchestration → Claim recovery: processes due traces
Collect-RX-main/src/server/rulesEngine.ts - Practice staff → Pre-visit estimates: requests estimate
- Practice staff → Practice dashboard: views status
- Practice staff → Authentication: signs in
- Authentication → Billing tiers: checks subscription
Collect-RX-main/src/server/routes/authRoutes.ts - Priority scoring → Carrier adapter: reads carrier rules
Collect-RX-main/src/server/services/priorityEngine.ts - Carrier adapter → Voice calls: uses voice client
Collect-RX-main/src/carriers/adapter.ts - Carrier adapter → PostgreSQL data: checks dispatch blocks
Collect-RX-main/src/carriers/adapter.ts - Priority scoring → PHI vault: uses PHI vault
Collect-RX-main/src/server/services/priorityEngine.ts - Priority scoring → Audit logging: records audit
Collect-RX-main/src/server/services/priorityEngine.ts