# manojgaddigolla/project-management-tool architecture

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

- Interactive diagram: https://gitdiagram.com/manojgaddigolla/project-management-tool
- Repository: https://github.com/manojgaddigolla/project-management-tool

## Overview

ProjecTrak is a team project-management application: users enter a protected dashboard, open a project board, and manage cards and columns; project changes are persisted and broadcast to collaborators. The graph also preserves project/member administration, analytics and AI summaries, activity, and notifications. Source excerpts support the board hook, card/column operations, server wiring, and several persistence relationships; some capability links rely on README documentation, and unsampled implementations are represented only at their exact enclosing paths.

Main entry points: [`backend/controllers/projectController.js`](https://github.com/manojgaddigolla/project-management-tool/blob/main/backend/controllers/projectController.js) (Project management), [`backend/server.js`](https://github.com/manojgaddigolla/project-management-tool/blob/main/backend/server.js) (HTTP and socket server), [`backend/controllers/cardController.js`](https://github.com/manojgaddigolla/project-management-tool/blob/main/backend/controllers/cardController.js) (Card management), [`backend/models/Project.js`](https://github.com/manojgaddigolla/project-management-tool/blob/main/backend/models/Project.js) (Project records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["Application shell<br/>[App.jsx]"]
  node_dashboard["Project dashboard<br/>[DashboardPage.jsx]"]
  node_boardview["Project board view<br/>[BoardPage.jsx]"]
  node_boardhook["Board state and socket<br/>[useBoard.js]"]
  node_projectservice["Project services<br/>[projectService.js]"]
  node_cardservice["Card services<br/>[cardService.js]"]
  node_httpclient["HTTP client<br/>[axios.js]"]
end

subgraph group_api["API and access"]
  node_server["HTTP and socket server<br/>[server.js]"]
  node_auth["Identity middleware<br/>[auth.js]"]
end

subgraph group_domain["Project domain"]
  node_projectctrl["Project management"]
  node_boardctrl["Board management<br/>[boardController.js]"]
  node_columnctrl["Column management"]
  node_cardctrl["Card management<br/>[cardController.js]"]
  node_projectmodel["Project records<br/>[Project.js]"]
  node_boardmodel["Board records<br/>[Board.js]"]
  node_columnmodel["Column records<br/>[Column.js]"]
  node_cardmodel["Card records<br/>[Card.js]"]
  node_mongodb[("MongoDB")]
end

subgraph group_collab["Collaboration and insights"]
  node_activity["Activity log<br/>[activityLogger.js]"]
  node_notifications["Notifications"]
  node_analytics["Project analytics"]
  node_ai["AI summary<br/>[aiController.js]"]
end

node_user(("Team member"))

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_boardview
node_boardview -.->|"uses"| node_boardhook
node_boardhook -->|"requests projects"| node_projectservice
node_boardhook -->|"requests cards"| node_cardservice
node_projectservice -->|"sends requests"| node_httpclient
node_cardservice -->|"sends requests"| node_httpclient
node_httpclient -->|"calls API"| node_server
node_server -->|"routes projects"| node_projectctrl
node_server -.->|"routes boards"| node_boardctrl
node_server -->|"routes cards"| node_cardctrl
node_server -->|"uses auth"| node_auth
node_cardctrl -->|"reads and writes"| node_cardmodel
node_cardctrl -->|"loads column"| node_columnmodel
node_cardctrl -->|"loads board"| node_boardmodel
node_cardctrl -->|"loads project"| node_projectmodel
node_columnctrl -->|"reads and writes"| node_columnmodel
node_columnctrl -->|"loads board"| node_boardmodel
node_columnctrl -->|"loads project"| node_projectmodel
node_projectctrl -->|"creates and queries"| node_projectmodel
node_projectctrl -->|"creates and queries"| node_boardmodel
node_projectctrl -->|"queries columns"| node_columnmodel
node_projectctrl -->|"queries cards"| node_cardmodel
node_projectmodel -->|"persists records"| node_mongodb
node_boardmodel -->|"persists records"| node_mongodb
node_columnmodel -->|"persists records"| node_mongodb
node_cardmodel -->|"persists records"| node_mongodb
node_cardctrl -->|"logs changes"| node_activity
node_columnctrl -->|"logs changes"| node_activity
node_projectctrl -->|"logs changes"| node_activity
node_activity -.->|"broadcasts updates"| node_server
node_projectctrl -.->|"notifies members"| node_notifications
node_notifications -->|"emits events"| node_server
node_user -->|"views metrics"| node_analytics
node_analytics -->|"loads project data"| node_projectmodel
node_analytics -->|"derives task metrics"| node_cardmodel
node_user -.->|"requests summary"| node_ai
node_projectservice -->|"requests summary"| node_ai

click node_app "https://github.com/manojgaddigolla/project-management-tool/blob/main/client/src/App.jsx"
click node_dashboard "https://github.com/manojgaddigolla/project-management-tool/blob/main/client/src/pages/DashboardPage.jsx"
click node_boardview "https://github.com/manojgaddigolla/project-management-tool/blob/main/client/src/pages/BoardPage.jsx"
click node_boardhook "https://github.com/manojgaddigolla/project-management-tool/blob/main/client/src/hooks/useBoard.js"
click node_projectservice "https://github.com/manojgaddigolla/project-management-tool/blob/main/client/src/services/projectService.js"
click node_cardservice "https://github.com/manojgaddigolla/project-management-tool/blob/main/client/src/services/cardService.js"
click node_httpclient "https://github.com/manojgaddigolla/project-management-tool/blob/main/client/src/api/axios.js"
click node_server "https://github.com/manojgaddigolla/project-management-tool/blob/main/backend/server.js"
click node_auth "https://github.com/manojgaddigolla/project-management-tool/blob/main/backend/middleware/auth.js"
click node_projectctrl "https://github.com/manojgaddigolla/project-management-tool/blob/main/backend/controllers/projectController.js"
click node_boardctrl "https://github.com/manojgaddigolla/project-management-tool/blob/main/backend/controllers/boardController.js"
click node_columnctrl "https://github.com/manojgaddigolla/project-management-tool/blob/main/backend/controllers/columnController.js"
click node_cardctrl "https://github.com/manojgaddigolla/project-management-tool/blob/main/backend/controllers/cardController.js"
click node_projectmodel "https://github.com/manojgaddigolla/project-management-tool/blob/main/backend/models/Project.js"
click node_boardmodel "https://github.com/manojgaddigolla/project-management-tool/blob/main/backend/models/Board.js"
click node_columnmodel "https://github.com/manojgaddigolla/project-management-tool/blob/main/backend/models/Column.js"
click node_cardmodel "https://github.com/manojgaddigolla/project-management-tool/blob/main/backend/models/Card.js"
click node_activity "https://github.com/manojgaddigolla/project-management-tool/blob/main/backend/utils/activityLogger.js"
click node_notifications "https://github.com/manojgaddigolla/project-management-tool/blob/main/backend/utils/notificationManager.js"
click node_analytics "https://github.com/manojgaddigolla/project-management-tool/blob/main/backend/controllers/projectController.js"
click node_ai "https://github.com/manojgaddigolla/project-management-tool/blob/main/backend/controllers/aiController.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_app,node_dashboard,node_boardview,node_boardhook,node_projectservice,node_cardservice,node_httpclient toneBlue
class node_server,node_auth toneAmber
class node_projectctrl,node_boardctrl,node_columnctrl,node_cardctrl,node_projectmodel,node_boardmodel,node_columnmodel,node_cardmodel,node_mongodb toneMint
class node_activity,node_notifications,node_analytics,node_ai toneRose
class node_user toneIndigo
```

## Components

### Web client

- [Application shell](https://github.com/manojgaddigolla/project-management-tool/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Project dashboard](https://github.com/manojgaddigolla/project-management-tool/blob/main/client/src/pages/DashboardPage.jsx): `client/src/pages/DashboardPage.jsx`
- [Project board view](https://github.com/manojgaddigolla/project-management-tool/blob/main/client/src/pages/BoardPage.jsx): `client/src/pages/BoardPage.jsx`
- [Board state and socket](https://github.com/manojgaddigolla/project-management-tool/blob/main/client/src/hooks/useBoard.js): `client/src/hooks/useBoard.js`
- [Project services](https://github.com/manojgaddigolla/project-management-tool/blob/main/client/src/services/projectService.js): `client/src/services/projectService.js`
- [Card services](https://github.com/manojgaddigolla/project-management-tool/blob/main/client/src/services/cardService.js): `client/src/services/cardService.js`
- [HTTP client](https://github.com/manojgaddigolla/project-management-tool/blob/main/client/src/api/axios.js): `client/src/api/axios.js`

### API and access

- [HTTP and socket server](https://github.com/manojgaddigolla/project-management-tool/blob/main/backend/server.js): `backend/server.js`
- [Identity middleware](https://github.com/manojgaddigolla/project-management-tool/blob/main/backend/middleware/auth.js): `backend/middleware/auth.js`

### Project domain

- [Project management](https://github.com/manojgaddigolla/project-management-tool/blob/main/backend/controllers/projectController.js): `backend/controllers/projectController.js`
- [Board management](https://github.com/manojgaddigolla/project-management-tool/blob/main/backend/controllers/boardController.js): `backend/controllers/boardController.js`
- [Column management](https://github.com/manojgaddigolla/project-management-tool/blob/main/backend/controllers/columnController.js): `backend/controllers/columnController.js`
- [Card management](https://github.com/manojgaddigolla/project-management-tool/blob/main/backend/controllers/cardController.js): `backend/controllers/cardController.js`
- [Project records](https://github.com/manojgaddigolla/project-management-tool/blob/main/backend/models/Project.js): `backend/models/Project.js`
- [Board records](https://github.com/manojgaddigolla/project-management-tool/blob/main/backend/models/Board.js): `backend/models/Board.js`
- [Column records](https://github.com/manojgaddigolla/project-management-tool/blob/main/backend/models/Column.js): `backend/models/Column.js`
- [Card records](https://github.com/manojgaddigolla/project-management-tool/blob/main/backend/models/Card.js): `backend/models/Card.js`
- **MongoDB**

### Collaboration and insights

- [Activity log](https://github.com/manojgaddigolla/project-management-tool/blob/main/backend/utils/activityLogger.js): `backend/utils/activityLogger.js`
- [Notifications](https://github.com/manojgaddigolla/project-management-tool/blob/main/backend/utils/notificationManager.js): `backend/utils/notificationManager.js`
- [Project analytics](https://github.com/manojgaddigolla/project-management-tool/blob/main/backend/controllers/projectController.js): `backend/controllers/projectController.js`
- [AI summary](https://github.com/manojgaddigolla/project-management-tool/blob/main/backend/controllers/aiController.js): `backend/controllers/aiController.js`

### Other components

- **Team member**

## Connections

- Team member → Application shell: uses
- Application shell → Project dashboard: routes to (evidence: `client/src/App.jsx`)
- Application shell → Project board view: routes to (evidence: `client/src/App.jsx`)
- Project board view → Board state and socket: uses
- Board state and socket → Project services: requests projects (evidence: `client/src/hooks/useBoard.js`)
- Board state and socket → Card services: requests cards (evidence: `client/src/hooks/useBoard.js`)
- Project services → HTTP client: sends requests (evidence: `client/src/services/projectService.js`)
- Card services → HTTP client: sends requests (evidence: `client/src/services/cardService.js`)
- HTTP client → HTTP and socket server: calls API
- HTTP and socket server → Project management: routes projects (evidence: `backend/server.js`)
- HTTP and socket server → Board management: routes boards
- HTTP and socket server → Card management: routes cards (evidence: `backend/server.js`)
- HTTP and socket server → Identity middleware: uses auth (evidence: `backend/server.js`)
- Card management → Card records: reads and writes (evidence: `backend/controllers/cardController.js`)
- Card management → Column records: loads column (evidence: `backend/controllers/cardController.js`)
- Card management → Board records: loads board (evidence: `backend/controllers/cardController.js`)
- Card management → Project records: loads project (evidence: `backend/controllers/cardController.js`)
- Column management → Column records: reads and writes (evidence: `backend/controllers/columnController.js`)
- Column management → Board records: loads board (evidence: `backend/controllers/columnController.js`)
- Column management → Project records: loads project (evidence: `backend/controllers/columnController.js`)
- Project management → Project records: creates and queries (evidence: `backend/controllers/projectController.js`)
- Project management → Board records: creates and queries (evidence: `backend/controllers/projectController.js`)
- Project management → Column records: queries columns (evidence: `backend/controllers/projectController.js`)
- Project management → Card records: queries cards (evidence: `backend/controllers/projectController.js`)
- Project records → MongoDB: persists records
- Board records → MongoDB: persists records
- Column records → MongoDB: persists records
- Card records → MongoDB: persists records
- Card management → Activity log: logs changes (evidence: `backend/controllers/cardController.js`)
- Column management → Activity log: logs changes (evidence: `backend/controllers/columnController.js`)
- Project management → Activity log: logs changes (evidence: `backend/controllers/projectController.js`)
- Activity log → HTTP and socket server: broadcasts updates
- Project management → Notifications: notifies members (evidence: `backend/controllers/projectController.js`)
- Notifications → HTTP and socket server: emits events (evidence: `backend/utils/notificationManager.js`)
- Team member → Project analytics: views metrics
- Project analytics → Project records: loads project data (evidence: `backend/controllers/projectController.js`)
- Project analytics → Card records: derives task metrics (evidence: `backend/controllers/projectController.js`)
- Team member → AI summary: requests summary
- Project services → AI summary: requests summary (evidence: `client/src/services/projectService.js`)
