# axelvega483/concesionaria architecture

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

- Interactive diagram: https://gitdiagram.com/axelvega483/concesionaria
- Repository: https://github.com/axelvega483/concesionaria

## Overview

##### Project type and purpose
- This is a Spring Boot–based backend REST API for managing a car dealership (“concesionaria”).
- It exposes endpoints for vehicles, clients, users (employees), sales, payments, and enforces JWT security.

##### File structure
- Top‐level: pom.xml, application entry point (ConcecionariaApplication).
- Config: WebConfig, SecurityConfig, JWT filter/utility under Security.
- Controller layer: REST controllers under controller/*.
- Service layer: business logic under service/*.
- Repository layer: Spring Data interfaces under repository/*.
- Entity model under entity/*.
- DTOs + Mappers under DTOs/* for input/output shaping.
- Utility classes under util/*.
- application.properties for DB + JWT settings.

##### README for additional insights
- Confirms Java 17, Spring Web, Spring Data JPA, MySQL/PostgreSQL, JWT auth, modular design, DTO‐based responses.
- Functional requirements: CRUD on vehicles/clients/users, sales/payments workflow with state transitions.

- Clients (Web/Mobile UI or API consumers)
- API Gateway / Load Balancer (optional)
- Authentication & Authorization (JWT filter + SecurityConfig)
- REST Controllers (VehicleController, ClienteController, etc.)
- Service Layer (e.g., VehiculoService, ClienteService…)
- Repository Layer (Spring Data JPA Repositories)
- RDBMS (MySQL/PostgreSQL tables: VEHICULO, CLIENTE, USUARIO, VENTA, PAGOS, DETALLE_VENTA, IMAGEN)
- DTO/Mapper modules (transform entities to API models)
1. Client → HTTP Request → Security Filter (JwtRequestFilter)
2. Security → Controller → Service → Repository → Database
3. Repository → Service → DTO Mapper → Controller → HTTP Response → Client
c. Architectural patterns & principles:
- Layered (Presentation → Business → Data)
- DTO pattern for decoupling API schema from internal model
- Spring Data repository abstraction (DAO)
- SOLID: single‐responsibility controllers/services, open for extension via modular packages
- JWT‐based stateless authentication
d. Key technologies:
- Java 17, Spring Boot, Spring Web MVC, Spring Security (JWT), Spring Data JPA, Hibernate, Lombok, MySQL/PostgreSQL, Maven

##### Detailed capture of essential elements
- Service classes under “Business Services”
- Repository interfaces under “Data Repositories”
- A “DTO Mapper” sub-layer between services and controllers
- Render the JWT flow: LoginController → JwtUtil → token → filter → SecurityContext

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Presentation Layer
    subgraph "Presentation Layer"
        direction TB
        Client["Client (Web/Mobile UI)"]:::apiLayer
        APIGW["API Gateway / Load Balancer"]:::apiLayer
        JwtFilter["JwtRequestFilter"]:::security
        SecurityConfig["SecurityConfig"]:::security
        Client -->|HTTP Request| APIGW
        APIGW -->|forward| JwtFilter
        JwtFilter -->|authenticate & authorize| SecurityConfig
        SecurityConfig -->|filter chain| JwtFilter
    end

    %% Controllers
    subgraph "REST Controllers" 
        direction TB
        ClienteController["ClienteController"]:::apiLayer
        VehiculoController["VehiculoController"]:::apiLayer
        UsuarioController["UsuarioController"]:::apiLayer
        VentaController["VentaController"]:::apiLayer
        PagosController["PagosController"]:::apiLayer
    end

    JwtFilter -->|proceed| ClienteController
    JwtFilter -->|proceed| VehiculoController
    JwtFilter -->|proceed| UsuarioController
    JwtFilter -->|proceed| VentaController
    JwtFilter -->|proceed| PagosController

    %% Business Layer
    subgraph "Business Services & DTO Mappers"
        direction TB
        DTOMapper["DTO Mappers"]:::dto
        ClienteService["ClienteService"]:::business
        VehiculoService["VehiculoService"]:::business
        UsuarioService["UsuarioService"]:::business
        VentaService["VentaService"]:::business
        PagosService["PagosService"]:::business
        DetalleVentaService["DetalleVentaService"]:::business
        ImagenService["ImagenService"]:::business
    end

    %% Data Layer
    subgraph "Data Repositories & Database"
        direction TB
        ClienteRepo["ClienteRepository"]:::data
        VehiculoRepo["VehiculoRepository"]:::data
        UsuarioRepo["UsuarioRepository"]:::data
        VentaRepo["VentaRepository"]:::data
        PagosRepo["PagosRepository"]:::data
        DetalleVentaRepo["DetalleVentaRepository"]:::data
        ImagenRepo["ImagenRepository"]:::data
        Database[(Database<br/>VEHICULO,<br/>CLIENTE,<br/>USUARIO,<br/>VENTA,<br/>PAGOS,<br/>DETALLE_VENTA,<br/>IMAGEN)]:::database
    end

    %% Flow between layers
    ClienteController -->|calls| ClienteService
    VehiculoController -->|calls| VehiculoService
    UsuarioController -->|calls| UsuarioService
    VentaController -->|calls| VentaService
    PagosController -->|calls| PagosService

    ClienteService -->|uses| ClienteRepo
    VehiculoService -->|uses| VehiculoRepo
    UsuarioService -->|uses| UsuarioRepo
    VentaService -->|uses| VentaRepo
    PagosService -->|uses| PagosRepo
    DetalleVentaService -->|uses| DetalleVentaRepo
    ImagenService -->|uses| ImagenRepo

    ClienteRepo -->|CRUD| Database
    VehiculoRepo -->|CRUD| Database
    UsuarioRepo -->|CRUD| Database
    VentaRepo -->|CRUD| Database
    PagosRepo -->|CRUD| Database
    DetalleVentaRepo -->|CRUD| Database
    ImagenRepo -->|CRUD| Database

    %% DTO mapping for responses
    ClienteService -->|returns Entities| DTOMapper
    VehiculoService -->|returns Entities| DTOMapper
    UsuarioService -->|returns Entities| DTOMapper
    VentaService -->|returns Entities| DTOMapper
    PagosService -->|returns Entities| DTOMapper
    DTOMapper -->|mapped DTOs| ClienteController
    DTOMapper -->|mapped DTOs| VehiculoController
    DTOMapper -->|mapped DTOs| UsuarioController
    DTOMapper -->|mapped DTOs| VentaController
    DTOMapper -->|mapped DTOs| PagosController

    %% Click Events
    click ConcecionariaApplication "https://github.com/axelvega483/concesionaria/blob/master/src/main/java/com/proyecto/concecionaria/ConcecionariaApplication.java"
    click WebConfig "https://github.com/axelvega483/concesionaria/blob/master/src/main/java/com/proyecto/concecionaria/Config/WebConfig.java"
    click SecurityConfig "https://github.com/axelvega483/concesionaria/blob/master/src/main/java/com/proyecto/concecionaria/Config/SecurityConfig.java"
    click JwtFilter "https://github.com/axelvega483/concesionaria/blob/master/src/main/java/com/proyecto/concecionaria/Security/JwtRequestFilter.java"
    click JwtUtil "https://github.com/axelvega483/concesionaria/blob/master/src/main/java/com/proyecto/concecionaria/Security/JwtUtil.java"
    click ClienteController "https://github.com/axelvega483/concesionaria/blob/master/src/main/java/com/proyecto/concecionaria/controller/ClienteController.java"
    click VehiculoController "https://github.com/axelvega483/concesionaria/blob/master/src/main/java/com/proyecto/concecionaria/controller/VehiculoController.java"
    click UsuarioController "https://github.com/axelvega483/concesionaria/blob/master/src/main/java/com/proyecto/concecionaria/controller/UsuarioController.java"
    click VentaController "https://github.com/axelvega483/concesionaria/blob/master/src/main/java/com/proyecto/concecionaria/controller/VentaController.java"
    click PagosController "https://github.com/axelvega483/concesionaria/blob/master/src/main/java/com/proyecto/concecionaria/controller/PagosController.java"
    click ClienteService "https://github.com/axelvega483/concesionaria/blob/master/src/main/java/com/proyecto/concecionaria/service/ClienteService.java"
    click VehiculoService "https://github.com/axelvega483/concesionaria/blob/master/src/main/java/com/proyecto/concecionaria/service/VehiculoService.java"
    click UsuarioService "https://github.com/axelvega483/concesionaria/blob/master/src/main/java/com/proyecto/concecionaria/service/UsuarioService.java"
    click VentaService "https://github.com/axelvega483/concesionaria/blob/master/src/main/java/com/proyecto/concecionaria/service/VentaService.java"
    click PagosService "https://github.com/axelvega483/concesionaria/blob/master/src/main/java/com/proyecto/concecionaria/service/PagosService.java"
    click DetalleVentaService "https://github.com/axelvega483/concesionaria/blob/master/src/main/java/com/proyecto/concecionaria/service/DetalleVentaService.java"
    click ImagenService "https://github.com/axelvega483/concesionaria/blob/master/src/main/java/com/proyecto/concecionaria/service/ImagenService.java"
    click ClienteRepo "https://github.com/axelvega483/concesionaria/blob/master/src/main/java/com/proyecto/concecionaria/repository/ClienteRepository.java"
    click VehiculoRepo "https://github.com/axelvega483/concesionaria/blob/master/src/main/java/com/proyecto/concecionaria/repository/VehiculoRepository.java"
    click UsuarioRepo "https://github.com/axelvega483/concesionaria/blob/master/src/main/java/com/proyecto/concecionaria/repository/UsuarioRepository.java"
    click VentaRepo "https://github.com/axelvega483/concesionaria/blob/master/src/main/java/com/proyecto/concecionaria/repository/VentaRepository.java"
    click PagosRepo "https://github.com/axelvega483/concesionaria/blob/master/src/main/java/com/proyecto/concecionaria/repository/PagosRepository.java"
    click DetalleVentaRepo "https://github.com/axelvega483/concesionaria/blob/master/src/main/java/com/proyecto/concecionaria/repository/DetalleVentaRepository.java"
    click ImagenRepo "https://github.com/axelvega483/concesionaria/blob/master/src/main/java/com/proyecto/concecionaria/repository/ImagenRepository.java"
    click ClienteModel "https://github.com/axelvega483/concesionaria/blob/master/src/main/java/com/proyecto/concecionaria/entity/Cliente.java"
    click VehiculoModel "https://github.com/axelvega483/concesionaria/blob/master/src/main/java/com/proyecto/concecionaria/entity/Vehiculo.java"
    click UsuarioModel "https://github.com/axelvega483/concesionaria/blob/master/src/main/java/com/proyecto/concecionaria/entity/Usuario.java"
    click VentaModel "https://github.com/axelvega483/concesionaria/blob/master/src/main/java/com/proyecto/concecionaria/entity/Venta.java"
    click PagosModel "https://github.com/axelvega483/concesionaria/blob/master/src/main/java/com/proyecto/concecionaria/entity/Pagos.java"
    click DetalleVentaModel "https://github.com/axelvega483/concesionaria/blob/master/src/main/java/com/proyecto/concecionaria/entity/DetalleVenta.java"
    click ImagenModel "https://github.com/axelvega483/concesionaria/blob/master/src/main/java/com/proyecto/concecionaria/entity/Imagen.java"
    click DTOs "https://github.com/axelvega483/concesionaria/tree/master/src/main/java/com/proyecto/concecionaria/DTOs/"
    click ApiResponse "https://github.com/axelvega483/concesionaria/blob/master/src/main/java/com/proyecto/concecionaria/util/ApiResponse.java"
    click Util "https://github.com/axelvega483/concesionaria/tree/master/src/main/java/com/proyecto/concecionaria/util/"

    %% Styles
    classDef apiLayer fill:#D0E6FF,stroke:#0366D6;
    classDef security fill:#FFD8D8,stroke:#D42E33;
    classDef business fill:#DFFFE0,stroke:#228B22;
    classDef data fill:#FFE8B0,stroke:#E69138;
    classDef database fill:#FFE6FA,stroke:#BF00FF;
    classDef dto fill:#E0F7FA,stroke:#00796B;
```
