# jciterceros/vr_online_backend architecture

> Architecture diagram of the GitHub repository jciterceros/vr_online_backend, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-11). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jciterceros/vr_online_backend
- Repository: https://github.com/jciterceros/vr_online_backend

## Overview

##### Project type & purpose
- This is a monolithic Java Spring Boot REST-API backend for an online store (“VR Online”).
- It follows a layered, domain-driven structure with packages per business domain: Endereço, Pessoa, Produtos, Pagamentos, Pedidos, Segurança.

##### High-level architecture
- Clients (Insomnia/Postman/SPA) → HTTP requests → Spring MVC Controllers → Business Services → Spring Data JPA Repositories → Relational DB
- Cross-cutting concerns: Security (BasicAuth filter, WebSecurityConfig, BCrypt), ModelMapper for DTO mapping, exception handlers
- External integration: ViaCep REST API (through an Adapter)

##### Main components
a. API Boundary
- HTTP entry point (Controller classes per domain)
- Security filter chain (CustomBasicAuthenticationFilter, WebSecurityConfig)
b. Domain services
- Service interfaces & implementations per domain; PaymentServiceImpl + factories/strategy objects (IPagamentoProcessar, …)
c. Persistence
d. Domain model
- Entities (Pessoa, Produto, Pagamento, Pedido, Endereco, etc.) and DTOs (request/response objects)
e. External system
- ViaCep REST service via EnderecoViaCepAdapter

##### Interactions & data flow
1. Client → (1) Authentication filter → (2) Controller
2. Controller → calls corresponding Service
3. Service → may use Factory/Strategy (payments) or Adapter (ViaCep) → if data access needed → Repository
4. Repository → Database
5. Service returns DTO → Controller → HTTP Response → Client

##### Architectural patterns & principles
- Layered architecture (Controller → Service → Repository)
- Domain-driven packages isolating business logic
- Factory & Strategy patterns in Pagamentos
- Adapter pattern for external ViaCep integration
- Dependency Injection for loose coupling
- DTOs + ModelMapper for mapping between domain and API models

##### Technologies & frameworks to annotate
- Spring Boot (starter-web, data-jpa, security)
- Spring MVC controllers
- Spring Data JPA (repositories)
- ModelMapper (ModelMapperConfig)
- Spring Security (WebSecurityConfig, CustomBasicAuthenticationFilter, BCryptPasswordEncoderAdapter)
- Maven build (pom.xml)

