# anoop-kumar-31/queueflow_backend architecture

> Architecture diagram of the GitHub repository anoop-kumar-31/queueflow_backend, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/anoop-kumar-31/queueflow_backend
- Repository: https://github.com/anoop-kumar-31/queueflow_backend

## Overview

QueueFlow is a real-time Kanban project-management backend. Clients use authenticated REST routes to register or sign in, manage project workspaces and members, and create, assign, reorder, and annotate tasks; project activity and analytics support workspace oversight. Controllers persist domain state and task/project changes also emit Socket.io updates. The README documents invitations, RBAC, pagination, analytics, and activity history; only sampled source relationships are shown where implementation details were not excerpted.

Main entry points: [`src/server.js`](https://github.com/anoop-kumar-31/queueflow_backend/blob/main/src/server.js) (HTTP server), [`src/routes/projectRoutes.js`](https://github.com/anoop-kumar-31/queueflow_backend/blob/main/src/routes/projectRoutes.js) (Project routes), [`src/routes/authRoutes.js`](https://github.com/anoop-kumar-31/queueflow_backend/blob/main/src/routes/authRoutes.js) (Auth routes), [`src/routes/taskRoutes.js`](https://github.com/anoop-kumar-31/queueflow_backend/blob/main/src/routes/taskRoutes.js) (Task routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API entry and security"]
  node_server["HTTP server<br/>[server.js]"]
  node_auth_routes["Auth routes<br/>[authRoutes.js]"]
  node_project_routes["Project routes<br/>[projectRoutes.js]"]
  node_task_routes["Task routes<br/>[taskRoutes.js]"]
end

subgraph group_identity["Identity and access"]
  node_auth_guard["JWT guard<br/>[authMiddleware.js]"]
  node_project_guard["Project roles<br/>[projectAuth.js]"]
  node_rate_limiter["Rate limits<br/>[rateLimiter.js]"]
  node_auth_controller["Authentication<br/>[authController.js]"]
end

subgraph group_workspace["Workspace and insights"]
  node_project_controller["Projects and invites"]
  node_analytics["Dashboard analytics"]
  node_activity["Activity timeline"]
end

subgraph group_work["Tasks and collaboration"]
  node_task_controller["Tasks and notes<br/>[taskController.js]"]
end

subgraph group_runtime["Persistence and realtime"]
  node_prisma_client["Prisma client<br/>[prismaClient.js]"]
  node_database[("PostgreSQL<br/>[schema.prisma]")]
  node_socket["Socket.io rooms<br/>[socket.js]"]
end

node_http_clients(("API clients"))
node_socket_clients(("Realtime clients"))

node_http_clients -->|"send requests"| node_server
node_server -->|"mounts routes"| node_auth_routes
node_server -->|"mounts routes"| node_project_routes
node_server -->|"mounts routes"| node_task_routes
node_server -->|"initializes"| node_socket
node_server -->|"applies limiter"| node_rate_limiter
node_auth_routes -->|"dispatches"| node_auth_controller
node_auth_routes -->|"protects routes"| node_auth_guard
node_auth_routes -->|"limits login"| node_rate_limiter
node_project_routes -->|"dispatches"| node_project_controller
node_project_routes -->|"dispatches"| node_analytics
node_project_routes -->|"requires token"| node_auth_guard
node_project_routes -->|"checks roles"| node_project_guard
node_project_routes -->|"limits invites"| node_rate_limiter
node_task_routes -->|"dispatches"| node_task_controller
node_task_routes -->|"requires token"| node_auth_guard
node_task_routes -->|"checks roles"| node_project_guard
node_auth_controller -->|"queries users"| node_prisma_client
node_project_controller -->|"queries workspace"| node_prisma_client
node_task_controller -->|"reads and writes"| node_database
node_project_guard -->|"checks membership"| node_prisma_client
node_task_controller -->|"emits updates"| node_socket
node_project_controller -->|"emits activity"| node_socket
node_socket_clients -->|"join rooms"| node_socket

click node_server "https://github.com/anoop-kumar-31/queueflow_backend/blob/main/src/server.js"
click node_auth_routes "https://github.com/anoop-kumar-31/queueflow_backend/blob/main/src/routes/authRoutes.js"
click node_project_routes "https://github.com/anoop-kumar-31/queueflow_backend/blob/main/src/routes/projectRoutes.js"
click node_task_routes "https://github.com/anoop-kumar-31/queueflow_backend/blob/main/src/routes/taskRoutes.js"
click node_auth_guard "https://github.com/anoop-kumar-31/queueflow_backend/blob/main/src/middleware/authMiddleware.js"
click node_project_guard "https://github.com/anoop-kumar-31/queueflow_backend/blob/main/src/middleware/projectAuth.js"
click node_rate_limiter "https://github.com/anoop-kumar-31/queueflow_backend/blob/main/src/middleware/rateLimiter.js"
click node_auth_controller "https://github.com/anoop-kumar-31/queueflow_backend/blob/main/src/controllers/authController.js"
click node_project_controller "https://github.com/anoop-kumar-31/queueflow_backend/blob/main/src/controllers/projectController.js"
click node_analytics "https://github.com/anoop-kumar-31/queueflow_backend/blob/main/src/controllers/analyticsController.js"
click node_task_controller "https://github.com/anoop-kumar-31/queueflow_backend/blob/main/src/controllers/taskController.js"
click node_activity "https://github.com/anoop-kumar-31/queueflow_backend/blob/main/src/controllers/projectController.js"
click node_prisma_client "https://github.com/anoop-kumar-31/queueflow_backend/blob/main/src/utils/prismaClient.js"
click node_database "https://github.com/anoop-kumar-31/queueflow_backend/blob/main/prisma/schema.prisma"
click node_socket "https://github.com/anoop-kumar-31/queueflow_backend/blob/main/src/socket.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_server,node_auth_routes,node_project_routes,node_task_routes,node_http_clients,node_socket_clients toneBlue
class node_auth_guard,node_project_guard,node_rate_limiter,node_auth_controller toneAmber
class node_project_controller,node_analytics,node_activity toneMint
class node_task_controller toneRose
class node_prisma_client,node_database,node_socket toneIndigo
```

## Components

### API entry and security

- [HTTP server](https://github.com/anoop-kumar-31/queueflow_backend/blob/main/src/server.js): `src/server.js`
- [Auth routes](https://github.com/anoop-kumar-31/queueflow_backend/blob/main/src/routes/authRoutes.js): `src/routes/authRoutes.js`
- [Project routes](https://github.com/anoop-kumar-31/queueflow_backend/blob/main/src/routes/projectRoutes.js): `src/routes/projectRoutes.js`
- [Task routes](https://github.com/anoop-kumar-31/queueflow_backend/blob/main/src/routes/taskRoutes.js): `src/routes/taskRoutes.js`

### Identity and access

- [JWT guard](https://github.com/anoop-kumar-31/queueflow_backend/blob/main/src/middleware/authMiddleware.js): `src/middleware/authMiddleware.js`
- [Project roles](https://github.com/anoop-kumar-31/queueflow_backend/blob/main/src/middleware/projectAuth.js): `src/middleware/projectAuth.js`
- [Rate limits](https://github.com/anoop-kumar-31/queueflow_backend/blob/main/src/middleware/rateLimiter.js): `src/middleware/rateLimiter.js`
- [Authentication](https://github.com/anoop-kumar-31/queueflow_backend/blob/main/src/controllers/authController.js): `src/controllers/authController.js`

### Workspace and insights

- [Projects and invites](https://github.com/anoop-kumar-31/queueflow_backend/blob/main/src/controllers/projectController.js): `src/controllers/projectController.js`
- [Dashboard analytics](https://github.com/anoop-kumar-31/queueflow_backend/blob/main/src/controllers/analyticsController.js): `src/controllers/analyticsController.js`
- [Activity timeline](https://github.com/anoop-kumar-31/queueflow_backend/blob/main/src/controllers/projectController.js): `src/controllers/projectController.js`

### Tasks and collaboration

- [Tasks and notes](https://github.com/anoop-kumar-31/queueflow_backend/blob/main/src/controllers/taskController.js): `src/controllers/taskController.js`

### Persistence and realtime

- [Prisma client](https://github.com/anoop-kumar-31/queueflow_backend/blob/main/src/utils/prismaClient.js): `src/utils/prismaClient.js`
- [PostgreSQL](https://github.com/anoop-kumar-31/queueflow_backend/blob/main/prisma/schema.prisma): `prisma/schema.prisma`
- [Socket.io rooms](https://github.com/anoop-kumar-31/queueflow_backend/blob/main/src/socket.js): `src/socket.js`

### Other components

- **API clients**
- **Realtime clients**

## Connections

- API clients → HTTP server: send requests (evidence: `src/server.js`)
- HTTP server → Auth routes: mounts routes (evidence: `src/server.js`)
- HTTP server → Project routes: mounts routes (evidence: `src/server.js`)
- HTTP server → Task routes: mounts routes (evidence: `src/server.js`)
- HTTP server → Socket.io rooms: initializes (evidence: `src/server.js`)
- HTTP server → Rate limits: applies limiter (evidence: `src/server.js`)
- Auth routes → Authentication: dispatches (evidence: `src/routes/authRoutes.js`)
- Auth routes → JWT guard: protects routes (evidence: `src/routes/authRoutes.js`)
- Auth routes → Rate limits: limits login (evidence: `src/routes/authRoutes.js`)
- Project routes → Projects and invites: dispatches (evidence: `src/routes/projectRoutes.js`)
- Project routes → Dashboard analytics: dispatches (evidence: `src/routes/projectRoutes.js`)
- Project routes → JWT guard: requires token (evidence: `src/routes/projectRoutes.js`)
- Project routes → Project roles: checks roles (evidence: `src/routes/projectRoutes.js`)
- Project routes → Rate limits: limits invites (evidence: `src/routes/projectRoutes.js`)
- Task routes → Tasks and notes: dispatches (evidence: `src/routes/taskRoutes.js`)
- Task routes → JWT guard: requires token (evidence: `src/routes/taskRoutes.js`)
- Task routes → Project roles: checks roles (evidence: `src/routes/taskRoutes.js`)
- Authentication → Prisma client: queries users (evidence: `src/controllers/authController.js`)
- Projects and invites → Prisma client: queries workspace (evidence: `src/controllers/projectController.js`)
- Tasks and notes → PostgreSQL: reads and writes (evidence: `src/controllers/taskController.js`)
- Project roles → Prisma client: checks membership (evidence: `src/middleware/projectAuth.js`)
- Tasks and notes → Socket.io rooms: emits updates (evidence: `src/controllers/taskController.js`)
- Projects and invites → Socket.io rooms: emits activity (evidence: `src/controllers/projectController.js`)
- Realtime clients → Socket.io rooms: join rooms (evidence: `src/socket.js`)
