# joaomiz/pedido_cliente_produto_desafio architecture

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

- Interactive diagram: https://gitdiagram.com/joaomiz/pedido_cliente_produto_desafio
- Repository: https://github.com/joaomiz/pedido_cliente_produto_desafio

## Overview

This repository is a small layered Spring Boot application organized around three business domains: Cliente, Produto, and Pedido.

Architecture style
- It follows a classic three-tier / layered structure:
  - Presentation layer: controller classes
  - Business layer: service classes
  - Persistence layer: repository interfaces
  - Domain layer: model classes
- The application entry point is `DesafioApplication.java`, which boots the Spring container and wires the layers together through dependency injection.

Main subsystems

1. Presentation / API layer
- `ClienteController`
- `ProdutoController`
- `PedidoController`

These classes are the external entry points for the application. They expose the domain operations for each entity and receive incoming requests, then delegate to the corresponding service.
- Each controller maps to one business area.
- This layer should be the only one directly exposed to clients.
- It does not appear to contain business logic itself; its role is orchestration and request/response handling.

2. Business / application logic layer
- `ClienteService`
- `ProdutoService`
- `PedidoService`

These services sit between controllers and repositories.
- They encapsulate domain rules, validation, and workflow orchestration.
- They coordinate reads and writes across repositories.
- `PedidoService` is likely the most important cross-domain service because orders usually depend on both client and product data.

3. Persistence layer
- `ClienteRepository`
- `ProdutoRepository`
- `PedidoRepository`

These repositories provide data access for the domain entities.
- In a Spring Boot project like this, they are typically Spring Data repositories.
- They abstract the database interaction away from services.
- The service layer depends on these interfaces, not on storage details.

4. Domain / model layer
- `Cliente`
- `Produto`
- `Pedido`

These classes represent the core business entities.
- They are likely mapped to database tables and used in request/response payloads or persistence operations.
- `Pedido` likely represents a relationship between a client and one or more products, although the exact cardinality is not visible from the file tree alone.

Data flow
A typical request flows through the application like this:
- A client calls one of the controllers.
- The controller delegates to the corresponding service.
- The service applies business rules and uses one or more repositories.
- The repository reads from or writes to the persistence store.
- The result flows back up through service to controller and then to the caller.

For `Pedido`, the flow may involve more than one repository:
- `PedidoService` may need to validate a `Cliente`
- it may also need to retrieve `Produto` data before persisting the order
- this makes the order subsystem a coordination point across the other two domains

Important boundaries
- Controllers are the boundary between external callers and internal application logic.
- Services are the boundary between request handling and persistence.
- Repositories are the boundary between application code and the database.
- Models are shared internal domain objects, but they should remain separate from transport concerns where possible.

Project/runtime characteristics
- The project is a Java application built with Maven.
- It uses the Maven wrapper (`mvnw`, `.mvn/`) so the build can run without a preinstalled Maven version.
- `application.properties` indicates runtime configuration is externalized, most likely for Spring Boot settings such as server and database configuration.
- `src/test/java/.../DesafioApplicationTests.java` shows that the project includes at least a basic Spring Boot test harness.

What an architecture diagram should show
- One application boundary labeled as the Spring Boot service.
- Inside it, three vertical layers:
  - Controllers at the top
  - Services in the middle
  - Repositories at the bottom
- Shared domain models alongside the service/repository layers.
- Three main business areas:
  - Cliente
  - Produto
  - Pedido
- Arrows from each controller to its service, from each service to its repository, and from repositories to the underlying database.
- A special note that Pedido likely coordinates Cliente and Produto data, making it the main integration flow among the domains.

In short, this is a conventional Spring Boot CRUD-style backend with clear separation of concerns and a domain split around clients, products, and orders.

