# chandan167/java-user-management architecture

> Architecture diagram of the GitHub repository chandan167/java-user-management, 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/chandan167/java-user-management
- Repository: https://github.com/chandan167/java-user-management

## Overview

This is a Spring Boot user-management API. Clients create, list, fetch, update, and delete users through REST endpoints; the controller delegates to a service implementation, which maps DTOs and persists user entities through a JPA repository. A global advice component formats validation and application errors. The source excerpts show these core calls; framework dispatch and persistence wiring beyond those calls are not expanded.

Main entry points: [`src/main/java/com/chandansingh16794/service/imp/UserServiceImp.java`](https://github.com/chandan167/java-user-management/blob/main/src/main/java/com/chandansingh16794/service/imp/UserServiceImp.java) (User service implementation), [`src/main/java/com/chandansingh16794/controller/UserController.java`](https://github.com/chandan167/java-user-management/blob/main/src/main/java/com/chandansingh16794/controller/UserController.java) (User controller), [`src/main/java/com/chandansingh16794/mapper/UserMapper.java`](https://github.com/chandan167/java-user-management/blob/main/src/main/java/com/chandansingh16794/mapper/UserMapper.java) (User mapper), [`src/main/java/com/chandansingh16794/exception/GlobalExceptionHandler.java`](https://github.com/chandan167/java-user-management/blob/main/src/main/java/com/chandansingh16794/exception/GlobalExceptionHandler.java) (Global exception handler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_controller["User controller"]
  node_dto["User DTO<br/>[UserDto.java]"]
  node_application["Application entry point"]
end

subgraph group_logic["User operations"]
  node_service["User service<br/>[UserService.java]"]
  node_service_impl["User service implementation"]
  node_mapper["User mapper<br/>[UserMapper.java]"]
end

subgraph group_data["User data"]
  node_repository["User repository"]
  node_user[("User entity<br/>[User.java]")]
end

subgraph group_errors["Error handling"]
  node_global_handler["Global exception handler"]
  node_http_exception["HTTP exception<br/>[HttpException.java]"]
  node_exception_response["Exception response"]
end

node_client(("API client"))

node_client -->|"sends requests"| node_controller
node_controller -->|"delegates operations"| node_service
node_service_impl -->|"implements"| node_service
node_controller -->|"accepts and returns"| node_dto
node_service_impl -->|"queries and saves"| node_repository
node_service_impl -->|"maps records"| node_mapper
node_service_impl -->|"throws"| node_http_exception
node_mapper -->|"converts"| node_dto
node_mapper -->|"converts"| node_user
node_repository -->|"persists"| node_user
node_global_handler -->|"handles"| node_http_exception
node_global_handler -->|"builds responses"| node_exception_response
node_application -.->|"enables advice"| node_global_handler

click node_controller "https://github.com/chandan167/java-user-management/blob/main/src/main/java/com/chandansingh16794/controller/UserController.java"
click node_dto "https://github.com/chandan167/java-user-management/blob/main/src/main/java/com/chandansingh16794/dto/UserDto.java"
click node_service "https://github.com/chandan167/java-user-management/blob/main/src/main/java/com/chandansingh16794/service/UserService.java"
click node_service_impl "https://github.com/chandan167/java-user-management/blob/main/src/main/java/com/chandansingh16794/service/imp/UserServiceImp.java"
click node_mapper "https://github.com/chandan167/java-user-management/blob/main/src/main/java/com/chandansingh16794/mapper/UserMapper.java"
click node_repository "https://github.com/chandan167/java-user-management/blob/main/src/main/java/com/chandansingh16794/repository/UserRepository.java"
click node_user "https://github.com/chandan167/java-user-management/blob/main/src/main/java/com/chandansingh16794/entity/User.java"
click node_global_handler "https://github.com/chandan167/java-user-management/blob/main/src/main/java/com/chandansingh16794/exception/GlobalExceptionHandler.java"
click node_http_exception "https://github.com/chandan167/java-user-management/blob/main/src/main/java/com/chandansingh16794/exception/HttpException.java"
click node_exception_response "https://github.com/chandan167/java-user-management/blob/main/src/main/java/com/chandansingh16794/exception/ExceptionResponse.java"
click node_application "https://github.com/chandan167/java-user-management/blob/main/src/main/java/com/chandansingh16794/UserManagementApplication.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_controller,node_dto,node_application,node_client toneBlue
class node_service,node_service_impl,node_mapper toneAmber
class node_repository,node_user toneMint
class node_global_handler,node_http_exception,node_exception_response toneRose
```

## Components

### REST API

- [User controller](https://github.com/chandan167/java-user-management/blob/main/src/main/java/com/chandansingh16794/controller/UserController.java): `src/main/java/com/chandansingh16794/controller/UserController.java`
- [User DTO](https://github.com/chandan167/java-user-management/blob/main/src/main/java/com/chandansingh16794/dto/UserDto.java): `src/main/java/com/chandansingh16794/dto/UserDto.java`
- [Application entry point](https://github.com/chandan167/java-user-management/blob/main/src/main/java/com/chandansingh16794/UserManagementApplication.java): `src/main/java/com/chandansingh16794/UserManagementApplication.java`

### User operations

- [User service](https://github.com/chandan167/java-user-management/blob/main/src/main/java/com/chandansingh16794/service/UserService.java): `src/main/java/com/chandansingh16794/service/UserService.java`
- [User service implementation](https://github.com/chandan167/java-user-management/blob/main/src/main/java/com/chandansingh16794/service/imp/UserServiceImp.java): `src/main/java/com/chandansingh16794/service/imp/UserServiceImp.java`
- [User mapper](https://github.com/chandan167/java-user-management/blob/main/src/main/java/com/chandansingh16794/mapper/UserMapper.java): `src/main/java/com/chandansingh16794/mapper/UserMapper.java`

### User data

- [User repository](https://github.com/chandan167/java-user-management/blob/main/src/main/java/com/chandansingh16794/repository/UserRepository.java): `src/main/java/com/chandansingh16794/repository/UserRepository.java`
- [User entity](https://github.com/chandan167/java-user-management/blob/main/src/main/java/com/chandansingh16794/entity/User.java): `src/main/java/com/chandansingh16794/entity/User.java`

### Error handling

- [Global exception handler](https://github.com/chandan167/java-user-management/blob/main/src/main/java/com/chandansingh16794/exception/GlobalExceptionHandler.java): `src/main/java/com/chandansingh16794/exception/GlobalExceptionHandler.java`
- [HTTP exception](https://github.com/chandan167/java-user-management/blob/main/src/main/java/com/chandansingh16794/exception/HttpException.java): `src/main/java/com/chandansingh16794/exception/HttpException.java`
- [Exception response](https://github.com/chandan167/java-user-management/blob/main/src/main/java/com/chandansingh16794/exception/ExceptionResponse.java): `src/main/java/com/chandansingh16794/exception/ExceptionResponse.java`

### Other components

- **API client**

## Connections

- API client → User controller: sends requests (evidence: `src/main/java/com/chandansingh16794/controller/UserController.java`)
- User controller → User service: delegates operations (evidence: `src/main/java/com/chandansingh16794/controller/UserController.java`)
- User service implementation → User service: implements (evidence: `src/main/java/com/chandansingh16794/service/imp/UserServiceImp.java`)
- User controller → User DTO: accepts and returns (evidence: `src/main/java/com/chandansingh16794/controller/UserController.java`)
- User service implementation → User repository: queries and saves (evidence: `src/main/java/com/chandansingh16794/service/imp/UserServiceImp.java`)
- User service implementation → User mapper: maps records (evidence: `src/main/java/com/chandansingh16794/service/imp/UserServiceImp.java`)
- User service implementation → HTTP exception: throws (evidence: `src/main/java/com/chandansingh16794/service/imp/UserServiceImp.java`)
- User mapper → User DTO: converts (evidence: `src/main/java/com/chandansingh16794/mapper/UserMapper.java`)
- User mapper → User entity: converts (evidence: `src/main/java/com/chandansingh16794/mapper/UserMapper.java`)
- User repository → User entity: persists (evidence: `src/main/java/com/chandansingh16794/repository/UserRepository.java`)
- Global exception handler → HTTP exception: handles (evidence: `src/main/java/com/chandansingh16794/exception/GlobalExceptionHandler.java`)
- Global exception handler → Exception response: builds responses (evidence: `src/main/java/com/chandansingh16794/exception/GlobalExceptionHandler.java`)
- Application entry point → Global exception handler: enables advice
