# riddheshrajwadkar/back-end-projects architecture

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

- Interactive diagram: https://gitdiagram.com/riddheshrajwadkar/back-end-projects
- Repository: https://github.com/riddheshrajwadkar/back-end-projects

## Overview

This repository is a collection of Spring Boot backend training examples, not one unified application. The clearest documented-by-source workflow is the client CRUD API: a caller submits or requests client data, the controller delegates to a service, and the service uses a JPA repository to persist or retrieve entities. Separate client examples demonstrate manual mapping, ModelMapper, and validation. The tree also contains a pagination example, but its runtime behavior is not shown. Other training directories have no source detail here, so their capabilities and connections are omitted.

Main entry points: [`Training/client/src/main/java/com/client/service/ClientService.java`](https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client/src/main/java/com/client/service/ClientService.java) (Client Service), [`Training/client/src/main/java/com/client/controller/ClientController.java`](https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client/src/main/java/com/client/controller/ClientController.java) (Client Controller), [`Training/client - Validation/src/main/java/com/client/controller/ClientController.java`](https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client%20-%20Validation/src/main/java/com/client/controller/ClientController.java) (Validation Controller), [`Training/client - Validation/src/main/java/com/client/service/ClientServiceImpl.java`](https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client%20-%20Validation/src/main/java/com/client/service/ClientServiceImpl.java) (Validation Service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client_api["Client API"]
  node_client_controller["Client Controller"]
  node_client_dto["Client DTO<br/>[ClientDTO.java]"]
  node_validation_controller["Validation Controller"]
  node_validation_dto["Validation DTO<br/>[ClientDTO.java]"]
  node_mapstruct_controller["MapStruct Controller"]
  node_modelmapper_controller["ModelMapper Controller"]
end

subgraph group_client_logic["Client Logic"]
  node_client_service["Client Service<br/>[ClientService.java]"]
  node_validation_service["Validation Service"]
  node_validation_helper["Client Validation<br/>[ClientHelper.java]"]
  node_mapstruct_service["MapStruct Service<br/>[ClientService.java]"]
  node_modelmapper_service["ModelMapper Service<br/>[ClientService.java]"]
end

subgraph group_client_data["Client Data"]
  node_client_repository["Client Repository"]
  node_client_entity["Client Entity<br/>[ClientEntity.java]"]
  node_validation_repository["Validation Repository"]
  node_validation_entity["Validation Entity<br/>[ClientEntity.java]"]
  node_mapstruct_repository["MapStruct Repository"]
  node_mapstruct_entity["MapStruct Entity<br/>[ClientEntity.java]"]
  node_modelmapper_repository["ModelMapper Repository"]
  node_modelmapper_entity["ModelMapper Entity<br/>[ClientEntity.java]"]
end

subgraph group_pagination["Pagination Example"]
  node_pagination_app["Pagination App"]
  node_pagination_product["Product Entity<br/>[Product.java]"]
  node_pagination_repository["Product Repository"]
end

node_caller(("API Caller"))

node_caller -->|"sends requests"| node_client_controller
node_client_controller -->|"delegates CRUD"| node_client_service
node_client_controller -->|"accepts and returns"| node_client_dto
node_client_service -->|"queries and saves"| node_client_repository
node_client_service -->|"maps records"| node_client_entity
node_client_service -->|"maps responses"| node_client_dto
node_client_repository -->|"stores entities"| node_client_entity
node_caller -->|"sends requests"| node_validation_controller
node_validation_controller -->|"delegates CRUD"| node_validation_service
node_validation_controller -->|"accepts and returns"| node_validation_dto
node_validation_service -.->|"uses validation"| node_validation_helper
node_validation_service -.->|"uses repository"| node_validation_repository
node_validation_repository -->|"stores entities"| node_validation_entity
node_caller -->|"sends requests"| node_mapstruct_controller
node_mapstruct_controller -->|"delegates CRUD"| node_mapstruct_service
node_mapstruct_service -->|"queries and saves"| node_mapstruct_repository
node_mapstruct_service -->|"maps records"| node_mapstruct_entity
node_mapstruct_repository -->|"stores entities"| node_mapstruct_entity
node_caller -->|"sends requests"| node_modelmapper_controller
node_modelmapper_controller -->|"delegates CRUD"| node_modelmapper_service
node_modelmapper_service -->|"queries and saves"| node_modelmapper_repository
node_modelmapper_service -->|"maps records"| node_modelmapper_entity
node_modelmapper_repository -->|"stores entities"| node_modelmapper_entity

click node_client_controller "https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client/src/main/java/com/client/controller/ClientController.java"
click node_client_dto "https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client/src/main/java/com/client/dto/ClientDTO.java"
click node_client_service "https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client/src/main/java/com/client/service/ClientService.java"
click node_validation_controller "https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client%20-%20Validation/src/main/java/com/client/controller/ClientController.java"
click node_validation_service "https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client%20-%20Validation/src/main/java/com/client/service/ClientServiceImpl.java"
click node_validation_helper "https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client%20-%20Validation/src/main/java/com/client/Helper/ClientHelper.java"
click node_validation_dto "https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client%20-%20Validation/src/main/java/com/client/dto/ClientDTO.java"
click node_mapstruct_controller "https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client%20-%20MapStruct/src/main/java/com/client/controller/ClientController.java"
click node_mapstruct_service "https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client%20-%20MapStruct/src/main/java/com/client/service/ClientService.java"
click node_modelmapper_controller "https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client%20-%20ModelMapper/src/main/java/com/client/controller/ClientController.java"
click node_modelmapper_service "https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client%20-%20ModelMapper/src/main/java/com/client/service/ClientService.java"
click node_client_repository "https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client/src/main/java/com/client/repository/ClientRepository.java"
click node_client_entity "https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client/src/main/java/com/client/entity/ClientEntity.java"
click node_validation_repository "https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client%20-%20Validation/src/main/java/com/client/repository/ClientRepository.java"
click node_validation_entity "https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client%20-%20Validation/src/main/java/com/client/entity/ClientEntity.java"
click node_mapstruct_repository "https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client%20-%20MapStruct/src/main/java/com/client/repository/ClientRepository.java"
click node_mapstruct_entity "https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client%20-%20MapStruct/src/main/java/com/client/entity/ClientEntity.java"
click node_modelmapper_repository "https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client%20-%20ModelMapper/src/main/java/com/client/repository/ClientRepository.java"
click node_modelmapper_entity "https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client%20-%20ModelMapper/src/main/java/com/client/entity/ClientEntity.java"
click node_pagination_app "https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/Pagination/src/main/java/com/example/pagination/PaginationApplication.java"
click node_pagination_product "https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/Pagination/src/main/java/com/example/pagination/entity/Product.java"
click node_pagination_repository "https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/Pagination/src/main/java/com/example/pagination/repository/ProductRepository.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_client_controller,node_client_dto,node_validation_controller,node_validation_dto,node_mapstruct_controller,node_modelmapper_controller toneBlue
class node_client_service,node_validation_service,node_validation_helper,node_mapstruct_service,node_modelmapper_service toneAmber
class node_client_repository,node_client_entity,node_validation_repository,node_validation_entity,node_mapstruct_repository,node_mapstruct_entity,node_modelmapper_repository,node_modelmapper_entity,node_caller toneMint
class node_pagination_app,node_pagination_product,node_pagination_repository toneRose
```

## Components

### Client API

- [Client Controller](https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client/src/main/java/com/client/controller/ClientController.java): `Training/client/src/main/java/com/client/controller/ClientController.java`
- [Client DTO](https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client/src/main/java/com/client/dto/ClientDTO.java): `Training/client/src/main/java/com/client/dto/ClientDTO.java`
- [Validation Controller](https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client%20-%20Validation/src/main/java/com/client/controller/ClientController.java): `Training/client - Validation/src/main/java/com/client/controller/ClientController.java`
- [Validation DTO](https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client%20-%20Validation/src/main/java/com/client/dto/ClientDTO.java): `Training/client - Validation/src/main/java/com/client/dto/ClientDTO.java`
- [MapStruct Controller](https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client%20-%20MapStruct/src/main/java/com/client/controller/ClientController.java): `Training/client - MapStruct/src/main/java/com/client/controller/ClientController.java`
- [ModelMapper Controller](https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client%20-%20ModelMapper/src/main/java/com/client/controller/ClientController.java): `Training/client - ModelMapper/src/main/java/com/client/controller/ClientController.java`

### Client Logic

- [Client Service](https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client/src/main/java/com/client/service/ClientService.java): `Training/client/src/main/java/com/client/service/ClientService.java`
- [Validation Service](https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client%20-%20Validation/src/main/java/com/client/service/ClientServiceImpl.java): `Training/client - Validation/src/main/java/com/client/service/ClientServiceImpl.java`
- [Client Validation](https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client%20-%20Validation/src/main/java/com/client/Helper/ClientHelper.java): `Training/client - Validation/src/main/java/com/client/Helper/ClientHelper.java`
- [MapStruct Service](https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client%20-%20MapStruct/src/main/java/com/client/service/ClientService.java): `Training/client - MapStruct/src/main/java/com/client/service/ClientService.java`
- [ModelMapper Service](https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client%20-%20ModelMapper/src/main/java/com/client/service/ClientService.java): `Training/client - ModelMapper/src/main/java/com/client/service/ClientService.java`

### Client Data

- [Client Repository](https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client/src/main/java/com/client/repository/ClientRepository.java): `Training/client/src/main/java/com/client/repository/ClientRepository.java`
- [Client Entity](https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client/src/main/java/com/client/entity/ClientEntity.java): `Training/client/src/main/java/com/client/entity/ClientEntity.java`
- [Validation Repository](https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client%20-%20Validation/src/main/java/com/client/repository/ClientRepository.java): `Training/client - Validation/src/main/java/com/client/repository/ClientRepository.java`
- [Validation Entity](https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client%20-%20Validation/src/main/java/com/client/entity/ClientEntity.java): `Training/client - Validation/src/main/java/com/client/entity/ClientEntity.java`
- [MapStruct Repository](https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client%20-%20MapStruct/src/main/java/com/client/repository/ClientRepository.java): `Training/client - MapStruct/src/main/java/com/client/repository/ClientRepository.java`
- [MapStruct Entity](https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client%20-%20MapStruct/src/main/java/com/client/entity/ClientEntity.java): `Training/client - MapStruct/src/main/java/com/client/entity/ClientEntity.java`
- [ModelMapper Repository](https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client%20-%20ModelMapper/src/main/java/com/client/repository/ClientRepository.java): `Training/client - ModelMapper/src/main/java/com/client/repository/ClientRepository.java`
- [ModelMapper Entity](https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/client%20-%20ModelMapper/src/main/java/com/client/entity/ClientEntity.java): `Training/client - ModelMapper/src/main/java/com/client/entity/ClientEntity.java`

### Pagination Example

- [Pagination App](https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/Pagination/src/main/java/com/example/pagination/PaginationApplication.java): `Training/Pagination/src/main/java/com/example/pagination/PaginationApplication.java`
- [Product Entity](https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/Pagination/src/main/java/com/example/pagination/entity/Product.java): `Training/Pagination/src/main/java/com/example/pagination/entity/Product.java`
- [Product Repository](https://github.com/riddheshrajwadkar/back-end-projects/blob/main/Training/Pagination/src/main/java/com/example/pagination/repository/ProductRepository.java): `Training/Pagination/src/main/java/com/example/pagination/repository/ProductRepository.java`

### Other components

- **API Caller**

## Connections

- API Caller → Client Controller: sends requests (evidence: `Training/client/src/main/java/com/client/controller/ClientController.java`)
- Client Controller → Client Service: delegates CRUD (evidence: `Training/client/src/main/java/com/client/controller/ClientController.java`)
- Client Controller → Client DTO: accepts and returns (evidence: `Training/client/src/main/java/com/client/controller/ClientController.java`)
- Client Service → Client Repository: queries and saves (evidence: `Training/client/src/main/java/com/client/service/ClientService.java`)
- Client Service → Client Entity: maps records (evidence: `Training/client/src/main/java/com/client/service/ClientService.java`)
- Client Service → Client DTO: maps responses (evidence: `Training/client/src/main/java/com/client/service/ClientService.java`)
- Client Repository → Client Entity: stores entities (evidence: `Training/client/src/main/java/com/client/repository/ClientRepository.java`)
- API Caller → Validation Controller: sends requests (evidence: `Training/client - Validation/src/main/java/com/client/controller/ClientController.java`)
- Validation Controller → Validation Service: delegates CRUD (evidence: `Training/client - Validation/src/main/java/com/client/controller/ClientController.java`)
- Validation Controller → Validation DTO: accepts and returns (evidence: `Training/client - Validation/src/main/java/com/client/controller/ClientController.java`)
- Validation Service → Client Validation: uses validation (evidence: `Training/client - Validation/src/main/java/com/client/service/ClientServiceImpl.java`)
- Validation Service → Validation Repository: uses repository
- Validation Repository → Validation Entity: stores entities (evidence: `Training/client - Validation/src/main/java/com/client/repository/ClientRepository.java`)
- API Caller → MapStruct Controller: sends requests (evidence: `Training/client - MapStruct/src/main/java/com/client/controller/ClientController.java`)
- MapStruct Controller → MapStruct Service: delegates CRUD (evidence: `Training/client - MapStruct/src/main/java/com/client/controller/ClientController.java`)
- MapStruct Service → MapStruct Repository: queries and saves (evidence: `Training/client - MapStruct/src/main/java/com/client/service/ClientService.java`)
- MapStruct Service → MapStruct Entity: maps records (evidence: `Training/client - MapStruct/src/main/java/com/client/service/ClientService.java`)
- MapStruct Repository → MapStruct Entity: stores entities (evidence: `Training/client - MapStruct/src/main/java/com/client/repository/ClientRepository.java`)
- API Caller → ModelMapper Controller: sends requests (evidence: `Training/client - ModelMapper/src/main/java/com/client/controller/ClientController.java`)
- ModelMapper Controller → ModelMapper Service: delegates CRUD (evidence: `Training/client - ModelMapper/src/main/java/com/client/controller/ClientController.java`)
- ModelMapper Service → ModelMapper Repository: queries and saves (evidence: `Training/client - ModelMapper/src/main/java/com/client/service/ClientService.java`)
- ModelMapper Service → ModelMapper Entity: maps records (evidence: `Training/client - ModelMapper/src/main/java/com/client/service/ClientService.java`)
- ModelMapper Repository → ModelMapper Entity: stores entities (evidence: `Training/client - ModelMapper/src/main/java/com/client/repository/ClientRepository.java`)
