# jhony-saba/tackflow_backend architecture

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

- Interactive diagram: https://gitdiagram.com/jhony-saba/tackflow_backend
- Repository: https://github.com/jhony-saba/tackflow_backend

## Overview

This is an Express API for user accounts and authenticated project/task management. Clients register or log in to receive a JWT; protected project and task routes validate requests, dispatch to controllers, and use Mongoose models for CRUD and task-progress calculations. Project deletion also removes its tasks. The graph includes the validation, authentication, persistence-model, and error-handling layers. Source excerpts do not show the database connection implementation or all route registrations, so uncertain storage and dispatch relationships are omitted.

Main entry points: [`index.js`](https://github.com/jhony-saba/tackflow_backend/blob/main/index.js) (Express server), [`routes/userRoute.js`](https://github.com/jhony-saba/tackflow_backend/blob/main/routes/userRoute.js) (User routes), [`routes/projectRoute.js`](https://github.com/jhony-saba/tackflow_backend/blob/main/routes/projectRoute.js) (Project routes), [`routes/taskRoute.js`](https://github.com/jhony-saba/tackflow_backend/blob/main/routes/taskRoute.js) (Task routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API runtime"]
  node_server["Express server<br/>[index.js]"]
  node_dbconn["DB connection<br/>[db.js]"]
  node_errors["Error handler<br/>[erroHandler.js]"]
end

subgraph group_identity["Identity and access"]
  node_user_routes["User routes<br/>[userRoute.js]"]
  node_user_validation["User validation<br/>[uservalidator.js]"]
  node_user_controller["User operations<br/>[userController.js]"]
  node_user_model["User model<br/>[userModel.js]"]
  node_token["JWT middleware"]
end

subgraph group_projects["Project management"]
  node_project_routes["Project routes<br/>[projectRoute.js]"]
  node_project_validation["Project validation"]
  node_project_controller["Project operations"]
  node_project_model["Project model<br/>[projectModel.js]"]
end

subgraph group_tasks["Task management"]
  node_task_routes["Task routes<br/>[taskRoute.js]"]
  node_task_validation["Task validation<br/>[taskValidator.js]"]
  node_task_controller["Task operations<br/>[taskController.js]"]
  node_task_model["Task model<br/>[taskModel.js]"]
end

node_client(("API client"))

node_client -->|"sends requests"| node_server
node_server -->|"connects"| node_dbconn
node_server -->|"mounts"| node_user_routes
node_server -->|"mounts"| node_project_routes
node_server -->|"mounts"| node_task_routes
node_server -->|"handles errors"| node_errors
node_user_routes -->|"validates"| node_user_validation
node_user_routes -->|"dispatches"| node_user_controller
node_user_controller -->|"queries"| node_user_model
node_user_routes -.->|"guards"| node_token
node_project_routes -->|"validates"| node_project_validation
node_project_routes -->|"guards"| node_token
node_project_routes -->|"dispatches"| node_project_controller
node_project_controller -->|"queries"| node_project_model
node_project_controller -->|"deletes tasks"| node_task_model
node_task_routes -->|"validates"| node_task_validation
node_task_routes -->|"guards"| node_token
node_task_routes -->|"dispatches"| node_task_controller
node_task_controller -->|"queries"| node_task_model

click node_server "https://github.com/jhony-saba/tackflow_backend/blob/main/index.js"
click node_dbconn "https://github.com/jhony-saba/tackflow_backend/blob/main/config/db.js"
click node_errors "https://github.com/jhony-saba/tackflow_backend/blob/main/middleware/erroHandler.js"
click node_user_routes "https://github.com/jhony-saba/tackflow_backend/blob/main/routes/userRoute.js"
click node_user_validation "https://github.com/jhony-saba/tackflow_backend/blob/main/Validator/uservalidator.js"
click node_user_controller "https://github.com/jhony-saba/tackflow_backend/blob/main/Controllers/userController.js"
click node_user_model "https://github.com/jhony-saba/tackflow_backend/blob/main/models/userModel.js"
click node_token "https://github.com/jhony-saba/tackflow_backend/blob/main/middleware/validateTokenHandler.js"
click node_project_routes "https://github.com/jhony-saba/tackflow_backend/blob/main/routes/projectRoute.js"
click node_project_validation "https://github.com/jhony-saba/tackflow_backend/blob/main/Validator/projectValidator.js"
click node_project_controller "https://github.com/jhony-saba/tackflow_backend/blob/main/Controllers/projectController.js"
click node_project_model "https://github.com/jhony-saba/tackflow_backend/blob/main/models/projectModel.js"
click node_task_routes "https://github.com/jhony-saba/tackflow_backend/blob/main/routes/taskRoute.js"
click node_task_validation "https://github.com/jhony-saba/tackflow_backend/blob/main/Validator/taskValidator.js"
click node_task_controller "https://github.com/jhony-saba/tackflow_backend/blob/main/Controllers/taskController.js"
click node_task_model "https://github.com/jhony-saba/tackflow_backend/blob/main/models/taskModel.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_server,node_dbconn,node_errors,node_client toneBlue
class node_user_routes,node_user_validation,node_user_controller,node_user_model,node_token toneAmber
class node_project_routes,node_project_validation,node_project_controller,node_project_model toneMint
class node_task_routes,node_task_validation,node_task_controller,node_task_model toneRose
```

## Components

### API runtime

- [Express server](https://github.com/jhony-saba/tackflow_backend/blob/main/index.js): `index.js`
- [DB connection](https://github.com/jhony-saba/tackflow_backend/blob/main/config/db.js): `config/db.js`
- [Error handler](https://github.com/jhony-saba/tackflow_backend/blob/main/middleware/erroHandler.js): `middleware/erroHandler.js`

### Identity and access

- [User routes](https://github.com/jhony-saba/tackflow_backend/blob/main/routes/userRoute.js): `routes/userRoute.js`
- [User validation](https://github.com/jhony-saba/tackflow_backend/blob/main/Validator/uservalidator.js): `Validator/uservalidator.js`
- [User operations](https://github.com/jhony-saba/tackflow_backend/blob/main/Controllers/userController.js): `Controllers/userController.js`
- [User model](https://github.com/jhony-saba/tackflow_backend/blob/main/models/userModel.js): `models/userModel.js`
- [JWT middleware](https://github.com/jhony-saba/tackflow_backend/blob/main/middleware/validateTokenHandler.js): `middleware/validateTokenHandler.js`

### Project management

- [Project routes](https://github.com/jhony-saba/tackflow_backend/blob/main/routes/projectRoute.js): `routes/projectRoute.js`
- [Project validation](https://github.com/jhony-saba/tackflow_backend/blob/main/Validator/projectValidator.js): `Validator/projectValidator.js`
- [Project operations](https://github.com/jhony-saba/tackflow_backend/blob/main/Controllers/projectController.js): `Controllers/projectController.js`
- [Project model](https://github.com/jhony-saba/tackflow_backend/blob/main/models/projectModel.js): `models/projectModel.js`

### Task management

- [Task routes](https://github.com/jhony-saba/tackflow_backend/blob/main/routes/taskRoute.js): `routes/taskRoute.js`
- [Task validation](https://github.com/jhony-saba/tackflow_backend/blob/main/Validator/taskValidator.js): `Validator/taskValidator.js`
- [Task operations](https://github.com/jhony-saba/tackflow_backend/blob/main/Controllers/taskController.js): `Controllers/taskController.js`
- [Task model](https://github.com/jhony-saba/tackflow_backend/blob/main/models/taskModel.js): `models/taskModel.js`

### Other components

- **API client**

## Connections

- API client → Express server: sends requests (evidence: `index.js`)
- Express server → DB connection: connects (evidence: `index.js`)
- Express server → User routes: mounts (evidence: `index.js`)
- Express server → Project routes: mounts (evidence: `index.js`)
- Express server → Task routes: mounts (evidence: `index.js`)
- Express server → Error handler: handles errors (evidence: `index.js`)
- User routes → User validation: validates (evidence: `routes/userRoute.js`)
- User routes → User operations: dispatches (evidence: `routes/userRoute.js`)
- User operations → User model: queries (evidence: `Controllers/userController.js`)
- User routes → JWT middleware: guards
- Project routes → Project validation: validates (evidence: `routes/projectRoute.js`)
- Project routes → JWT middleware: guards (evidence: `routes/projectRoute.js`)
- Project routes → Project operations: dispatches (evidence: `routes/projectRoute.js`)
- Project operations → Project model: queries (evidence: `Controllers/projectController.js`)
- Project operations → Task model: deletes tasks (evidence: `Controllers/projectController.js`)
- Task routes → Task validation: validates (evidence: `routes/taskRoute.js`)
- Task routes → JWT middleware: guards (evidence: `routes/taskRoute.js`)
- Task routes → Task operations: dispatches (evidence: `routes/taskRoute.js`)
- Task operations → Task model: queries (evidence: `Controllers/taskController.js`)
