# veenus-rajpoot/qobocheck architecture

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

- Interactive diagram: https://gitdiagram.com/veenus-rajpoot/qobocheck
- Repository: https://github.com/veenus-rajpoot/qobocheck

## Overview

Qobo CRM is a multi-tenant WhatsApp marketing and omnichannel operations platform. An authenticated user enters the React workstation, selects a domain page, and that page’s API request reaches an Express route, which delegates to a service and returns its result. The documented scope also includes campaigns, templates, messaging, commerce, scheduling, billing, audit logs, and developer tools. Several feature modules are present in the tree but were not sampled; their API-to-service relationships are documented by server route registration, while deeper behavior is not assumed.

Main entry points: [`apps/server/src/index.js`](https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/index.js) (Express API), [`apps/web/src/App.jsx`](https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/web/src/App.jsx) (Workstation router), [`apps/server/src/middlewares/auth.middleware.js`](https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/middlewares/auth.middleware.js) (JWT access), [`apps/server/src/routes/chat.routes.js`](https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/routes/chat.routes.js) (Chat routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["CRM Workstation"]
  node_workstation["Workstation router<br/>[App.jsx]"]
  node_chatui["Live chat<br/>[LiveChat.jsx]"]
  node_contactsui["Contacts<br/>[Contacts.jsx]"]
  node_campaignui["Campaigns<br/>[Campaigns.jsx]"]
  node_automationui["Automation builder<br/>[Automations.jsx]"]
end

subgraph group_api["API and Access"]
  node_api["Express API<br/>[index.js]"]
  node_auth["JWT access<br/>[auth.middleware.js]"]
end

subgraph group_engagement["Messaging and Growth"]
  node_chatroute["Chat routes<br/>[chat.routes.js]"]
  node_chatservice["Chat service<br/>[chat.service.js]"]
  node_waba["WhatsApp integration<br/>[waba.service.js]"]
  node_campaignroute["Campaign routes"]
  node_campaignservice["Campaign service"]
  node_automationroute["Automation routes"]
  node_automationservice["Automation service"]
  node_templates["Template studio"]
  node_wabaroutes["WABA endpoints<br/>[waba.routes.js]"]
end

subgraph group_operations["CRM Operations"]
  node_contactsroute["Contact routes<br/>[contacts.routes.js]"]
  node_contactsservice["Contact service"]
  node_segments["Segmentation"]
  node_pipeline["Deal pipeline"]
  node_appointments["Appointments"]
  node_orders["Orders and commerce<br/>[orders.routes.js]"]
  node_billing["Messaging wallet<br/>[billing.routes.js]"]
  node_logs["Message audit<br/>[logs.routes.js]"]
  node_tools["Developer tools<br/>[tools.service.js]"]
end

node_user(("CRM user"))
node_externalmeta(("Meta Graph API"))

node_user -->|"uses"| node_workstation
node_workstation -->|"routes to"| node_chatui
node_workstation -->|"routes to"| node_contactsui
node_workstation -->|"routes to"| node_campaignui
node_workstation -->|"routes to"| node_automationui
node_api -->|"mounts"| node_chatroute
node_api -->|"mounts"| node_campaignroute
node_api -->|"mounts"| node_automationroute
node_api -->|"mounts"| node_contactsroute
node_api -->|"mounts"| node_segments
node_api -->|"mounts"| node_pipeline
node_api -->|"mounts"| node_appointments
node_api -->|"mounts"| node_orders
node_api -->|"mounts"| node_billing
node_api -->|"mounts"| node_logs
node_api -->|"mounts"| node_templates
node_api -->|"mounts"| node_wabaroutes
node_api -->|"mounts"| node_tools
node_chatroute -->|"authenticates"| node_auth
node_campaignroute -->|"authenticates"| node_auth
node_automationroute -->|"authenticates"| node_auth
node_contactsroute -->|"authenticates"| node_auth
node_chatroute -->|"delegates"| node_chatservice
node_chatservice -->|"uses"| node_waba
node_campaignroute -->|"delegates"| node_campaignservice
node_automationroute -->|"delegates"| node_automationservice
node_contactsroute -->|"delegates"| node_contactsservice
node_externalmeta -.->|"webhook/API"| node_wabaroutes
node_user -.->|"manages"| node_appointments
node_user -.->|"manages"| node_orders
node_user -.->|"manages"| node_billing
node_user -.->|"reviews"| node_logs
node_user -.->|"configures"| node_tools
node_user -.->|"edits"| node_templates
node_user -.->|"segments"| node_segments
node_user -.->|"manages"| node_pipeline

click node_workstation "https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/web/src/App.jsx"
click node_chatui "https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/web/src/pages/LiveChat.jsx"
click node_contactsui "https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/web/src/pages/Contacts.jsx"
click node_campaignui "https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/web/src/pages/Campaigns.jsx"
click node_automationui "https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/web/src/pages/Automations.jsx"
click node_api "https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/index.js"
click node_auth "https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/middlewares/auth.middleware.js"
click node_chatroute "https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/routes/chat.routes.js"
click node_chatservice "https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/services/chat.service.js"
click node_waba "https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/services/waba.service.js"
click node_campaignroute "https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/routes/campaigns.routes.js"
click node_campaignservice "https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/services/campaigns.service.js"
click node_automationroute "https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/routes/automation.routes.js"
click node_automationservice "https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/services/automation.service.js"
click node_templates "https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/routes/templates.routes.js"
click node_wabaroutes "https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/routes/waba.routes.js"
click node_contactsroute "https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/routes/contacts.routes.js"
click node_contactsservice "https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/services/contacts.service.js"
click node_segments "https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/services/segments.service.js"
click node_pipeline "https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/services/pipeline.service.js"
click node_appointments "https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/routes/appointments.routes.js"
click node_orders "https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/routes/orders.routes.js"
click node_billing "https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/routes/billing.routes.js"
click node_logs "https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/routes/logs.routes.js"
click node_tools "https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/services/tools.service.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_workstation,node_chatui,node_contactsui,node_campaignui,node_automationui,node_user toneBlue
class node_api,node_auth toneAmber
class node_chatroute,node_chatservice,node_waba,node_campaignroute,node_campaignservice,node_automationroute,node_automationservice,node_templates,node_wabaroutes,node_externalmeta toneMint
class node_contactsroute,node_contactsservice,node_segments,node_pipeline,node_appointments,node_orders,node_billing,node_logs,node_tools toneRose
```

## Components

### CRM Workstation

- [Workstation router](https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/web/src/App.jsx): `apps/web/src/App.jsx`
- [Live chat](https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/web/src/pages/LiveChat.jsx): `apps/web/src/pages/LiveChat.jsx`
- [Contacts](https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/web/src/pages/Contacts.jsx): `apps/web/src/pages/Contacts.jsx`
- [Campaigns](https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/web/src/pages/Campaigns.jsx): `apps/web/src/pages/Campaigns.jsx`
- [Automation builder](https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/web/src/pages/Automations.jsx): `apps/web/src/pages/Automations.jsx`

### API and Access

- [Express API](https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/index.js): `apps/server/src/index.js`
- [JWT access](https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/middlewares/auth.middleware.js): `apps/server/src/middlewares/auth.middleware.js`

### Messaging and Growth

- [Chat routes](https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/routes/chat.routes.js): `apps/server/src/routes/chat.routes.js`
- [Chat service](https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/services/chat.service.js): `apps/server/src/services/chat.service.js`
- [WhatsApp integration](https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/services/waba.service.js): `apps/server/src/services/waba.service.js`
- [Campaign routes](https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/routes/campaigns.routes.js): `apps/server/src/routes/campaigns.routes.js`
- [Campaign service](https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/services/campaigns.service.js): `apps/server/src/services/campaigns.service.js`
- [Automation routes](https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/routes/automation.routes.js): `apps/server/src/routes/automation.routes.js`
- [Automation service](https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/services/automation.service.js): `apps/server/src/services/automation.service.js`
- [Template studio](https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/routes/templates.routes.js): `apps/server/src/routes/templates.routes.js`
- [WABA endpoints](https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/routes/waba.routes.js): `apps/server/src/routes/waba.routes.js`

### CRM Operations

- [Contact routes](https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/routes/contacts.routes.js): `apps/server/src/routes/contacts.routes.js`
- [Contact service](https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/services/contacts.service.js): `apps/server/src/services/contacts.service.js`
- [Segmentation](https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/services/segments.service.js): `apps/server/src/services/segments.service.js`
- [Deal pipeline](https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/services/pipeline.service.js): `apps/server/src/services/pipeline.service.js`
- [Appointments](https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/routes/appointments.routes.js): `apps/server/src/routes/appointments.routes.js`
- [Orders and commerce](https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/routes/orders.routes.js): `apps/server/src/routes/orders.routes.js`
- [Messaging wallet](https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/routes/billing.routes.js): `apps/server/src/routes/billing.routes.js`
- [Message audit](https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/routes/logs.routes.js): `apps/server/src/routes/logs.routes.js`
- [Developer tools](https://github.com/veenus-rajpoot/qobocheck/blob/main/apps/server/src/services/tools.service.js): `apps/server/src/services/tools.service.js`

### Other components

- **CRM user**
- **Meta Graph API**

## Connections

- CRM user → Workstation router: uses (evidence: `apps/web/src/App.jsx`)
- Workstation router → Live chat: routes to (evidence: `apps/web/src/App.jsx`)
- Workstation router → Contacts: routes to (evidence: `apps/web/src/App.jsx`)
- Workstation router → Campaigns: routes to (evidence: `apps/web/src/App.jsx`)
- Workstation router → Automation builder: routes to (evidence: `apps/web/src/App.jsx`)
- Express API → Chat routes: mounts (evidence: `apps/server/src/index.js`)
- Express API → Campaign routes: mounts (evidence: `apps/server/src/index.js`)
- Express API → Automation routes: mounts (evidence: `apps/server/src/index.js`)
- Express API → Contact routes: mounts (evidence: `apps/server/src/index.js`)
- Express API → Segmentation: mounts (evidence: `apps/server/src/index.js`)
- Express API → Deal pipeline: mounts (evidence: `apps/server/src/index.js`)
- Express API → Appointments: mounts (evidence: `apps/server/src/index.js`)
- Express API → Orders and commerce: mounts (evidence: `apps/server/src/index.js`)
- Express API → Messaging wallet: mounts (evidence: `apps/server/src/index.js`)
- Express API → Message audit: mounts (evidence: `apps/server/src/index.js`)
- Express API → Template studio: mounts (evidence: `apps/server/src/index.js`)
- Express API → WABA endpoints: mounts (evidence: `apps/server/src/index.js`)
- Express API → Developer tools: mounts (evidence: `apps/server/src/index.js`)
- Chat routes → JWT access: authenticates (evidence: `apps/server/src/routes/chat.routes.js`)
- Campaign routes → JWT access: authenticates (evidence: `apps/server/src/routes/campaigns.routes.js`)
- Automation routes → JWT access: authenticates (evidence: `apps/server/src/routes/automation.routes.js`)
- Contact routes → JWT access: authenticates (evidence: `apps/server/src/routes/contacts.routes.js`)
- Chat routes → Chat service: delegates (evidence: `apps/server/src/routes/chat.routes.js`)
- Chat service → WhatsApp integration: uses (evidence: `apps/server/src/services/chat.service.js`)
- Campaign routes → Campaign service: delegates (evidence: `apps/server/src/routes/campaigns.routes.js`)
- Automation routes → Automation service: delegates (evidence: `apps/server/src/routes/automation.routes.js`)
- Contact routes → Contact service: delegates (evidence: `apps/server/src/routes/contacts.routes.js`)
- Meta Graph API → WABA endpoints: webhook/API (evidence: `README.md`)
- CRM user → Appointments: manages (evidence: `README.md`)
- CRM user → Orders and commerce: manages (evidence: `README.md`)
- CRM user → Messaging wallet: manages (evidence: `README.md`)
- CRM user → Message audit: reviews (evidence: `README.md`)
- CRM user → Developer tools: configures (evidence: `README.md`)
- CRM user → Template studio: edits (evidence: `README.md`)
- CRM user → Segmentation: segments (evidence: `README.md`)
- CRM user → Deal pipeline: manages
