# hugo-mesquita-dev/projetc architecture

> Architecture diagram of the GitHub repository hugo-mesquita-dev/projetc, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-02-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hugo-mesquita-dev/projetc
- Repository: https://github.com/hugo-mesquita-dev/projetc

## Overview

##### Tipo e propósito do projeto (o que seu diagrama precisa “contar”)
Pelo *file tree* e README, este é um **backend API monolítico em Java (Spring Boot 3.2 / Java 17)** para uma **Loja de Maquiagem**, com dois domínios principais:

- **Produtos**: CRUD + buscas por categoria/marca, controle de estoque, datas de criação/atualização.
- **Compras**: criação/listagem/buscas/cancelamento, com **validação de estoque**, **baixa de estoque** na compra e **reposição** no cancelamento.

Infra/execução:
- **H2 Database em memória** (padrão), com console web.
- **Maven** build.
- **Dockerfile** e **docker-compose.yml** (indicam containerização; mesmo com H2, o compose pode servir para executar a API padronizada).
- **Insomnia collection** para chamadas.

**Mensagem central do diagrama:** uma API REST Spring, organizada em camadas (Controller → Service → Repository → DB), com regras de negócio explícitas na camada Service (estoque e status de compra), e suporte infra (H2 console, CORS, container).

##### Leitura da estrutura (como mapear para componentes no diagrama)
A árvore deixa muito claro um padrão **Layered Architecture** típico do Spring:

- `controller/`
- `ProdutoController.java`
- `CompraController.java`
**Responsabilidade:** expor endpoints REST `/api/produtos` e `/api/compras`, validação básica de request/response, status HTTP.
- `service/`
- `ProdutoService.java`
- `CompraService.java`
**Responsabilidade:** regras de negócio (ex.: validar estoque; diminuir/restaurar estoque; cancelar compra; calcular valor total; definir status; acionar repositórios).
- `repository/`
- `ProdutoRepository.java`
- `CompraRepository.java`
**Responsabilidade:** acesso a dados via Spring Data JPA (queries por marca/categoria/cliente/status etc).
- `model/`
- `Produto.java`
- `Compra.java`
**Responsabilidade:** entidades JPA (tabelas PRODUTOS e COMPRAS); relacionamento Compra → Produto via `produto_id`.
- `dto/`
- `ProdutoDTO.java`
- `CompraDTO.java`
**Responsabilidade:** contratos de entrada/saída (evitar expor entidade diretamente; montar resposta com `produtoNome`, `valorTotal`, etc).
- `resources/application.properties`
**Responsabilidade:** configuração (datasource H2, JPA, CORS, path base `/api`, habilitar console H2 etc).
- Raiz:
- `pom.xml`: dependências (Spring Web, Data JPA, H2, Lombok).
- `Dockerfile`, `docker-compose.yml`: execução em container.
- `dados_exemplo.sql`: seed de dados (se estiver sendo carregado).
- `insomnia_collection.json`: cliente de teste.

No diagrama, isso vira: **um serviço “Loja API”** com sub-blocos internos representando camadas.

##### O que extrair do README para enriquecer o diagrama
Do README, inclua no desenho:

- **Endpoints** (ao menos como rótulos nas setas do “Client → API”):
- `/api/produtos` (CRUD + buscas)
- `/api/compras` (criar, listar, buscar, cancelar)
- **Regras chave** (principalmente no bloco Service):
- “validar se produto existe”
- “validar estoque suficiente”
- “reduzir estoque após compra”
- “restaurar estoque ao cancelar”
- **Banco**: H2 em memória + console `GET /h2-console` (é um ator/componente diferente do cliente normal).
- **CORS habilitado**: sugere consumo por frontend remoto (ainda que não exista frontend no repo).

##### Diagrama A — Contexto/Container (C4 – nível 2)
**Objetivo:** mostrar como o sistema roda e quem fala com quem.

Componentes:
##### Docker (opcional como “execution environment”)

