# iskhakov-06/kanban-task-tracker architecture

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

- Interactive diagram: https://gitdiagram.com/iskhakov-06/kanban-task-tracker
- Repository: https://github.com/iskhakov-06/kanban-task-tracker

## Overview

Task Tracker is a collaborative kanban application. Users register or sign in, then create boards, organize work into columns and tasks, move tasks between columns, and collaborate through membership, comments, and activity history. The React client calls a REST API; backend routes apply authentication, role and resource-scope checks before controllers delegate domain operations to services and Sequelize models. The README documents email verification and password reset as additional auth flows. Some feature links rely on README statements or SOURCE INDEX references because their implementation was not excerpted.

Main entry points: [`frontend/src/router/index.jsx`](https://github.com/iskhakov-06/kanban-task-tracker/blob/main/frontend/src/router/index.jsx) (Page router), [`frontend/src/pages/BoardPage.jsx`](https://github.com/iskhakov-06/kanban-task-tracker/blob/main/frontend/src/pages/BoardPage.jsx) (Board workspace), [`backend/src/app.js`](https://github.com/iskhakov-06/kanban-task-tracker/blob/main/backend/src/app.js) (Express app), [`backend/src/models/index.js`](https://github.com/iskhakov-06/kanban-task-tracker/blob/main/backend/src/models/index.js) (Domain models)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["React client"]
  node_app["App shell<br/>[App.jsx]"]
  node_router["Page router<br/>[index.jsx]"]
  node_auth_pages["Auth pages<br/>[LoginPage.jsx]"]
  node_home_page["Board listing<br/>[HomePage.jsx]"]
  node_board_page["Board workspace<br/>[BoardPage.jsx]"]
  node_board_components["Board components<br/>[BoardColumn.jsx]"]
  node_task_modal["Task details<br/>[TaskModal.jsx]"]
  node_member_modal["Member management<br/>[AddMemberModal.jsx]"]
  node_auth_state["Auth state<br/>[authSlice.js]"]
  node_api_client["API client<br/>[axios.js]"]
  node_api_methods["API operations<br/>[index.js]"]
end

subgraph group_api["REST API"]
  node_express_app["Express app<br/>[app.js]"]
  node_auth_routes["Auth routes<br/>[auth.js]"]
  node_board_routes["Board routes<br/>[boards.js]"]
  node_column_routes["Column routes<br/>[columns.js]"]
  node_task_routes["Task routes<br/>[tasks.js]"]
  node_auth_controller["Auth handlers<br/>[authController.js]"]
  node_task_controller["Task handlers<br/>[taskController.js]"]
  node_access_middleware["Access checks<br/>[rbac.js]"]
end

subgraph group_identity["Identity and access"]
  node_auth_service["Auth service<br/>[authService.js]"]
  node_email_helper["Email delivery helper<br/>[email.js]"]
end

subgraph group_work["Kanban collaboration"]
  node_board_service["Board service<br/>[boardService.js]"]
  node_column_service["Column service<br/>[columnService.js]"]
  node_task_service["Task service<br/>[taskService.js]"]
end

subgraph group_persistence["Persistence and operations"]
  node_domain_models["Domain models<br/>[index.js]"]
  node_db_config["Database connection<br/>[database.js]"]
end

node_user(("User"))
node_mail_service["SMTP service"]
node_mysql[("MySQL")]

node_user -->|"uses"| node_app
node_app -->|"renders"| node_router
node_router -->|"routes to"| node_auth_pages
node_router -->|"routes to"| node_home_page
node_router -->|"routes to"| node_board_page
node_router -->|"restores session"| node_auth_state
node_auth_pages -->|"dispatches"| node_auth_state
node_auth_state -->|"calls"| node_api_methods
node_home_page -.->|"loads boards"| node_api_methods
node_board_page -->|"loads and updates"| node_api_methods
node_board_page -->|"renders"| node_board_components
node_board_page -->|"renders"| node_task_modal
node_board_page -->|"renders"| node_member_modal
node_api_methods -->|"sends requests"| node_api_client
node_api_client -->|"calls REST API"| node_express_app
node_express_app -->|"mounts"| node_auth_routes
node_express_app -->|"mounts"| node_board_routes
node_express_app -->|"mounts"| node_column_routes
node_express_app -->|"mounts"| node_task_routes
node_auth_routes -->|"dispatches"| node_auth_controller
node_task_routes -->|"checks access"| node_access_middleware
node_task_routes -->|"dispatches"| node_task_controller
node_auth_controller -->|"delegates to"| node_auth_service
node_auth_service -->|"reads and writes"| node_domain_models
node_auth_service -->|"requests email"| node_email_helper
node_email_helper -.->|"sends mail"| node_mail_service
node_board_routes -.->|"dispatches"| node_board_service
node_column_routes -.->|"dispatches"| node_column_service
node_task_controller -->|"delegates to"| node_task_service
node_task_service -->|"reads and writes"| node_domain_models
node_board_service -->|"reads and writes"| node_domain_models
node_column_service -->|"reads and writes"| node_domain_models
node_domain_models -.->|"uses connection"| node_db_config
node_db_config -->|"connects to"| node_mysql

click node_app "https://github.com/iskhakov-06/kanban-task-tracker/blob/main/frontend/src/App.jsx"
click node_router "https://github.com/iskhakov-06/kanban-task-tracker/blob/main/frontend/src/router/index.jsx"
click node_auth_pages "https://github.com/iskhakov-06/kanban-task-tracker/blob/main/frontend/src/pages/LoginPage.jsx"
click node_home_page "https://github.com/iskhakov-06/kanban-task-tracker/blob/main/frontend/src/pages/HomePage.jsx"
click node_board_page "https://github.com/iskhakov-06/kanban-task-tracker/blob/main/frontend/src/pages/BoardPage.jsx"
click node_board_components "https://github.com/iskhakov-06/kanban-task-tracker/blob/main/frontend/src/components/Board/BoardColumn.jsx"
click node_task_modal "https://github.com/iskhakov-06/kanban-task-tracker/blob/main/frontend/src/components/Board/TaskModal.jsx"
click node_member_modal "https://github.com/iskhakov-06/kanban-task-tracker/blob/main/frontend/src/components/Board/AddMemberModal.jsx"
click node_auth_state "https://github.com/iskhakov-06/kanban-task-tracker/blob/main/frontend/src/store/slices/authSlice.js"
click node_api_client "https://github.com/iskhakov-06/kanban-task-tracker/blob/main/frontend/src/api/axios.js"
click node_api_methods "https://github.com/iskhakov-06/kanban-task-tracker/blob/main/frontend/src/api/index.js"
click node_express_app "https://github.com/iskhakov-06/kanban-task-tracker/blob/main/backend/src/app.js"
click node_auth_routes "https://github.com/iskhakov-06/kanban-task-tracker/blob/main/backend/src/routes/auth.js"
click node_board_routes "https://github.com/iskhakov-06/kanban-task-tracker/blob/main/backend/src/routes/boards.js"
click node_column_routes "https://github.com/iskhakov-06/kanban-task-tracker/blob/main/backend/src/routes/columns.js"
click node_task_routes "https://github.com/iskhakov-06/kanban-task-tracker/blob/main/backend/src/routes/tasks.js"
click node_auth_controller "https://github.com/iskhakov-06/kanban-task-tracker/blob/main/backend/src/controllers/authController.js"
click node_task_controller "https://github.com/iskhakov-06/kanban-task-tracker/blob/main/backend/src/controllers/taskController.js"
click node_access_middleware "https://github.com/iskhakov-06/kanban-task-tracker/blob/main/backend/src/middleware/rbac.js"
click node_auth_service "https://github.com/iskhakov-06/kanban-task-tracker/blob/main/backend/src/services/authService.js"
click node_email_helper "https://github.com/iskhakov-06/kanban-task-tracker/blob/main/backend/src/utils/email.js"
click node_board_service "https://github.com/iskhakov-06/kanban-task-tracker/blob/main/backend/src/services/boardService.js"
click node_column_service "https://github.com/iskhakov-06/kanban-task-tracker/blob/main/backend/src/services/columnService.js"
click node_task_service "https://github.com/iskhakov-06/kanban-task-tracker/blob/main/backend/src/services/taskService.js"
click node_domain_models "https://github.com/iskhakov-06/kanban-task-tracker/blob/main/backend/src/models/index.js"
click node_db_config "https://github.com/iskhakov-06/kanban-task-tracker/blob/main/backend/src/config/database.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_router,node_auth_pages,node_home_page,node_board_page,node_board_components,node_task_modal,node_member_modal,node_auth_state,node_api_client,node_api_methods,node_user toneBlue
class node_express_app,node_auth_routes,node_board_routes,node_column_routes,node_task_routes,node_auth_controller,node_task_controller,node_access_middleware,node_mysql toneAmber
class node_auth_service,node_email_helper toneMint
class node_board_service,node_column_service,node_task_service toneRose
class node_domain_models,node_db_config,node_mail_service toneIndigo
```

## Components

### React client

- [App shell](https://github.com/iskhakov-06/kanban-task-tracker/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Page router](https://github.com/iskhakov-06/kanban-task-tracker/blob/main/frontend/src/router/index.jsx): `frontend/src/router/index.jsx`
- [Auth pages](https://github.com/iskhakov-06/kanban-task-tracker/blob/main/frontend/src/pages/LoginPage.jsx): `frontend/src/pages/LoginPage.jsx`
- [Board listing](https://github.com/iskhakov-06/kanban-task-tracker/blob/main/frontend/src/pages/HomePage.jsx): `frontend/src/pages/HomePage.jsx`
- [Board workspace](https://github.com/iskhakov-06/kanban-task-tracker/blob/main/frontend/src/pages/BoardPage.jsx): `frontend/src/pages/BoardPage.jsx`
- [Board components](https://github.com/iskhakov-06/kanban-task-tracker/blob/main/frontend/src/components/Board/BoardColumn.jsx): `frontend/src/components/Board/BoardColumn.jsx`
- [Task details](https://github.com/iskhakov-06/kanban-task-tracker/blob/main/frontend/src/components/Board/TaskModal.jsx): `frontend/src/components/Board/TaskModal.jsx`
- [Member management](https://github.com/iskhakov-06/kanban-task-tracker/blob/main/frontend/src/components/Board/AddMemberModal.jsx): `frontend/src/components/Board/AddMemberModal.jsx`
- [Auth state](https://github.com/iskhakov-06/kanban-task-tracker/blob/main/frontend/src/store/slices/authSlice.js): `frontend/src/store/slices/authSlice.js`
- [API client](https://github.com/iskhakov-06/kanban-task-tracker/blob/main/frontend/src/api/axios.js): `frontend/src/api/axios.js`
- [API operations](https://github.com/iskhakov-06/kanban-task-tracker/blob/main/frontend/src/api/index.js): `frontend/src/api/index.js`

### REST API

- [Express app](https://github.com/iskhakov-06/kanban-task-tracker/blob/main/backend/src/app.js): `backend/src/app.js`
- [Auth routes](https://github.com/iskhakov-06/kanban-task-tracker/blob/main/backend/src/routes/auth.js): `backend/src/routes/auth.js`
- [Board routes](https://github.com/iskhakov-06/kanban-task-tracker/blob/main/backend/src/routes/boards.js): `backend/src/routes/boards.js`
- [Column routes](https://github.com/iskhakov-06/kanban-task-tracker/blob/main/backend/src/routes/columns.js): `backend/src/routes/columns.js`
- [Task routes](https://github.com/iskhakov-06/kanban-task-tracker/blob/main/backend/src/routes/tasks.js): `backend/src/routes/tasks.js`
- [Auth handlers](https://github.com/iskhakov-06/kanban-task-tracker/blob/main/backend/src/controllers/authController.js): `backend/src/controllers/authController.js`
- [Task handlers](https://github.com/iskhakov-06/kanban-task-tracker/blob/main/backend/src/controllers/taskController.js): `backend/src/controllers/taskController.js`
- [Access checks](https://github.com/iskhakov-06/kanban-task-tracker/blob/main/backend/src/middleware/rbac.js): `backend/src/middleware/rbac.js`

### Identity and access

- [Auth service](https://github.com/iskhakov-06/kanban-task-tracker/blob/main/backend/src/services/authService.js): `backend/src/services/authService.js`
- [Email delivery helper](https://github.com/iskhakov-06/kanban-task-tracker/blob/main/backend/src/utils/email.js): `backend/src/utils/email.js`

### Kanban collaboration

- [Board service](https://github.com/iskhakov-06/kanban-task-tracker/blob/main/backend/src/services/boardService.js): `backend/src/services/boardService.js`
- [Column service](https://github.com/iskhakov-06/kanban-task-tracker/blob/main/backend/src/services/columnService.js): `backend/src/services/columnService.js`
- [Task service](https://github.com/iskhakov-06/kanban-task-tracker/blob/main/backend/src/services/taskService.js): `backend/src/services/taskService.js`

### Persistence and operations

- [Domain models](https://github.com/iskhakov-06/kanban-task-tracker/blob/main/backend/src/models/index.js): `backend/src/models/index.js`
- [Database connection](https://github.com/iskhakov-06/kanban-task-tracker/blob/main/backend/src/config/database.js): `backend/src/config/database.js`

### Other components

- **User**
- **SMTP service**
- **MySQL**

## Connections

- User → App shell: uses (evidence: `README.md`)
- App shell → Page router: renders (evidence: `frontend/src/App.jsx`)
- Page router → Auth pages: routes to (evidence: `frontend/src/router/index.jsx`)
- Page router → Board listing: routes to (evidence: `frontend/src/router/index.jsx`)
- Page router → Board workspace: routes to (evidence: `frontend/src/router/index.jsx`)
- Page router → Auth state: restores session (evidence: `frontend/src/router/index.jsx`)
- Auth pages → Auth state: dispatches (evidence: `frontend/src/pages/LoginPage.jsx`)
- Auth state → API operations: calls (evidence: `frontend/src/store/slices/authSlice.js`)
- Board listing → API operations: loads boards
- Board workspace → API operations: loads and updates (evidence: `frontend/src/pages/BoardPage.jsx`)
- Board workspace → Board components: renders (evidence: `frontend/src/pages/BoardPage.jsx`)
- Board workspace → Task details: renders (evidence: `frontend/src/pages/BoardPage.jsx`)
- Board workspace → Member management: renders (evidence: `frontend/src/pages/BoardPage.jsx`)
- API operations → API client: sends requests (evidence: `frontend/src/api/index.js`)
- API client → Express app: calls REST API (evidence: `README.md`)
- Express app → Auth routes: mounts (evidence: `backend/src/app.js`)
- Express app → Board routes: mounts (evidence: `backend/src/app.js`)
- Express app → Column routes: mounts (evidence: `backend/src/app.js`)
- Express app → Task routes: mounts (evidence: `backend/src/app.js`)
- Auth routes → Auth handlers: dispatches (evidence: `backend/src/routes/auth.js`)
- Task routes → Access checks: checks access (evidence: `backend/src/routes/tasks.js`)
- Task routes → Task handlers: dispatches (evidence: `backend/src/routes/tasks.js`)
- Auth handlers → Auth service: delegates to (evidence: `backend/src/controllers/authController.js`)
- Auth service → Domain models: reads and writes (evidence: `backend/src/services/authService.js`)
- Auth service → Email delivery helper: requests email (evidence: `backend/src/services/authService.js`)
- Email delivery helper → SMTP service: sends mail
- Board routes → Board service: dispatches
- Column routes → Column service: dispatches
- Task handlers → Task service: delegates to (evidence: `backend/src/controllers/taskController.js`)
- Task service → Domain models: reads and writes (evidence: `backend/src/services/taskService.js`)
- Board service → Domain models: reads and writes (evidence: `backend/src/services/boardService.js`)
- Column service → Domain models: reads and writes (evidence: `backend/src/services/columnService.js`)
- Domain models → Database connection: uses connection
- Database connection → MySQL: connects to (evidence: `README.md`)
