# balaji-s-08-tech/devcollab-platform architecture

> Architecture diagram of the GitHub repository balaji-s-08-tech/devcollab-platform, 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/balaji-s-08-tech/devcollab-platform
- Repository: https://github.com/balaji-s-08-tech/devcollab-platform

## Overview

DevCollab is a developer-team collaboration platform. Users authenticate in the React client, enter project workspaces, and work across documents, Kanban tasks, issues, and team collaboration; the client communicates with an Express API and Socket.io for live updates. Server-side domain APIs support search, notifications, Git/GitHub, video, and AI assistance, with MongoDB-backed records and Redis-backed cache/pub-sub. The README documents these capabilities; sampled server wiring confirms route registration, while most individual route-to-controller relationships were not inspected.

Main entry points: [`server/server.js`](https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/server/server.js) (Express API), [`client/src/App.jsx`](https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/client/src/App.jsx) (React app), [`server/socket/handlers.js`](https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/server/socket/handlers.js) (Socket events), [`server/controllers/authController.js`](https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/server/controllers/authController.js) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["React app<br/>[App.jsx]"]
  node_clientapi["HTTP client<br/>[api.js]"]
  node_socketclient["Socket client<br/>[socket.js]"]
end

subgraph group_work["Project work"]
  node_projectui["Project workspace<br/>[ProjectPage.jsx]"]
  node_docsui["Document editor<br/>[DocEditorPage.jsx]"]
  node_boardui["Kanban board<br/>[BoardPage.jsx]"]
  node_issuesui["Issue tracker<br/>[IssuesPage.jsx]"]
  node_teamui["Team management<br/>[TeamPage.jsx]"]
end

subgraph group_live["Live collaboration"]
  node_chatui["Team chat<br/>[ChatPage.jsx]"]
  node_videoui["Video calls<br/>[VideoPage.jsx]"]
  node_socketserver["Socket events<br/>[handlers.js]"]
end

subgraph group_server["API domains"]
  node_api["Express API<br/>[server.js]"]
  node_docsapi["Document APIs<br/>[documents.js]"]
  node_tasksapi["Task APIs<br/>[tasks.js]"]
  node_issuesapi["Issue APIs<br/>[issues.js]"]
  node_chatapi["Chat APIs<br/>[chat.js]"]
  node_videoapi["Video APIs<br/>[video.js]"]
  node_searchapi["Search APIs<br/>[search.js]"]
  node_otherdomains["Other domain APIs"]
end

subgraph group_platform["Identity and services"]
  node_auth["Authentication<br/>[authController.js]"]
  node_rbac["Access control<br/>[rbacService.js]"]
  node_searchindex["Search indexing"]
  node_ai["Document AI<br/>[ragService.js]"]
  node_aiworker["AI job worker<br/>[aiWorker.js]"]
  node_mongo[("MongoDB<br/>[db.js]")]
  node_redis[("Redis cache<br/>[redis.js]")]
  node_meili[("Meilisearch<br/>[meilisearch.js]")]
end

node_user(("Team member"))
node_github["GitHub"]
node_ai_provider["AI provider"]

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_projectui
node_app -.->|"uses API"| node_clientapi
node_app -->|"sets up"| node_socketclient
node_user -->|"edits"| node_docsui
node_user -->|"manages tasks"| node_boardui
node_user -->|"tracks issues"| node_issuesui
node_user -->|"manages team"| node_teamui
node_user -->|"collaborates in"| node_chatui
node_user -.->|"joins calls"| node_videoui
node_clientapi -.->|"sends requests"| node_api
node_api -->|"mounts routes"| node_docsapi
node_api -->|"mounts routes"| node_tasksapi
node_api -->|"mounts routes"| node_issuesapi
node_api -->|"mounts routes"| node_chatapi
node_api -->|"mounts routes"| node_videoapi
node_api -->|"mounts routes"| node_searchapi
node_api -->|"mounts routes"| node_otherdomains
node_tasksapi -->|"checks permissions"| node_rbac
node_auth -->|"reads and writes"| node_mongo
node_auth -->|"invalidates cache"| node_redis
node_auth -->|"authenticates"| node_user
node_chatui -->|"exchanges live events"| node_socketserver
node_boardui -->|"receives task updates"| node_socketserver
node_socketserver -->|"stores messages"| node_mongo
node_socketserver -->|"sets cache"| node_redis
node_searchapi -.->|"searches indexed content"| node_searchindex
node_searchindex -->|"indexes and searches"| node_meili
node_aiworker -->|"runs jobs"| node_ai
node_ai -->|"reads documents"| node_mongo
node_ai -->|"embeds and streams"| node_ai_provider
node_user -.->|"integrates repositories"| node_github

