# rathachhorm/task-management-system architecture

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

- Interactive diagram: https://gitdiagram.com/rathachhorm/task-management-system
- Repository: https://github.com/rathachhorm/task-management-system

## Overview

This is a task-management web application: users register or sign in, then view tasks grouped by pending/completed status and create, update, or delete them. The frontend calls a Spring backend; authentication issues access and refresh JWTs, while task operations are scoped to the authenticated user. The backend also exposes category operations, though the README does not describe their user-facing flow. Source excerpts establish several frontend and service calls; links marked dashed are unverified because the relevant implementation was not shown. The README documents a startup-created admin account.

Main entry points: [`task-management-frontend/src/App.jsx`](https://github.com/rathachhorm/task-management-system/blob/main/task-management-frontend/src/App.jsx) (App routing), [`task-management-frontend/src/pages/TasksPage.jsx`](https://github.com/rathachhorm/task-management-system/blob/main/task-management-frontend/src/pages/TasksPage.jsx) (Task board), [`task-management-backend/src/main/java/com/ratha/taskmanagementbackend/service/impl/AuthServiceImpl.java`](https://github.com/rathachhorm/task-management-system/blob/main/task-management-backend/src/main/java/com/ratha/taskmanagementbackend/service/impl/AuthServiceImpl.java) (Auth service), [`task-management-backend/src/main/java/com/ratha/taskmanagementbackend/model/Task.java`](https://github.com/rathachhorm/task-management-system/blob/main/task-management-backend/src/main/java/com/ratha/taskmanagementbackend/model/Task.java) (Task model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["App routing<br/>[App.jsx]"]
  node_login_page["Sign-in page<br/>[LoginPage.jsx]"]
  node_register_page["Registration page<br/>[RegisterPage.jsx]"]
  node_tasks_page["Task board<br/>[TasksPage.jsx]"]
  node_task_card["Task card"]
  node_task_form["Task form"]
end

subgraph group_identity["Identity and security"]
  node_login_service["Login service<br/>[login.service.js]"]
  node_auth_api["Auth API"]
  node_auth_service["Auth service"]
  node_jwt["JWT service<br/>[JwtService.java]"]
  node_user_repo["User repository"]
  node_user_model["User model<br/>[User.java]"]
end

subgraph group_tasks["Task management"]
  node_task_service["Task service<br/>[task.service.js]"]
  node_task_api["Task API"]
  node_task_service_impl["Task service"]
  node_task_repo["Task repository"]
  node_task_model["Task model<br/>[Task.java]"]
  node_status_model["Task status<br/>[TaskStatus.java]"]
end

subgraph group_backend["Backend domain"]
  node_category_api["Category API"]
  node_category_service["Category service"]
  node_category_model["Category model<br/>[Category.java]"]
  node_category_repo["Category repository"]
end

node_person(("User"))
node_database[("Application database")]

node_person -.->|"opens"| node_app
node_app -->|"routes to"| node_login_page
node_app -->|"routes to"| node_register_page
node_app -->|"routes to"| node_tasks_page
node_login_page -.->|"authenticates via"| node_login_service
node_register_page -->|"registers via"| node_login_service
node_login_service -->|"sends auth requests"| node_auth_api
node_auth_api -->|"delegates to"| node_auth_service
node_auth_service -->|"reads and writes"| node_user_repo
node_auth_service -->|"issues tokens"| node_jwt
node_user_repo -->|"stores"| node_user_model
node_user_model -.->|"persists in"| node_database
node_tasks_page -->|"loads and mutates"| node_task_service
node_tasks_page -->|"renders"| node_task_card
node_tasks_page -->|"renders"| node_task_form
node_task_service -.->|"sends task requests"| node_task_api
node_task_api -->|"delegates to"| node_task_service_impl
node_task_service_impl -.->|"accesses tasks"| node_task_repo
node_task_repo -->|"queries"| node_task_model
node_task_model -.->|"uses status"| node_status_model
node_task_model -.->|"persists in"| node_database
node_category_api -->|"delegates to"| node_category_service
node_category_service -.->|"uses category"| node_category_model
node_category_service -.->|"accesses categories"| node_category_repo
node_category_model -.->|"persists in"| node_database

click node_app "https://github.com/rathachhorm/task-management-system/blob/main/task-management-frontend/src/App.jsx"
click node_login_page "https://github.com/rathachhorm/task-management-system/blob/main/task-management-frontend/src/pages/LoginPage.jsx"
click node_register_page "https://github.com/rathachhorm/task-management-system/blob/main/task-management-frontend/src/pages/RegisterPage.jsx"
click node_tasks_page "https://github.com/rathachhorm/task-management-system/blob/main/task-management-frontend/src/pages/TasksPage.jsx"
click node_task_card "https://github.com/rathachhorm/task-management-system/blob/main/task-management-frontend/src/components/TaskCardComponent.jsx"
click node_task_form "https://github.com/rathachhorm/task-management-system/blob/main/task-management-frontend/src/components/AddNewTaskComponent.jsx"
click node_login_service "https://github.com/rathachhorm/task-management-system/blob/main/task-management-frontend/src/services/login.service.js"
click node_task_service "https://github.com/rathachhorm/task-management-system/blob/main/task-management-frontend/src/services/task.service.js"
click node_auth_api "https://github.com/rathachhorm/task-management-system/blob/main/task-management-backend/src/main/java/com/ratha/taskmanagementbackend/controller/AuthController.java"
click node_auth_service "https://github.com/rathachhorm/task-management-system/blob/main/task-management-backend/src/main/java/com/ratha/taskmanagementbackend/service/impl/AuthServiceImpl.java"
click node_jwt "https://github.com/rathachhorm/task-management-system/blob/main/task-management-backend/src/main/java/com/ratha/taskmanagementbackend/jwt/JwtService.java"
click node_user_repo "https://github.com/rathachhorm/task-management-system/blob/main/task-management-backend/src/main/java/com/ratha/taskmanagementbackend/repository/UserRepository.java"
click node_user_model "https://github.com/rathachhorm/task-management-system/blob/main/task-management-backend/src/main/java/com/ratha/taskmanagementbackend/model/User.java"
click node_task_api "https://github.com/rathachhorm/task-management-system/blob/main/task-management-backend/src/main/java/com/ratha/taskmanagementbackend/controller/TaskController.java"
click node_task_service_impl "https://github.com/rathachhorm/task-management-system/blob/main/task-management-backend/src/main/java/com/ratha/taskmanagementbackend/service/impl/TaskServiceImpl.java"
click node_task_repo "https://github.com/rathachhorm/task-management-system/blob/main/task-management-backend/src/main/java/com/ratha/taskmanagementbackend/repository/TaskRepository.java"
click node_task_model "https://github.com/rathachhorm/task-management-system/blob/main/task-management-backend/src/main/java/com/ratha/taskmanagementbackend/model/Task.java"
click node_status_model "https://github.com/rathachhorm/task-management-system/blob/main/task-management-backend/src/main/java/com/ratha/taskmanagementbackend/model/TaskStatus.java"
click node_category_api "https://github.com/rathachhorm/task-management-system/blob/main/task-management-backend/src/main/java/com/ratha/taskmanagementbackend/controller/CategoryController.java"
click node_category_service "https://github.com/rathachhorm/task-management-system/blob/main/task-management-backend/src/main/java/com/ratha/taskmanagementbackend/service/impl/CategoryServiceImpl.java"
click node_category_model "https://github.com/rathachhorm/task-management-system/blob/main/task-management-backend/src/main/java/com/ratha/taskmanagementbackend/model/Category.java"
click node_category_repo "https://github.com/rathachhorm/task-management-system/blob/main/task-management-backend/src/main/java/com/ratha/taskmanagementbackend/repository/CategoryRepository.java"

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_page,node_register_page,node_tasks_page,node_task_card,node_task_form,node_person toneBlue
class node_login_service,node_auth_api,node_auth_service,node_jwt,node_user_repo,node_user_model,node_database toneAmber
class node_task_service,node_task_api,node_task_service_impl,node_task_repo,node_task_model,node_status_model toneMint
class node_category_api,node_category_service,node_category_model,node_category_repo toneRose
```

## Components

### Web application

- [App routing](https://github.com/rathachhorm/task-management-system/blob/main/task-management-frontend/src/App.jsx): `task-management-frontend/src/App.jsx`
- [Sign-in page](https://github.com/rathachhorm/task-management-system/blob/main/task-management-frontend/src/pages/LoginPage.jsx): `task-management-frontend/src/pages/LoginPage.jsx`
- [Registration page](https://github.com/rathachhorm/task-management-system/blob/main/task-management-frontend/src/pages/RegisterPage.jsx): `task-management-frontend/src/pages/RegisterPage.jsx`
- [Task board](https://github.com/rathachhorm/task-management-system/blob/main/task-management-frontend/src/pages/TasksPage.jsx): `task-management-frontend/src/pages/TasksPage.jsx`
- [Task card](https://github.com/rathachhorm/task-management-system/blob/main/task-management-frontend/src/components/TaskCardComponent.jsx): `task-management-frontend/src/components/TaskCardComponent.jsx`
- [Task form](https://github.com/rathachhorm/task-management-system/blob/main/task-management-frontend/src/components/AddNewTaskComponent.jsx): `task-management-frontend/src/components/AddNewTaskComponent.jsx`

### Identity and security

- [Login service](https://github.com/rathachhorm/task-management-system/blob/main/task-management-frontend/src/services/login.service.js): `task-management-frontend/src/services/login.service.js`
- [Auth API](https://github.com/rathachhorm/task-management-system/blob/main/task-management-backend/src/main/java/com/ratha/taskmanagementbackend/controller/AuthController.java): `task-management-backend/src/main/java/com/ratha/taskmanagementbackend/controller/AuthController.java`
- [Auth service](https://github.com/rathachhorm/task-management-system/blob/main/task-management-backend/src/main/java/com/ratha/taskmanagementbackend/service/impl/AuthServiceImpl.java): `task-management-backend/src/main/java/com/ratha/taskmanagementbackend/service/impl/AuthServiceImpl.java`
- [JWT service](https://github.com/rathachhorm/task-management-system/blob/main/task-management-backend/src/main/java/com/ratha/taskmanagementbackend/jwt/JwtService.java): `task-management-backend/src/main/java/com/ratha/taskmanagementbackend/jwt/JwtService.java`
- [User repository](https://github.com/rathachhorm/task-management-system/blob/main/task-management-backend/src/main/java/com/ratha/taskmanagementbackend/repository/UserRepository.java): `task-management-backend/src/main/java/com/ratha/taskmanagementbackend/repository/UserRepository.java`
- [User model](https://github.com/rathachhorm/task-management-system/blob/main/task-management-backend/src/main/java/com/ratha/taskmanagementbackend/model/User.java): `task-management-backend/src/main/java/com/ratha/taskmanagementbackend/model/User.java`

### Task management

- [Task service](https://github.com/rathachhorm/task-management-system/blob/main/task-management-frontend/src/services/task.service.js): `task-management-frontend/src/services/task.service.js`
- [Task API](https://github.com/rathachhorm/task-management-system/blob/main/task-management-backend/src/main/java/com/ratha/taskmanagementbackend/controller/TaskController.java): `task-management-backend/src/main/java/com/ratha/taskmanagementbackend/controller/TaskController.java`
- [Task service](https://github.com/rathachhorm/task-management-system/blob/main/task-management-backend/src/main/java/com/ratha/taskmanagementbackend/service/impl/TaskServiceImpl.java): `task-management-backend/src/main/java/com/ratha/taskmanagementbackend/service/impl/TaskServiceImpl.java`
- [Task repository](https://github.com/rathachhorm/task-management-system/blob/main/task-management-backend/src/main/java/com/ratha/taskmanagementbackend/repository/TaskRepository.java): `task-management-backend/src/main/java/com/ratha/taskmanagementbackend/repository/TaskRepository.java`
- [Task model](https://github.com/rathachhorm/task-management-system/blob/main/task-management-backend/src/main/java/com/ratha/taskmanagementbackend/model/Task.java): `task-management-backend/src/main/java/com/ratha/taskmanagementbackend/model/Task.java`
- [Task status](https://github.com/rathachhorm/task-management-system/blob/main/task-management-backend/src/main/java/com/ratha/taskmanagementbackend/model/TaskStatus.java): `task-management-backend/src/main/java/com/ratha/taskmanagementbackend/model/TaskStatus.java`

### Backend domain

- [Category API](https://github.com/rathachhorm/task-management-system/blob/main/task-management-backend/src/main/java/com/ratha/taskmanagementbackend/controller/CategoryController.java): `task-management-backend/src/main/java/com/ratha/taskmanagementbackend/controller/CategoryController.java`
- [Category service](https://github.com/rathachhorm/task-management-system/blob/main/task-management-backend/src/main/java/com/ratha/taskmanagementbackend/service/impl/CategoryServiceImpl.java): `task-management-backend/src/main/java/com/ratha/taskmanagementbackend/service/impl/CategoryServiceImpl.java`
- [Category model](https://github.com/rathachhorm/task-management-system/blob/main/task-management-backend/src/main/java/com/ratha/taskmanagementbackend/model/Category.java): `task-management-backend/src/main/java/com/ratha/taskmanagementbackend/model/Category.java`
- [Category repository](https://github.com/rathachhorm/task-management-system/blob/main/task-management-backend/src/main/java/com/ratha/taskmanagementbackend/repository/CategoryRepository.java): `task-management-backend/src/main/java/com/ratha/taskmanagementbackend/repository/CategoryRepository.java`

### Other components

- **User**
- **Application database**

## Connections

- User → App routing: opens
- App routing → Sign-in page: routes to (evidence: `task-management-frontend/src/App.jsx`)
- App routing → Registration page: routes to (evidence: `task-management-frontend/src/App.jsx`)
- App routing → Task board: routes to (evidence: `task-management-frontend/src/App.jsx`)
- Sign-in page → Login service: authenticates via (evidence: `task-management-frontend/src/pages/LoginPage.jsx`)
- Registration page → Login service: registers via (evidence: `task-management-frontend/src/pages/RegisterPage.jsx`)
- Login service → Auth API: sends auth requests (evidence: `task-management-frontend/src/services/login.service.js`)
- Auth API → Auth service: delegates to (evidence: `task-management-backend/src/main/java/com/ratha/taskmanagementbackend/controller/AuthController.java`)
- Auth service → User repository: reads and writes (evidence: `task-management-backend/src/main/java/com/ratha/taskmanagementbackend/service/impl/AuthServiceImpl.java`)
- Auth service → JWT service: issues tokens (evidence: `task-management-backend/src/main/java/com/ratha/taskmanagementbackend/service/impl/AuthServiceImpl.java`)
- User repository → User model: stores (evidence: `task-management-backend/src/main/java/com/ratha/taskmanagementbackend/repository/UserRepository.java`)
- User model → Application database: persists in
- Task board → Task service: loads and mutates (evidence: `task-management-frontend/src/pages/TasksPage.jsx`)
- Task board → Task card: renders (evidence: `task-management-frontend/src/pages/TasksPage.jsx`)
- Task board → Task form: renders (evidence: `task-management-frontend/src/pages/TasksPage.jsx`)
- Task service → Task API: sends task requests
- Task API → Task service: delegates to (evidence: `task-management-backend/src/main/java/com/ratha/taskmanagementbackend/controller/TaskController.java`)
- Task service → Task repository: accesses tasks (evidence: `task-management-backend/src/main/java/com/ratha/taskmanagementbackend/service/impl/TaskServiceImpl.java`)
- Task repository → Task model: queries (evidence: `task-management-backend/src/main/java/com/ratha/taskmanagementbackend/repository/TaskRepository.java`)
- Task model → Task status: uses status (evidence: `task-management-backend/src/main/java/com/ratha/taskmanagementbackend/model/Task.java`)
- Task model → Application database: persists in
- Category API → Category service: delegates to (evidence: `task-management-backend/src/main/java/com/ratha/taskmanagementbackend/controller/CategoryController.java`)
- Category service → Category model: uses category
- Category service → Category repository: accesses categories
- Category model → Application database: persists in