Conexões:
- Client → Loja API: HTTP/JSON (REST) em `:8080`, base `/api`
- Loja API → H2: JDBC (via Hibernate/JPA)
- Admin/Dev → H2 Console: browser → `/h2-console` (passa pela app)

**Detalhe importante:** como H2 é *in-memory*, represente como “ephemeral storage” (dados perdidos ao reiniciar) — isso é arquitetural.

##### Diagrama B — Componentes internos (C4 – nível 3 / diagrama de componentes)
**Objetivo:** explicitar as camadas e o fluxo de uma compra (onde está a lógica crítica).

Dentro do bloco “Loja API”, desenhe:

- **Controllers**
- ProdutoController
- CompraController

- **Services**
- ProdutoService
- CompraService

- **Repositories**
- ProdutoRepository (JPA)
- CompraRepository (JPA)

- **Domain Model**
- Produto (Entity)
- Compra (Entity)

- **DTOs**
- ProdutoDTO
- CompraDTO

- **Framework/Infra adapters**
- Spring MVC (request mapping)
- Spring Data JPA + Hibernate (ORM)
- H2 Driver

Setas principais:
- ProdutoController → ProdutoService → ProdutoRepository → DB
- CompraController → CompraService → (CompraRepository + ProdutoRepository) → DB

**Observação crucial para precisão:** CompraService provavelmente depende de **ProdutoRepository** para:
- buscar o produto por `produtoId`
- debitar/restaurar estoque
e de **CompraRepository** para persistir/alterar compra.

##### Relacionamentos e interações que devem aparecer (fluxos)
Para “capturar o essencial”, coloque pelo menos dois fluxos narrados no diagrama (como notas numeradas):

##### Retorna compra atualizada

Isso diferencia um CRUD trivial de um sistema com regra de estoque.

##### Padrões/decisões arquiteturais a explicitar no desenho
- **Monólito modular por camadas** (não microservices).
- **REST API** com Spring MVC.
- **Persistência via Repository pattern** (Spring Data JPA).
- **DTO boundary** entre API e domínio (contratos de transporte).
- **Regra de negócio** centralizada em Services (estoque, status, total).
- **Banco H2 em memória** (tradeoff: rápido/dev, sem persistência).
- **Containerização** disponível (Dockerfile/compose).

##### Rótulos (labels)
- Nome do componente + responsabilidade curta.
- Tecnologias onde importam:
- “Spring Boot 3.2 / Java 17”
- “Spring MVC”
- “Spring Data JPA (Hibernate)”
- “H2 In-Memory DB”

##### Setas direcionais (dataflow / dependency)
- Use setas **unidirecionais** para dependência (Controller → Service → Repo).
- Use setas com protocolo para comunicação:
- HTTP/JSON, JDBC.

##### Cores/formatos (recomendação prática)
- **Azul**: API layer (Controllers)
- **Roxo**: Business layer (Services)
- **Verde**: Data access (Repositories)
- **Cinza**: Infra/framework (Spring/Hibernate/H2)
- **Amarelo**: External actors (Client, Admin)

Ou use formas:
- Retângulos: componentes
- Cilindro: database
- Documento: DTOs/contratos

##### Como “separar em tantos componentes quanto possível” sem inventar coisas
Você consegue granularidade alta sem especular:
- Componentize por pacote (controller/service/repository/model/dto).
- Separe “Produto” e “Compra” como **bounded contexts internos** (dois módulos lógicos).
- Explicite o “H2 Console” como ator/entrada alternativa.
- Explicite os “Artefatos de execução”:
- Maven build → JAR
- Docker image → Container → Porta 8080

O que **não** desenhar (porque não está no repo/README):
- Filas, cache, auth JWT, gateways, observability stack, etc (a menos que você queira um “future architecture”).

##### Um template textual para você transformar em desenho rapidamente

