# getcollectrx/collect-rx architecture

> Architecture diagram of the GitHub repository getcollectrx/collect-rx, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/getcollectrx/collect-rx
- Repository: https://github.com/getcollectrx/collect-rx

## Overview

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: [`Collect-RX-main/src/server/services/priorityEngine.ts`](https://github.com/getcollectrx/collect-rx/blob/main/Collect-RX-main/src/server/services/priorityEngine.ts) (Priority scoring), [`Collect-RX-main/src/carriers/adapter.ts`](https://github.com/getcollectrx/collect-rx/blob/main/Collect-RX-main/src/carriers/adapter.ts) (Carrier adapter), [`Collect-RX-main/src/server/rulesEngine.ts`](https://github.com/getcollectrx/collect-rx/blob/main/Collect-RX-main/src/server/rulesEngine.ts) (Scheduled orchestration), [`Collect-RX-main/src/server/pms/pmsImportPipeline.ts`](https://github.com/getcollectrx/collect-rx/blob/main/Collect-RX-main/src/server/pms/pmsImportPipeline.ts) (Claim import)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_practice["Practice app"]
  node_csv["CSV intake<br/>[CsvImportPage.tsx]"]
  node_dashboard["Practice dashboard<br/>[Dashboard.tsx]"]
end

subgraph group_claims["Claims workflow"]
  node_import["Claim import"]
  node_work["Work queue"]
  node_priority["Priority scoring<br/>[priorityEngine.ts]"]
  node_outcome["Call outcomes<br/>[processor.ts]"]
  node_recovery["Claim recovery"]
  node_previsit["Pre-visit estimates<br/>[engine.ts]"]
end

subgraph group_automation["Follow-up automation"]
  node_queueengine["Desk dispatch<br/>[queueEngine.ts]"]
  node_carrier["Carrier adapter<br/>[adapter.ts]"]
  node_vapi["Voice calls<br/>[client.ts]"]
  node_rules["Scheduled orchestration<br/>[rulesEngine.ts]"]
end

subgraph group_platform["Platform services"]
  node_auth["Authentication<br/>[authRoutes.ts]"]
  node_tiers["Billing tiers<br/>[tiers.ts]"]
  node_db[("PostgreSQL data<br/>[rlsContext.ts]")]
  node_audit["Audit logging<br/>[auditLog.ts]"]
  node_pii["PHI vault<br/>[pii-vault.ts]"]
end

node_staff(("Practice staff"))

node_staff -->|"uploads CSV"| node_csv
node_csv -.->|"submits claims"| node_import
node_import -->|"syncs work items"| node_work
node_import -->|"imports claims"| node_db
node_work -->|"uses priority"| node_priority
node_rules -->|"syncs scheduling"| node_priority
node_rules -->|"syncs work"| node_work
node_queueengine -->|"dispatch checks"| node_carrier
node_queueengine -->|"dispatches calls"| node_vapi
node_rules -->|"processes due traces"| node_recovery
node_staff -.->|"requests estimate"| node_previsit
node_staff -.->|"views status"| node_dashboard
node_staff -.->|"signs in"| node_auth
node_auth -->|"checks subscription"| node_tiers
node_priority -->|"reads carrier rules"| node_carrier
node_carrier -->|"uses voice client"| node_vapi
node_carrier -->|"checks dispatch blocks"| node_db
node_priority -->|"uses PHI vault"| node_pii
node_priority -->|"records audit"| node_audit

click node_csv "https://github.com/getcollectrx/collect-rx/blob/main/Collect-RX-main/src/pages/CsvImportPage.tsx"
click node_import "https://github.com/getcollectrx/collect-rx/blob/main/Collect-RX-main/src/server/pms/pmsImportPipeline.ts"
click node_work "https://github.com/getcollectrx/collect-rx/blob/main/Collect-RX-main/src/server/services/workQueueService.ts"
click node_priority "https://github.com/getcollectrx/collect-rx/blob/main/Collect-RX-main/src/server/services/priorityEngine.ts"
click node_queueengine "https://github.com/getcollectrx/collect-rx/blob/main/Collect-RX-main/src/server/frontDesk/queueEngine.ts"
click node_carrier "https://github.com/getcollectrx/collect-rx/blob/main/Collect-RX-main/src/carriers/adapter.ts"
click node_vapi "https://github.com/getcollectrx/collect-rx/blob/main/Collect-RX-main/src/vapi/client.ts"
click node_outcome "https://github.com/getcollectrx/collect-rx/blob/main/Collect-RX-main/src/outcome/processor.ts"
click node_recovery "https://github.com/getcollectrx/collect-rx/blob/main/Collect-RX-main/src/server/recovery/recoveryLoopService.ts"
click node_previsit "https://github.com/getcollectrx/collect-rx/blob/main/Collect-RX-main/src/services/eligibility/engine.ts"
click node_dashboard "https://github.com/getcollectrx/collect-rx/blob/main/Collect-RX-main/src/pages/Dashboard.tsx"
click node_auth "https://github.com/getcollectrx/collect-rx/blob/main/Collect-RX-main/src/server/routes/authRoutes.ts"
click node_tiers "https://github.com/getcollectrx/collect-rx/blob/main/Collect-RX-main/src/billing/tiers.ts"
click node_db "https://github.com/getcollectrx/collect-rx/blob/main/Collect-RX-main/src/server/db/rlsContext.ts"
click node_audit "https://github.com/getcollectrx/collect-rx/blob/main/Collect-RX-main/src/server/audit/auditLog.ts"
click node_pii "https://github.com/getcollectrx/collect-rx/blob/main/Collect-RX-main/src/pii-vault.ts"
click node_rules "https://github.com/getcollectrx/collect-rx/blob/main/Collect-RX-main/src/server/rulesEngine.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_csv,node_dashboard toneBlue
class node_import,node_work,node_priority,node_outcome,node_recovery,node_previsit toneAmber
class node_queueengine,node_carrier,node_vapi,node_rules toneMint
class node_auth,node_tiers,node_db,node_audit,node_pii toneRose
class node_staff toneIndigo
```

## Components

### Practice app

- [CSV intake](https://github.com/getcollectrx/collect-rx/blob/main/Collect-RX-main/src/pages/CsvImportPage.tsx): `Collect-RX-main/src/pages/CsvImportPage.tsx`
- [Practice dashboard](https://github.com/getcollectrx/collect-rx/blob/main/Collect-RX-main/src/pages/Dashboard.tsx): `Collect-RX-main/src/pages/Dashboard.tsx`

### Claims workflow

- [Claim import](https://github.com/getcollectrx/collect-rx/blob/main/Collect-RX-main/src/server/pms/pmsImportPipeline.ts): `Collect-RX-main/src/server/pms/pmsImportPipeline.ts`
- [Work queue](https://github.com/getcollectrx/collect-rx/blob/main/Collect-RX-main/src/server/services/workQueueService.ts): `Collect-RX-main/src/server/services/workQueueService.ts`
- [Priority scoring](https://github.com/getcollectrx/collect-rx/blob/main/Collect-RX-main/src/server/services/priorityEngine.ts): `Collect-RX-main/src/server/services/priorityEngine.ts`
- [Call outcomes](https://github.com/getcollectrx/collect-rx/blob/main/Collect-RX-main/src/outcome/processor.ts): `Collect-RX-main/src/outcome/processor.ts`
- [Claim recovery](https://github.com/getcollectrx/collect-rx/blob/main/Collect-RX-main/src/server/recovery/recoveryLoopService.ts): `Collect-RX-main/src/server/recovery/recoveryLoopService.ts`
- [Pre-visit estimates](https://github.com/getcollectrx/collect-rx/blob/main/Collect-RX-main/src/services/eligibility/engine.ts): `Collect-RX-main/src/services/eligibility/engine.ts`

### Follow-up automation

- [Desk dispatch](https://github.com/getcollectrx/collect-rx/blob/main/Collect-RX-main/src/server/frontDesk/queueEngine.ts): `Collect-RX-main/src/server/frontDesk/queueEngine.ts`
- [Carrier adapter](https://github.com/getcollectrx/collect-rx/blob/main/Collect-RX-main/src/carriers/adapter.ts): `Collect-RX-main/src/carriers/adapter.ts`
- [Voice calls](https://github.com/getcollectrx/collect-rx/blob/main/Collect-RX-main/src/vapi/client.ts): `Collect-RX-main/src/vapi/client.ts`
- [Scheduled orchestration](https://github.com/getcollectrx/collect-rx/blob/main/Collect-RX-main/src/server/rulesEngine.ts): `Collect-RX-main/src/server/rulesEngine.ts`

### Platform services

- [Authentication](https://github.com/getcollectrx/collect-rx/blob/main/Collect-RX-main/src/server/routes/authRoutes.ts): `Collect-RX-main/src/server/routes/authRoutes.ts`
- [Billing tiers](https://github.com/getcollectrx/collect-rx/blob/main/Collect-RX-main/src/billing/tiers.ts): `Collect-RX-main/src/billing/tiers.ts`
- [PostgreSQL data](https://github.com/getcollectrx/collect-rx/blob/main/Collect-RX-main/src/server/db/rlsContext.ts): `Collect-RX-main/src/server/db/rlsContext.ts`
- [Audit logging](https://github.com/getcollectrx/collect-rx/blob/main/Collect-RX-main/src/server/audit/auditLog.ts): `Collect-RX-main/src/server/audit/auditLog.ts`
- [PHI vault](https://github.com/getcollectrx/collect-rx/blob/main/Collect-RX-main/src/pii-vault.ts): `Collect-RX-main/src/pii-vault.ts`

### Other components

- **Practice staff**

## Connections

- Practice staff → CSV intake: uploads CSV
- CSV intake → Claim import: submits claims
- Claim import → Work queue: syncs work items (evidence: `Collect-RX-main/src/server/pms/pmsImportPipeline.ts`)
- Claim import → PostgreSQL data: imports claims (evidence: `Collect-RX-main/src/server/pms/pmsImportPipeline.ts`)
- Work queue → Priority scoring: uses priority (evidence: `Collect-RX-main/src/server/services/workQueueService.ts`)
- Scheduled orchestration → Priority scoring: syncs scheduling (evidence: `Collect-RX-main/src/server/rulesEngine.ts`)
- Scheduled orchestration → Work queue: syncs work (evidence: `Collect-RX-main/src/server/rulesEngine.ts`)
- Desk dispatch → Carrier adapter: dispatch checks (evidence: `Collect-RX-main/src/server/frontDesk/queueEngine.ts`)
- Desk dispatch → Voice calls: dispatches calls (evidence: `Collect-RX-main/src/server/frontDesk/queueEngine.ts`)
- Scheduled orchestration → Claim recovery: processes due traces (evidence: `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 (evidence: `Collect-RX-main/src/server/routes/authRoutes.ts`)
- Priority scoring → Carrier adapter: reads carrier rules (evidence: `Collect-RX-main/src/server/services/priorityEngine.ts`)
- Carrier adapter → Voice calls: uses voice client (evidence: `Collect-RX-main/src/carriers/adapter.ts`)
- Carrier adapter → PostgreSQL data: checks dispatch blocks (evidence: `Collect-RX-main/src/carriers/adapter.ts`)
- Priority scoring → PHI vault: uses PHI vault (evidence: `Collect-RX-main/src/server/services/priorityEngine.ts`)
- Priority scoring → Audit logging: records audit (evidence: `Collect-RX-main/src/server/services/priorityEngine.ts`)