click node_app "https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/client/src/App.jsx"
click node_clientapi "https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/client/src/services/api.js"
click node_socketclient "https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/client/src/services/socket.js"
click node_projectui "https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/client/src/pages/ProjectPage.jsx"
click node_docsui "https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/client/src/pages/DocEditorPage.jsx"
click node_boardui "https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/client/src/pages/BoardPage.jsx"
click node_issuesui "https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/client/src/pages/IssuesPage.jsx"
click node_teamui "https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/client/src/pages/TeamPage.jsx"
click node_chatui "https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/client/src/pages/ChatPage.jsx"
click node_videoui "https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/client/src/pages/VideoPage.jsx"
click node_api "https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/server/server.js"
click node_docsapi "https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/server/routes/documents.js"
click node_tasksapi "https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/server/routes/tasks.js"
click node_issuesapi "https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/server/routes/issues.js"
click node_chatapi "https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/server/routes/chat.js"
click node_videoapi "https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/server/routes/video.js"
click node_searchapi "https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/server/routes/search.js"
click node_otherdomains "https://github.com/balaji-s-08-tech/devcollab-platform/tree/main/server/routes"
click node_auth "https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/server/controllers/authController.js"
click node_rbac "https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/server/permissions/rbacService.js"
click node_searchindex "https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/server/services/searchIndexService.js"
click node_ai "https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/server/services/ai/ragService.js"
click node_aiworker "https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/server/workers/aiWorker.js"
click node_mongo "https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/server/config/db.js"
click node_redis "https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/server/config/redis.js"
click node_socketserver "https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/server/socket/handlers.js"
click node_meili "https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/server/config/meilisearch.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_app,node_clientapi,node_socketclient toneBlue
class node_projectui,node_docsui,node_boardui,node_issuesui,node_teamui toneAmber
class node_chatui,node_videoui,node_socketserver toneMint
class node_api,node_docsapi,node_tasksapi,node_issuesapi,node_chatapi,node_videoapi,node_searchapi,node_otherdomains toneRose
class node_auth,node_rbac,node_searchindex,node_ai,node_aiworker,node_mongo,node_redis,node_meili,node_user,node_github,node_ai_provider toneIndigo
```

## Components

### Web client

- [React app](https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [HTTP client](https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/client/src/services/api.js): `client/src/services/api.js`
- [Socket client](https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/client/src/services/socket.js): `client/src/services/socket.js`

### Project work

- [Project workspace](https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/client/src/pages/ProjectPage.jsx): `client/src/pages/ProjectPage.jsx`
- [Document editor](https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/client/src/pages/DocEditorPage.jsx): `client/src/pages/DocEditorPage.jsx`
- [Kanban board](https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/client/src/pages/BoardPage.jsx): `client/src/pages/BoardPage.jsx`
- [Issue tracker](https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/client/src/pages/IssuesPage.jsx): `client/src/pages/IssuesPage.jsx`
- [Team management](https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/client/src/pages/TeamPage.jsx): `client/src/pages/TeamPage.jsx`

### Live collaboration

- [Team chat](https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/client/src/pages/ChatPage.jsx): `client/src/pages/ChatPage.jsx`
- [Video calls](https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/client/src/pages/VideoPage.jsx): `client/src/pages/VideoPage.jsx`
- [Socket events](https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/server/socket/handlers.js): `server/socket/handlers.js`

### API domains

- [Express API](https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/server/server.js): `server/server.js`
- [Document APIs](https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/server/routes/documents.js): `server/routes/documents.js`
- [Task APIs](https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/server/routes/tasks.js): `server/routes/tasks.js`
- [Issue APIs](https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/server/routes/issues.js): `server/routes/issues.js`
- [Chat APIs](https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/server/routes/chat.js): `server/routes/chat.js`
- [Video APIs](https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/server/routes/video.js): `server/routes/video.js`
- [Search APIs](https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/server/routes/search.js): `server/routes/search.js`
- [Other domain APIs](https://github.com/balaji-s-08-tech/devcollab-platform/tree/main/server/routes): `server/routes`

### Identity and services

- [Authentication](https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/server/controllers/authController.js): `server/controllers/authController.js`
- [Access control](https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/server/permissions/rbacService.js): `server/permissions/rbacService.js`
- [Search indexing](https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/server/services/searchIndexService.js): `server/services/searchIndexService.js`
- [Document AI](https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/server/services/ai/ragService.js): `server/services/ai/ragService.js`
- [AI job worker](https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/server/workers/aiWorker.js): `server/workers/aiWorker.js`
- [MongoDB](https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/server/config/db.js): `server/config/db.js`
- [Redis cache](https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/server/config/redis.js): `server/config/redis.js`
- [Meilisearch](https://github.com/balaji-s-08-tech/devcollab-platform/blob/main/server/config/meilisearch.js): `server/config/meilisearch.js`

### Other components

- **Team member**
- **GitHub**
- **AI provider**

## Connections

- Team member → React app: uses (evidence: `README.md`)
- React app → Project workspace: routes to (evidence: `client/src/App.jsx`)
- React app → HTTP client: uses API
- React app → Socket client: sets up (evidence: `client/src/App.jsx`)
- Team member → Document editor: edits (evidence: `README.md`)
- Team member → Kanban board: manages tasks (evidence: `README.md`)
- Team member → Issue tracker: tracks issues (evidence: `README.md`)
- Team member → Team management: manages team (evidence: `README.md`)
- Team member → Team chat: collaborates in (evidence: `README.md`)
- Team member → Video calls: joins calls
- HTTP client → Express API: sends requests
- Express API → Document APIs: mounts routes (evidence: `server/server.js`)
- Express API → Task APIs: mounts routes (evidence: `server/server.js`)
- Express API → Issue APIs: mounts routes (evidence: `server/server.js`)
- Express API → Chat APIs: mounts routes (evidence: `server/server.js`)
- Express API → Video APIs: mounts routes (evidence: `server/server.js`)
- Express API → Search APIs: mounts routes (evidence: `server/server.js`)
- Express API → Other domain APIs: mounts routes (evidence: `server/server.js`)
- Task APIs → Access control: checks permissions (evidence: `server/routes/tasks.js`)
- Authentication → MongoDB: reads and writes (evidence: `server/controllers/authController.js`)
- Authentication → Redis cache: invalidates cache (evidence: `server/controllers/authController.js`)
- Authentication → Team member: authenticates (evidence: `README.md`)
- Team chat → Socket events: exchanges live events (evidence: `README.md`)
- Kanban board → Socket events: receives task updates (evidence: `README.md`)
- Socket events → MongoDB: stores messages (evidence: `server/socket/handlers.js`)
- Socket events → Redis cache: sets cache (evidence: `server/socket/handlers.js`)
- Search APIs → Search indexing: searches indexed content
- Search indexing → Meilisearch: indexes and searches (evidence: `server/services/searchIndexService.js`)
- AI job worker → Document AI: runs jobs (evidence: `server/workers/aiWorker.js`)
- Document AI → MongoDB: reads documents (evidence: `server/services/ai/ragService.js`)
- Document AI → AI provider: embeds and streams (evidence: `server/services/ai/ragService.js`)
- Team member → GitHub: integrates repositories
