# jatlashivakumar/flowdesk-collaborative-platform architecture

> Architecture diagram of the GitHub repository jatlashivakumar/flowdesk-collaborative-platform, 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/jatlashivakumar/flowdesk-collaborative-platform
- Repository: https://github.com/jatlashivakumar/flowdesk-collaborative-platform

## Overview

FlowDesk is a collaborative project-management work OS. Users register or sign in, create workspaces and projects, then manage paginated, version-checked tasks on a Kanban board; updates can reach collaborators in real time, while assignment and invitation notifications are processed asynchronously. The graph preserves the documented member-management, file-upload, and collaboration capabilities. Some frontend and integration wiring is documented rather than visible in the sampled source, so those relationships are cited to the README or left unverified.

Main entry points: [`apps/web/src/App.tsx`](https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/web/src/App.tsx) (React application), [`apps/api/src/routes/index.ts`](https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/api/src/routes/index.ts) (API routes), [`apps/api/src/services/queue.service.ts`](https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/api/src/services/queue.service.ts) (Notification worker), [`apps/api/src/config/db.ts`](https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/api/src/config/db.ts) (PostgreSQL)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_webapp["React application<br/>[App.tsx]"]
  node_webapi["API client<br/>[api.ts]"]
  node_board["Kanban board<br/>[TaskCard.tsx]"]
  node_workspaceui["Workspace UI"]
  node_authui["Authentication pages<br/>[LoginPage.tsx]"]
  node_socketclient["Socket client<br/>[socket.ts]"]
end

subgraph group_api["API and domain"]
  node_apiapp["Express API<br/>[app.ts]"]
  node_routes["API routes<br/>[index.ts]"]
  node_auth["Authentication<br/>[auth.controller.ts]"]
  node_workspaces["Workspace members"]
  node_projects["Project management"]
  node_tasks["Tasks and comments<br/>[task.controller.ts]"]
  node_authorization["Access control<br/>[auth.middleware.ts]"]
end

subgraph group_realtime["Collaboration and jobs"]
  node_socketserver["Socket.IO sync<br/>[io.ts]"]
  node_notifications["Notification worker<br/>[queue.service.ts]"]
end

subgraph group_infra["Data and integrations"]
  node_database[("PostgreSQL<br/>[db.ts]")]
  node_redis[("Redis queue<br/>[redis.ts]")]
  node_email["Email service<br/>[email.service.ts]"]
  node_s3["S3 uploads<br/>[s3.service.ts]"]
end

node_user(("User"))

node_user -->|"uses"| node_webapp
node_webapp -.->|"requests data"| node_webapi
node_webapp -.->|"presents board"| node_board
node_webapp -.->|"presents workspaces"| node_workspaceui
node_webapp -.->|"supports sign-in"| node_authui
node_webapp -.->|"uses updates"| node_socketclient
node_webapi -->|"calls"| node_apiapp
node_apiapp -->|"mounts"| node_routes
node_routes -->|"routes to"| node_auth
node_routes -->|"routes to"| node_workspaces
node_routes -->|"routes to"| node_projects
node_routes -->|"routes to"| node_tasks
node_routes -->|"applies"| node_authorization
node_auth -->|"reads and writes"| node_database
node_auth -->|"sends welcome"| node_email
node_workspaces -->|"reads and writes"| node_database
node_workspaces -->|"enqueues invite"| node_notifications
node_projects -->|"reads and writes"| node_database
node_tasks -->|"reads and writes"| node_database
node_tasks -->|"emits updates"| node_socketserver
node_tasks -->|"enqueues alerts"| node_notifications
node_notifications -->|"uses queue"| node_redis
node_notifications -->|"persists alerts"| node_database
node_notifications -->|"emits alerts"| node_socketserver
node_notifications -->|"sends emails"| node_email
node_socketclient -->|"synchronizes"| node_socketserver
node_user -.->|"uploads files"| node_s3

