# senthil221/prospect-sync architecture

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

- Interactive diagram: https://gitdiagram.com/senthil221/prospect-sync
- Repository: https://github.com/senthil221/prospect-sync

## Overview

Prospect Sync is a team workspace for managing a shared prospect and company database, with client lists preserving import provenance. The main workflow is importing client CSVs, linking rows to master records, then searching and filtering scoped People and Company workspaces, selecting results, and exporting or adding people to lists. Other major capabilities include title classification, email-provider detection, ICP validation, email verification, integrations, blocklists, and operational monitoring. Several feature paths are unsampled; those nodes reflect README capabilities and the repository tree, while edges are limited to documented or excerpted relationships.

Main entry points: [`app/api/prospects/route.ts`](https://github.com/senthil221/prospect-sync/blob/main/app/api/prospects/route.ts) (People queries), [`lib/supabase/admin.ts`](https://github.com/senthil221/prospect-sync/blob/main/lib/supabase/admin.ts) (Supabase database), [`app/api/companies/route.ts`](https://github.com/senthil221/prospect-sync/blob/main/app/api/companies/route.ts) (Company queries), [`app/components/ClientsPanel.tsx`](https://github.com/senthil221/prospect-sync/blob/main/app/components/ClientsPanel.tsx) (Client workspaces)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workspace["Workspace"]
  node_dashboard["Workspace UI<br/>[DashboardUi.tsx]"]
  node_clientwork["Client workspaces<br/>[ClientsPanel.tsx]"]
  node_peopleui["People workspace<br/>[ProspectTable.tsx]"]
  node_companyui["Company workspace"]
end

subgraph group_data["Data operations"]
  node_imports["CSV imports"]
  node_importworker["Import processing<br/>[import-worker.mjs]"]
  node_prospectsapi["People queries<br/>[route.ts]"]
  node_companiesapi["Company queries<br/>[route.ts]"]
  node_filters["Search and filters"]
  node_filtersets["Saved filter sets<br/>[filter-sets.ts]"]
  node_resultsets["Frozen result sets<br/>[result-sets.ts]"]
  node_exports["Exports<br/>[route.ts]"]
end

subgraph group_quality["Data quality"]
  node_titleclass["Title classifier<br/>[title-taxonomy.ts]"]
  node_providerdetect["Email provider scan<br/>[route.ts]"]
  node_coverage["Coverage reporting<br/>[route.ts]"]
  node_icp["ICP validation<br/>[route.ts]"]
end

subgraph group_engagement["Email operations"]
  node_verification["Email verification"]
  node_integrations["ESP integrations<br/>[route.ts]"]
  node_blocklists["Blocklists<br/>[route.ts]"]
end

subgraph group_platform["Platform services"]
  node_database[("Supabase database<br/>[admin.ts]")]
  node_auth["User authorization<br/>[auth.ts]"]
  node_observability["Operations monitoring<br/>[observability.ts]"]
end

node_team(("Agency team"))

node_team -->|"uses"| node_dashboard
node_dashboard -->|"opens"| node_clientwork
node_clientwork -->|"renders"| node_peopleui
node_clientwork -->|"renders"| node_companyui
node_team -->|"uploads CSV"| node_imports
node_imports -.->|"processes upload"| node_importworker
node_importworker -.->|"writes records"| node_database
node_peopleui -.->|"queries people"| node_prospectsapi
node_companyui -.->|"queries companies"| node_companiesapi
node_prospectsapi -->|"parses filters"| node_filters
node_companiesapi -->|"parses filters"| node_filters
node_prospectsapi -->|"queries records"| node_database
node_companiesapi -->|"queries records"| node_database
node_companiesapi -->|"checks ownership"| node_filtersets
node_filters -->|"resolves saved sets"| node_filtersets
node_team -->|"requests export"| node_exports
node_exports -.->|"reads matching data"| node_database
node_team -->|"uses classifications"| node_titleclass
node_team -->|"scans domains"| node_providerdetect
node_team -->|"reviews coverage"| node_coverage
node_team -.->|"validates ICP"| node_icp
node_team -.->|"verifies email"| node_verification
node_team -->|"manages integrations"| node_integrations
node_team -.->|"manages blocklists"| node_blocklists
node_prospectsapi -->|"uses result sets"| node_resultsets
node_team -->|"signs in"| node_auth
node_prospectsapi -->|"authorizes request"| node_auth
node_integrations -->|"stores connection"| node_database
node_team -.->|"reviews operations"| node_observability

click node_dashboard "https://github.com/senthil221/prospect-sync/blob/main/app/components/DashboardUi.tsx"
click node_clientwork "https://github.com/senthil221/prospect-sync/blob/main/app/components/ClientsPanel.tsx"
click node_peopleui "https://github.com/senthil221/prospect-sync/blob/main/app/components/ProspectTable.tsx"
click node_companyui "https://github.com/senthil221/prospect-sync/blob/main/app/components/CompaniesWorkspace.tsx"
click node_imports "https://github.com/senthil221/prospect-sync/tree/main/app/api/imports"
click node_importworker "https://github.com/senthil221/prospect-sync/blob/main/worker/import-worker.mjs"
click node_prospectsapi "https://github.com/senthil221/prospect-sync/blob/main/app/api/prospects/route.ts"
click node_companiesapi "https://github.com/senthil221/prospect-sync/blob/main/app/api/companies/route.ts"
click node_filters "https://github.com/senthil221/prospect-sync/blob/main/lib/prospect-filters.ts"
click node_filtersets "https://github.com/senthil221/prospect-sync/blob/main/lib/filter-sets.ts"
click node_resultsets "https://github.com/senthil221/prospect-sync/blob/main/lib/result-sets.ts"
click node_exports "https://github.com/senthil221/prospect-sync/blob/main/app/api/exports/route.ts"
click node_database "https://github.com/senthil221/prospect-sync/blob/main/lib/supabase/admin.ts"
click node_titleclass "https://github.com/senthil221/prospect-sync/blob/main/lib/title-taxonomy.ts"
click node_providerdetect "https://github.com/senthil221/prospect-sync/blob/main/app/api/email-providers/scan/route.ts"
click node_coverage "https://github.com/senthil221/prospect-sync/blob/main/app/api/coverage/route.ts"
click node_icp "https://github.com/senthil221/prospect-sync/blob/main/app/api/icp-checks/route.ts"
click node_verification "https://github.com/senthil221/prospect-sync/blob/main/worker/verification-worker.mjs"
click node_integrations "https://github.com/senthil221/prospect-sync/blob/main/app/api/integrations/route.ts"
click node_blocklists "https://github.com/senthil221/prospect-sync/blob/main/app/api/clients/%5Bid%5D/blocklist/route.ts"
click node_auth "https://github.com/senthil221/prospect-sync/blob/main/lib/auth.ts"
click node_observability "https://github.com/senthil221/prospect-sync/blob/main/lib/observability.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_dashboard,node_clientwork,node_peopleui,node_companyui toneBlue
class node_imports,node_importworker,node_prospectsapi,node_companiesapi,node_filters,node_filtersets,node_resultsets,node_exports toneAmber
class node_titleclass,node_providerdetect,node_coverage,node_icp toneMint
class node_verification,node_integrations,node_blocklists toneRose
class node_database,node_auth,node_observability,node_team toneIndigo
```

## Components

### Workspace

- [Workspace UI](https://github.com/senthil221/prospect-sync/blob/main/app/components/DashboardUi.tsx): `app/components/DashboardUi.tsx`
- [Client workspaces](https://github.com/senthil221/prospect-sync/blob/main/app/components/ClientsPanel.tsx): `app/components/ClientsPanel.tsx`
- [People workspace](https://github.com/senthil221/prospect-sync/blob/main/app/components/ProspectTable.tsx): `app/components/ProspectTable.tsx`
- [Company workspace](https://github.com/senthil221/prospect-sync/blob/main/app/components/CompaniesWorkspace.tsx): `app/components/CompaniesWorkspace.tsx`

### Data operations

- [CSV imports](https://github.com/senthil221/prospect-sync/tree/main/app/api/imports): `app/api/imports`
- [Import processing](https://github.com/senthil221/prospect-sync/blob/main/worker/import-worker.mjs): `worker/import-worker.mjs`
- [People queries](https://github.com/senthil221/prospect-sync/blob/main/app/api/prospects/route.ts): `app/api/prospects/route.ts`
- [Company queries](https://github.com/senthil221/prospect-sync/blob/main/app/api/companies/route.ts): `app/api/companies/route.ts`
- [Search and filters](https://github.com/senthil221/prospect-sync/blob/main/lib/prospect-filters.ts): `lib/prospect-filters.ts`
- [Saved filter sets](https://github.com/senthil221/prospect-sync/blob/main/lib/filter-sets.ts): `lib/filter-sets.ts`
- [Frozen result sets](https://github.com/senthil221/prospect-sync/blob/main/lib/result-sets.ts): `lib/result-sets.ts`
- [Exports](https://github.com/senthil221/prospect-sync/blob/main/app/api/exports/route.ts): `app/api/exports/route.ts`

### Data quality

- [Title classifier](https://github.com/senthil221/prospect-sync/blob/main/lib/title-taxonomy.ts): `lib/title-taxonomy.ts`
- [Email provider scan](https://github.com/senthil221/prospect-sync/blob/main/app/api/email-providers/scan/route.ts): `app/api/email-providers/scan/route.ts`
- [Coverage reporting](https://github.com/senthil221/prospect-sync/blob/main/app/api/coverage/route.ts): `app/api/coverage/route.ts`
- [ICP validation](https://github.com/senthil221/prospect-sync/blob/main/app/api/icp-checks/route.ts): `app/api/icp-checks/route.ts`

### Email operations

- [Email verification](https://github.com/senthil221/prospect-sync/blob/main/worker/verification-worker.mjs): `worker/verification-worker.mjs`
- [ESP integrations](https://github.com/senthil221/prospect-sync/blob/main/app/api/integrations/route.ts): `app/api/integrations/route.ts`
- [Blocklists](https://github.com/senthil221/prospect-sync/blob/main/app/api/clients/%5Bid%5D/blocklist/route.ts): `app/api/clients/[id]/blocklist/route.ts`

### Platform services

- [Supabase database](https://github.com/senthil221/prospect-sync/blob/main/lib/supabase/admin.ts): `lib/supabase/admin.ts`
- [User authorization](https://github.com/senthil221/prospect-sync/blob/main/lib/auth.ts): `lib/auth.ts`
- [Operations monitoring](https://github.com/senthil221/prospect-sync/blob/main/lib/observability.ts): `lib/observability.ts`

### Other components

- **Agency team**

## Connections

- Agency team → Workspace UI: uses (evidence: `README.md`)
- Workspace UI → Client workspaces: opens (evidence: `app/components/DashboardUi.tsx`)
- Client workspaces → People workspace: renders (evidence: `app/components/ClientsPanel.tsx`)
- Client workspaces → Company workspace: renders (evidence: `app/components/ClientsPanel.tsx`)
- Agency team → CSV imports: uploads CSV (evidence: `README.md`)
- CSV imports → Import processing: processes upload
- Import processing → Supabase database: writes records
- People workspace → People queries: queries people
- Company workspace → Company queries: queries companies
- People queries → Search and filters: parses filters (evidence: `app/api/prospects/route.ts`)
- Company queries → Search and filters: parses filters (evidence: `app/api/companies/route.ts`)
- People queries → Supabase database: queries records (evidence: `app/api/prospects/route.ts`)
- Company queries → Supabase database: queries records (evidence: `app/api/companies/route.ts`)
- Company queries → Saved filter sets: checks ownership (evidence: `app/api/companies/route.ts`)
- Search and filters → Saved filter sets: resolves saved sets (evidence: `lib/filter-sets.ts`)
- Agency team → Exports: requests export (evidence: `README.md`)
- Exports → Supabase database: reads matching data (evidence: `app/api/exports/route.ts`)
- Agency team → Title classifier: uses classifications (evidence: `README.md`)
- Agency team → Email provider scan: scans domains (evidence: `README.md`)
- Agency team → Coverage reporting: reviews coverage (evidence: `README.md`)
- Agency team → ICP validation: validates ICP
- Agency team → Email verification: verifies email
- Agency team → ESP integrations: manages integrations (evidence: `app/api/integrations/route.ts`)
- Agency team → Blocklists: manages blocklists
- People queries → Frozen result sets: uses result sets (evidence: `app/api/prospects/route.ts`)
- Agency team → User authorization: signs in (evidence: `README.md`)
- People queries → User authorization: authorizes request (evidence: `app/api/prospects/route.ts`)
- ESP integrations → Supabase database: stores connection (evidence: `app/api/integrations/route.ts`)
- Agency team → Operations monitoring: reviews operations