- **Actor:** API Client (Insomnia / Frontend)
- → **Loja API (Spring Boot)** `:8080`
- **ProdutoController**
- → **ProdutoService**
- → **ProdutoRepository (Spring Data JPA)**
- → **H2 DB**
- **CompraController**
- → **CompraService**
- → **CompraRepository**
- → **H2 DB**
- → **ProdutoRepository**
- → **H2 DB**
- **DTOs:** ProdutoDTO, CompraDTO (between Client and Controllers)
- **Entities:** Produto, Compra (between JPA and DB)
- **Actor:** Dev/Admin Browser
- → `/h2-console` on **Loja API** → **H2 DB**

Se você fizer esses dois diagramas (Contexto/Container + Componentes internos) e incluir os fluxos “Realizar compra” e “Cancelar compra”, você terá uma arquitetura altamente fiel ao projeto e detalhada o suficiente para engenharia principal revisar regras críticas (estoque/status) sem abrir o código.

## Diagram (Mermaid)

```mermaid
flowchart TD
  %% =========================
  %% Diagram A — Context/Container (C4 L2)
  %% =========================
  subgraph A["Diagrama A — Contexto/Container (C4 Nível 2)"]
    direction TB

    Client["API Client\n(Insomnia / Browser / Future Frontend)"]:::external
    Admin["Dev/Admin Browser\n(H2 Console UI)"]:::external

    subgraph Run["Execution & Packaging"]
      direction TB
      Maven["Maven Build\n(JAR packaging)"]:::build
      DockerfileNode["Dockerfile\n(Image definition)"]:::build
      Compose["docker-compose\n(Container runtime)"]:::build
    end

    subgraph Sys["Loja API Container\nSpring Boot 3.2 • Java 17 • Port :8080"]
      direction TB
      AppEntry["Spring Boot Application\n(Entrypoint)"]:::app
      MVC["Spring MVC\n(REST, CORS enabled)"]:::infra
      H2Console["H2 Console Endpoint\nGET /h2-console"]:::infra
      BaseApi["REST Base Path\n/api"]:::infra
    end

    H2["H2 In-Memory Database\n(ephemeral, reset on restart)"]:::db

    Client -->|"HTTP/JSON • :8080 • /api/produtos,/api/compras"| BaseApi
    Admin -->|"Browser • GET /h2-console"| H2Console

    BaseApi -->|"routes via"| MVC
    H2Console -->|"JDBC via app"| H2
    MVC -->|"JDBC (Hibernate/JPA)"| H2

    Maven -->|"builds"| AppEntry
    DockerfileNode -->|"packages JAR into image"| AppEntry
    Compose -->|"runs container"| AppEntry
  end

  %% =========================
  %% Diagram B — Internal Components (C4 L3)
  %% =========================
  subgraph B["Diagrama B — Componentes Internos (C4 Nível 3) — Loja API"]
    direction TB

    subgraph Boundary["API Boundary (DTOs)"]
      direction TB
      ProdutoDTO["ProdutoDTO\n(request/response contract)"]:::dto
      CompraDTO["CompraDTO\n(request/response contract)"]:::dto
    end

    subgraph Controllers["Controllers (Spring MVC)"]
      direction TB
      ControllersPkg["controller/ (package)"]:::pkg
      ProdutoController["ProdutoController\nREST: /api/produtos"]:::controller
      CompraController["CompraController\nREST: /api/compras"]:::controller
    end

    subgraph Services["Services (Business Rules)"]
      direction TB
      ServicesPkg["service/ (package)"]:::pkg
      ProdutoService["ProdutoService\nCRUD + estoque + buscas"]:::service
      CompraService["CompraService\nvalidar/baixar/restaurar estoque\nstatus + valorTotal"]:::service
    end

    subgraph Repos["Repositories (Spring Data JPA)"]
      direction TB
      ReposPkg["repository/ (package)"]:::pkg
      ProdutoRepository["ProdutoRepository\nqueries categoria/marca"]:::repo
      CompraRepository["CompraRepository\nqueries cliente/status"]:::repo
    end

    subgraph Domain["Domain Model (JPA Entities)"]
      direction TB
      ModelPkg["model/ (package)"]:::pkg
      ProdutoEntity["Produto (Entity)\nPRODUTOS • estoque • timestamps"]:::entity
      CompraEntity["Compra (Entity)\nCOMPRAS • produto_id • status"]:::entity
    end

    subgraph Persistence["Persistence/Infra"]
      direction TB
      JPA["Spring Data JPA + Hibernate\n(ORM)"]:::infra
      H2Driver["H2 JDBC Driver"]:::infra
      AppProps["application.properties\n(H2/JPA/CORS/H2-console)"]:::config
      DB2[("H2 In-Memory DB")]:::db
    end

    %% API boundary usage
    ProdutoDTO -->|"maps to/from"| ProdutoController
    CompraDTO -->|"maps to/from"| CompraController

    %% Layered dependencies
    ProdutoController -->|"calls"| ProdutoService
    CompraController -->|"calls"| CompraService

    ProdutoService -->|"uses"| ProdutoRepository
    CompraService -->|"uses"| CompraRepository
    CompraService -->|"uses (stock check/update)"| ProdutoRepository

    %% Repos to entities/ORM/DB
    ProdutoRepository -->|"manages"| ProdutoEntity
    CompraRepository -->|"manages"| CompraEntity

    ProdutoRepository -->|"via"| JPA
    CompraRepository -->|"via"| JPA
    JPA -->|"JDBC"| H2Driver
    H2Driver -->|"connects"| DB2

    AppProps -->|"configures"| JPA
    AppProps -->|"configures"| DB2

    %% Relationship (domain)
    CompraEntity -->|"FK produto_id"| ProdutoEntity

    %% Notes as numbered flows (purchase/cancel)
    Flow1["Fluxo 1 — Realizar compra\n1) POST /api/compras (CompraDTO)\n2) validar produto e estoque\n3) calcular valorTotal\n4) status=CONFIRMADA\n5) reduzir estoque\n6) salvar compra e retornar DTO"]:::note
    Flow2["Fluxo 2 — Cancelar compra\n1) PUT /api/compras/{id}/cancelar\n2) buscar compra\n3) restaurar estoque do produto\n4) status=CANCELADA\n5) persistir e retornar"]:::note

    CompraController -.->|"executes"| Flow1
    CompraController -.->|"executes"| Flow2
    Flow1 -.->|"touches"| CompraService
    Flow2 -.->|"touches"| CompraService
  end

  %% =========================
  %% Click Events (mapped components)
  %% =========================
  click AppEntry "https://github.com/hugo-mesquita-dev/projetc/blob/main/src/main/java/com/java/projetc/ProjetcApplication.java"
  click ControllersPkg "https://github.com/hugo-mesquita-dev/projetc/tree/main/src/main/java/com/java/projetc/controller/"
  click ProdutoController "https://github.com/hugo-mesquita-dev/projetc/blob/main/src/main/java/com/java/projetc/controller/ProdutoController.java"
  click CompraController "https://github.com/hugo-mesquita-dev/projetc/blob/main/src/main/java/com/java/projetc/controller/CompraController.java"
  click ServicesPkg "https://github.com/hugo-mesquita-dev/projetc/tree/main/src/main/java/com/java/projetc/service/"
  click ProdutoService "https://github.com/hugo-mesquita-dev/projetc/blob/main/src/main/java/com/java/projetc/service/ProdutoService.java"
  click CompraService "https://github.com/hugo-mesquita-dev/projetc/blob/main/src/main/java/com/java/projetc/service/CompraService.java"
  click ReposPkg "https://github.com/hugo-mesquita-dev/projetc/tree/main/src/main/java/com/java/projetc/repository/"
  click ProdutoRepository "https://github.com/hugo-mesquita-dev/projetc/blob/main/src/main/java/com/java/projetc/repository/ProdutoRepository.java"
  click CompraRepository "https://github.com/hugo-mesquita-dev/projetc/blob/main/src/main/java/com/java/projetc/repository/CompraRepository.java"
  click ModelPkg "https://github.com/hugo-mesquita-dev/projetc/tree/main/src/main/java/com/java/projetc/model/"
  click ProdutoEntity "https://github.com/hugo-mesquita-dev/projetc/blob/main/src/main/java/com/java/projetc/model/Produto.java"
  click CompraEntity "https://github.com/hugo-mesquita-dev/projetc/blob/main/src/main/java/com/java/projetc/model/Compra.java"
  click ProdutoDTO "https://github.com/hugo-mesquita-dev/projetc/blob/main/src/main/java/com/java/projetc/dto/ProdutoDTO.java"
  click CompraDTO "https://github.com/hugo-mesquita-dev/projetc/blob/main/src/main/java/com/java/projetc/dto/CompraDTO.java"
  click AppProps "https://github.com/hugo-mesquita-dev/projetc/blob/main/src/main/resources/application.properties"
  click Maven "https://github.com/hugo-mesquita-dev/projetc/blob/main/pom.xml"
  click DockerfileNode "https://github.com/hugo-mesquita-dev/projetc/tree/main/Dockerfile"
  click Compose "https://github.com/hugo-mesquita-dev/projetc/blob/main/docker-compose.yml"
  click Client "https://github.com/hugo-mesquita-dev/projetc/blob/main/insomnia_collection.json"

  %% Not directly drawn nodes for click coverage (kept minimal, non-invasive)
  Seed["SQL Seed\n(sample data)"]:::artifact
  Tests["Spring Boot Tests\n(context)"]:::test
  Seed -.->|"optional load"| DB2
  Tests -.->|"verifies"| AppEntry
  click Seed "https://github.com/hugo-mesquita-dev/projetc/blob/main/dados_exemplo.sql"
  click Tests "https://github.com/hugo-mesquita-dev/projetc/blob/main/src/test/java/com/java/projetc/ProjetcApplicationTests.java"

  %% =========================
  %% Styles (colors)
  %% =========================
  classDef external fill:#FFE08A,stroke:#8A6D00,stroke-width:1px,color:#1f1f1f
  classDef app fill:#BFE3FF,stroke:#1B6CA8,stroke-width:1px,color:#0b2239
  classDef controller fill:#7EC8FF,stroke:#0B5FA5,stroke-width:1px,color:#0b2239
  classDef service fill:#D7B7FF,stroke:#6B2FB8,stroke-width:1px,color:#1e1033
  classDef repo fill:#BFF0C2,stroke:#1F7A3A,stroke-width:1px,color:#0b2a14
  classDef entity fill:#C9F7D3,stroke:#1F7A3A,stroke-width:1px,color:#0b2a14
  classDef dto fill:#FFF2B3,stroke:#B08900,stroke-width:1px,color:#3a2b00
  classDef infra fill:#D9D9D9,stroke:#666666,stroke-width:1px,color:#1f1f1f
  classDef db fill:#BDBDBD,stroke:#4F4F4F,stroke-width:1px,color:#1f1f1f
  classDef build fill:#FFD1C2,stroke:#B84A2B,stroke-width:1px,color:#3a140b
  classDef config fill:#E6E6E6,stroke:#6C6C6C,stroke-width:1px,color:#1f1f1f
  classDef note fill:#FFF7CC,stroke:#B59B00,stroke-width:1px,color:#3a2b00
  classDef pkg fill:#EAF4FF,stroke:#5B8DB8,stroke-width:1px,color:#0b2239
  classDef artifact fill:#F3F3F3,stroke:#8A8A8A,stroke-width:1px,color:#1f1f1f
  classDef test fill:#E8F5E9,stroke:#2E7D32,stroke-width:1px,color:#102a12
```
