# pankaj-mandloi/collabai-workspace architecture

> Architecture diagram of the GitHub repository pankaj-mandloi/collabai-workspace, 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/pankaj-mandloi/collabai-workspace
- Repository: https://github.com/pankaj-mandloi/collabai-workspace

## Overview

CollabAI is a team workspace product whose main workflow is sign-in, workspace collaboration, and shared chat, tasks, and documents, with an AI agent that can answer questions using workspace context. The frontend presents these features and calls backend APIs; backend services implement domain operations over MongoDB models. Socket.io provides a separate real-time path for chat and presence. Several feature routes and UI implementations were not sampled, so those branches are grounded in README capabilities and their tree paths; the graph omits unverified implementation-level links.

Main entry points: [`frontend/src/services/api.ts`](https://github.com/pankaj-mandloi/collabai-workspace/blob/main/frontend/src/services/api.ts) (API client), [`backend/src/app.js`](https://github.com/pankaj-mandloi/collabai-workspace/blob/main/backend/src/app.js) (HTTP app and routes), [`backend/src/models`](https://github.com/pankaj-mandloi/collabai-workspace/tree/main/backend/src/models) (MongoDB domain models), [`backend/src/services/rag.service.js`](https://github.com/pankaj-mandloi/collabai-workspace/blob/main/backend/src/services/rag.service.js) (Workspace retrieval)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_authui["Sign-in and sign-up"]
  node_workspaceui["Workspace views<br/>[page.tsx]"]
  node_chatui["Chat interface<br/>[chat-area.tsx]"]
  node_taskui["Kanban tasks<br/>[kanban-board.tsx]"]
  node_docui["Document editor"]
  node_aiui["AI chat panel<br/>[ai-chat-panel.tsx]"]
  node_searchui["Global search<br/>[search-command.tsx]"]
  node_notificationsui["Notifications"]
  node_clientapi["API client<br/>[api.ts]"]
end

subgraph group_api["API and domain"]
  node_approuter["HTTP app and routes<br/>[app.js]"]
  node_auth["Request authentication<br/>[auth.middleware.js]"]
  node_workspace["Workspace management"]
  node_messages["Message operations<br/>[message.service.js]"]
  node_tasks["Task operations<br/>[task.service.js]"]
  node_documents["Document operations"]
  node_models[("MongoDB domain models")]
end

subgraph group_realtime["Live collaboration"]
  node_socketserver["Socket event handlers<br/>[chat.handler.js]"]
  node_presence["Presence handler"]
end

subgraph group_intelligence["AI and retrieval"]
  node_rag["Workspace retrieval<br/>[rag.service.js]"]
  node_embeddings["Embedding generation"]
  node_ai["AI response service<br/>[ai.service.js]"]
end

node_member(("Team member"))
node_gemini{{"Google Gemini"}}
node_clerk{{"Clerk identity"}}

node_member -->|"signs in"| node_authui
node_authui -->|"authenticates with"| node_clerk
node_member -->|"collaborates in"| node_workspaceui
node_workspaceui -.->|"requests workspace data"| node_clientapi
node_chatui -.->|"sends chat requests"| node_clientapi
node_taskui -.->|"sends task requests"| node_clientapi
node_docui -.->|"sends document requests"| node_clientapi
node_aiui -.->|"sends AI requests"| node_clientapi
node_searchui -.->|"searches content"| node_clientapi
node_notificationsui -.->|"fetches notifications"| node_clientapi
node_clientapi -.->|"calls API"| node_approuter
node_approuter -->|"protects routes"| node_auth
node_approuter -->|"routes workspace actions"| node_workspace
node_approuter -->|"routes message actions"| node_messages
node_approuter -->|"routes task actions"| node_tasks
node_workspace -->|"reads and writes"| node_models
node_messages -->|"reads and writes"| node_models
node_tasks -.->|"reads and writes"| node_models
node_documents -.->|"reads and writes"| node_models
node_member -->|"exchanges live chat"| node_socketserver
node_socketserver -->|"uses message operations"| node_messages
node_member -->|"shares online status"| node_presence
node_aiui -.->|"asks workspace questions"| node_ai
node_ai -->|"retrieves context"| node_rag
node_rag -->|"searches messages, docs, tasks"| node_models
node_rag -->|"generates query vectors"| node_embeddings
node_embeddings -->|"requests embeddings"| node_gemini
node_ai -.->|"generates responses"| node_gemini

click node_workspaceui "https://github.com/pankaj-mandloi/collabai-workspace/blob/main/frontend/src/app/(dashboard)/workspace/%5BworkspaceId%5D/page.tsx"
click node_chatui "https://github.com/pankaj-mandloi/collabai-workspace/blob/main/frontend/src/components/features/chat/chat-area.tsx"
click node_taskui "https://github.com/pankaj-mandloi/collabai-workspace/blob/main/frontend/src/components/features/tasks/kanban-board.tsx"
click node_docui "https://github.com/pankaj-mandloi/collabai-workspace/blob/main/frontend/src/components/features/documents/document-editor.tsx"
click node_aiui "https://github.com/pankaj-mandloi/collabai-workspace/blob/main/frontend/src/components/features/ai/ai-chat-panel.tsx"
click node_searchui "https://github.com/pankaj-mandloi/collabai-workspace/blob/main/frontend/src/components/shared/search-command.tsx"
click node_notificationsui "https://github.com/pankaj-mandloi/collabai-workspace/blob/main/frontend/src/components/shared/notification-bell.tsx"
click node_clientapi "https://github.com/pankaj-mandloi/collabai-workspace/blob/main/frontend/src/services/api.ts"
click node_approuter "https://github.com/pankaj-mandloi/collabai-workspace/blob/main/backend/src/app.js"
click node_auth "https://github.com/pankaj-mandloi/collabai-workspace/blob/main/backend/src/middlewares/auth.middleware.js"
click node_workspace "https://github.com/pankaj-mandloi/collabai-workspace/blob/main/backend/src/services/workspace.service.js"
click node_messages "https://github.com/pankaj-mandloi/collabai-workspace/blob/main/backend/src/services/message.service.js"
click node_tasks "https://github.com/pankaj-mandloi/collabai-workspace/blob/main/backend/src/services/task.service.js"
click node_documents "https://github.com/pankaj-mandloi/collabai-workspace/blob/main/backend/src/services/document.service.js"
click node_models "https://github.com/pankaj-mandloi/collabai-workspace/tree/main/backend/src/models"
click node_socketserver "https://github.com/pankaj-mandloi/collabai-workspace/blob/main/backend/src/sockets/handlers/chat.handler.js"
click node_presence "https://github.com/pankaj-mandloi/collabai-workspace/blob/main/backend/src/sockets/handlers/presence.handler.js"
click node_rag "https://github.com/pankaj-mandloi/collabai-workspace/blob/main/backend/src/services/rag.service.js"
click node_embeddings "https://github.com/pankaj-mandloi/collabai-workspace/blob/main/backend/src/services/embedding.service.js"
click node_ai "https://github.com/pankaj-mandloi/collabai-workspace/blob/main/backend/src/services/ai.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_authui,node_workspaceui,node_chatui,node_taskui,node_docui,node_aiui,node_searchui,node_notificationsui,node_clientapi toneBlue
class node_approuter,node_auth,node_workspace,node_messages,node_tasks,node_documents,node_models toneAmber
class node_socketserver,node_presence toneMint
class node_rag,node_embeddings,node_ai toneRose
class node_member,node_gemini,node_clerk toneIndigo
```

## Components

### Web client

- **Sign-in and sign-up**
- [Workspace views](https://github.com/pankaj-mandloi/collabai-workspace/blob/main/frontend/src/app/(dashboard)/workspace/%5BworkspaceId%5D/page.tsx): `frontend/src/app/(dashboard)/workspace/[workspaceId]/page.tsx`
- [Chat interface](https://github.com/pankaj-mandloi/collabai-workspace/blob/main/frontend/src/components/features/chat/chat-area.tsx): `frontend/src/components/features/chat/chat-area.tsx`
- [Kanban tasks](https://github.com/pankaj-mandloi/collabai-workspace/blob/main/frontend/src/components/features/tasks/kanban-board.tsx): `frontend/src/components/features/tasks/kanban-board.tsx`
- [Document editor](https://github.com/pankaj-mandloi/collabai-workspace/blob/main/frontend/src/components/features/documents/document-editor.tsx): `frontend/src/components/features/documents/document-editor.tsx`
- [AI chat panel](https://github.com/pankaj-mandloi/collabai-workspace/blob/main/frontend/src/components/features/ai/ai-chat-panel.tsx): `frontend/src/components/features/ai/ai-chat-panel.tsx`
- [Global search](https://github.com/pankaj-mandloi/collabai-workspace/blob/main/frontend/src/components/shared/search-command.tsx): `frontend/src/components/shared/search-command.tsx`
- [Notifications](https://github.com/pankaj-mandloi/collabai-workspace/blob/main/frontend/src/components/shared/notification-bell.tsx): `frontend/src/components/shared/notification-bell.tsx`
- [API client](https://github.com/pankaj-mandloi/collabai-workspace/blob/main/frontend/src/services/api.ts): `frontend/src/services/api.ts`

### API and domain

- [HTTP app and routes](https://github.com/pankaj-mandloi/collabai-workspace/blob/main/backend/src/app.js): `backend/src/app.js`
- [Request authentication](https://github.com/pankaj-mandloi/collabai-workspace/blob/main/backend/src/middlewares/auth.middleware.js): `backend/src/middlewares/auth.middleware.js`
- [Workspace management](https://github.com/pankaj-mandloi/collabai-workspace/blob/main/backend/src/services/workspace.service.js): `backend/src/services/workspace.service.js`
- [Message operations](https://github.com/pankaj-mandloi/collabai-workspace/blob/main/backend/src/services/message.service.js): `backend/src/services/message.service.js`
- [Task operations](https://github.com/pankaj-mandloi/collabai-workspace/blob/main/backend/src/services/task.service.js): `backend/src/services/task.service.js`
- [Document operations](https://github.com/pankaj-mandloi/collabai-workspace/blob/main/backend/src/services/document.service.js): `backend/src/services/document.service.js`
- [MongoDB domain models](https://github.com/pankaj-mandloi/collabai-workspace/tree/main/backend/src/models): `backend/src/models`

### Live collaboration

- [Socket event handlers](https://github.com/pankaj-mandloi/collabai-workspace/blob/main/backend/src/sockets/handlers/chat.handler.js): `backend/src/sockets/handlers/chat.handler.js`
- [Presence handler](https://github.com/pankaj-mandloi/collabai-workspace/blob/main/backend/src/sockets/handlers/presence.handler.js): `backend/src/sockets/handlers/presence.handler.js`

### AI and retrieval

- [Workspace retrieval](https://github.com/pankaj-mandloi/collabai-workspace/blob/main/backend/src/services/rag.service.js): `backend/src/services/rag.service.js`
- [Embedding generation](https://github.com/pankaj-mandloi/collabai-workspace/blob/main/backend/src/services/embedding.service.js): `backend/src/services/embedding.service.js`
- [AI response service](https://github.com/pankaj-mandloi/collabai-workspace/blob/main/backend/src/services/ai.service.js): `backend/src/services/ai.service.js`

### Other components

- **Team member**
- **Google Gemini**
- **Clerk identity**

## Connections

- Team member → Sign-in and sign-up: signs in
- Sign-in and sign-up → Clerk identity: authenticates with
- Team member → Workspace views: collaborates in
- Workspace views → API client: requests workspace data
- Chat interface → API client: sends chat requests
- Kanban tasks → API client: sends task requests
- Document editor → API client: sends document requests
- AI chat panel → API client: sends AI requests
- Global search → API client: searches content
- Notifications → API client: fetches notifications
- API client → HTTP app and routes: calls API
- HTTP app and routes → Request authentication: protects routes
- HTTP app and routes → Workspace management: routes workspace actions
- HTTP app and routes → Message operations: routes message actions
- HTTP app and routes → Task operations: routes task actions
- Workspace management → MongoDB domain models: reads and writes (evidence: `backend/src/services/workspace.service.js`)
- Message operations → MongoDB domain models: reads and writes (evidence: `backend/src/services/message.service.js`)
- Task operations → MongoDB domain models: reads and writes
- Document operations → MongoDB domain models: reads and writes
- Team member → Socket event handlers: exchanges live chat
- Socket event handlers → Message operations: uses message operations (evidence: `backend/src/sockets/handlers/chat.handler.js`)
- Team member → Presence handler: shares online status
- AI chat panel → AI response service: asks workspace questions
- AI response service → Workspace retrieval: retrieves context (evidence: `backend/src/services/ai.service.js`)
- Workspace retrieval → MongoDB domain models: searches messages, docs, tasks (evidence: `backend/src/services/rag.service.js`)
- Workspace retrieval → Embedding generation: generates query vectors (evidence: `backend/src/services/rag.service.js`)
- Embedding generation → Google Gemini: requests embeddings (evidence: `backend/src/services/embedding.service.js`)
- AI response service → Google Gemini: generates responses
