# devaraj-07/nexus-ai architecture

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

- Interactive diagram: https://gitdiagram.com/devaraj-07/nexus-ai
- Repository: https://github.com/devaraj-07/nexus-ai

## Overview

Nexus AI is a beta developer-pipeline command center. Users enter through the Next.js workspace to inspect pipeline intelligence, repository status, analytics, content, automation, and integrations; the Express API exposes corresponding services and persists workspace data. The graph separates the UI, API/domain routes, AI and automation services, and persistence. Several frontend-to-feature API calls and unsampled modules are not shown, so those links are limited to documented architecture rather than inferred route-by-route wiring.

Main entry points: [`backend/src/app.js`](https://github.com/devaraj-07/nexus-ai/blob/main/backend/src/app.js) (Express API), [`backend/src/config/db.js`](https://github.com/devaraj-07/nexus-ai/blob/main/backend/src/config/db.js) (Application database), [`backend/src/routes/ai.routes.js`](https://github.com/devaraj-07/nexus-ai/blob/main/backend/src/routes/ai.routes.js) (AI workflows), [`backend/src/services/worker.service.js`](https://github.com/devaraj-07/nexus-ai/blob/main/backend/src/services/worker.service.js) (Queue worker)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Web workspace"]
  node_workspace["Command center<br/>[ClientAppShell.js]"]
  node_intelligence["Pipeline intelligence<br/>[page.js]"]
  node_content_ui["Content studio<br/>[page.js]"]
  node_pipeline_ui["Pipeline board<br/>[page.js]"]
  node_analytics_ui["Pipeline analytics<br/>[page.js]"]
  node_automation_ui["Automation UI<br/>[page.js]"]
  node_integrations_ui["Integrations UI<br/>[page.js]"]
end

subgraph group_api["API and domain routes"]
  node_api["Express API<br/>[app.js]"]
  node_auth["Authentication routes<br/>[auth.routes.js]"]
  node_ai_routes["AI workflows<br/>[ai.routes.js]"]
  node_documents["Documents routes"]
  node_content["Content routes<br/>[content.routes.js]"]
  node_crm["Repository pipelines<br/>[crm.routes.js]"]
  node_analytics["Analytics routes"]
  node_automation["Automation routes"]
  node_integrations["Integration routes"]
  node_settings["Settings routes<br/>[settings.routes.js]"]
end

subgraph group_runtime["AI and automation"]
  node_providers["AI providers<br/>[gemini.service.js]"]
  node_queue["Job queue<br/>[queue.service.js]"]
  node_worker["Queue worker<br/>[worker.service.js]"]
  node_integration_service["Integration service"]
end

subgraph group_data["Persistence"]
  node_database[("Application database<br/>[db.js]")]
  node_document_store[("Document storage<br/>[documentsStore.js]")]
end

node_user(("Team member"))
node_ai_vendors["AI services"]

node_user -->|"uses"| node_workspace
node_workspace -->|"REST / SSE"| node_api
node_api -->|"routes to"| node_auth
node_api -->|"routes to"| node_ai_routes
node_api -->|"routes to"| node_documents
node_api -->|"routes to"| node_content
node_api -->|"routes to"| node_crm
node_api -->|"routes to"| node_analytics
node_api -->|"routes to"| node_automation
node_api -->|"routes to"| node_integrations
node_api -->|"routes to"| node_settings
node_ai_routes -->|"dispatches to"| node_providers
node_ai_routes -->|"reads / writes"| node_database
node_ai_routes -->|"reads"| node_document_store
node_automation -->|"enqueues jobs"| node_queue
node_queue -->|"starts worker"| node_worker
node_worker -->|"uses"| node_database
node_worker -->|"uses"| node_integration_service
node_crm -->|"reads / writes"| node_database
node_content -->|"reads / writes"| node_database
node_integrations -->|"reads / writes"| node_database
node_analytics -->|"reads"| node_database
node_providers -.->|"calls models"| node_ai_vendors
node_intelligence -.->|"uses AI workflows"| node_ai_routes
node_content_ui -.->|"uses content API"| node_content
node_pipeline_ui -.->|"uses pipeline API"| node_crm
node_analytics_ui -.->|"uses analytics API"| node_analytics
node_automation_ui -.->|"uses automation API"| node_automation
node_integrations_ui -.->|"uses integrations API"| node_integrations

click node_workspace "https://github.com/devaraj-07/nexus-ai/blob/main/frontend/src/app/components/ClientAppShell.js"
click node_intelligence "https://github.com/devaraj-07/nexus-ai/blob/main/frontend/src/app/intelligence/page.js"
click node_content_ui "https://github.com/devaraj-07/nexus-ai/blob/main/frontend/src/app/content/page.js"
click node_pipeline_ui "https://github.com/devaraj-07/nexus-ai/blob/main/frontend/src/app/crm/page.js"
click node_analytics_ui "https://github.com/devaraj-07/nexus-ai/blob/main/frontend/src/app/analytics/page.js"
click node_automation_ui "https://github.com/devaraj-07/nexus-ai/blob/main/frontend/src/app/automation/page.js"
click node_integrations_ui "https://github.com/devaraj-07/nexus-ai/blob/main/frontend/src/app/integrations/page.js"
click node_api "https://github.com/devaraj-07/nexus-ai/blob/main/backend/src/app.js"
click node_auth "https://github.com/devaraj-07/nexus-ai/blob/main/backend/src/routes/auth.routes.js"
click node_ai_routes "https://github.com/devaraj-07/nexus-ai/blob/main/backend/src/routes/ai.routes.js"
click node_documents "https://github.com/devaraj-07/nexus-ai/blob/main/backend/src/routes/documents.routes.js"
click node_content "https://github.com/devaraj-07/nexus-ai/blob/main/backend/src/routes/content.routes.js"
click node_crm "https://github.com/devaraj-07/nexus-ai/blob/main/backend/src/routes/crm.routes.js"
click node_analytics "https://github.com/devaraj-07/nexus-ai/blob/main/backend/src/routes/analytics.routes.js"
click node_automation "https://github.com/devaraj-07/nexus-ai/blob/main/backend/src/routes/automation.routes.js"
click node_integrations "https://github.com/devaraj-07/nexus-ai/blob/main/backend/src/routes/integrations.routes.js"
click node_settings "https://github.com/devaraj-07/nexus-ai/blob/main/backend/src/routes/settings.routes.js"
click node_providers "https://github.com/devaraj-07/nexus-ai/blob/main/backend/src/services/gemini.service.js"
click node_queue "https://github.com/devaraj-07/nexus-ai/blob/main/backend/src/services/queue.service.js"
click node_worker "https://github.com/devaraj-07/nexus-ai/blob/main/backend/src/services/worker.service.js"
click node_integration_service "https://github.com/devaraj-07/nexus-ai/blob/main/backend/src/services/integration.service.js"
click node_database "https://github.com/devaraj-07/nexus-ai/blob/main/backend/src/config/db.js"
click node_document_store "https://github.com/devaraj-07/nexus-ai/blob/main/backend/src/config/documentsStore.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,node_intelligence,node_content_ui,node_pipeline_ui,node_analytics_ui,node_automation_ui,node_integrations_ui toneBlue
class node_api,node_auth,node_ai_routes,node_documents,node_content,node_crm,node_analytics,node_automation,node_integrations,node_settings toneAmber
class node_providers,node_queue,node_worker,node_integration_service toneMint
class node_database,node_document_store toneRose
class node_user,node_ai_vendors toneIndigo
```

## Components

### Web workspace

- [Command center](https://github.com/devaraj-07/nexus-ai/blob/main/frontend/src/app/components/ClientAppShell.js): `frontend/src/app/components/ClientAppShell.js`
- [Pipeline intelligence](https://github.com/devaraj-07/nexus-ai/blob/main/frontend/src/app/intelligence/page.js): `frontend/src/app/intelligence/page.js`
- [Content studio](https://github.com/devaraj-07/nexus-ai/blob/main/frontend/src/app/content/page.js): `frontend/src/app/content/page.js`
- [Pipeline board](https://github.com/devaraj-07/nexus-ai/blob/main/frontend/src/app/crm/page.js): `frontend/src/app/crm/page.js`
- [Pipeline analytics](https://github.com/devaraj-07/nexus-ai/blob/main/frontend/src/app/analytics/page.js): `frontend/src/app/analytics/page.js`
- [Automation UI](https://github.com/devaraj-07/nexus-ai/blob/main/frontend/src/app/automation/page.js): `frontend/src/app/automation/page.js`
- [Integrations UI](https://github.com/devaraj-07/nexus-ai/blob/main/frontend/src/app/integrations/page.js): `frontend/src/app/integrations/page.js`

### API and domain routes

- [Express API](https://github.com/devaraj-07/nexus-ai/blob/main/backend/src/app.js): `backend/src/app.js`
- [Authentication routes](https://github.com/devaraj-07/nexus-ai/blob/main/backend/src/routes/auth.routes.js): `backend/src/routes/auth.routes.js`
- [AI workflows](https://github.com/devaraj-07/nexus-ai/blob/main/backend/src/routes/ai.routes.js): `backend/src/routes/ai.routes.js`
- [Documents routes](https://github.com/devaraj-07/nexus-ai/blob/main/backend/src/routes/documents.routes.js): `backend/src/routes/documents.routes.js`
- [Content routes](https://github.com/devaraj-07/nexus-ai/blob/main/backend/src/routes/content.routes.js): `backend/src/routes/content.routes.js`
- [Repository pipelines](https://github.com/devaraj-07/nexus-ai/blob/main/backend/src/routes/crm.routes.js): `backend/src/routes/crm.routes.js`
- [Analytics routes](https://github.com/devaraj-07/nexus-ai/blob/main/backend/src/routes/analytics.routes.js): `backend/src/routes/analytics.routes.js`
- [Automation routes](https://github.com/devaraj-07/nexus-ai/blob/main/backend/src/routes/automation.routes.js): `backend/src/routes/automation.routes.js`
- [Integration routes](https://github.com/devaraj-07/nexus-ai/blob/main/backend/src/routes/integrations.routes.js): `backend/src/routes/integrations.routes.js`
- [Settings routes](https://github.com/devaraj-07/nexus-ai/blob/main/backend/src/routes/settings.routes.js): `backend/src/routes/settings.routes.js`

### AI and automation

- [AI providers](https://github.com/devaraj-07/nexus-ai/blob/main/backend/src/services/gemini.service.js): `backend/src/services/gemini.service.js`
- [Job queue](https://github.com/devaraj-07/nexus-ai/blob/main/backend/src/services/queue.service.js): `backend/src/services/queue.service.js`
- [Queue worker](https://github.com/devaraj-07/nexus-ai/blob/main/backend/src/services/worker.service.js): `backend/src/services/worker.service.js`
- [Integration service](https://github.com/devaraj-07/nexus-ai/blob/main/backend/src/services/integration.service.js): `backend/src/services/integration.service.js`

### Persistence

- [Application database](https://github.com/devaraj-07/nexus-ai/blob/main/backend/src/config/db.js): `backend/src/config/db.js`
- [Document storage](https://github.com/devaraj-07/nexus-ai/blob/main/backend/src/config/documentsStore.js): `backend/src/config/documentsStore.js`

### Other components

- **Team member**
- **AI services**

## Connections

- Team member → Command center: uses (evidence: `README.md`)
- Command center → Express API: REST / SSE (evidence: `README.md`)
- Express API → Authentication routes: routes to (evidence: `backend/src/app.js`)
- Express API → AI workflows: routes to (evidence: `backend/src/app.js`)
- Express API → Documents routes: routes to (evidence: `backend/src/app.js`)
- Express API → Content routes: routes to (evidence: `backend/src/app.js`)
- Express API → Repository pipelines: routes to (evidence: `backend/src/app.js`)
- Express API → Analytics routes: routes to (evidence: `backend/src/app.js`)
- Express API → Automation routes: routes to (evidence: `backend/src/app.js`)
- Express API → Integration routes: routes to (evidence: `backend/src/app.js`)
- Express API → Settings routes: routes to (evidence: `backend/src/app.js`)
- AI workflows → AI providers: dispatches to (evidence: `backend/src/routes/ai.routes.js`)
- AI workflows → Application database: reads / writes (evidence: `backend/src/routes/ai.routes.js`)
- AI workflows → Document storage: reads (evidence: `backend/src/routes/ai.routes.js`)
- Automation routes → Job queue: enqueues jobs (evidence: `backend/src/routes/automation.routes.js`)
- Job queue → Queue worker: starts worker (evidence: `backend/src/services/queue.service.js`)
- Queue worker → Application database: uses (evidence: `backend/src/services/worker.service.js`)
- Queue worker → Integration service: uses (evidence: `backend/src/services/worker.service.js`)
- Repository pipelines → Application database: reads / writes (evidence: `backend/src/routes/crm.routes.js`)
- Content routes → Application database: reads / writes (evidence: `backend/src/routes/content.routes.js`)
- Integration routes → Application database: reads / writes (evidence: `backend/src/routes/integrations.routes.js`)
- Analytics routes → Application database: reads (evidence: `backend/src/routes/analytics.routes.js`)
- AI providers → AI services: calls models
- Pipeline intelligence → AI workflows: uses AI workflows
- Content studio → Content routes: uses content API
- Pipeline board → Repository pipelines: uses pipeline API
- Pipeline analytics → Analytics routes: uses analytics API
- Automation UI → Automation routes: uses automation API
- Integrations UI → Integration routes: uses integrations API
