# inamulhasankiaq-devops/smart-task-mgmt architecture

> Architecture diagram of the GitHub repository inamulhasankiaq-devops/smart-task-mgmt, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/inamulhasankiaq-devops/smart-task-mgmt
- Repository: https://github.com/inamulhasankiaq-devops/smart-task-mgmt

## Overview

Smart-task-mgmt is a task-management application built around a browser client, an API gateway, and separate authentication and task services; notification and reporting services are also present. The principal evidenced workflow is a user signing in and managing tasks through the frontend API and gateway. Service controllers handle requests and use their models. Notification and report creation are exposed as separate service branches, but no connection from task operations to those services is shown. The README gives no further capability details, and unsampled page and service behavior is not inferred.

Main entry points: [`frontend/src/App.jsx`](https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/frontend/src/App.jsx) (Frontend router), [`api-gateway_1784010924579/src/app.js`](https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/api-gateway_1784010924579/src/app.js) (Gateway routes), [`frontend/src/api/api.js`](https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/frontend/src/api/api.js) (API client), [`auth-service_1784011000189/src/routes/auth.routes.js`](https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/auth-service_1784011000189/src/routes/auth.routes.js) (Auth routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Browser client"]
  node_app["Frontend router<br/>[App.jsx]"]
  node_login["Login page<br/>[Login.jsx]"]
  node_dashboard["Task dashboard<br/>[Dashboard.jsx]"]
  node_create_task["Create task page<br/>[CreateTask.jsx]"]
  node_api_client["API client<br/>[api.js]"]
end

subgraph group_gateway["API gateway"]
  node_gateway_app["Gateway routes<br/>[app.js]"]
  node_metrics["HTTP metrics<br/>[metrics.js]"]
end

subgraph group_auth["Authentication"]
  node_auth_routes["Auth routes<br/>[auth.routes.js]"]
  node_auth_controller["Auth operations<br/>[auth.controller.js]"]
  node_auth_middleware["Auth middleware<br/>[auth.middleware.js]"]
  node_user_model["User model<br/>[User.js]"]
end

subgraph group_tasks["Task management"]
  node_task_routes["Task routes<br/>[task.routes.js]"]
  node_task_middleware["Task auth middleware<br/>[auth.middleware.js]"]
  node_task_controller["Task operations<br/>[task.controller.js]"]
  node_task_model["Task model<br/>[Task.js]"]
end

subgraph group_support["Notifications and reports"]
  node_notification_routes["Notification routes"]
  node_notification_controller["Notification creation"]
  node_notification_model["Notification model<br/>[Notification.js]"]
  node_report_routes["Report routes<br/>[report.routes.js]"]
  node_report_controller["Report creation"]
  node_report_model["Report model<br/>[Report.js]"]
end

node_user(("User"))

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_create_task
node_login -->|"calls"| node_api_client
node_dashboard -->|"calls"| node_api_client
node_create_task -->|"calls"| node_api_client
node_api_client -->|"sends HTTP"| node_gateway_app
node_gateway_app -->|"records requests"| node_metrics
node_gateway_app -->|"proxies auth"| node_auth_routes
node_gateway_app -->|"proxies tasks"| node_task_routes
node_auth_routes -->|"dispatches"| node_auth_controller
node_auth_routes -->|"guards profile"| node_auth_middleware
node_auth_controller -->|"reads and writes"| node_user_model
node_task_routes -->|"guards operations"| node_task_middleware
node_task_routes -->|"dispatches"| node_task_controller
node_task_controller -->|"reads and writes"| node_task_model
node_notification_routes -->|"dispatches"| node_notification_controller
node_notification_controller -->|"creates"| node_notification_model
node_report_routes -->|"dispatches"| node_report_controller
node_report_controller -->|"creates"| node_report_model

click node_app "https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/frontend/src/App.jsx"
click node_login "https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/frontend/src/pages/Login.jsx"
click node_dashboard "https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/frontend/src/pages/Dashboard.jsx"
click node_create_task "https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/frontend/src/pages/CreateTask.jsx"
click node_api_client "https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/frontend/src/api/api.js"
click node_gateway_app "https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/api-gateway_1784010924579/src/app.js"
click node_metrics "https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/api-gateway_1784010924579/src/metrics.js"
click node_auth_routes "https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/auth-service_1784011000189/src/routes/auth.routes.js"
click node_auth_controller "https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/auth-service_1784011000189/src/controllers/auth.controller.js"
click node_auth_middleware "https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/auth-service_1784011000189/src/middlewares/auth.middleware.js"
click node_user_model "https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/auth-service_1784011000189/src/models/User.js"
click node_task_routes "https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/task-service/src/routes/task.routes.js"
click node_task_middleware "https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/task-service/src/middlewares/auth.middleware.js"
click node_task_controller "https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/task-service/src/controllers/task.controller.js"
click node_task_model "https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/task-service/src/models/Task.js"
click node_notification_routes "https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/notification-service/src/routes/notification.routes.js"
click node_notification_controller "https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/notification-service/src/controllers/notification.controller.js"
click node_notification_model "https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/notification-service/src/models/Notification.js"
click node_report_routes "https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/report-service/src/routes/report.routes.js"
click node_report_controller "https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/report-service/src/controllers/report.controller.js"
click node_report_model "https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/report-service/src/models/Report.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_login,node_dashboard,node_create_task,node_api_client,node_user toneBlue
class node_gateway_app,node_metrics toneAmber
class node_auth_routes,node_auth_controller,node_auth_middleware,node_user_model toneMint
class node_task_routes,node_task_middleware,node_task_controller,node_task_model toneRose
class node_notification_routes,node_notification_controller,node_notification_model,node_report_routes,node_report_controller,node_report_model toneIndigo
```

## Components

### Browser client

- [Frontend router](https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Login page](https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/frontend/src/pages/Login.jsx): `frontend/src/pages/Login.jsx`
- [Task dashboard](https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/frontend/src/pages/Dashboard.jsx): `frontend/src/pages/Dashboard.jsx`
- [Create task page](https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/frontend/src/pages/CreateTask.jsx): `frontend/src/pages/CreateTask.jsx`
- [API client](https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/frontend/src/api/api.js): `frontend/src/api/api.js`

### API gateway

- [Gateway routes](https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/api-gateway_1784010924579/src/app.js): `api-gateway_1784010924579/src/app.js`
- [HTTP metrics](https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/api-gateway_1784010924579/src/metrics.js): `api-gateway_1784010924579/src/metrics.js`

### Authentication

- [Auth routes](https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/auth-service_1784011000189/src/routes/auth.routes.js): `auth-service_1784011000189/src/routes/auth.routes.js`
- [Auth operations](https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/auth-service_1784011000189/src/controllers/auth.controller.js): `auth-service_1784011000189/src/controllers/auth.controller.js`
- [Auth middleware](https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/auth-service_1784011000189/src/middlewares/auth.middleware.js): `auth-service_1784011000189/src/middlewares/auth.middleware.js`
- [User model](https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/auth-service_1784011000189/src/models/User.js): `auth-service_1784011000189/src/models/User.js`

### Task management

- [Task routes](https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/task-service/src/routes/task.routes.js): `task-service/src/routes/task.routes.js`
- [Task auth middleware](https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/task-service/src/middlewares/auth.middleware.js): `task-service/src/middlewares/auth.middleware.js`
- [Task operations](https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/task-service/src/controllers/task.controller.js): `task-service/src/controllers/task.controller.js`
- [Task model](https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/task-service/src/models/Task.js): `task-service/src/models/Task.js`

### Notifications and reports

- [Notification routes](https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/notification-service/src/routes/notification.routes.js): `notification-service/src/routes/notification.routes.js`
- [Notification creation](https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/notification-service/src/controllers/notification.controller.js): `notification-service/src/controllers/notification.controller.js`
- [Notification model](https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/notification-service/src/models/Notification.js): `notification-service/src/models/Notification.js`
- [Report routes](https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/report-service/src/routes/report.routes.js): `report-service/src/routes/report.routes.js`
- [Report creation](https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/report-service/src/controllers/report.controller.js): `report-service/src/controllers/report.controller.js`
- [Report model](https://github.com/inamulhasankiaq-devops/smart-task-mgmt/blob/main/report-service/src/models/Report.js): `report-service/src/models/Report.js`

### Other components

- **User**

## Connections

- User → Frontend router: uses
- Frontend router → Login page: routes to (evidence: `frontend/src/App.jsx`)
- Frontend router → Task dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Frontend router → Create task page: routes to (evidence: `frontend/src/App.jsx`)
- Login page → API client: calls (evidence: `frontend/src/pages/Login.jsx`)
- Task dashboard → API client: calls (evidence: `frontend/src/pages/Dashboard.jsx`)
- Create task page → API client: calls (evidence: `frontend/src/pages/CreateTask.jsx`)
- API client → Gateway routes: sends HTTP (evidence: `frontend/src/api/api.js`)
- Gateway routes → HTTP metrics: records requests (evidence: `api-gateway_1784010924579/src/app.js`)
- Gateway routes → Auth routes: proxies auth (evidence: `api-gateway_1784010924579/src/app.js`)
- Gateway routes → Task routes: proxies tasks (evidence: `api-gateway_1784010924579/src/app.js`)
- Auth routes → Auth operations: dispatches (evidence: `auth-service_1784011000189/src/routes/auth.routes.js`)
- Auth routes → Auth middleware: guards profile (evidence: `auth-service_1784011000189/src/routes/auth.routes.js`)
- Auth operations → User model: reads and writes (evidence: `auth-service_1784011000189/src/controllers/auth.controller.js`)
- Task routes → Task auth middleware: guards operations (evidence: `task-service/src/routes/task.routes.js`)
- Task routes → Task operations: dispatches (evidence: `task-service/src/routes/task.routes.js`)
- Task operations → Task model: reads and writes (evidence: `task-service/src/controllers/task.controller.js`)
- Notification routes → Notification creation: dispatches (evidence: `notification-service/src/routes/notification.routes.js`)
- Notification creation → Notification model: creates (evidence: `notification-service/src/controllers/notification.controller.js`)
- Report routes → Report creation: dispatches (evidence: `report-service/src/routes/report.routes.js`)
- Report creation → Report model: creates (evidence: `report-service/src/controllers/report.controller.js`)