click node_webapp "https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/web/src/App.tsx"
click node_webapi "https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/web/src/lib/api.ts"
click node_board "https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/web/src/components/kanban/TaskCard.tsx"
click node_workspaceui "https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/web/src/components/layout/WorkspaceLayout.tsx"
click node_authui "https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/web/src/pages/LoginPage.tsx"
click node_socketclient "https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/web/src/lib/socket.ts"
click node_apiapp "https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/api/src/app.ts"
click node_routes "https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/api/src/routes/index.ts"
click node_auth "https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/api/src/controllers/auth.controller.ts"
click node_workspaces "https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/api/src/controllers/workspace.controller.ts"
click node_projects "https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/api/src/controllers/project.controller.ts"
click node_tasks "https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/api/src/controllers/task.controller.ts"
click node_authorization "https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/api/src/middleware/auth.middleware.ts"
click node_socketserver "https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/api/src/sockets/io.ts"
click node_notifications "https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/api/src/services/queue.service.ts"
click node_database "https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/api/src/config/db.ts"
click node_redis "https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/api/src/config/redis.ts"
click node_email "https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/api/src/services/email.service.ts"
click node_s3 "https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/api/src/services/s3.service.ts"

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_webapp,node_webapi,node_board,node_workspaceui,node_authui,node_socketclient,node_user toneBlue
class node_apiapp,node_routes,node_auth,node_workspaces,node_projects,node_tasks,node_authorization toneAmber
class node_socketserver,node_notifications toneMint
class node_database,node_redis,node_email,node_s3 toneRose
```

## Components

### Web application

- [React application](https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/web/src/App.tsx): `apps/web/src/App.tsx`
- [API client](https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/web/src/lib/api.ts): `apps/web/src/lib/api.ts`
- [Kanban board](https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/web/src/components/kanban/TaskCard.tsx): `apps/web/src/components/kanban/TaskCard.tsx`
- [Workspace UI](https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/web/src/components/layout/WorkspaceLayout.tsx): `apps/web/src/components/layout/WorkspaceLayout.tsx`
- [Authentication pages](https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/web/src/pages/LoginPage.tsx): `apps/web/src/pages/LoginPage.tsx`
- [Socket client](https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/web/src/lib/socket.ts): `apps/web/src/lib/socket.ts`

### API and domain

- [Express API](https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/api/src/app.ts): `apps/api/src/app.ts`
- [API routes](https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/api/src/routes/index.ts): `apps/api/src/routes/index.ts`
- [Authentication](https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/api/src/controllers/auth.controller.ts): `apps/api/src/controllers/auth.controller.ts`
- [Workspace members](https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/api/src/controllers/workspace.controller.ts): `apps/api/src/controllers/workspace.controller.ts`
- [Project management](https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/api/src/controllers/project.controller.ts): `apps/api/src/controllers/project.controller.ts`
- [Tasks and comments](https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/api/src/controllers/task.controller.ts): `apps/api/src/controllers/task.controller.ts`
- [Access control](https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/api/src/middleware/auth.middleware.ts): `apps/api/src/middleware/auth.middleware.ts`

### Collaboration and jobs

- [Socket.IO sync](https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/api/src/sockets/io.ts): `apps/api/src/sockets/io.ts`
- [Notification worker](https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/api/src/services/queue.service.ts): `apps/api/src/services/queue.service.ts`

### Data and integrations

- [PostgreSQL](https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/api/src/config/db.ts): `apps/api/src/config/db.ts`
- [Redis queue](https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/api/src/config/redis.ts): `apps/api/src/config/redis.ts`
- [Email service](https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/api/src/services/email.service.ts): `apps/api/src/services/email.service.ts`
- [S3 uploads](https://github.com/jatlashivakumar/flowdesk-collaborative-platform/blob/main/apps/api/src/services/s3.service.ts): `apps/api/src/services/s3.service.ts`

### Other components

- **User**

## Connections

- User → React application: uses (evidence: `README.md`)
- React application → API client: requests data
- React application → Kanban board: presents board
- React application → Workspace UI: presents workspaces
- React application → Authentication pages: supports sign-in
- React application → Socket client: uses updates
- API client → Express API: calls (evidence: `README.md`)
- Express API → API routes: mounts (evidence: `apps/api/src/app.ts`)
- API routes → Authentication: routes to (evidence: `apps/api/src/routes/index.ts`)
- API routes → Workspace members: routes to (evidence: `apps/api/src/routes/index.ts`)
- API routes → Project management: routes to (evidence: `apps/api/src/routes/index.ts`)
- API routes → Tasks and comments: routes to (evidence: `apps/api/src/routes/index.ts`)
- API routes → Access control: applies (evidence: `apps/api/src/routes/index.ts`)
- Authentication → PostgreSQL: reads and writes (evidence: `apps/api/src/controllers/auth.controller.ts`)
- Authentication → Email service: sends welcome (evidence: `apps/api/src/controllers/auth.controller.ts`)
- Workspace members → PostgreSQL: reads and writes (evidence: `apps/api/src/controllers/workspace.controller.ts`)
- Workspace members → Notification worker: enqueues invite (evidence: `apps/api/src/controllers/workspace.controller.ts`)
- Project management → PostgreSQL: reads and writes (evidence: `apps/api/src/controllers/project.controller.ts`)
- Tasks and comments → PostgreSQL: reads and writes (evidence: `apps/api/src/controllers/task.controller.ts`)
- Tasks and comments → Socket.IO sync: emits updates (evidence: `apps/api/src/controllers/task.controller.ts`)
- Tasks and comments → Notification worker: enqueues alerts (evidence: `apps/api/src/controllers/task.controller.ts`)
- Notification worker → Redis queue: uses queue (evidence: `apps/api/src/services/queue.service.ts`)
- Notification worker → PostgreSQL: persists alerts (evidence: `apps/api/src/services/queue.service.ts`)
- Notification worker → Socket.IO sync: emits alerts (evidence: `apps/api/src/services/queue.service.ts`)
- Notification worker → Email service: sends emails (evidence: `apps/api/src/services/queue.service.ts`)
- Socket client → Socket.IO sync: synchronizes (evidence: `README.md`)
- User → S3 uploads: uploads files (evidence: `README.md`)
