# rajeshcode-boy/colddesk architecture

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

- Interactive diagram: https://gitdiagram.com/rajeshcode-boy/colddesk
- Repository: https://github.com/rajeshcode-boy/colddesk

## Overview

ColdDesk is a company-managed prospecting and email sequencing application. Employees sign in, work assigned projects, add prospects to the shared contact database, and manage resulting leads and notifications; admins additionally manage senders, employees, suppression, and audits. The server owns authorization, project and contact operations, scheduled sending, reply handling, and persistence. The README documents these product capabilities, while excerpts show only parts of the client and server, so unsampled feature links are omitted rather than inferred.

Main entry points: [`server.js`](https://github.com/rajeshcode-boy/colddesk/blob/main/server.js) (SQLite database), [`public/js/app.js`](https://github.com/rajeshcode-boy/colddesk/blob/main/public/js/app.js) (Workspace UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Employee workspace"]
  node_workspace["Workspace UI<br/>[app.js]"]
end

subgraph group_operations["Prospecting operations"]
  node_auth["Account access<br/>[server.js]"]
  node_projects["Projects and sequences<br/>[server.js]"]
  node_contacts["Master contacts<br/>[server.js]"]
  node_assignments["Project assignments<br/>[server.js]"]
  node_leads["Leads and notifications<br/>[server.js]"]
end

subgraph group_sequencing["Sequence execution"]
  node_scheduler["Scheduled sending<br/>[server.js]"]
  node_gmail{{"Gmail API"}}
  node_replies["Reply and bounce sync<br/>[server.js]"]
end

subgraph group_admin["Administration and reporting"]
  node_sender_admin["Sender management<br/>[server.js]"]
  node_employee_admin["Employee management<br/>[server.js]"]
  node_suppression["Suppression and audit<br/>[server.js]"]
  node_analytics["Project analytics<br/>[server.js]"]
end

subgraph group_storage["Application state"]
  node_database[("SQLite database<br/>[server.js]")]
end

node_employee(("Employee"))
node_admin_actor(("Super Admin"))

node_employee -->|"uses"| node_workspace
node_admin_actor -->|"uses"| node_workspace
node_workspace -->|"requests access"| node_auth
node_workspace -->|"requests projects"| node_projects
node_workspace -->|"manages prospects"| node_contacts
node_workspace -->|"views leads"| node_leads
node_workspace -->|"requests analytics"| node_analytics
node_projects -->|"reads and writes"| node_database
node_contacts -->|"reads and writes"| node_database
node_assignments -->|"reads and writes"| node_database
node_leads -->|"reads and writes"| node_database
node_scheduler -->|"reads and writes"| node_database
node_scheduler -.->|"sends email"| node_gmail
node_replies -.->|"syncs messages"| node_gmail
node_replies -.->|"creates leads"| node_leads
node_scheduler -.->|"advances stages"| node_assignments
node_admin_actor -->|"manages senders"| node_sender_admin
node_admin_actor -->|"manages employees"| node_employee_admin
node_admin_actor -->|"controls suppression"| node_suppression
node_admin_actor -->|"reviews metrics"| node_analytics
node_sender_admin -.->|"stores sender settings"| node_database
node_employee_admin -.->|"stores accounts"| node_database
node_suppression -.->|"stores audit state"| node_database
node_analytics -.->|"reads metrics"| node_database

click node_workspace "https://github.com/rajeshcode-boy/colddesk/blob/main/public/js/app.js"
click node_auth "https://github.com/rajeshcode-boy/colddesk/blob/main/server.js"
click node_projects "https://github.com/rajeshcode-boy/colddesk/blob/main/server.js"
click node_contacts "https://github.com/rajeshcode-boy/colddesk/blob/main/server.js"
click node_assignments "https://github.com/rajeshcode-boy/colddesk/blob/main/server.js"
click node_leads "https://github.com/rajeshcode-boy/colddesk/blob/main/server.js"
click node_scheduler "https://github.com/rajeshcode-boy/colddesk/blob/main/server.js"
click node_replies "https://github.com/rajeshcode-boy/colddesk/blob/main/server.js"
click node_sender_admin "https://github.com/rajeshcode-boy/colddesk/blob/main/server.js"
click node_employee_admin "https://github.com/rajeshcode-boy/colddesk/blob/main/server.js"
click node_suppression "https://github.com/rajeshcode-boy/colddesk/blob/main/server.js"
click node_analytics "https://github.com/rajeshcode-boy/colddesk/blob/main/server.js"
click node_database "https://github.com/rajeshcode-boy/colddesk/blob/main/server.js"

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_workspace toneBlue
class node_auth,node_projects,node_contacts,node_assignments,node_leads toneAmber
class node_scheduler,node_gmail,node_replies toneMint
class node_sender_admin,node_employee_admin,node_suppression,node_analytics toneRose
class node_database,node_employee,node_admin_actor toneIndigo
```

## Components

### Employee workspace

- [Workspace UI](https://github.com/rajeshcode-boy/colddesk/blob/main/public/js/app.js): `public/js/app.js`

### Prospecting operations

- [Account access](https://github.com/rajeshcode-boy/colddesk/blob/main/server.js): `server.js`
- [Projects and sequences](https://github.com/rajeshcode-boy/colddesk/blob/main/server.js): `server.js`
- [Master contacts](https://github.com/rajeshcode-boy/colddesk/blob/main/server.js): `server.js`
- [Project assignments](https://github.com/rajeshcode-boy/colddesk/blob/main/server.js): `server.js`
- [Leads and notifications](https://github.com/rajeshcode-boy/colddesk/blob/main/server.js): `server.js`

### Sequence execution

- [Scheduled sending](https://github.com/rajeshcode-boy/colddesk/blob/main/server.js): `server.js`
- **Gmail API**
- [Reply and bounce sync](https://github.com/rajeshcode-boy/colddesk/blob/main/server.js): `server.js`

### Administration and reporting

- [Sender management](https://github.com/rajeshcode-boy/colddesk/blob/main/server.js): `server.js`
- [Employee management](https://github.com/rajeshcode-boy/colddesk/blob/main/server.js): `server.js`
- [Suppression and audit](https://github.com/rajeshcode-boy/colddesk/blob/main/server.js): `server.js`
- [Project analytics](https://github.com/rajeshcode-boy/colddesk/blob/main/server.js): `server.js`

### Application state

- [SQLite database](https://github.com/rajeshcode-boy/colddesk/blob/main/server.js): `server.js`

### Other components

- **Employee**
- **Super Admin**

## Connections

- Employee → Workspace UI: uses (evidence: `README.md`)
- Super Admin → Workspace UI: uses (evidence: `README.md`)
- Workspace UI → Account access: requests access (evidence: `public/js/app.js`)
- Workspace UI → Projects and sequences: requests projects (evidence: `public/js/app.js`)
- Workspace UI → Master contacts: manages prospects (evidence: `public/js/app.js`)
- Workspace UI → Leads and notifications: views leads (evidence: `public/js/app.js`)
- Workspace UI → Project analytics: requests analytics (evidence: `public/js/app.js`)
- Projects and sequences → SQLite database: reads and writes (evidence: `server.js`)
- Master contacts → SQLite database: reads and writes (evidence: `server.js`)
- Project assignments → SQLite database: reads and writes (evidence: `server.js`)
- Leads and notifications → SQLite database: reads and writes (evidence: `server.js`)
- Scheduled sending → SQLite database: reads and writes (evidence: `server.js`)
- Scheduled sending → Gmail API: sends email
- Reply and bounce sync → Gmail API: syncs messages
- Reply and bounce sync → Leads and notifications: creates leads (evidence: `server.js`)
- Scheduled sending → Project assignments: advances stages (evidence: `server.js`)
- Super Admin → Sender management: manages senders (evidence: `README.md`)
- Super Admin → Employee management: manages employees (evidence: `README.md`)
- Super Admin → Suppression and audit: controls suppression (evidence: `README.md`)
- Super Admin → Project analytics: reviews metrics (evidence: `README.md`)
- Sender management → SQLite database: stores sender settings (evidence: `server.js`)
- Employee management → SQLite database: stores accounts (evidence: `server.js`)
- Suppression and audit → SQLite database: stores audit state (evidence: `server.js`)
- Project analytics → SQLite database: reads metrics (evidence: `server.js`)
