# dimpesh10/multi-tenant-saas-task-manager architecture

> Architecture diagram of the GitHub repository dimpesh10/multi-tenant-saas-task-manager, 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/dimpesh10/multi-tenant-saas-task-manager
- Repository: https://github.com/dimpesh10/multi-tenant-saas-task-manager

## Overview

This is a collaborative organization and workspace task-board application. Users register or sign in, create an organization, enter a protected dashboard, and manage workspace tasks; the backend provides role-checked APIs and Socket.io workspace rooms. The map covers the documented-by-code UI, organization/workspace/task stages, persistence models, and authentication. Some backend services and UI components were not excerpted, so their connections are included only where the source index supports them.

Main entry points: [`frontend/src/pages/Dashboard.jsx`](https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/frontend/src/pages/Dashboard.jsx) (Dashboard), [`backend/server.js`](https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/backend/server.js) (HTTP server), [`backend/middleware/auth.js`](https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/backend/middleware/auth.js) (Token verification), [`frontend/src/App.jsx`](https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/frontend/src/App.jsx) (Routes and providers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_app["Routes and providers<br/>[App.jsx]"]
  node_auth_pages["Sign in and register<br/>[Login.jsx]"]
  node_create_org["Organization setup<br/>[CreateOrg.jsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
  node_board["Kanban board<br/>[KanbanBoard.jsx]"]
  node_task_modal["Task editor<br/>[TaskModal.jsx]"]
  node_task_card["Task card<br/>[TaskCard.jsx]"]
  node_sidebar["Workspace sidebar<br/>[Sidebar.jsx]"]
  node_invite["Member invites<br/>[InviteModal.jsx]"]
  node_topbar["Dashboard top bar<br/>[TopBar.jsx]"]
  node_api_client["HTTP client<br/>[client.js]"]
end

subgraph group_api["API and domain"]
  node_org_routes["Organization routes<br/>[orgRoutes.js]"]
  node_org_service["Organization service<br/>[orgService.js]"]
  node_org_model[("Organization records<br/>[Organization.js]")]
  node_workspace_routes["Workspace routes<br/>[workspaceRoutes.js]"]
  node_workspace_service["Workspace service"]
  node_workspace_model[("Workspace records<br/>[Workspace.js]")]
  node_task_routes["Task routes<br/>[taskRoutes.js]"]
  node_task_service["Task service<br/>[taskService.js]"]
  node_task_model[("Task records<br/>[Task.js]")]
  node_server["HTTP server<br/>[server.js]"]
  node_error_handler["Error handling<br/>[errorHandler.js]"]
end

subgraph group_security["Identity and access"]
  node_auth_context["Session state<br/>[AuthContext.jsx]"]
  node_auth_routes["Authentication routes<br/>[authRoutes.js]"]
  node_auth_service["Authentication service<br/>[authService.js]"]
  node_auth_middleware["Token verification<br/>[auth.js]"]
  node_rbac["Role checks<br/>[rbac.js]"]
  node_users[("User records<br/>[User.js]")]
end

subgraph group_realtime["Live collaboration"]
  node_socket_context["Socket client state<br/>[SocketContext.jsx]"]
  node_socket_server["Workspace socket rooms<br/>[index.js]"]
end

node_user(("User"))

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_auth_pages
node_app -->|"routes to"| node_create_org
node_app -->|"routes to"| node_dashboard
node_auth_pages -->|"uses session"| node_auth_context
node_create_org -->|"sends requests"| node_api_client
node_dashboard -->|"sends requests"| node_api_client
node_dashboard -->|"renders"| node_board
node_dashboard -->|"renders"| node_task_modal
node_dashboard -->|"renders"| node_sidebar
node_dashboard -->|"renders"| node_invite
node_dashboard -->|"renders"| node_topbar
node_board -->|"renders"| node_task_card
node_auth_context -->|"calls"| node_api_client
node_api_client -->|"sends HTTP"| node_server
node_server -->|"mounts"| node_auth_routes
node_server -->|"mounts"| node_org_routes
node_server -->|"mounts"| node_workspace_routes
node_server -->|"mounts"| node_task_routes
node_server -->|"initializes"| node_socket_server
node_server -->|"registers"| node_error_handler
node_auth_routes -->|"calls"| node_auth_service
node_auth_routes -->|"applies"| node_auth_middleware
node_auth_service -->|"reads and writes"| node_users
node_auth_middleware -->|"loads user"| node_users
node_org_routes -->|"calls"| node_org_service
node_org_routes -->|"applies"| node_auth_middleware
node_org_routes -->|"checks roles"| node_rbac
node_org_service -->|"uses records"| node_org_model
node_org_service -->|"uses records"| node_users
node_workspace_routes -->|"calls"| node_workspace_service
node_workspace_routes -->|"applies"| node_auth_middleware
node_workspace_routes -->|"checks roles"| node_rbac
node_workspace_service -->|"uses records"| node_workspace_model
node_task_routes -->|"calls"| node_task_service
node_task_routes -->|"applies"| node_auth_middleware
node_task_routes -->|"checks roles"| node_rbac
node_task_service -->|"uses records"| node_task_model
node_task_service -->|"uses records"| node_workspace_model
node_task_service -->|"emits updates"| node_socket_server
node_socket_context -->|"uses session"| node_auth_context
node_socket_context -.->|"connects to"| node_socket_server

click node_app "https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/frontend/src/App.jsx"
click node_auth_pages "https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/frontend/src/pages/Login.jsx"
click node_create_org "https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/frontend/src/pages/CreateOrg.jsx"
click node_dashboard "https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/frontend/src/pages/Dashboard.jsx"
click node_board "https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/frontend/src/components/KanbanBoard.jsx"
click node_task_modal "https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/frontend/src/components/TaskModal.jsx"
click node_task_card "https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/frontend/src/components/TaskCard.jsx"
click node_sidebar "https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/frontend/src/components/Sidebar.jsx"
click node_invite "https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/frontend/src/components/InviteModal.jsx"
click node_topbar "https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/frontend/src/components/TopBar.jsx"
click node_auth_context "https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/frontend/src/context/AuthContext.jsx"
click node_api_client "https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/frontend/src/api/client.js"
click node_auth_routes "https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/backend/routes/authRoutes.js"
click node_auth_service "https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/backend/services/authService.js"
click node_auth_middleware "https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/backend/middleware/auth.js"
click node_rbac "https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/backend/middleware/rbac.js"
click node_users "https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/backend/models/User.js"
click node_org_routes "https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/backend/routes/orgRoutes.js"
click node_org_service "https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/backend/services/orgService.js"
click node_org_model "https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/backend/models/Organization.js"
click node_workspace_routes "https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/backend/routes/workspaceRoutes.js"
click node_workspace_service "https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/backend/services/workspaceService.js"
click node_workspace_model "https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/backend/models/Workspace.js"
click node_task_routes "https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/backend/routes/taskRoutes.js"
click node_task_service "https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/backend/services/taskService.js"
click node_task_model "https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/backend/models/Task.js"
click node_server "https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/backend/server.js"
click node_error_handler "https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/backend/middleware/errorHandler.js"
click node_socket_context "https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/frontend/src/context/SocketContext.jsx"
click node_socket_server "https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/backend/sockets/index.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_auth_pages,node_create_org,node_dashboard,node_board,node_task_modal,node_task_card,node_sidebar,node_invite,node_topbar,node_api_client,node_user toneBlue
class node_org_routes,node_org_service,node_org_model,node_workspace_routes,node_workspace_service,node_workspace_model,node_task_routes,node_task_service,node_task_model,node_server,node_error_handler toneAmber
class node_auth_context,node_auth_routes,node_auth_service,node_auth_middleware,node_rbac,node_users toneMint
class node_socket_context,node_socket_server toneRose
```

## Components

### Web application

- [Routes and providers](https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Sign in and register](https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/frontend/src/pages/Login.jsx): `frontend/src/pages/Login.jsx`
- [Organization setup](https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/frontend/src/pages/CreateOrg.jsx): `frontend/src/pages/CreateOrg.jsx`
- [Dashboard](https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/frontend/src/pages/Dashboard.jsx): `frontend/src/pages/Dashboard.jsx`
- [Kanban board](https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/frontend/src/components/KanbanBoard.jsx): `frontend/src/components/KanbanBoard.jsx`
- [Task editor](https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/frontend/src/components/TaskModal.jsx): `frontend/src/components/TaskModal.jsx`
- [Task card](https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/frontend/src/components/TaskCard.jsx): `frontend/src/components/TaskCard.jsx`
- [Workspace sidebar](https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/frontend/src/components/Sidebar.jsx): `frontend/src/components/Sidebar.jsx`
- [Member invites](https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/frontend/src/components/InviteModal.jsx): `frontend/src/components/InviteModal.jsx`
- [Dashboard top bar](https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/frontend/src/components/TopBar.jsx): `frontend/src/components/TopBar.jsx`
- [HTTP client](https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/frontend/src/api/client.js): `frontend/src/api/client.js`

### API and domain

- [Organization routes](https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/backend/routes/orgRoutes.js): `backend/routes/orgRoutes.js`
- [Organization service](https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/backend/services/orgService.js): `backend/services/orgService.js`
- [Organization records](https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/backend/models/Organization.js): `backend/models/Organization.js`
- [Workspace routes](https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/backend/routes/workspaceRoutes.js): `backend/routes/workspaceRoutes.js`
- [Workspace service](https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/backend/services/workspaceService.js): `backend/services/workspaceService.js`
- [Workspace records](https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/backend/models/Workspace.js): `backend/models/Workspace.js`
- [Task routes](https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/backend/routes/taskRoutes.js): `backend/routes/taskRoutes.js`
- [Task service](https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/backend/services/taskService.js): `backend/services/taskService.js`
- [Task records](https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/backend/models/Task.js): `backend/models/Task.js`
- [HTTP server](https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/backend/server.js): `backend/server.js`
- [Error handling](https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/backend/middleware/errorHandler.js): `backend/middleware/errorHandler.js`

### Identity and access

- [Session state](https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Authentication routes](https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/backend/routes/authRoutes.js): `backend/routes/authRoutes.js`
- [Authentication service](https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/backend/services/authService.js): `backend/services/authService.js`
- [Token verification](https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/backend/middleware/auth.js): `backend/middleware/auth.js`
- [Role checks](https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/backend/middleware/rbac.js): `backend/middleware/rbac.js`
- [User records](https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/backend/models/User.js): `backend/models/User.js`

### Live collaboration

- [Socket client state](https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/frontend/src/context/SocketContext.jsx): `frontend/src/context/SocketContext.jsx`
- [Workspace socket rooms](https://github.com/dimpesh10/multi-tenant-saas-task-manager/blob/main/backend/sockets/index.js): `backend/sockets/index.js`

### Other components

- **User**

## Connections

- User → Routes and providers: uses (evidence: `frontend/src/App.jsx`)
- Routes and providers → Sign in and register: routes to (evidence: `frontend/src/App.jsx`)
- Routes and providers → Organization setup: routes to (evidence: `frontend/src/App.jsx`)
- Routes and providers → Dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Sign in and register → Session state: uses session (evidence: `frontend/src/pages/Login.jsx`)
- Organization setup → HTTP client: sends requests (evidence: `frontend/src/pages/CreateOrg.jsx`)
- Dashboard → HTTP client: sends requests (evidence: `frontend/src/pages/Dashboard.jsx`)
- Dashboard → Kanban board: renders (evidence: `frontend/src/pages/Dashboard.jsx`)
- Dashboard → Task editor: renders (evidence: `frontend/src/pages/Dashboard.jsx`)
- Dashboard → Workspace sidebar: renders (evidence: `frontend/src/pages/Dashboard.jsx`)
- Dashboard → Member invites: renders (evidence: `frontend/src/pages/Dashboard.jsx`)
- Dashboard → Dashboard top bar: renders (evidence: `frontend/src/pages/Dashboard.jsx`)
- Kanban board → Task card: renders (evidence: `frontend/src/components/KanbanBoard.jsx`)
- Session state → HTTP client: calls (evidence: `frontend/src/context/AuthContext.jsx`)
- HTTP client → HTTP server: sends HTTP (evidence: `frontend/src/api/client.js`)
- HTTP server → Authentication routes: mounts (evidence: `backend/server.js`)
- HTTP server → Organization routes: mounts (evidence: `backend/server.js`)
- HTTP server → Workspace routes: mounts (evidence: `backend/server.js`)
- HTTP server → Task routes: mounts (evidence: `backend/server.js`)
- HTTP server → Workspace socket rooms: initializes (evidence: `backend/server.js`)
- HTTP server → Error handling: registers (evidence: `backend/server.js`)
- Authentication routes → Authentication service: calls (evidence: `backend/routes/authRoutes.js`)
- Authentication routes → Token verification: applies (evidence: `backend/routes/authRoutes.js`)
- Authentication service → User records: reads and writes (evidence: `backend/services/authService.js`)
- Token verification → User records: loads user (evidence: `backend/middleware/auth.js`)
- Organization routes → Organization service: calls (evidence: `backend/routes/orgRoutes.js`)
- Organization routes → Token verification: applies (evidence: `backend/routes/orgRoutes.js`)
- Organization routes → Role checks: checks roles (evidence: `backend/routes/orgRoutes.js`)
- Organization service → Organization records: uses records (evidence: `backend/services/orgService.js`)
- Organization service → User records: uses records (evidence: `backend/services/orgService.js`)
- Workspace routes → Workspace service: calls (evidence: `backend/routes/workspaceRoutes.js`)
- Workspace routes → Token verification: applies (evidence: `backend/routes/workspaceRoutes.js`)
- Workspace routes → Role checks: checks roles (evidence: `backend/routes/workspaceRoutes.js`)
- Workspace service → Workspace records: uses records (evidence: `backend/services/workspaceService.js`)
- Task routes → Task service: calls (evidence: `backend/routes/taskRoutes.js`)
- Task routes → Token verification: applies (evidence: `backend/routes/taskRoutes.js`)
- Task routes → Role checks: checks roles (evidence: `backend/routes/taskRoutes.js`)
- Task service → Task records: uses records (evidence: `backend/services/taskService.js`)
- Task service → Workspace records: uses records (evidence: `backend/services/taskService.js`)
- Task service → Workspace socket rooms: emits updates (evidence: `backend/services/taskService.js`)
- Socket client state → Session state: uses session (evidence: `frontend/src/context/SocketContext.jsx`)
- Socket client state → Workspace socket rooms: connects to
