# infgonza/final_practicas_profesionalizantes_2024 architecture

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

- Interactive diagram: https://gitdiagram.com/infgonza/final_practicas_profesionalizantes_2024
- Repository: https://github.com/infgonza/final_practicas_profesionalizantes_2024

## Overview

##### Project Type and Purpose
- This is a full-stack e-commerce solution built as a REST API in Java with Spring Boot.
- The system supports selling CDs and vinyl, handles user authentication (with JWT and Spring Security), integrates with a MySQL database, delivers static web pages (leveraging HTML, CSS, JavaScript, and Bootstrap), and interacts with an external payment API (Mercado Pago).

##### Main Components
a. Frontend/Presentation Layer:
– Located in src/main/resources/static and src/main/resources/templates.
– Contains HTML, CSS, and JavaScript files for pages such as login, product display, shopping cart, contact, and user profile.

b. API/Backend Layer:
– Controllers (e.g., AuthController, ProductoController, CarritoDeComprasController, etc.) handle HTTP requests.
– Configuration classes (e.g., CorsConfig, JwtAuthFilter, SecurityConfig) set up cross-origin policies, JWT-based authentication, and security policies.

c. Business Logic Layer:
– Services (e.g., CarritoDeComprasService, ClienteService, CompraService, etc.) encapsulate business rules and processes.
– DTOs in the dto package aid in data transfer between the client and backend layers.

d. Data Access Layer:
– Repositories (e.g., ClienteRepository, ProductoRepository, UsuarioRepository, etc.) provide database interaction using Spring Data.
– Entities (e.g., Cliente, Producto, Compra, Factura, etc.) represent the underlying data model persisted in MySQL.

e. Persistence/Database:
– The MySQL database (indicated by the disqueria_db.sql file) stores application data.

f. External Integration:
- Mercado Pago API integration is managed through a designated controller (MercadoPagoController) and possibly supported by additional service classes.
- Also, there is an S3Service, which likely handles file or image storage.

##### Determining Relationships and Interactions
- The Frontend communicates with the RESTful API endpoints exposed by the Controllers.
- Controllers translate HTTP requests into calls on the Business Logic (Services), which then use DTOs to pass data.
- The Services interact with the repository layer for CRUD operations, read/write transactions with the MySQL database.
- Security is applied at multiple layers via Spring Security, JWT handling, and custom authentication services.
- External communication is showcased with dedicated controllers and services (e.g., MercadoPagoController for payment processes, S3Service for storage).
- The configuration classes (like CorsConfig and SecurityConfig) are cross-cutting concerns that affect request filtering and authorization.

