# madhan5153/project-management-and-team-collaboration-platfrom architecture

> Architecture diagram of the GitHub repository madhan5153/project-management-and-team-collaboration-platfrom, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/madhan5153/project-management-and-team-collaboration-platfrom
- Repository: https://github.com/madhan5153/project-management-and-team-collaboration-platfrom

## Overview

Taskly is a project-management and team-collaboration application. Users enter through the web app, authenticate, then work with projects and tasks; the README also identifies project-workflow analysis as a capability. The backend exposes dedicated services for projects, tasks, time tracking, documents, risks, analytics, and notifications, alongside account and support workflows. The tree and excerpts show the app’s route structure and several backend calls; many feature implementations were not sampled, so those connections are marked unverified rather than presented as inspected call paths.

Main entry points: [`taskly-frontend/src/pages/ProjectsPage.jsx`](https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-frontend/src/pages/ProjectsPage.jsx) (Projects UI), [`taskly-backend/src/main/java/com/taskly/service/SupportQueryService.java`](https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/service/SupportQueryService.java) (Support queries), [`taskly-frontend/src/App.jsx`](https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-frontend/src/App.jsx) (App routes), [`taskly-backend/src/main/java/com/taskly/service/AuthService.java`](https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/service/AuthService.java) (Authentication service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["App routes<br/>[App.jsx]"]
  node_projectspage["Projects UI<br/>[ProjectsPage.jsx]"]
  node_taskboard["Task board UI<br/>[TaskBoardPage.jsx]"]
  node_authpage["Login and registration<br/>[LoginPage.jsx]"]
  node_authcontext["Authentication state<br/>[AuthContext.jsx]"]
  node_authapi["Auth API client<br/>[authApi.js]"]
  node_projectsapi["Projects API client<br/>[projectsApi.js]"]
  node_tasksapi["Tasks API client<br/>[tasksApi.js]"]
end

subgraph group_identity["Identity and access"]
  node_authcontroller["Auth endpoints"]
  node_authservice["Authentication service<br/>[AuthService.java]"]
  node_jwt["JWT utilities<br/>[JwtUtil.java]"]
  node_userrepo[("User repository")]
end

subgraph group_workspace["Project workspace"]
  node_projectcontroller["Project endpoints"]
  node_projectservice["Project service"]
  node_taskcontroller["Task endpoints"]
  node_taskservice["Task service<br/>[TaskService.java]"]
  node_projectrepo[("Project repository")]
  node_projectsecurity["Project access checks"]
end

subgraph group_collaboration["Collaboration and insights"]
  node_timeservice["Time tracking<br/>[TimeService.java]"]
  node_documents["Document handling"]
  node_risks["Risk management<br/>[RiskService.java]"]
  node_analytics["Workflow analytics"]
  node_notificationservice["Notifications"]
end

subgraph group_operations["Support and administration"]
  node_supportcontroller["Support endpoints"]
  node_supportservice["Support queries"]
  node_supportrepo[("Support query store")]
  node_replyrepo[("Reply store")]
  node_admincontroller["Admin endpoints"]
  node_adminservice["Administration<br/>[AdminService.java]"]
end

node_user(("User"))

node_user -->|"uses"| node_app
node_app -->|"routes"| node_authpage
node_app -->|"routes"| node_projectspage
node_app -->|"routes"| node_taskboard
node_authpage -.->|"reads state"| node_authcontext
node_authcontext -.->|"uses"| node_authapi
node_authapi -.->|"HTTP requests"| node_authcontroller
node_authcontroller -.->|"delegates"| node_authservice
node_authservice -->|"reads/writes"| node_userrepo
node_authservice -->|"creates tokens"| node_jwt
node_projectspage -.->|"uses"| node_projectsapi
node_taskboard -.->|"uses"| node_tasksapi
node_projectsapi -.->|"HTTP requests"| node_projectcontroller
node_tasksapi -.->|"HTTP requests"| node_taskcontroller
node_projectcontroller -.->|"delegates"| node_projectservice
node_projectservice -.->|"reads/writes"| node_projectrepo
node_taskcontroller -.->|"delegates"| node_taskservice
node_taskservice -.->|"checks access"| node_projectsecurity
node_projectsecurity -->|"looks up projects"| node_projectrepo
node_projectspage -.->|"records time"| node_timeservice
node_projectspage -.->|"manages files"| node_documents
node_projectspage -.->|"tracks risks"| node_risks
node_projectspage -.->|"analyzes workflow"| node_analytics
node_supportcontroller -->|"delegates"| node_supportservice
node_supportservice -->|"reads/writes"| node_supportrepo
node_supportservice -->|"stores replies"| node_replyrepo
node_supportservice -->|"notifies admins"| node_notificationservice
node_admincontroller -->|"delegates"| node_adminservice
node_admincontroller -.->|"manages queries"| node_supportservice

click node_app "https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-frontend/src/App.jsx"
click node_projectspage "https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-frontend/src/pages/ProjectsPage.jsx"
click node_taskboard "https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-frontend/src/pages/TaskBoardPage.jsx"
click node_authpage "https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-frontend/src/pages/LoginPage.jsx"
click node_authcontext "https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-frontend/src/context/AuthContext.jsx"
click node_authapi "https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-frontend/src/api/authApi.js"
click node_projectsapi "https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-frontend/src/api/projectsApi.js"
click node_tasksapi "https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-frontend/src/api/tasksApi.js"
click node_authcontroller "https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/controller/AuthController.java"
click node_authservice "https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/service/AuthService.java"
click node_jwt "https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/security/JwtUtil.java"
click node_userrepo "https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/repository/UserRepository.java"
click node_projectcontroller "https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/controller/ProjectController.java"
click node_projectservice "https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/service/ProjectService.java"
click node_taskcontroller "https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/controller/TaskController.java"
click node_taskservice "https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/service/TaskService.java"
click node_projectrepo "https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/repository/ProjectRepository.java"
click node_projectsecurity "https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/security/ProjectSecurityService.java"
click node_timeservice "https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/service/TimeService.java"
click node_documents "https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/service/DocumentService.java"
click node_risks "https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/service/RiskService.java"
click node_analytics "https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/service/AnalyticsService.java"
click node_notificationservice "https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/service/NotificationService.java"
click node_supportcontroller "https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/controller/SupportQueryController.java"
click node_supportservice "https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/service/SupportQueryService.java"
click node_supportrepo "https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/repository/SupportQueryRepository.java"
click node_replyrepo "https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/repository/SupportQueryReplyRepository.java"
click node_admincontroller "https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/controller/AdminController.java"
click node_adminservice "https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/service/AdminService.java"

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_projectspage,node_taskboard,node_authpage,node_authcontext,node_authapi,node_projectsapi,node_tasksapi,node_user toneBlue
class node_authcontroller,node_authservice,node_jwt,node_userrepo toneAmber
class node_projectcontroller,node_projectservice,node_taskcontroller,node_taskservice,node_projectrepo,node_projectsecurity toneMint
class node_timeservice,node_documents,node_risks,node_analytics,node_notificationservice toneRose
class node_supportcontroller,node_supportservice,node_supportrepo,node_replyrepo,node_admincontroller,node_adminservice toneIndigo
```

## Components

### Web application

- [App routes](https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-frontend/src/App.jsx): `taskly-frontend/src/App.jsx`
- [Projects UI](https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-frontend/src/pages/ProjectsPage.jsx): `taskly-frontend/src/pages/ProjectsPage.jsx`
- [Task board UI](https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-frontend/src/pages/TaskBoardPage.jsx): `taskly-frontend/src/pages/TaskBoardPage.jsx`
- [Login and registration](https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-frontend/src/pages/LoginPage.jsx): `taskly-frontend/src/pages/LoginPage.jsx`
- [Authentication state](https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-frontend/src/context/AuthContext.jsx): `taskly-frontend/src/context/AuthContext.jsx`
- [Auth API client](https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-frontend/src/api/authApi.js): `taskly-frontend/src/api/authApi.js`
- [Projects API client](https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-frontend/src/api/projectsApi.js): `taskly-frontend/src/api/projectsApi.js`
- [Tasks API client](https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-frontend/src/api/tasksApi.js): `taskly-frontend/src/api/tasksApi.js`

### Identity and access

- [Auth endpoints](https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/controller/AuthController.java): `taskly-backend/src/main/java/com/taskly/controller/AuthController.java`
- [Authentication service](https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/service/AuthService.java): `taskly-backend/src/main/java/com/taskly/service/AuthService.java`
- [JWT utilities](https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/security/JwtUtil.java): `taskly-backend/src/main/java/com/taskly/security/JwtUtil.java`
- [User repository](https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/repository/UserRepository.java): `taskly-backend/src/main/java/com/taskly/repository/UserRepository.java`

### Project workspace

- [Project endpoints](https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/controller/ProjectController.java): `taskly-backend/src/main/java/com/taskly/controller/ProjectController.java`
- [Project service](https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/service/ProjectService.java): `taskly-backend/src/main/java/com/taskly/service/ProjectService.java`
- [Task endpoints](https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/controller/TaskController.java): `taskly-backend/src/main/java/com/taskly/controller/TaskController.java`
- [Task service](https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/service/TaskService.java): `taskly-backend/src/main/java/com/taskly/service/TaskService.java`
- [Project repository](https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/repository/ProjectRepository.java): `taskly-backend/src/main/java/com/taskly/repository/ProjectRepository.java`
- [Project access checks](https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/security/ProjectSecurityService.java): `taskly-backend/src/main/java/com/taskly/security/ProjectSecurityService.java`

### Collaboration and insights

- [Time tracking](https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/service/TimeService.java): `taskly-backend/src/main/java/com/taskly/service/TimeService.java`
- [Document handling](https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/service/DocumentService.java): `taskly-backend/src/main/java/com/taskly/service/DocumentService.java`
- [Risk management](https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/service/RiskService.java): `taskly-backend/src/main/java/com/taskly/service/RiskService.java`
- [Workflow analytics](https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/service/AnalyticsService.java): `taskly-backend/src/main/java/com/taskly/service/AnalyticsService.java`
- [Notifications](https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/service/NotificationService.java): `taskly-backend/src/main/java/com/taskly/service/NotificationService.java`

### Support and administration

- [Support endpoints](https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/controller/SupportQueryController.java): `taskly-backend/src/main/java/com/taskly/controller/SupportQueryController.java`
- [Support queries](https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/service/SupportQueryService.java): `taskly-backend/src/main/java/com/taskly/service/SupportQueryService.java`
- [Support query store](https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/repository/SupportQueryRepository.java): `taskly-backend/src/main/java/com/taskly/repository/SupportQueryRepository.java`
- [Reply store](https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/repository/SupportQueryReplyRepository.java): `taskly-backend/src/main/java/com/taskly/repository/SupportQueryReplyRepository.java`
- [Admin endpoints](https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/controller/AdminController.java): `taskly-backend/src/main/java/com/taskly/controller/AdminController.java`
- [Administration](https://github.com/madhan5153/project-management-and-team-collaboration-platfrom/blob/main/taskly-backend/src/main/java/com/taskly/service/AdminService.java): `taskly-backend/src/main/java/com/taskly/service/AdminService.java`

### Other components

- **User**

## Connections

- User → App routes: uses (evidence: `taskly-frontend/src/App.jsx`)
- App routes → Login and registration: routes (evidence: `taskly-frontend/src/App.jsx`)
- App routes → Projects UI: routes (evidence: `taskly-frontend/src/App.jsx`)
- App routes → Task board UI: routes (evidence: `taskly-frontend/src/App.jsx`)
- Login and registration → Authentication state: reads state
- Authentication state → Auth API client: uses
- Auth API client → Auth endpoints: HTTP requests
- Auth endpoints → Authentication service: delegates
- Authentication service → User repository: reads/writes (evidence: `taskly-backend/src/main/java/com/taskly/service/AuthService.java`)
- Authentication service → JWT utilities: creates tokens (evidence: `taskly-backend/src/main/java/com/taskly/service/AuthService.java`)
- Projects UI → Projects API client: uses
- Task board UI → Tasks API client: uses
- Projects API client → Project endpoints: HTTP requests
- Tasks API client → Task endpoints: HTTP requests
- Project endpoints → Project service: delegates
- Project service → Project repository: reads/writes
- Task endpoints → Task service: delegates
- Task service → Project access checks: checks access
- Project access checks → Project repository: looks up projects (evidence: `taskly-backend/src/main/java/com/taskly/security/ProjectSecurityService.java`)
- Projects UI → Time tracking: records time
- Projects UI → Document handling: manages files
- Projects UI → Risk management: tracks risks
- Projects UI → Workflow analytics: analyzes workflow
- Support endpoints → Support queries: delegates (evidence: `taskly-backend/src/main/java/com/taskly/controller/SupportQueryController.java`)
- Support queries → Support query store: reads/writes (evidence: `taskly-backend/src/main/java/com/taskly/service/SupportQueryService.java`)
- Support queries → Reply store: stores replies (evidence: `taskly-backend/src/main/java/com/taskly/service/SupportQueryService.java`)
- Support queries → Notifications: notifies admins (evidence: `taskly-backend/src/main/java/com/taskly/service/SupportQueryService.java`)
- Admin endpoints → Administration: delegates (evidence: `taskly-backend/src/main/java/com/taskly/controller/AdminController.java`)
- Admin endpoints → Support queries: manages queries
