# pradeepkumararivel-pradeep/team-tracker architecture

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

- Interactive diagram: https://gitdiagram.com/pradeepkumararivel-pradeep/team-tracker
- Repository: https://github.com/pradeepkumararivel-pradeep/team-tracker

## Overview

TeamTracker is a team collaboration and project-management SaaS. Members authenticate, enter a protected dashboard, manage projects and tasks, and collaborate through chat and live notifications; admins also manage accounts and audit activity. The graph preserves documented dashboard, AI assistant, profile, themes, and admin capabilities. Relationships use README statements and shown imports, routes, and calls; unsampled feature internals are represented by their exact page or controller paths, with unverified links omitted.

Main entry points: [`client/src/App.jsx`](https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/client/src/App.jsx) (Protected app routing), [`server/controllers/taskController.js`](https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/server/controllers/taskController.js) (Task operations), [`server/models/Project.js`](https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/server/models/Project.js) (Project records), [`server/models/Task.js`](https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/server/models/Task.js) (Task records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web application"]
  node_app["Protected app routing<br/>[App.jsx]"]
  node_authui["Authentication state<br/>[AuthContext.jsx]"]
  node_api["HTTP client<br/>[api.js]"]
  node_dashboard["Metrics and activity<br/>[Dashboard.jsx]"]
  node_projectsui["Project workspace<br/>[Projects.jsx]"]
  node_tasksui["Kanban and task list<br/>[Tasks.jsx]"]
  node_chatui["Project chat<br/>[Chat.jsx]"]
  node_aiui["AI assistant<br/>[AIAssistant.jsx]"]
  node_adminui["Admin controls<br/>[AdminPanel.jsx]"]
  node_profileui["User profile<br/>[Profile.jsx]"]
  node_socketctx["Live connection<br/>[SocketContext.jsx]"]
end

subgraph group_server["API and realtime"]
  node_routes["HTTP route dispatch<br/>[server.js]"]
  node_authroutes["Auth endpoints<br/>[authRoutes.js]"]
  node_authctrl["Identity and access<br/>[authController.js]"]
  node_middleware["JWT and role checks<br/>[authMiddleware.js]"]
  node_projectroutes["Project endpoints<br/>[projectRoutes.js]"]
  node_projectctrl["Project operations"]
  node_taskctrl["Task operations<br/>[taskController.js]"]
  node_dashboardctrl["Dashboard aggregation"]
  node_aictrl["AI insights<br/>[aiController.js]"]
  node_adminctrl["Administration<br/>[adminController.js]"]
  node_socket["Realtime events<br/>[socketHandler.js]"]
end

subgraph group_data["Domain data"]
  node_userdb[("User records<br/>[User.js]")]
  node_projectdb[("Project records<br/>[Project.js]")]
  node_taskdb[("Task records<br/>[Task.js]")]
  node_activitydb[("Activity logs<br/>[ActivityLog.js]")]
  node_notificationdb[("Notifications<br/>[Notification.js]")]
end

node_actor(("Team user"))
node_service[("MongoDB")]

node_actor -->|"uses"| node_app
node_app -->|"provides state"| node_authui
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_projectsui
node_app -->|"routes to"| node_tasksui
node_app -->|"routes to"| node_chatui
node_app -->|"routes to"| node_aiui
node_app -->|"routes to"| node_adminui
node_app -->|"routes to"| node_profileui
node_authui -->|"calls"| node_api
node_tasksui -->|"calls"| node_api
node_tasksui -->|"listens through"| node_socketctx
node_api -->|"sends requests"| node_routes
node_routes -->|"mounts"| node_authroutes
node_routes -->|"mounts"| node_projectroutes
node_authroutes -->|"protects routes"| node_middleware
node_authroutes -->|"dispatches"| node_authctrl
node_projectroutes -->|"protects routes"| node_middleware
node_projectroutes -->|"dispatches"| node_projectctrl
node_authctrl -->|"reads and writes"| node_userdb
node_authctrl -->|"records events"| node_activitydb
node_middleware -->|"loads user"| node_userdb
node_projectctrl -->|"reads and writes"| node_projectdb
node_projectctrl -->|"deletes project tasks"| node_taskdb
node_projectctrl -->|"records activity"| node_activitydb
node_projectctrl -->|"creates invites"| node_notificationdb
node_taskctrl -->|"reads and writes"| node_taskdb
node_taskctrl -->|"recalculates progress"| node_projectdb
node_taskctrl -->|"creates assignments"| node_notificationdb
node_taskctrl -->|"records activity"| node_activitydb
node_taskctrl -->|"emits task updates"| node_socket
node_routes -->|"initializes"| node_socket
node_dashboard -.->|"loads metrics"| node_api
node_dashboardctrl -->|"aggregates"| node_projectdb
node_dashboardctrl -->|"aggregates"| node_taskdb
node_dashboardctrl -->|"reads activity"| node_activitydb
node_aictrl -->|"reads context"| node_projectdb
node_aictrl -->|"analyzes tasks"| node_taskdb
node_adminctrl -->|"manages accounts"| node_userdb
node_adminctrl -->|"reads projects"| node_projectdb
node_adminctrl -->|"reads tasks"| node_taskdb
node_adminctrl -->|"reads audit logs"| node_activitydb
node_socketctx -.->|"connects to"| node_socket
node_service -.->|"persists"| node_userdb
node_service -.->|"persists"| node_projectdb
node_service -.->|"persists"| node_taskdb

click node_app "https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/client/src/App.jsx"
click node_authui "https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/client/src/context/AuthContext.jsx"
click node_api "https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/client/src/services/api.js"
click node_dashboard "https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/client/src/pages/Dashboard.jsx"
click node_projectsui "https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/client/src/pages/Projects.jsx"
click node_tasksui "https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/client/src/pages/Tasks.jsx"
click node_chatui "https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/client/src/pages/Chat.jsx"
click node_aiui "https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/client/src/pages/AIAssistant.jsx"
click node_adminui "https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/client/src/pages/AdminPanel.jsx"
click node_profileui "https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/client/src/pages/Profile.jsx"
click node_socketctx "https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/client/src/context/SocketContext.jsx"
click node_routes "https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/server/server.js"
click node_authroutes "https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/server/routes/authRoutes.js"
click node_authctrl "https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/server/controllers/authController.js"
click node_middleware "https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/server/middleware/authMiddleware.js"
click node_projectroutes "https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/server/routes/projectRoutes.js"
click node_projectctrl "https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/server/controllers/projectController.js"
click node_taskctrl "https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/server/controllers/taskController.js"
click node_dashboardctrl "https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/server/controllers/dashboardController.js"
click node_aictrl "https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/server/controllers/aiController.js"
click node_adminctrl "https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/server/controllers/adminController.js"
click node_socket "https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/server/sockets/socketHandler.js"
click node_userdb "https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/server/models/User.js"
click node_projectdb "https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/server/models/Project.js"
click node_taskdb "https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/server/models/Task.js"
click node_activitydb "https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/server/models/ActivityLog.js"
click node_notificationdb "https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/server/models/Notification.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_authui,node_api,node_dashboard,node_projectsui,node_tasksui,node_chatui,node_aiui,node_adminui,node_profileui,node_socketctx,node_actor toneBlue
class node_routes,node_authroutes,node_authctrl,node_middleware,node_projectroutes,node_projectctrl,node_taskctrl,node_dashboardctrl,node_aictrl,node_adminctrl,node_socket,node_service toneAmber
class node_userdb,node_projectdb,node_taskdb,node_activitydb,node_notificationdb toneMint
```

## Components

### Web application

- [Protected app routing](https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Authentication state](https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/client/src/context/AuthContext.jsx): `client/src/context/AuthContext.jsx`
- [HTTP client](https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/client/src/services/api.js): `client/src/services/api.js`
- [Metrics and activity](https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/client/src/pages/Dashboard.jsx): `client/src/pages/Dashboard.jsx`
- [Project workspace](https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/client/src/pages/Projects.jsx): `client/src/pages/Projects.jsx`
- [Kanban and task list](https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/client/src/pages/Tasks.jsx): `client/src/pages/Tasks.jsx`
- [Project chat](https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/client/src/pages/Chat.jsx): `client/src/pages/Chat.jsx`
- [AI assistant](https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/client/src/pages/AIAssistant.jsx): `client/src/pages/AIAssistant.jsx`
- [Admin controls](https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/client/src/pages/AdminPanel.jsx): `client/src/pages/AdminPanel.jsx`
- [User profile](https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/client/src/pages/Profile.jsx): `client/src/pages/Profile.jsx`
- [Live connection](https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/client/src/context/SocketContext.jsx): `client/src/context/SocketContext.jsx`

### API and realtime

- [HTTP route dispatch](https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/server/server.js): `server/server.js`
- [Auth endpoints](https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/server/routes/authRoutes.js): `server/routes/authRoutes.js`
- [Identity and access](https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/server/controllers/authController.js): `server/controllers/authController.js`
- [JWT and role checks](https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/server/middleware/authMiddleware.js): `server/middleware/authMiddleware.js`
- [Project endpoints](https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/server/routes/projectRoutes.js): `server/routes/projectRoutes.js`
- [Project operations](https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/server/controllers/projectController.js): `server/controllers/projectController.js`
- [Task operations](https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/server/controllers/taskController.js): `server/controllers/taskController.js`
- [Dashboard aggregation](https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/server/controllers/dashboardController.js): `server/controllers/dashboardController.js`
- [AI insights](https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/server/controllers/aiController.js): `server/controllers/aiController.js`
- [Administration](https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/server/controllers/adminController.js): `server/controllers/adminController.js`
- [Realtime events](https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/server/sockets/socketHandler.js): `server/sockets/socketHandler.js`

### Domain data

- [User records](https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/server/models/User.js): `server/models/User.js`
- [Project records](https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/server/models/Project.js): `server/models/Project.js`
- [Task records](https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/server/models/Task.js): `server/models/Task.js`
- [Activity logs](https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/server/models/ActivityLog.js): `server/models/ActivityLog.js`
- [Notifications](https://github.com/pradeepkumararivel-pradeep/team-tracker/blob/main/server/models/Notification.js): `server/models/Notification.js`

### Other components

- **Team user**
- **MongoDB**

## Connections

- Team user → Protected app routing: uses
- Protected app routing → Authentication state: provides state (evidence: `client/src/App.jsx`)
- Protected app routing → Metrics and activity: routes to (evidence: `client/src/App.jsx`)
- Protected app routing → Project workspace: routes to (evidence: `client/src/App.jsx`)
- Protected app routing → Kanban and task list: routes to (evidence: `client/src/App.jsx`)
- Protected app routing → Project chat: routes to (evidence: `client/src/App.jsx`)
- Protected app routing → AI assistant: routes to (evidence: `client/src/App.jsx`)
- Protected app routing → Admin controls: routes to (evidence: `client/src/App.jsx`)
- Protected app routing → User profile: routes to (evidence: `client/src/App.jsx`)
- Authentication state → HTTP client: calls (evidence: `client/src/context/AuthContext.jsx`)
- Kanban and task list → HTTP client: calls (evidence: `client/src/pages/Tasks.jsx`)
- Kanban and task list → Live connection: listens through (evidence: `client/src/pages/Tasks.jsx`)
- HTTP client → HTTP route dispatch: sends requests
- HTTP route dispatch → Auth endpoints: mounts (evidence: `server/server.js`)
- HTTP route dispatch → Project endpoints: mounts (evidence: `server/server.js`)
- Auth endpoints → JWT and role checks: protects routes (evidence: `server/routes/authRoutes.js`)
- Auth endpoints → Identity and access: dispatches (evidence: `server/routes/authRoutes.js`)
- Project endpoints → JWT and role checks: protects routes (evidence: `server/routes/projectRoutes.js`)
- Project endpoints → Project operations: dispatches (evidence: `server/routes/projectRoutes.js`)
- Identity and access → User records: reads and writes (evidence: `server/controllers/authController.js`)
- Identity and access → Activity logs: records events (evidence: `server/controllers/authController.js`)
- JWT and role checks → User records: loads user (evidence: `server/middleware/authMiddleware.js`)
- Project operations → Project records: reads and writes (evidence: `server/controllers/projectController.js`)
- Project operations → Task records: deletes project tasks (evidence: `server/controllers/projectController.js`)
- Project operations → Activity logs: records activity (evidence: `server/controllers/projectController.js`)
- Project operations → Notifications: creates invites (evidence: `server/controllers/projectController.js`)
- Task operations → Task records: reads and writes (evidence: `server/controllers/taskController.js`)
- Task operations → Project records: recalculates progress (evidence: `server/controllers/taskController.js`)
- Task operations → Notifications: creates assignments (evidence: `server/controllers/taskController.js`)
- Task operations → Activity logs: records activity (evidence: `server/controllers/taskController.js`)
- Task operations → Realtime events: emits task updates (evidence: `server/controllers/taskController.js`)
- HTTP route dispatch → Realtime events: initializes (evidence: `server/server.js`)
- Metrics and activity → HTTP client: loads metrics
- Dashboard aggregation → Project records: aggregates (evidence: `server/controllers/dashboardController.js`)
- Dashboard aggregation → Task records: aggregates (evidence: `server/controllers/dashboardController.js`)
- Dashboard aggregation → Activity logs: reads activity (evidence: `server/controllers/dashboardController.js`)
- AI insights → Project records: reads context (evidence: `server/controllers/aiController.js`)
- AI insights → Task records: analyzes tasks (evidence: `server/controllers/aiController.js`)
- Administration → User records: manages accounts (evidence: `server/controllers/adminController.js`)
- Administration → Project records: reads projects (evidence: `server/controllers/adminController.js`)
- Administration → Task records: reads tasks (evidence: `server/controllers/adminController.js`)
- Administration → Activity logs: reads audit logs (evidence: `server/controllers/adminController.js`)
- Live connection → Realtime events: connects to
- MongoDB → User records: persists
- MongoDB → Project records: persists
- MongoDB → Task records: persists
