# vanshkesarwani/roots-management-system architecture

> Architecture diagram of the GitHub repository vanshkesarwani/roots-management-system, 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/vanshkesarwani/roots-management-system
- Repository: https://github.com/vanshkesarwani/roots-management-system

## Overview

Roots Media Marketing’s employee-and-task management web application centers on staff creating and tracking assigned tasks, alongside employee directory management and dashboard oversight. The React routes and pages call a centralized API client; Express routes dispatch to controllers and services, which enforce lifecycle and assignment rules against MongoDB models. The README also documents filtered CSV export, URL-persistent list state, workload capacity, overdue metrics, and a development in-memory database fallback. Some frontend plumbing and dashboard/employee internals were not excerpted, so those links follow explicit README capability descriptions or are omitted.

Main entry points: [`backend/models/Task.js`](https://github.com/vanshkesarwani/roots-management-system/blob/main/backend/models/Task.js) (Task records), [`backend/app.js`](https://github.com/vanshkesarwani/roots-management-system/blob/main/backend/app.js) (Express API), [`frontend/src/services/api.js`](https://github.com/vanshkesarwani/roots-management-system/blob/main/frontend/src/services/api.js) (API client), [`backend/models/Employee.js`](https://github.com/vanshkesarwani/roots-management-system/blob/main/backend/models/Employee.js) (Employee records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["React application"]
  node_app["Route shell<br/>[App.jsx]"]
  node_dashboard_ui["Dashboard view<br/>[DashboardPage.jsx]"]
  node_employee_ui["Employee pages"]
  node_task_ui["Task pages"]
  node_task_status_ui["Status selector"]
  node_url_state["URL list state<br/>[urlParams.js]"]
  node_api_client["API client<br/>[api.js]"]
end

subgraph group_api["HTTP API"]
  node_http_api["Express API<br/>[app.js]"]
  node_employee_routes["Employee routes<br/>[employeeRoutes.js]"]
  node_task_routes["Task routes<br/>[taskRoutes.js]"]
  node_dashboard_routes["Dashboard routes<br/>[dashboardRoutes.js]"]
  node_employee_controller["Employee controller"]
  node_task_controller["Task controller<br/>[taskController.js]"]
  node_dashboard_controller["Dashboard controller"]
end

subgraph group_domain["Management services"]
  node_employee_service["Employee management<br/>[employeeService.js]"]
  node_task_service["Task management<br/>[taskService.js]"]
  node_state_service["Lifecycle rules"]
  node_dashboard_service["Dashboard metrics"]
  node_csv_service["CSV export"]
end

subgraph group_data["Persistence"]
  node_employee_model[("Employee records<br/>[Employee.js]")]
  node_task_model[("Task records<br/>[Task.js]")]
  node_counter_model[("ID counter<br/>[Counter.js]")]
end

subgraph group_runtime["Runtime support"]
  node_db_connection["MongoDB connection<br/>[db.js]"]
  node_error_handler["Error handling<br/>[errorHandler.js]"]
end

node_user(("Staff user"))
node_browser(("Browser"))
node_mongodb[("MongoDB")]

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_dashboard_ui
node_app -->|"routes to"| node_employee_ui
node_app -->|"routes to"| node_task_ui
node_task_ui -->|"renders"| node_task_status_ui
node_task_ui -->|"synchronizes"| node_url_state
node_dashboard_ui -->|"requests data"| node_api_client
node_employee_ui -->|"requests data"| node_api_client
node_task_ui -->|"requests data"| node_api_client
node_browser -.->|"hosts UI"| node_api_client
node_api_client -.->|"sends HTTP"| node_http_api
node_http_api -->|"mounts"| node_employee_routes
node_http_api -->|"mounts"| node_task_routes
node_http_api -->|"mounts"| node_dashboard_routes
node_http_api -->|"connects before API"| node_db_connection
node_http_api -->|"handles errors"| node_error_handler
node_employee_routes -->|"dispatches"| node_employee_controller
node_task_routes -->|"dispatches"| node_task_controller
node_dashboard_routes -->|"dispatches"| node_dashboard_controller
node_employee_controller -->|"calls"| node_employee_service
node_task_controller -->|"calls"| node_task_service
node_task_controller -->|"transitions via"| node_state_service
node_task_controller -->|"exports via"| node_csv_service
node_dashboard_controller -->|"calls"| node_dashboard_service
node_employee_service -->|"queries"| node_employee_model
node_employee_service -->|"queries"| node_task_model
node_task_service -->|"queries"| node_task_model
node_task_service -->|"checks capacity"| node_employee_model
node_state_service -->|"updates status"| node_task_model
node_state_service -->|"adjusts workload"| node_employee_model
node_dashboard_service -->|"aggregates"| node_employee_model
node_dashboard_service -->|"aggregates"| node_task_model
node_csv_service -->|"reads tasks"| node_task_model
node_task_model -->|"generates IDs"| node_counter_model
node_db_connection -->|"connects"| node_mongodb
node_task_model -.->|"persists"| node_mongodb
node_employee_model -.->|"persists"| node_mongodb

click node_app "https://github.com/vanshkesarwani/roots-management-system/blob/main/frontend/src/App.jsx"
click node_dashboard_ui "https://github.com/vanshkesarwani/roots-management-system/blob/main/frontend/src/pages/DashboardPage.jsx"
click node_employee_ui "https://github.com/vanshkesarwani/roots-management-system/tree/main/frontend/src/pages/employees"
click node_task_ui "https://github.com/vanshkesarwani/roots-management-system/tree/main/frontend/src/pages/tasks"
click node_task_status_ui "https://github.com/vanshkesarwani/roots-management-system/blob/main/frontend/src/components/tasks/TaskStatusDropdown.jsx"
click node_url_state "https://github.com/vanshkesarwani/roots-management-system/blob/main/frontend/src/utils/urlParams.js"
click node_api_client "https://github.com/vanshkesarwani/roots-management-system/blob/main/frontend/src/services/api.js"
click node_http_api "https://github.com/vanshkesarwani/roots-management-system/blob/main/backend/app.js"
click node_employee_routes "https://github.com/vanshkesarwani/roots-management-system/blob/main/backend/routes/employeeRoutes.js"
click node_task_routes "https://github.com/vanshkesarwani/roots-management-system/blob/main/backend/routes/taskRoutes.js"
click node_dashboard_routes "https://github.com/vanshkesarwani/roots-management-system/blob/main/backend/routes/dashboardRoutes.js"
click node_employee_controller "https://github.com/vanshkesarwani/roots-management-system/blob/main/backend/controllers/employeeController.js"
click node_task_controller "https://github.com/vanshkesarwani/roots-management-system/blob/main/backend/controllers/taskController.js"
click node_dashboard_controller "https://github.com/vanshkesarwani/roots-management-system/blob/main/backend/controllers/dashboardController.js"
click node_employee_service "https://github.com/vanshkesarwani/roots-management-system/blob/main/backend/services/employeeService.js"
click node_task_service "https://github.com/vanshkesarwani/roots-management-system/blob/main/backend/services/taskService.js"
click node_state_service "https://github.com/vanshkesarwani/roots-management-system/blob/main/backend/services/taskStateService.js"
click node_dashboard_service "https://github.com/vanshkesarwani/roots-management-system/blob/main/backend/services/dashboardService.js"
click node_csv_service "https://github.com/vanshkesarwani/roots-management-system/blob/main/backend/services/csvExportService.js"
click node_employee_model "https://github.com/vanshkesarwani/roots-management-system/blob/main/backend/models/Employee.js"
click node_task_model "https://github.com/vanshkesarwani/roots-management-system/blob/main/backend/models/Task.js"
click node_counter_model "https://github.com/vanshkesarwani/roots-management-system/blob/main/backend/models/Counter.js"
click node_db_connection "https://github.com/vanshkesarwani/roots-management-system/blob/main/backend/config/db.js"
click node_error_handler "https://github.com/vanshkesarwani/roots-management-system/blob/main/backend/middlewares/errorHandler.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_ui,node_employee_ui,node_task_ui,node_task_status_ui,node_url_state,node_api_client,node_user,node_browser toneBlue
class node_http_api,node_employee_routes,node_task_routes,node_dashboard_routes,node_employee_controller,node_task_controller,node_dashboard_controller,node_mongodb toneAmber
class node_employee_service,node_task_service,node_state_service,node_dashboard_service,node_csv_service toneMint
class node_employee_model,node_task_model,node_counter_model toneRose
class node_db_connection,node_error_handler toneIndigo
```

## Components

### React application

- [Route shell](https://github.com/vanshkesarwani/roots-management-system/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Dashboard view](https://github.com/vanshkesarwani/roots-management-system/blob/main/frontend/src/pages/DashboardPage.jsx): `frontend/src/pages/DashboardPage.jsx`
- [Employee pages](https://github.com/vanshkesarwani/roots-management-system/tree/main/frontend/src/pages/employees): `frontend/src/pages/employees`
- [Task pages](https://github.com/vanshkesarwani/roots-management-system/tree/main/frontend/src/pages/tasks): `frontend/src/pages/tasks`
- [Status selector](https://github.com/vanshkesarwani/roots-management-system/blob/main/frontend/src/components/tasks/TaskStatusDropdown.jsx): `frontend/src/components/tasks/TaskStatusDropdown.jsx`
- [URL list state](https://github.com/vanshkesarwani/roots-management-system/blob/main/frontend/src/utils/urlParams.js): `frontend/src/utils/urlParams.js`
- [API client](https://github.com/vanshkesarwani/roots-management-system/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`

### HTTP API

- [Express API](https://github.com/vanshkesarwani/roots-management-system/blob/main/backend/app.js): `backend/app.js`
- [Employee routes](https://github.com/vanshkesarwani/roots-management-system/blob/main/backend/routes/employeeRoutes.js): `backend/routes/employeeRoutes.js`
- [Task routes](https://github.com/vanshkesarwani/roots-management-system/blob/main/backend/routes/taskRoutes.js): `backend/routes/taskRoutes.js`
- [Dashboard routes](https://github.com/vanshkesarwani/roots-management-system/blob/main/backend/routes/dashboardRoutes.js): `backend/routes/dashboardRoutes.js`
- [Employee controller](https://github.com/vanshkesarwani/roots-management-system/blob/main/backend/controllers/employeeController.js): `backend/controllers/employeeController.js`
- [Task controller](https://github.com/vanshkesarwani/roots-management-system/blob/main/backend/controllers/taskController.js): `backend/controllers/taskController.js`
- [Dashboard controller](https://github.com/vanshkesarwani/roots-management-system/blob/main/backend/controllers/dashboardController.js): `backend/controllers/dashboardController.js`

### Management services

- [Employee management](https://github.com/vanshkesarwani/roots-management-system/blob/main/backend/services/employeeService.js): `backend/services/employeeService.js`
- [Task management](https://github.com/vanshkesarwani/roots-management-system/blob/main/backend/services/taskService.js): `backend/services/taskService.js`
- [Lifecycle rules](https://github.com/vanshkesarwani/roots-management-system/blob/main/backend/services/taskStateService.js): `backend/services/taskStateService.js`
- [Dashboard metrics](https://github.com/vanshkesarwani/roots-management-system/blob/main/backend/services/dashboardService.js): `backend/services/dashboardService.js`
- [CSV export](https://github.com/vanshkesarwani/roots-management-system/blob/main/backend/services/csvExportService.js): `backend/services/csvExportService.js`

### Persistence

- [Employee records](https://github.com/vanshkesarwani/roots-management-system/blob/main/backend/models/Employee.js): `backend/models/Employee.js`
- [Task records](https://github.com/vanshkesarwani/roots-management-system/blob/main/backend/models/Task.js): `backend/models/Task.js`
- [ID counter](https://github.com/vanshkesarwani/roots-management-system/blob/main/backend/models/Counter.js): `backend/models/Counter.js`

### Runtime support

- [MongoDB connection](https://github.com/vanshkesarwani/roots-management-system/blob/main/backend/config/db.js): `backend/config/db.js`
- [Error handling](https://github.com/vanshkesarwani/roots-management-system/blob/main/backend/middlewares/errorHandler.js): `backend/middlewares/errorHandler.js`

### Other components

- **Staff user**
- **Browser**
- **MongoDB**

## Connections

- Staff user → Route shell: uses (evidence: `frontend/src/App.jsx`)
- Route shell → Dashboard view: routes to (evidence: `frontend/src/App.jsx`)
- Route shell → Employee pages: routes to (evidence: `frontend/src/App.jsx`)
- Route shell → Task pages: routes to (evidence: `frontend/src/App.jsx`)
- Task pages → Status selector: renders (evidence: `frontend/src/pages/tasks/TaskListPage.jsx`)
- Task pages → URL list state: synchronizes (evidence: `frontend/src/pages/tasks/TaskListPage.jsx`)
- Dashboard view → API client: requests data (evidence: `frontend/src/pages/DashboardPage.jsx`)
- Employee pages → API client: requests data (evidence: `frontend/src/pages/employees/EmployeeListPage.jsx`)
- Task pages → API client: requests data (evidence: `frontend/src/pages/tasks/TaskListPage.jsx`)
- Browser → API client: hosts UI
- API client → Express API: sends HTTP
- Express API → Employee routes: mounts (evidence: `backend/app.js`)
- Express API → Task routes: mounts (evidence: `backend/app.js`)
- Express API → Dashboard routes: mounts (evidence: `backend/app.js`)
- Express API → MongoDB connection: connects before API (evidence: `backend/app.js`)
- Express API → Error handling: handles errors (evidence: `backend/app.js`)
- Employee routes → Employee controller: dispatches (evidence: `backend/routes/employeeRoutes.js`)
- Task routes → Task controller: dispatches (evidence: `backend/routes/taskRoutes.js`)
- Dashboard routes → Dashboard controller: dispatches (evidence: `backend/routes/dashboardRoutes.js`)
- Employee controller → Employee management: calls (evidence: `backend/controllers/employeeController.js`)
- Task controller → Task management: calls (evidence: `backend/controllers/taskController.js`)
- Task controller → Lifecycle rules: transitions via (evidence: `backend/controllers/taskController.js`)
- Task controller → CSV export: exports via (evidence: `backend/controllers/taskController.js`)
- Dashboard controller → Dashboard metrics: calls (evidence: `backend/controllers/dashboardController.js`)
- Employee management → Employee records: queries (evidence: `backend/services/employeeService.js`)
- Employee management → Task records: queries (evidence: `backend/services/employeeService.js`)
- Task management → Task records: queries (evidence: `backend/services/taskService.js`)
- Task management → Employee records: checks capacity (evidence: `backend/services/taskService.js`)
- Lifecycle rules → Task records: updates status (evidence: `backend/services/taskStateService.js`)
- Lifecycle rules → Employee records: adjusts workload (evidence: `backend/services/taskStateService.js`)
- Dashboard metrics → Employee records: aggregates (evidence: `backend/services/dashboardService.js`)
- Dashboard metrics → Task records: aggregates (evidence: `backend/services/dashboardService.js`)
- CSV export → Task records: reads tasks (evidence: `backend/services/csvExportService.js`)
- Task records → ID counter: generates IDs (evidence: `backend/models/Task.js`)
- MongoDB connection → MongoDB: connects (evidence: `backend/config/db.js`)
- Task records → MongoDB: persists
- Employee records → MongoDB: persists
