How jatlashivakumar/flowdesk-collaborative-platform works
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: App.tsx React application · index.ts API routes · queue.service.ts Notification worker · db.ts PostgreSQL
Components 20
Web application
- React application
apps/web/src/App.tsx - API client
apps/web/src/lib/api.ts - Kanban board
apps/web/src/components/kanban/TaskCard.tsx - Workspace UI
apps/web/src/components/layout/WorkspaceLayout.tsx - Authentication pages
apps/web/src/pages/LoginPage.tsx - Socket client
apps/web/src/lib/socket.ts
API and domain
- Express API
apps/api/src/app.ts - API routes
apps/api/src/routes/index.ts - Authentication
apps/api/src/controllers/auth.controller.ts - Workspace members
apps/api/src/controllers/workspace.controller.ts - Project management
apps/api/src/controllers/project.controller.ts - Tasks and comments
apps/api/src/controllers/task.controller.ts - Access control
apps/api/src/middleware/auth.middleware.ts
Collaboration and jobs
- Socket.IO sync
apps/api/src/sockets/io.ts - Notification worker
apps/api/src/services/queue.service.ts
Data and integrations
- PostgreSQL
apps/api/src/config/db.ts - Redis queue
apps/api/src/config/redis.ts - Email service
apps/api/src/services/email.service.ts - S3 uploads
apps/api/src/services/s3.service.ts
Other components
- User
Connections 27
- User → React application: uses
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
README.md - Express API → API routes: mounts
apps/api/src/app.ts - API routes → Authentication: routes to
apps/api/src/routes/index.ts - API routes → Workspace members: routes to
apps/api/src/routes/index.ts - API routes → Project management: routes to
apps/api/src/routes/index.ts - API routes → Tasks and comments: routes to
apps/api/src/routes/index.ts - API routes → Access control: applies
apps/api/src/routes/index.ts - Authentication → PostgreSQL: reads and writes
apps/api/src/controllers/auth.controller.ts - Authentication → Email service: sends welcome
apps/api/src/controllers/auth.controller.ts - Workspace members → PostgreSQL: reads and writes
apps/api/src/controllers/workspace.controller.ts - Workspace members → Notification worker: enqueues invite
apps/api/src/controllers/workspace.controller.ts - Project management → PostgreSQL: reads and writes
apps/api/src/controllers/project.controller.ts - Tasks and comments → PostgreSQL: reads and writes
apps/api/src/controllers/task.controller.ts - Tasks and comments → Socket.IO sync: emits updates
apps/api/src/controllers/task.controller.ts - Tasks and comments → Notification worker: enqueues alerts
apps/api/src/controllers/task.controller.ts - Notification worker → Redis queue: uses queue
apps/api/src/services/queue.service.ts - Notification worker → PostgreSQL: persists alerts
apps/api/src/services/queue.service.ts - Notification worker → Socket.IO sync: emits alerts
apps/api/src/services/queue.service.ts - Notification worker → Email service: sends emails
apps/api/src/services/queue.service.ts - Socket client → Socket.IO sync: synchronizes
README.md - User → S3 uploads: uploads files
README.md