Main entry points: [`src/main/java/xped/desafio/DesafioApplication.java`](https://github.com/joaomiz/pedido_cliente_produto_desafio/blob/HEAD/src/main/java/xped/desafio/DesafioApplication.java) (DesafioApplication), [`src/main/java/xped/desafio/service/PedidoService.java`](https://github.com/joaomiz/pedido_cliente_produto_desafio/blob/HEAD/src/main/java/xped/desafio/service/PedidoService.java) (PedidoService), [`src/main/java/xped/desafio/service/ClienteService.java`](https://github.com/joaomiz/pedido_cliente_produto_desafio/blob/HEAD/src/main/java/xped/desafio/service/ClienteService.java) (ClienteService), [`src/main/java/xped/desafio/service/ProdutoService.java`](https://github.com/joaomiz/pedido_cliente_produto_desafio/blob/HEAD/src/main/java/xped/desafio/service/ProdutoService.java) (ProdutoService)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph "Spring Boot Service"
  desafio_application(("DesafioApplication<br/>bootstraps app"))
end

subgraph "Presentation"
  cliente_controller["ClienteController<br/>api controller"]
  produto_controller["ProdutoController<br/>api controller"]
  pedido_controller["PedidoController<br/>api controller"]
end

subgraph "Business"
  cliente_service["ClienteService<br/>business service"]
  produto_service["ProdutoService<br/>business service"]
  pedido_service["PedidoService<br/>orchestration service<br/>[PedidoService.java]"]
end

subgraph "Persistence"
  cliente_repository[("ClienteRepository<br/>data repository")]
  produto_repository[("ProdutoRepository<br/>data repository")]
  pedido_repository[("PedidoRepository<br/>data repository")]
end

subgraph "Domain"
  cliente_model["Cliente<br/>domain model<br/>[Cliente.java]"]
  produto_model["Produto<br/>domain model<br/>[Produto.java]"]
  pedido_model["Pedido<br/>domain model<br/>[Pedido.java]"]
end

subgraph "Database"
  database[("Database<br/>persistence store")]
end

desafio_application -->|"wires"| cliente_controller
desafio_application -->|"wires"| produto_controller
desafio_application -->|"wires"| pedido_controller
desafio_application -->|"wires"| cliente_service
desafio_application -->|"wires"| produto_service
desafio_application -->|"wires"| pedido_service
cliente_controller -->|"delegates"| cliente_service
produto_controller -->|"delegates"| produto_service
pedido_controller -->|"delegates"| pedido_service
cliente_service -->|"uses"| cliente_repository
produto_service -->|"uses"| produto_repository
pedido_service -->|"uses"| pedido_repository
pedido_service -.->|"validates cliente"| cliente_repository
pedido_service -.->|"loads produto"| produto_repository
cliente_repository -->|"stores"| database
produto_repository -->|"stores"| database
pedido_repository -->|"stores"| database
cliente_service -->|"operates on"| cliente_model
produto_service -->|"operates on"| produto_model
pedido_service -->|"operates on"| pedido_model
cliente_repository -->|"maps"| cliente_model
produto_repository -->|"maps"| produto_model
pedido_repository -->|"maps"| pedido_model

click desafio_application "https://github.com/joaomiz/pedido_cliente_produto_desafio/blob/main/src/main/java/xped/desafio/DesafioApplication.java"
click cliente_controller "https://github.com/joaomiz/pedido_cliente_produto_desafio/blob/main/src/main/java/xped/desafio/controller/ClienteController.java"
click produto_controller "https://github.com/joaomiz/pedido_cliente_produto_desafio/blob/main/src/main/java/xped/desafio/controller/ProdutoController.java"
click pedido_controller "https://github.com/joaomiz/pedido_cliente_produto_desafio/blob/main/src/main/java/xped/desafio/controller/PedidoController.java"
click cliente_service "https://github.com/joaomiz/pedido_cliente_produto_desafio/blob/main/src/main/java/xped/desafio/service/ClienteService.java"
click produto_service "https://github.com/joaomiz/pedido_cliente_produto_desafio/blob/main/src/main/java/xped/desafio/service/ProdutoService.java"
click pedido_service "https://github.com/joaomiz/pedido_cliente_produto_desafio/blob/main/src/main/java/xped/desafio/service/PedidoService.java"
click cliente_repository "https://github.com/joaomiz/pedido_cliente_produto_desafio/blob/main/src/main/java/xped/desafio/repository/ClienteRepository.java"
click produto_repository "https://github.com/joaomiz/pedido_cliente_produto_desafio/blob/main/src/main/java/xped/desafio/repository/ProdutoRepository.java"
click pedido_repository "https://github.com/joaomiz/pedido_cliente_produto_desafio/blob/main/src/main/java/xped/desafio/repository/PedidoRepository.java"
click cliente_model "https://github.com/joaomiz/pedido_cliente_produto_desafio/blob/main/src/main/java/xped/desafio/model/Cliente.java"
click produto_model "https://github.com/joaomiz/pedido_cliente_produto_desafio/blob/main/src/main/java/xped/desafio/model/Produto.java"
click pedido_model "https://github.com/joaomiz/pedido_cliente_produto_desafio/blob/main/src/main/java/xped/desafio/model/Pedido.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 desafio_application toneBlue
class cliente_controller,produto_controller,pedido_controller toneAmber
class cliente_service,produto_service,pedido_service toneMint
class cliente_repository,produto_repository,pedido_repository toneRose
class cliente_model,produto_model,pedido_model toneIndigo
class database toneTeal
```

## Components

### Spring Boot Service

Application boundary and startup wiring

- [DesafioApplication](https://github.com/joaomiz/pedido_cliente_produto_desafio/blob/HEAD/src/main/java/xped/desafio/DesafioApplication.java): bootstraps app · Spring Boot entry point and container startup · `src/main/java/xped/desafio/DesafioApplication.java`

### Presentation

External API controllers

- [ClienteController](https://github.com/joaomiz/pedido_cliente_produto_desafio/blob/HEAD/src/main/java/xped/desafio/controller/ClienteController.java): api controller · Cliente API entry point · `src/main/java/xped/desafio/controller/ClienteController.java`
- [ProdutoController](https://github.com/joaomiz/pedido_cliente_produto_desafio/blob/HEAD/src/main/java/xped/desafio/controller/ProdutoController.java): api controller · Produto API entry point · `src/main/java/xped/desafio/controller/ProdutoController.java`
- [PedidoController](https://github.com/joaomiz/pedido_cliente_produto_desafio/blob/HEAD/src/main/java/xped/desafio/controller/PedidoController.java): api controller · Pedido API entry point · `src/main/java/xped/desafio/controller/PedidoController.java`

### Business

Application services and orchestration

- [ClienteService](https://github.com/joaomiz/pedido_cliente_produto_desafio/blob/HEAD/src/main/java/xped/desafio/service/ClienteService.java): business service · Cliente rules and workflow · `src/main/java/xped/desafio/service/ClienteService.java`
- [ProdutoService](https://github.com/joaomiz/pedido_cliente_produto_desafio/blob/HEAD/src/main/java/xped/desafio/service/ProdutoService.java): business service · Produto rules and workflow · `src/main/java/xped/desafio/service/ProdutoService.java`
- [PedidoService](https://github.com/joaomiz/pedido_cliente_produto_desafio/blob/HEAD/src/main/java/xped/desafio/service/PedidoService.java): orchestration service · Coordinates order logic across domains · `src/main/java/xped/desafio/service/PedidoService.java`

### Persistence

Repositories and storage access

- [ClienteRepository](https://github.com/joaomiz/pedido_cliente_produto_desafio/blob/HEAD/src/main/java/xped/desafio/repository/ClienteRepository.java): data repository · Cliente persistence boundary · `src/main/java/xped/desafio/repository/ClienteRepository.java`
- [ProdutoRepository](https://github.com/joaomiz/pedido_cliente_produto_desafio/blob/HEAD/src/main/java/xped/desafio/repository/ProdutoRepository.java): data repository · Produto persistence boundary · `src/main/java/xped/desafio/repository/ProdutoRepository.java`
- [PedidoRepository](https://github.com/joaomiz/pedido_cliente_produto_desafio/blob/HEAD/src/main/java/xped/desafio/repository/PedidoRepository.java): data repository · Pedido persistence boundary · `src/main/java/xped/desafio/repository/PedidoRepository.java`

### Domain

Core business entities

- [Cliente](https://github.com/joaomiz/pedido_cliente_produto_desafio/blob/HEAD/src/main/java/xped/desafio/model/Cliente.java): domain model · Cliente entity · `src/main/java/xped/desafio/model/Cliente.java`
- [Produto](https://github.com/joaomiz/pedido_cliente_produto_desafio/blob/HEAD/src/main/java/xped/desafio/model/Produto.java): domain model · Produto entity · `src/main/java/xped/desafio/model/Produto.java`
- [Pedido](https://github.com/joaomiz/pedido_cliente_produto_desafio/blob/HEAD/src/main/java/xped/desafio/model/Pedido.java): domain model · Pedido entity · `src/main/java/xped/desafio/model/Pedido.java`

### Database

Underlying persistence store

- **Database**: persistence store · External data store behind repositories

## Connections

- DesafioApplication → ClienteController: wires · Bootstraps controller layer
- DesafioApplication → ProdutoController: wires · Bootstraps controller layer
- DesafioApplication → PedidoController: wires · Bootstraps controller layer
- DesafioApplication → ClienteService: wires · Bootstraps service layer
- DesafioApplication → ProdutoService: wires · Bootstraps service layer
- DesafioApplication → PedidoService: wires · Bootstraps service layer
- ClienteController → ClienteService: delegates · Request handling passes to business logic
- ProdutoController → ProdutoService: delegates · Request handling passes to business logic
- PedidoController → PedidoService: delegates · Request handling passes to business logic
- ClienteService → ClienteRepository: uses · Reads and writes cliente data
- ProdutoService → ProdutoRepository: uses · Reads and writes produto data
- PedidoService → PedidoRepository: uses · Persists pedidos
- PedidoService → ClienteRepository: validates cliente · Pedido coordination depends on cliente data
- PedidoService → ProdutoRepository: loads produto · Pedido coordination depends on produto data
- ClienteRepository → Database: stores · Persistence access to database
- ProdutoRepository → Database: stores · Persistence access to database
- PedidoRepository → Database: stores · Persistence access to database
- ClienteService → Cliente: operates on · Business logic around cliente entity
- ProdutoService → Produto: operates on · Business logic around produto entity
- PedidoService → Pedido: operates on · Business logic around pedido entity
- ClienteRepository → Cliente: maps · Persists cliente entity
- ProdutoRepository → Produto: maps · Persists produto entity
- PedidoRepository → Pedido: maps · Persists pedido entity
