# sii-informatica-uma/mini-pim-plytix-digital-dynamics architecture

> Architecture diagram of the GitHub repository sii-informatica-uma/mini-pim-plytix-digital-dynamics, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sii-informatica-uma/mini-pim-plytix-digital-dynamics
- Repository: https://github.com/sii-informatica-uma/mini-pim-plytix-digital-dynamics

## Overview

##### Project type and purpose
- This is a single Spring-Boot microservice named “microservice_gestor_productos.”
- Its sole responsibility is managing product data (CRUD operations on products, attributes, categories, relations).
- It exposes HTTP endpoints (controllers), uses a service layer for business logic, persists data in a relational DB via JPA repositories, and maps between DTOs and entities.

##### File structure
- Top‐level folder “microservice_gestor_productos” contains:
- pom.xml, mvnw* files, .mvn wrapper → Maven‐based Java project
- src/main/java/.../controladores → REST API controllers + Mapper classes
- src/main/java/.../servicios → service layer (business logic)
- src/main/java/.../repository → Spring Data JPA repositories
- src/main/java/.../entity → JPA entity classes
- src/main/java/.../dtos → data‐transfer objects
- src/main/java/.../excepciones → custom exceptions
- src/main/resources/application.properties → config for DB, port, etc.
- ddl-schema.sql → initial database schema
- There is also a test package for unit/integration tests.

##### Main components & their interactions
a. External Client
- E.g., UI or another service calls REST endpoints (over HTTP).
b. API Layer (Controllers + Mappers)
- ProductoController receives HTTP requests.
- Calls Mapper classes (ProductoMapper, CategoriaMapper, etc.) to convert between Entity ↔ DTO.
c. Service Layer
- ProductoService enforces business rules, orchestrates calls to repositories and handles exceptions.
d. Persistence Layer
- Spring Data JPA Repositories (ProductoRepository, CategoriaRepository, …) perform CRUD on the relational database.
e. Database
- A relational DB (schema defined in ddl-schema.sql) stores entities: Producto, Categoria, Atributo, Relacion.

##### Architectural patterns & design principles
- Layered (Onion) Architecture: Controller → Service → Repository → Database
- DTO pattern: strong separation between internal entity model and API contract
- Dependency Injection (Spring) for loose coupling
- Exception Handling: custom exceptions bubble up to a global handler (not shown but implied)

## Diagram (Mermaid)

```mermaid
graph TD
    subgraph "Application"
        App["GestorProductosApplication"]:::service
    end

    ExternalClient["External Client"]:::external

    subgraph "API Layer"
        ProdCtrl["ProductoController"]:::api
        AtribMapper["AtributoMapper"]:::api
        CatMapper["CategoriaMapper"]:::api
        ProdMapper["ProductoMapper"]:::api
        RelMapper["RelacionMapper"]:::api
    end

    subgraph "Service Layer"
        ProdSvc["ProductoService"]:::business
    end

    subgraph "Repository Layer"
        ProdRepo["ProductoRepository"]:::persistence
        CatRepo["CategoriaRepository"]:::persistence
        AtribRepo["AtributoRepository"]:::persistence
        RelRepo["RelacionRepository"]:::persistence
    end

    Database[(Database)]:::database

    ExternalClient -->|"HTTP GET/POST"| ProdCtrl
    ProdCtrl -->|"map DTO↔Entity"| ProdMapper
    ProdCtrl -->|"map DTO↔Entity"| CatMapper
    ProdCtrl -->|"map DTO↔Entity"| AtribMapper
    ProdCtrl -->|"map DTO↔Entity"| RelMapper
    ProdCtrl -->|"calls service"| ProdSvc
    ProdSvc -->|"calls CRUD"| ProdRepo
    ProdSvc -->|"calls CRUD"| CatRepo
    ProdSvc -->|"calls CRUD"| AtribRepo
    ProdSvc -->|"calls CRUD"| RelRepo
    ProdRepo -->|"SQL queries"| Database
    CatRepo -->|"SQL queries"| Database
    AtribRepo -->|"SQL queries"| Database
    RelRepo -->|"SQL queries"| Database

    click App "https://github.com/sii-informatica-uma/mini-pim-plytix-digital-dynamics/blob/main/microservice_gestor_productos/src/main/java/uma/informatica/sii/gestor_productos/microservice_gestor_productos/GestorProductosApplication.java"
    click ProdCtrl "https://github.com/sii-informatica-uma/mini-pim-plytix-digital-dynamics/blob/main/microservice_gestor_productos/src/main/java/uma/informatica/sii/gestor_productos/microservice_gestor_productos/controladores/ProductoController.java"
    click AtribMapper "https://github.com/sii-informatica-uma/mini-pim-plytix-digital-dynamics/blob/main/microservice_gestor_productos/src/main/java/uma/informatica/sii/gestor_productos/microservice_gestor_productos/controladores/AtributoMapper.java"
    click CatMapper "https://github.com/sii-informatica-uma/mini-pim-plytix-digital-dynamics/blob/main/microservice_gestor_productos/src/main/java/uma/informatica/sii/gestor_productos/microservice_gestor_productos/controladores/CategoriaMapper.java"
    click ProdMapper "https://github.com/sii-informatica-uma/mini-pim-plytix-digital-dynamics/blob/main/microservice_gestor_productos/src/main/java/uma/informatica/sii/gestor_productos/microservice_gestor_productos/controladores/ProductoMapper.java"
    click RelMapper "https://github.com/sii-informatica-uma/mini-pim-plytix-digital-dynamics/blob/main/microservice_gestor_productos/src/main/java/uma/informatica/sii/gestor_productos/microservice_gestor_productos/controladores/RelacionMapper.java"
    click ProdSvc "https://github.com/sii-informatica-uma/mini-pim-plytix-digital-dynamics/blob/main/microservice_gestor_productos/src/main/java/uma/informatica/sii/gestor_productos/microservice_gestor_productos/servicios/ProductoService.java"
    click AtribRepo "https://github.com/sii-informatica-uma/mini-pim-plytix-digital-dynamics/blob/main/microservice_gestor_productos/src/main/java/uma/informatica/sii/gestor_productos/microservice_gestor_productos/repository/AtributoRepository.java"
    click CatRepo "https://github.com/sii-informatica-uma/mini-pim-plytix-digital-dynamics/blob/main/microservice_gestor_productos/src/main/java/uma/informatica/sii/gestor_productos/microservice_gestor_productos/repository/CategoriaRepository.java"
    click ProdRepo "https://github.com/sii-informatica-uma/mini-pim-plytix-digital-dynamics/blob/main/microservice_gestor_productos/src/main/java/uma/informatica/sii/gestor_productos/microservice_gestor_productos/repository/ProductoRepository.java"
    click RelRepo "https://github.com/sii-informatica-uma/mini-pim-plytix-digital-dynamics/blob/main/microservice_gestor_productos/src/main/java/uma/informatica/sii/gestor_productos/microservice_gestor_productos/repository/RelacionRepository.java"
    click Database "https://github.com/sii-informatica-uma/mini-pim-plytix-digital-dynamics/blob/main/microservice_gestor_productos/ddl-schema.sql"

    classDef external fill:#cccccc,stroke:#333,stroke-width:1px;
    classDef api fill:#ADD8E6,stroke:#333,stroke-width:1px;
    classDef business fill:#90EE90,stroke:#333,stroke-width:1px;
    classDef persistence fill:#FFD580,stroke:#333,stroke-width:1px;
    classDef database fill:#f9c74f,stroke:#333,stroke-width:1px;
```
