# rohan28107/teamsync-backend architecture

> Architecture diagram of the GitHub repository rohan28107/teamsync-backend, 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/rohan28107/teamsync-backend
- Repository: https://github.com/rohan28107/teamsync-backend

## Overview

This is an Express/Mongoose backend for account authentication and collaborative workspaces, projects, and tasks. Users authenticate or register, then access workspace membership and role-controlled operations; project and task endpoints support tracking work, while workspace and project analytics expose summaries. Controllers validate requests and invoke domain services, which read and write MongoDB models. The graph follows explicit imports and calls in the excerpts and SOURCE INDEX; some route-to-controller and service-to-model relationships are supported by index references rather than inspected implementations.

Main entry points: [`src/index.ts`](https://github.com/rohan28107/teamsync-backend/blob/main/src/index.ts) (Express server), [`src/services/member.service.ts`](https://github.com/rohan28107/teamsync-backend/blob/main/src/services/member.service.ts) (Member service), [`src/services/workspace.service.ts`](https://github.com/rohan28107/teamsync-backend/blob/main/src/services/workspace.service.ts) (Workspace service), [`src/services/auth.service.ts`](https://github.com/rohan28107/teamsync-backend/blob/main/src/services/auth.service.ts) (Auth service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["HTTP runtime"]
  node_server["Express server<br/>[index.ts]"]
  node_auth_routes["Auth routes<br/>[auth.route.ts]"]
  node_workspace_routes["Workspace routes<br/>[workspace.route.ts]"]
  node_member_routes["Member routes<br/>[member.route.ts]"]
  node_project_routes["Project routes<br/>[project.route.ts]"]
  node_task_routes["Task routes<br/>[task.route.ts]"]
end

subgraph group_identity["Identity and access"]
  node_auth_controller["Auth controller<br/>[auth.controller.ts]"]
  node_auth_service["Auth service<br/>[auth.service.ts]"]
  node_jwt_auth["JWT authentication"]
  node_role_access["Role permissions<br/>[roleGuard.ts]"]
end

subgraph group_collaboration["Workspace collaboration"]
  node_workspace_controller["Workspace controller"]
  node_workspace_service["Workspace service"]
  node_member_controller["Member controller"]
  node_member_service["Member service<br/>[member.service.ts]"]
  node_project_controller["Project controller"]
  node_project_service["Project service<br/>[project.service.ts]"]
  node_task_controller["Task controller<br/>[task.controller.ts]"]
  node_task_service["Task service<br/>[task.service.ts]"]
end

subgraph group_persistence["Domain data"]
  node_auth_models[("Account and user<br/>[account.model.ts]")]
  node_workspace_model[("Workspace records<br/>[workspace.model.ts]")]
  node_member_model[("Membership records<br/>[member.model.ts]")]
  node_role_model[("Role records")]
  node_project_model[("Project records<br/>[project.model.ts]")]
  node_task_model[("Task records<br/>[task.model.ts]")]
end

node_client(("API client"))
node_mongo[("MongoDB")]

node_client -->|"sends requests"| node_server
node_server -->|"mounts"| node_auth_routes
node_server -->|"mounts"| node_workspace_routes
node_server -->|"mounts"| node_member_routes
node_server -->|"mounts"| node_project_routes
node_server -->|"mounts"| node_task_routes
node_auth_routes -->|"routes to"| node_auth_controller
node_workspace_routes -->|"routes to"| node_workspace_controller
node_member_routes -.->|"routes to"| node_member_controller
node_project_routes -->|"routes to"| node_project_controller
node_task_routes -.->|"routes to"| node_task_controller
node_server -->|"protects routes"| node_jwt_auth
node_auth_controller -->|"invokes"| node_auth_service
node_auth_service -->|"reads and writes"| node_auth_models
node_auth_service -->|"creates workspace"| node_workspace_model
node_auth_service -->|"creates membership"| node_member_model
node_auth_service -->|"looks up role"| node_role_model
node_workspace_controller -->|"invokes"| node_workspace_service
node_workspace_controller -->|"checks membership"| node_member_service
node_workspace_controller -->|"checks permission"| node_role_access
node_member_controller -->|"invokes"| node_member_service
node_project_controller -->|"invokes"| node_project_service
node_project_controller -->|"checks membership"| node_member_service
node_project_controller -->|"checks permission"| node_role_access
node_task_controller -->|"invokes"| node_task_service
node_task_controller -->|"checks membership"| node_member_service
node_task_controller -->|"checks permission"| node_role_access
node_workspace_service -->|"reads and writes"| node_workspace_model
node_workspace_service -->|"reads and writes"| node_member_model
node_workspace_service -->|"reads roles"| node_role_model
node_workspace_service -->|"queries tasks"| node_task_model
node_workspace_service -->|"deletes projects"| node_project_model
node_member_service -->|"checks workspace"| node_workspace_model
node_member_service -->|"reads and writes"| node_member_model
node_member_service -->|"reads roles"| node_role_model
node_project_service -->|"reads and writes"| node_project_model
node_project_service -->|"uses task data"| node_task_model
node_task_service -->|"reads and writes"| node_task_model
node_task_service -->|"checks project"| node_project_model
node_task_service -->|"checks assignee"| node_member_model
node_server -->|"connects on startup"| node_mongo
node_workspace_model -.->|"persists records"| node_mongo
node_member_model -.->|"persists records"| node_mongo
node_role_model -.->|"persists records"| node_mongo
node_project_model -.->|"persists records"| node_mongo
node_task_model -.->|"persists records"| node_mongo
node_auth_models -.->|"persists records"| node_mongo

click node_server "https://github.com/rohan28107/teamsync-backend/blob/main/src/index.ts"
click node_auth_routes "https://github.com/rohan28107/teamsync-backend/blob/main/src/routes/auth.route.ts"
click node_workspace_routes "https://github.com/rohan28107/teamsync-backend/blob/main/src/routes/workspace.route.ts"
click node_member_routes "https://github.com/rohan28107/teamsync-backend/blob/main/src/routes/member.route.ts"
click node_project_routes "https://github.com/rohan28107/teamsync-backend/blob/main/src/routes/project.route.ts"
click node_task_routes "https://github.com/rohan28107/teamsync-backend/blob/main/src/routes/task.route.ts"
click node_auth_controller "https://github.com/rohan28107/teamsync-backend/blob/main/src/controllers/auth.controller.ts"
click node_auth_service "https://github.com/rohan28107/teamsync-backend/blob/main/src/services/auth.service.ts"
click node_auth_models "https://github.com/rohan28107/teamsync-backend/blob/main/src/models/account.model.ts"
click node_jwt_auth "https://github.com/rohan28107/teamsync-backend/blob/main/src/middlewares/jwtAuth.middleware.ts"
click node_role_access "https://github.com/rohan28107/teamsync-backend/blob/main/src/utils/roleGuard.ts"
click node_workspace_controller "https://github.com/rohan28107/teamsync-backend/blob/main/src/controllers/workspace.controller.ts"
click node_workspace_service "https://github.com/rohan28107/teamsync-backend/blob/main/src/services/workspace.service.ts"
click node_member_controller "https://github.com/rohan28107/teamsync-backend/blob/main/src/controllers/member.controller.ts"
click node_member_service "https://github.com/rohan28107/teamsync-backend/blob/main/src/services/member.service.ts"
click node_project_controller "https://github.com/rohan28107/teamsync-backend/blob/main/src/controllers/project.controller.ts"
click node_project_service "https://github.com/rohan28107/teamsync-backend/blob/main/src/services/project.service.ts"
click node_task_controller "https://github.com/rohan28107/teamsync-backend/blob/main/src/controllers/task.controller.ts"
click node_task_service "https://github.com/rohan28107/teamsync-backend/blob/main/src/services/task.service.ts"
click node_workspace_model "https://github.com/rohan28107/teamsync-backend/blob/main/src/models/workspace.model.ts"
click node_member_model "https://github.com/rohan28107/teamsync-backend/blob/main/src/models/member.model.ts"
click node_role_model "https://github.com/rohan28107/teamsync-backend/blob/main/src/models/roles-permission.model.ts"
click node_project_model "https://github.com/rohan28107/teamsync-backend/blob/main/src/models/project.model.ts"
click node_task_model "https://github.com/rohan28107/teamsync-backend/blob/main/src/models/task.model.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_server,node_auth_routes,node_workspace_routes,node_member_routes,node_project_routes,node_task_routes,node_client toneBlue
class node_auth_controller,node_auth_service,node_jwt_auth,node_role_access,node_mongo toneAmber
class node_workspace_controller,node_workspace_service,node_member_controller,node_member_service,node_project_controller,node_project_service,node_task_controller,node_task_service toneMint
class node_auth_models,node_workspace_model,node_member_model,node_role_model,node_project_model,node_task_model toneRose
```

## Components

### HTTP runtime

- [Express server](https://github.com/rohan28107/teamsync-backend/blob/main/src/index.ts): `src/index.ts`
- [Auth routes](https://github.com/rohan28107/teamsync-backend/blob/main/src/routes/auth.route.ts): `src/routes/auth.route.ts`
- [Workspace routes](https://github.com/rohan28107/teamsync-backend/blob/main/src/routes/workspace.route.ts): `src/routes/workspace.route.ts`
- [Member routes](https://github.com/rohan28107/teamsync-backend/blob/main/src/routes/member.route.ts): `src/routes/member.route.ts`
- [Project routes](https://github.com/rohan28107/teamsync-backend/blob/main/src/routes/project.route.ts): `src/routes/project.route.ts`
- [Task routes](https://github.com/rohan28107/teamsync-backend/blob/main/src/routes/task.route.ts): `src/routes/task.route.ts`

### Identity and access

- [Auth controller](https://github.com/rohan28107/teamsync-backend/blob/main/src/controllers/auth.controller.ts): `src/controllers/auth.controller.ts`
- [Auth service](https://github.com/rohan28107/teamsync-backend/blob/main/src/services/auth.service.ts): `src/services/auth.service.ts`
- [JWT authentication](https://github.com/rohan28107/teamsync-backend/blob/main/src/middlewares/jwtAuth.middleware.ts): `src/middlewares/jwtAuth.middleware.ts`
- [Role permissions](https://github.com/rohan28107/teamsync-backend/blob/main/src/utils/roleGuard.ts): `src/utils/roleGuard.ts`

### Workspace collaboration

- [Workspace controller](https://github.com/rohan28107/teamsync-backend/blob/main/src/controllers/workspace.controller.ts): `src/controllers/workspace.controller.ts`
- [Workspace service](https://github.com/rohan28107/teamsync-backend/blob/main/src/services/workspace.service.ts): `src/services/workspace.service.ts`
- [Member controller](https://github.com/rohan28107/teamsync-backend/blob/main/src/controllers/member.controller.ts): `src/controllers/member.controller.ts`
- [Member service](https://github.com/rohan28107/teamsync-backend/blob/main/src/services/member.service.ts): `src/services/member.service.ts`
- [Project controller](https://github.com/rohan28107/teamsync-backend/blob/main/src/controllers/project.controller.ts): `src/controllers/project.controller.ts`
- [Project service](https://github.com/rohan28107/teamsync-backend/blob/main/src/services/project.service.ts): `src/services/project.service.ts`
- [Task controller](https://github.com/rohan28107/teamsync-backend/blob/main/src/controllers/task.controller.ts): `src/controllers/task.controller.ts`
- [Task service](https://github.com/rohan28107/teamsync-backend/blob/main/src/services/task.service.ts): `src/services/task.service.ts`

### Domain data

- [Account and user](https://github.com/rohan28107/teamsync-backend/blob/main/src/models/account.model.ts): `src/models/account.model.ts`
- [Workspace records](https://github.com/rohan28107/teamsync-backend/blob/main/src/models/workspace.model.ts): `src/models/workspace.model.ts`
- [Membership records](https://github.com/rohan28107/teamsync-backend/blob/main/src/models/member.model.ts): `src/models/member.model.ts`
- [Role records](https://github.com/rohan28107/teamsync-backend/blob/main/src/models/roles-permission.model.ts): `src/models/roles-permission.model.ts`
- [Project records](https://github.com/rohan28107/teamsync-backend/blob/main/src/models/project.model.ts): `src/models/project.model.ts`
- [Task records](https://github.com/rohan28107/teamsync-backend/blob/main/src/models/task.model.ts): `src/models/task.model.ts`

### Other components

- **API client**
- **MongoDB**

## Connections

- API client → Express server: sends requests
- Express server → Auth routes: mounts (evidence: `src/index.ts`)
- Express server → Workspace routes: mounts (evidence: `src/index.ts`)
- Express server → Member routes: mounts (evidence: `src/index.ts`)
- Express server → Project routes: mounts (evidence: `src/index.ts`)
- Express server → Task routes: mounts (evidence: `src/index.ts`)
- Auth routes → Auth controller: routes to (evidence: `src/routes/auth.route.ts`)
- Workspace routes → Workspace controller: routes to (evidence: `src/routes/workspace.route.ts`)
- Member routes → Member controller: routes to
- Project routes → Project controller: routes to (evidence: `src/routes/project.route.ts`)
- Task routes → Task controller: routes to
- Express server → JWT authentication: protects routes (evidence: `src/index.ts`)
- Auth controller → Auth service: invokes (evidence: `src/controllers/auth.controller.ts`)
- Auth service → Account and user: reads and writes (evidence: `src/services/auth.service.ts`)
- Auth service → Workspace records: creates workspace (evidence: `src/services/auth.service.ts`)
- Auth service → Membership records: creates membership (evidence: `src/services/auth.service.ts`)
- Auth service → Role records: looks up role (evidence: `src/services/auth.service.ts`)
- Workspace controller → Workspace service: invokes (evidence: `src/controllers/workspace.controller.ts`)
- Workspace controller → Member service: checks membership (evidence: `src/controllers/workspace.controller.ts`)
- Workspace controller → Role permissions: checks permission (evidence: `src/controllers/workspace.controller.ts`)
- Member controller → Member service: invokes (evidence: `src/controllers/member.controller.ts`)
- Project controller → Project service: invokes (evidence: `src/controllers/project.controller.ts`)
- Project controller → Member service: checks membership (evidence: `src/controllers/project.controller.ts`)
- Project controller → Role permissions: checks permission (evidence: `src/controllers/project.controller.ts`)
- Task controller → Task service: invokes (evidence: `src/controllers/task.controller.ts`)
- Task controller → Member service: checks membership (evidence: `src/controllers/task.controller.ts`)
- Task controller → Role permissions: checks permission (evidence: `src/controllers/task.controller.ts`)
- Workspace service → Workspace records: reads and writes (evidence: `src/services/workspace.service.ts`)
- Workspace service → Membership records: reads and writes (evidence: `src/services/workspace.service.ts`)
- Workspace service → Role records: reads roles (evidence: `src/services/workspace.service.ts`)
- Workspace service → Task records: queries tasks (evidence: `src/services/workspace.service.ts`)
- Workspace service → Project records: deletes projects (evidence: `src/services/workspace.service.ts`)
- Member service → Workspace records: checks workspace (evidence: `src/services/member.service.ts`)
- Member service → Membership records: reads and writes (evidence: `src/services/member.service.ts`)
- Member service → Role records: reads roles (evidence: `src/services/member.service.ts`)
- Project service → Project records: reads and writes (evidence: `src/services/project.service.ts`)
- Project service → Task records: uses task data (evidence: `src/services/project.service.ts`)
- Task service → Task records: reads and writes (evidence: `src/services/task.service.ts`)
- Task service → Project records: checks project (evidence: `src/services/task.service.ts`)
- Task service → Membership records: checks assignee (evidence: `src/services/task.service.ts`)
- Express server → MongoDB: connects on startup (evidence: `src/index.ts`)
- Workspace records → MongoDB: persists records
- Membership records → MongoDB: persists records
- Role records → MongoDB: persists records
- Project records → MongoDB: persists records
- Task records → MongoDB: persists records
- Account and user → MongoDB: persists records
