How pankaj-mandloi/collabai-workspace works
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: api.ts API client · app.js HTTP app and routes · models MongoDB domain models · rag.service.js Workspace retrieval
Components 24
Web client
- Sign-in and sign-up
- Workspace views
frontend/src/app/(dashboard)/workspace/[workspaceId]/page.tsx - Chat interface
frontend/src/components/features/chat/chat-area.tsx - Kanban tasks
frontend/src/components/features/tasks/kanban-board.tsx - Document editor
frontend/src/components/features/documents/document-editor.tsx - AI chat panel
frontend/src/components/features/ai/ai-chat-panel.tsx - Global search
frontend/src/components/shared/search-command.tsx - Notifications
frontend/src/components/shared/notification-bell.tsx - API client
frontend/src/services/api.ts
API and domain
- HTTP app and routes
backend/src/app.js - Request authentication
backend/src/middlewares/auth.middleware.js - Workspace management
backend/src/services/workspace.service.js - Message operations
backend/src/services/message.service.js - Task operations
backend/src/services/task.service.js - Document operations
backend/src/services/document.service.js - MongoDB domain models
backend/src/models
Live collaboration
- Socket event handlers
backend/src/sockets/handlers/chat.handler.js - Presence handler
backend/src/sockets/handlers/presence.handler.js
AI and retrieval
- Workspace retrieval
backend/src/services/rag.service.js - Embedding generation
backend/src/services/embedding.service.js - AI response service
backend/src/services/ai.service.js
Other components
- Team member
- Google Gemini
- Clerk identity
Connections 28
- 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
backend/src/services/workspace.service.js - Message operations → MongoDB domain models: reads and writes
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
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
backend/src/services/ai.service.js - Workspace retrieval → MongoDB domain models: searches messages, docs, tasks
backend/src/services/rag.service.js - Workspace retrieval → Embedding generation: generates query vectors
backend/src/services/rag.service.js - Embedding generation → Google Gemini: requests embeddings
backend/src/services/embedding.service.js - AI response service → Google Gemini: generates responses