- Clear component labels (e.g., PedidoVendaController, PedidoVendaService, PedidoVendaRepository)
- Logical grouping by domain boundaries

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Security Layer
    subgraph "Security"
        direction TB
        SEC_FILTER["CustomBasicAuthenticationFilter"]:::security
        SEC_CONFIG["WebSecurityConfig"]:::security
    end

    %% API Boundary - Controllers
    subgraph "API Boundary"
        direction TB
        subgraph "Endereço (Controllers)"
            direction TB
            END_CTR["EnderecoController"]:::controller
        end
        subgraph "Pessoa (Controllers)"
            direction TB
            PESS_CTR["PessoaController"]:::controller
        end
        subgraph "Produtos (Controllers)"
            direction TB
            PROD_CTR["ProdutoController"]:::controller
        end
        subgraph "Pagamentos (Controllers)"
            direction TB
            PAG_CTR["PagamentoController"]:::controller
        end
        subgraph "Pedidos (Controllers)"
            direction TB
            PED_CTR["PedidoVendaController"]:::controller
        end
    end

    %% Services
    subgraph "Domain Services"
        direction TB
        subgraph "Endereço"
            direction TB
            END_SVC_INT["EnderecoService"]:::service
            END_SVC_IMPL["EnderecoServiceImpl"]:::service
        end
        subgraph "Pessoa"
            direction TB
            PESS_SVC_INT["PessoaService"]:::service
            PESS_SVC_IMPL["PessoaServiceImpl"]:::service
            PESS_FACTORY["PessoaFactoryImpl"]:::service
        end
        subgraph "Produtos"
            direction TB
            PROD_SVC_INT["ProdutoService"]:::service
            PROD_SVC_IMPL["ProdutoServiceImpl"]:::service
        end
        subgraph "Pagamentos"
            direction TB
            PAG_SVC_IMPL["PagamentoServiceImpl"]:::service
            PAG_FACTORY["PagamentoProcessarFactory"]:::service
            PAG_STRAT["IPagamentoProcessar"]:::service
        end
        subgraph "Pedidos"
            direction TB
            PED_SVC_INT["PedidoVendaService"]:::service
            PED_SVC_IMPL["PedidoVendaServiceImpl"]:::service
        end
    end

    %% Persistence - Repositories
    subgraph "Repositories"
        direction TB
        subgraph "Endereço"
            direction TB
            END_REPO["EnderecoRepository"]:::repo
        end
        subgraph "Pessoa"
            direction TB
            PESS_REPO["PessoaRepository"]:::repo
        end
        subgraph "Produtos"
            direction TB
            PROD_REPO["ProdutoRepository"]:::repo
        end
        subgraph "Pagamentos"
            direction TB
            PAG_REPO["PagamentoRepository"]:::repo
        end
        subgraph "Pedidos"
            direction TB
            PED_REPO["PedidoVendaRepository"]:::repo
        end
    end

    %% External Adapter
    EXTERNAL["EnderecoViaCepAdapter"]:::external

    %% Database
    DB[(Relational Database)]:::database

    %% DTOs and Config
    DTO["DTOs"]:::dto
    MODEL_MAPPER["ModelMapperConfig"]:::config

    %% Flows
    SEC_FILTER -->|"passes auth"| END_CTR
    SEC_FILTER -->|"passes auth"| PESS_CTR
    SEC_FILTER -->|"passes auth"| PROD_CTR
    SEC_FILTER -->|"passes auth"| PAG_CTR
    SEC_FILTER -->|"passes auth"| PED_CTR
    SEC_CONFIG --> SEC_FILTER

    END_CTR -->|"calls Service"| END_SVC_INT
    PESS_CTR -->|"calls Service"| PESS_SVC_INT
    PROD_CTR -->|"calls Service"| PROD_SVC_INT
    PAG_CTR -->|"calls Service"| PAG_SVC_IMPL
    PED_CTR -->|"calls Service"| PED_SVC_INT

    END_SVC_IMPL -->|"uses Repository"| END_REPO
    PESS_SVC_IMPL -->|"uses Repository"| PESS_REPO
    PROD_SVC_IMPL -->|"uses Repository"| PROD_REPO
    PAG_SVC_IMPL -->|"factory ->"| PAG_FACTORY
    PAG_FACTORY -->|"strategy ->"| PAG_STRAT
    PAG_SVC_IMPL -->|"uses Repository"| PAG_REPO
    PED_SVC_IMPL -->|"uses Repository"| PED_REPO

    END_SVC_IMPL -->|"adapter call HTTP client"| EXTERNAL
    EXTERNAL -->|"REST/JSON"| DB

    END_REPO -->|"JPA"| DB
    PESS_REPO -->|"JPA"| DB
    PROD_REPO -->|"JPA"| DB
    PAG_REPO -->|"JPA"| DB
    PED_REPO -->|"JPA"| DB

    END_SVC_IMPL -->|"returns DTO"| DTO
    PESS_SVC_IMPL -->|"returns DTO"| DTO
    PROD_SVC_IMPL -->|"returns DTO"| DTO
    PAG_SVC_IMPL -->|"returns DTO"| DTO
    PED_SVC_IMPL -->|"returns DTO"| DTO

    DTO -->|"mapped by"| MODEL_MAPPER
    MODEL_MAPPER --> END_CTR
    MODEL_MAPPER --> PESS_CTR
    MODEL_MAPPER --> PROD_CTR
    MODEL_MAPPER --> PAG_CTR
    MODEL_MAPPER --> PED_CTR

    %% Click Events
    click END_CTR "https://github.com/jciterceros/vr_online_backend/blob/main/src/main/java/com/jciterceros/vr_online_backend/domain/endereco/controllers/*.java"
    click PESS_CTR "https://github.com/jciterceros/vr_online_backend/blob/main/src/main/java/com/jciterceros/vr_online_backend/domain/pessoa/controllers/*.java"
    click PROD_CTR "https://github.com/jciterceros/vr_online_backend/blob/main/src/main/java/com/jciterceros/vr_online_backend/domain/produtos/controllers/*.java"
    click PAG_CTR "https://github.com/jciterceros/vr_online_backend/blob/main/src/main/java/com/jciterceros/vr_online_backend/domain/pagamentos/controllers/PagamentoController.java"
    click PED_CTR "https://github.com/jciterceros/vr_online_backend/blob/main/src/main/java/com/jciterceros/vr_online_backend/domain/pedidos/controllers/*.java"

    click SEC_FILTER "https://github.com/jciterceros/vr_online_backend/blob/main/src/main/java/com/jciterceros/vr_online_backend/domain/security/filters/CustomBasicAuthenticationFilter.java"
    click SEC_CONFIG "https://github.com/jciterceros/vr_online_backend/blob/main/src/main/java/com/jciterceros/vr_online_backend/domain/security/config/WebSecurityConfig.java"

    click END_SVC_INT "https://github.com/jciterceros/vr_online_backend/blob/main/src/main/java/com/jciterceros/vr_online_backend/domain/endereco/services/EnderecoService.java"
    click END_SVC_IMPL "https://github.com/jciterceros/vr_online_backend/blob/main/src/main/java/com/jciterceros/vr_online_backend/domain/endereco/services/EnderecoServiceImpl.java"
    click PESS_SVC_INT "https://github.com/jciterceros/vr_online_backend/blob/main/src/main/java/com/jciterceros/vr_online_backend/domain/pessoa/services/PessoaService.java"
    click PESS_SVC_IMPL "https://github.com/jciterceros/vr_online_backend/blob/main/src/main/java/com/jciterceros/vr_online_backend/domain/pessoa/services/PessoaServiceImpl.java"
    click PESS_FACTORY "https://github.com/jciterceros/vr_online_backend/blob/main/src/main/java/com/jciterceros/vr_online_backend/domain/pessoa/services/PessoaFactoryImpl.java"
    click PROD_SVC_INT "https://github.com/jciterceros/vr_online_backend/blob/main/src/main/java/com/jciterceros/vr_online_backend/domain/produtos/services/ProdutoService.java"
    click PROD_SVC_IMPL "https://github.com/jciterceros/vr_online_backend/blob/main/src/main/java/com/jciterceros/vr_online_backend/domain/produtos/services/ProdutoServiceImpl.java"
    click PAG_SVC_IMPL "https://github.com/jciterceros/vr_online_backend/blob/main/src/main/java/com/jciterceros/vr_online_backend/domain/pagamentos/services/implementations/PagamentoServiceImpl.java"
    click PAG_FACTORY "https://github.com/jciterceros/vr_online_backend/blob/main/src/main/java/com/jciterceros/vr_online_backend/domain/pagamentos/factories/PagamentoProcessarFactory.java"
    click PAG_STRAT "https://github.com/jciterceros/vr_online_backend/blob/main/src/main/java/com/jciterceros/vr_online_backend/domain/pagamentos/models/interfaces/IPagamentoProcessar.java"
    click PED_SVC_INT "https://github.com/jciterceros/vr_online_backend/blob/main/src/main/java/com/jciterceros/vr_online_backend/domain/pedidos/services/PedidoVendaService.java"
    click PED_SVC_IMPL "https://github.com/jciterceros/vr_online_backend/blob/main/src/main/java/com/jciterceros/vr_online_backend/domain/pedidos/services/PedidoVendaServiceImpl.java"

    click END_REPO "https://github.com/jciterceros/vr_online_backend/blob/main/src/main/java/com/jciterceros/vr_online_backend/domain/endereco/repositories/*.java"
    click PESS_REPO "https://github.com/jciterceros/vr_online_backend/blob/main/src/main/java/com/jciterceros/vr_online_backend/domain/pessoa/repositories/*.java"
    click PROD_REPO "https://github.com/jciterceros/vr_online_backend/blob/main/src/main/java/com/jciterceros/vr_online_backend/domain/produtos/repositories/*.java"
    click PAG_REPO "https://github.com/jciterceros/vr_online_backend/blob/main/src/main/java/com/jciterceros/vr_online_backend/domain/pagamentos/repositories/PagamentoRepository.java"
    click PED_REPO "https://github.com/jciterceros/vr_online_backend/blob/main/src/main/java/com/jciterceros/vr_online_backend/domain/pedidos/repositories/*.java"

    click EXTERNAL "https://github.com/jciterceros/vr_online_backend/blob/main/src/main/java/com/jciterceros/vr_online_backend/domain/endereco/adapters/EnderecoViaCepAdapter.java"

    click DTO "https://github.com/jciterceros/vr_online_backend/blob/main/src/main/java/com/jciterceros/vr_online_backend/domain/dto/**/*.java"
    click MODEL_MAPPER "https://github.com/jciterceros/vr_online_backend/blob/main/src/main/java/com/jciterceros/vr_online_backend/domain/config/ModelMapperConfig.java"

    %% Styles
    classDef controller fill:#d0e1f9,stroke:#0366d6,stroke-width:1px
    classDef service fill:#d3f9d8,stroke:#28a745,stroke-width:1px
    classDef repo fill:#ffe5b4,stroke:#d2691e,stroke-width:1px
    classDef database fill:#f0f0f0,stroke:#636363,stroke-width:1px
    classDef external fill:#e2e2f0,stroke:#6a5acd,stroke-width:1px,stroke-dasharray: 5 5
    classDef security fill:#f3e5f5,stroke:#8e44ad,stroke-width:1px
    classDef dto fill:#fafad2,stroke:#b3b300,stroke-width:1px
    classDef config fill:#e0f7fa,stroke:#006064,stroke-width:1px
```