##### Architectural Patterns & Design Principles
- Layered Architecture: Clear separation into presentation, API, business logic, and data access layers.
- Use of DTOs: To decouple API models from internal entities.
- Dependency Injection: Spring Boot’s inherent pattern that wires controllers, services, and repositories.
- RESTful Design: Controllers serve as endpoints for standard HTTP methods.
- Security via JWT and Spring Security: Ensuring stateless, token-based authentication.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Frontend (Presentation)"
        A["Static Assets"]:::frontend
        B["Templates"]:::frontend
    end

    subgraph "API Layer - Controllers"
        C["AuthController"]:::controller
        D["ProductoController"]:::controller
        E["CarritoDeComprasController"]:::controller
        F["MercadoPagoController"]:::controller
    end

    subgraph "Business Logic - Services"
        G["CarritoDeComprasService"]:::services
        H["CompraService"]:::services
        I["ProductoService"]:::services
        J["S3Service"]:::services
    end

    subgraph "Data Access Layer"
        K["Entities"]:::data
        L["Repositories"]:::data
    end

    subgraph "Persistence"
        M["MySQL Database"]:::db
    end

    subgraph "Security & Configuration"
        N["CorsConfig"]:::security
        O["JwtAuthFilter"]:::security
        P["SecurityConfig"]:::security
        Q["CustomUserDetailsService"]:::security
    end

    subgraph "External Services"
        R["Mercado Pago API"]:::external
        S["S3 Storage"]:::external
    end

    %% Connections between Frontend and Controllers
    A -->|"calls"| C
    B -->|"calls"| C
    A -->|"calls"| D
    B -->|"calls"| D
    A -->|"calls"| E
    B -->|"calls"| E
    A -->|"calls"| F
    B -->|"calls"| F

    %% Controllers delegating to Business Logic
    C -->|"delegates"| G
    D -->|"delegates"| I
    E -->|"delegates"| G
    F -->|"delegates"| J

    %% Business Logic interacting with Data Access
    G -->|"processes"| L
    H -->|"processes"| L
    I -->|"processes"| L
    J -->|"processes"| L

    %% Repositories persisting data to Database
    L -->|"persistsData"| M
    K --> M

    %% Security configuration integration with API Layer
    N --- O
    O --- P
    P --- Q
    C --- O
    D --- O
    E --- O
    F --- O

    %% External integrations
    F -->|"integrates"| R
    J -->|"integrates"| S

    %% Click Events
    click A "https://github.com/infgonza/final_practicas_profesionalizantes_2024/tree/master/src/main/resources/static"
    click B "https://github.com/infgonza/final_practicas_profesionalizantes_2024/tree/master/src/main/resources/templates"
    click C "https://github.com/infgonza/final_practicas_profesionalizantes_2024/blob/master/src/main/java/controllers/AuthController.java"
    click D "https://github.com/infgonza/final_practicas_profesionalizantes_2024/blob/master/src/main/java/controllers/ProductoController.java"
    click E "https://github.com/infgonza/final_practicas_profesionalizantes_2024/blob/master/src/main/java/controllers/CarritoDeComprasController.java"
    click F "https://github.com/infgonza/final_practicas_profesionalizantes_2024/blob/master/src/main/java/controllers/MercadoPagoController.java"
    click G "https://github.com/infgonza/final_practicas_profesionalizantes_2024/blob/master/src/main/java/services/CarritoDeComprasService.java"
    click H "https://github.com/infgonza/final_practicas_profesionalizantes_2024/blob/master/src/main/java/services/CompraService.java"
    click I "https://github.com/infgonza/final_practicas_profesionalizantes_2024/blob/master/src/main/java/services/ProductoService.java"
    click J "https://github.com/infgonza/final_practicas_profesionalizantes_2024/blob/master/src/main/java/services/S3Service.java"
    click K "https://github.com/infgonza/final_practicas_profesionalizantes_2024/tree/master/src/main/java/entities"
    click L "https://github.com/infgonza/final_practicas_profesionalizantes_2024/tree/master/src/main/java/repositories"
    click M "https://github.com/infgonza/final_practicas_profesionalizantes_2024/blob/master/disqueria_db.sql"
    click N "https://github.com/infgonza/final_practicas_profesionalizantes_2024/blob/master/src/main/java/config/CorsConfig.java"
    click O "https://github.com/infgonza/final_practicas_profesionalizantes_2024/blob/master/src/main/java/config/JwtAuthFilter.java"
    click P "https://github.com/infgonza/final_practicas_profesionalizantes_2024/blob/master/src/main/java/config/SecurityConfig.java"
    click Q "https://github.com/infgonza/final_practicas_profesionalizantes_2024/blob/master/src/main/java/config/CustomUserDetailsService.java"

    %% Styles
    classDef frontend fill:#aee4ff,stroke:#333,stroke-width:1px;
    classDef controller fill:#f7b26a,stroke:#333,stroke-width:1px;
    classDef services fill:#c5f7c3,stroke:#333,stroke-width:1px;
    classDef data fill:#fff9c4,stroke:#333,stroke-width:1px;
    classDef db fill:#ffcccb,stroke:#333,stroke-width:1px;
    classDef security fill:#d3d3d3,stroke:#333,stroke-width:1px;
    classDef external fill:#e0b0ff,stroke:#333,stroke-width:1px;
```
