# sureshgandham18/asset-management-system architecture

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

- Interactive diagram: https://gitdiagram.com/sureshgandham18/asset-management-system
- Repository: https://github.com/sureshgandham18/asset-management-system

## Overview

This Spring application manages enterprise assets through inventory, assignment/check-in, employee and department records, and maintenance work orders; it also supports user registration and login with JWTs. The main workflow is an API request routed to a domain controller and service, with persistence represented by repositories and JPA entities. The graph includes documented controller/service and authentication dependencies; implementation classes and unshown wiring are not inferred from their names.

Main entry points: [`src/main/java/com/enterprise/asset_management/security/service/AuthService.java`](https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/security/service/AuthService.java) (Authentication service), [`src/main/java/com/enterprise/asset_management/asset/controller/AssetController.java`](https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/asset/controller/AssetController.java) (Asset API), [`src/main/java/com/enterprise/asset_management/assignment/controller/AssignmentController.java`](https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/assignment/controller/AssignmentController.java) (Assignment API), [`src/main/java/com/enterprise/asset_management/department/controller/DepartmentController.java`](https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/department/controller/DepartmentController.java) (Department API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inventory["Asset inventory"]
  node_asset_controller["Asset API"]
  node_asset_service["Asset service<br/>[AssetService.java]"]
  node_asset_repository["Asset repository"]
  node_asset_entity[("Asset records<br/>[Asset.java]")]
  node_asset_status["Asset lifecycle<br/>[AssetStatus.java]"]
  node_asset_requests["Asset request data"]
  node_asset_responses["Asset response data<br/>[AssetResponse.java]"]
  node_paged_response["Paged results<br/>[PagedResponse.java]"]
end

subgraph group_operations["Asset operations"]
  node_assignment_controller["Assignment API"]
  node_assignment_service["Assignment service"]
  node_assignment_repository["Assignment repository"]
  node_assignment_entity[("Assignment records")]
  node_assignment_requests["Check-in/out data"]
  node_assignment_response["Assignment response"]
end

subgraph group_organization["Organization"]
  node_department_controller["Department API"]
  node_department_service["Department service"]
  node_department_repository["Department repository"]
  node_department_entity[("Department records<br/>[Department.java]")]
  node_employee_controller["Employee API"]
  node_employee_service["Employee service"]
  node_employee_repository["Employee repository"]
  node_employee_entity[("Employee records<br/>[Employee.java]")]
end

subgraph group_maintenance["Maintenance"]
  node_workorder_controller["Work order API"]
  node_workorder_service["Work order service"]
  node_workorder_repository["Work order repository"]
  node_workorder_entity[("Work orders<br/>[WorkOrder.java]")]
  node_workorder_status["Work order lifecycle"]
  node_workorder_requests["Work order requests"]
  node_workorder_responses["Work order responses"]
end

subgraph group_identity["Identity and security"]
  node_auth_controller["Authentication API"]
  node_auth_service["Authentication service<br/>[AuthService.java]"]
  node_user_repository["User repository"]
  node_user_entity[("User accounts<br/>[User.java]")]
end

node_client(("API client"))

node_client -->|"calls API"| node_asset_controller
node_asset_controller -->|"delegates to"| node_asset_service
node_client -->|"calls API"| node_assignment_controller
node_assignment_controller -->|"delegates to"| node_assignment_service
node_client -->|"calls API"| node_department_controller
node_department_controller -->|"delegates to"| node_department_service
node_client -->|"calls API"| node_employee_controller
node_employee_controller -->|"delegates to"| node_employee_service
node_client -->|"calls API"| node_workorder_controller
node_workorder_controller -->|"delegates to"| node_workorder_service
node_client -->|"calls API"| node_auth_controller
node_auth_controller -->|"delegates to"| node_auth_service
node_asset_entity -->|"references department"| node_department_entity
node_auth_service -->|"checks and saves"| node_user_repository
node_auth_service -->|"creates account"| node_user_entity

click node_asset_controller "https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/asset/controller/AssetController.java"
click node_asset_service "https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/asset/service/AssetService.java"
click node_asset_repository "https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/asset/repository/AssetRepository.java"
click node_asset_entity "https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/asset/model/Asset.java"
click node_asset_status "https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/asset/model/AssetStatus.java"
click node_asset_requests "https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/asset/dto/AssetCreateRequest.java"
click node_asset_responses "https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/asset/dto/AssetResponse.java"
click node_paged_response "https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/asset/dto/PagedResponse.java"
click node_assignment_controller "https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/assignment/controller/AssignmentController.java"
click node_assignment_service "https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/assignment/service/AssignmentService.java"
click node_assignment_repository "https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/assignment/repository/AssetAssignmentRepository.java"
click node_assignment_entity "https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/assignment/model/AssetAssignment.java"
click node_assignment_requests "https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/assignment/dto/CheckOutRequest.java"
click node_assignment_response "https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/assignment/dto/AssignmentResponse.java"
click node_department_controller "https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/department/controller/DepartmentController.java"
click node_department_service "https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/department/service/DepartmentService.java"
click node_department_repository "https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/department/repository/DepartmentRepository.java"
click node_department_entity "https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/department/model/Department.java"
click node_employee_controller "https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/employee/controller/EmployeeController.java"
click node_employee_service "https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/employee/service/EmployeeService.java"
click node_employee_repository "https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/employee/repository/EmployeeRepository.java"
click node_employee_entity "https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/employee/model/Employee.java"
click node_workorder_controller "https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/maintenance/controller/WorkOrderController.java"
click node_workorder_service "https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/maintenance/service/WorkOrderService.java"
click node_workorder_repository "https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/maintenance/repository/WorkOrderRepository.java"
click node_workorder_entity "https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/maintenance/model/WorkOrder.java"
click node_workorder_status "https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/maintenance/model/WorkOrderStatus.java"
click node_workorder_requests "https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/maintenance/dto/WorkOrderCreateRequest.java"
click node_workorder_responses "https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/maintenance/dto/WorkOrderResponse.java"
click node_auth_controller "https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/security/controller/AuthController.java"
click node_auth_service "https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/security/service/AuthService.java"
click node_user_repository "https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/security/repository/UserRepository.java"
click node_user_entity "https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/security/model/User.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_asset_controller,node_asset_service,node_asset_repository,node_asset_entity,node_asset_status,node_asset_requests,node_asset_responses,node_paged_response,node_client toneBlue
class node_assignment_controller,node_assignment_service,node_assignment_repository,node_assignment_entity,node_assignment_requests,node_assignment_response toneAmber
class node_department_controller,node_department_service,node_department_repository,node_department_entity,node_employee_controller,node_employee_service,node_employee_repository,node_employee_entity toneMint
class node_workorder_controller,node_workorder_service,node_workorder_repository,node_workorder_entity,node_workorder_status,node_workorder_requests,node_workorder_responses toneRose
class node_auth_controller,node_auth_service,node_user_repository,node_user_entity toneIndigo
```

## Components

### Asset inventory

- [Asset API](https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/asset/controller/AssetController.java): `src/main/java/com/enterprise/asset_management/asset/controller/AssetController.java`
- [Asset service](https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/asset/service/AssetService.java): `src/main/java/com/enterprise/asset_management/asset/service/AssetService.java`
- [Asset repository](https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/asset/repository/AssetRepository.java): `src/main/java/com/enterprise/asset_management/asset/repository/AssetRepository.java`
- [Asset records](https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/asset/model/Asset.java): `src/main/java/com/enterprise/asset_management/asset/model/Asset.java`
- [Asset lifecycle](https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/asset/model/AssetStatus.java): `src/main/java/com/enterprise/asset_management/asset/model/AssetStatus.java`
- [Asset request data](https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/asset/dto/AssetCreateRequest.java): `src/main/java/com/enterprise/asset_management/asset/dto/AssetCreateRequest.java`
- [Asset response data](https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/asset/dto/AssetResponse.java): `src/main/java/com/enterprise/asset_management/asset/dto/AssetResponse.java`
- [Paged results](https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/asset/dto/PagedResponse.java): `src/main/java/com/enterprise/asset_management/asset/dto/PagedResponse.java`

### Asset operations

- [Assignment API](https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/assignment/controller/AssignmentController.java): `src/main/java/com/enterprise/asset_management/assignment/controller/AssignmentController.java`
- [Assignment service](https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/assignment/service/AssignmentService.java): `src/main/java/com/enterprise/asset_management/assignment/service/AssignmentService.java`
- [Assignment repository](https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/assignment/repository/AssetAssignmentRepository.java): `src/main/java/com/enterprise/asset_management/assignment/repository/AssetAssignmentRepository.java`
- [Assignment records](https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/assignment/model/AssetAssignment.java): `src/main/java/com/enterprise/asset_management/assignment/model/AssetAssignment.java`
- [Check-in/out data](https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/assignment/dto/CheckOutRequest.java): `src/main/java/com/enterprise/asset_management/assignment/dto/CheckOutRequest.java`
- [Assignment response](https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/assignment/dto/AssignmentResponse.java): `src/main/java/com/enterprise/asset_management/assignment/dto/AssignmentResponse.java`

### Organization

- [Department API](https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/department/controller/DepartmentController.java): `src/main/java/com/enterprise/asset_management/department/controller/DepartmentController.java`
- [Department service](https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/department/service/DepartmentService.java): `src/main/java/com/enterprise/asset_management/department/service/DepartmentService.java`
- [Department repository](https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/department/repository/DepartmentRepository.java): `src/main/java/com/enterprise/asset_management/department/repository/DepartmentRepository.java`
- [Department records](https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/department/model/Department.java): `src/main/java/com/enterprise/asset_management/department/model/Department.java`
- [Employee API](https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/employee/controller/EmployeeController.java): `src/main/java/com/enterprise/asset_management/employee/controller/EmployeeController.java`
- [Employee service](https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/employee/service/EmployeeService.java): `src/main/java/com/enterprise/asset_management/employee/service/EmployeeService.java`
- [Employee repository](https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/employee/repository/EmployeeRepository.java): `src/main/java/com/enterprise/asset_management/employee/repository/EmployeeRepository.java`
- [Employee records](https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/employee/model/Employee.java): `src/main/java/com/enterprise/asset_management/employee/model/Employee.java`

### Maintenance

- [Work order API](https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/maintenance/controller/WorkOrderController.java): `src/main/java/com/enterprise/asset_management/maintenance/controller/WorkOrderController.java`
- [Work order service](https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/maintenance/service/WorkOrderService.java): `src/main/java/com/enterprise/asset_management/maintenance/service/WorkOrderService.java`
- [Work order repository](https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/maintenance/repository/WorkOrderRepository.java): `src/main/java/com/enterprise/asset_management/maintenance/repository/WorkOrderRepository.java`
- [Work orders](https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/maintenance/model/WorkOrder.java): `src/main/java/com/enterprise/asset_management/maintenance/model/WorkOrder.java`
- [Work order lifecycle](https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/maintenance/model/WorkOrderStatus.java): `src/main/java/com/enterprise/asset_management/maintenance/model/WorkOrderStatus.java`
- [Work order requests](https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/maintenance/dto/WorkOrderCreateRequest.java): `src/main/java/com/enterprise/asset_management/maintenance/dto/WorkOrderCreateRequest.java`
- [Work order responses](https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/maintenance/dto/WorkOrderResponse.java): `src/main/java/com/enterprise/asset_management/maintenance/dto/WorkOrderResponse.java`

### Identity and security

- [Authentication API](https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/security/controller/AuthController.java): `src/main/java/com/enterprise/asset_management/security/controller/AuthController.java`
- [Authentication service](https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/security/service/AuthService.java): `src/main/java/com/enterprise/asset_management/security/service/AuthService.java`
- [User repository](https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/security/repository/UserRepository.java): `src/main/java/com/enterprise/asset_management/security/repository/UserRepository.java`
- [User accounts](https://github.com/sureshgandham18/asset-management-system/blob/main/src/main/java/com/enterprise/asset_management/security/model/User.java): `src/main/java/com/enterprise/asset_management/security/model/User.java`

### Other components

- **API client**

## Connections

- API client → Asset API: calls API (evidence: `src/main/java/com/enterprise/asset_management/asset/controller/AssetController.java`)
- Asset API → Asset service: delegates to (evidence: `src/main/java/com/enterprise/asset_management/asset/controller/AssetController.java`)
- API client → Assignment API: calls API (evidence: `src/main/java/com/enterprise/asset_management/assignment/controller/AssignmentController.java`)
- Assignment API → Assignment service: delegates to (evidence: `src/main/java/com/enterprise/asset_management/assignment/controller/AssignmentController.java`)
- API client → Department API: calls API (evidence: `src/main/java/com/enterprise/asset_management/department/controller/DepartmentController.java`)
- Department API → Department service: delegates to (evidence: `src/main/java/com/enterprise/asset_management/department/controller/DepartmentController.java`)
- API client → Employee API: calls API (evidence: `src/main/java/com/enterprise/asset_management/employee/controller/EmployeeController.java`)
- Employee API → Employee service: delegates to (evidence: `src/main/java/com/enterprise/asset_management/employee/controller/EmployeeController.java`)
- API client → Work order API: calls API (evidence: `src/main/java/com/enterprise/asset_management/maintenance/controller/WorkOrderController.java`)
- Work order API → Work order service: delegates to (evidence: `src/main/java/com/enterprise/asset_management/maintenance/controller/WorkOrderController.java`)
- API client → Authentication API: calls API (evidence: `src/main/java/com/enterprise/asset_management/security/controller/AuthController.java`)
- Authentication API → Authentication service: delegates to (evidence: `src/main/java/com/enterprise/asset_management/security/controller/AuthController.java`)
- Asset records → Department records: references department (evidence: `src/main/java/com/enterprise/asset_management/asset/model/Asset.java`)
- Authentication service → User repository: checks and saves (evidence: `src/main/java/com/enterprise/asset_management/security/service/AuthService.java`)
- Authentication service → User accounts: creates account (evidence: `src/main/java/com/enterprise/asset_management/security/service/AuthService.java`)
