# estebanrcarmona/api-stock-emazon architecture

> Architecture diagram of the GitHub repository estebanrcarmona/api-stock-emazon, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/estebanrcarmona/api-stock-emazon
- Repository: https://github.com/estebanrcarmona/api-stock-emazon

## Overview

##### Project type and purpose
- This is a standalone Spring Boot microservice (“API Stock”) for inventory management of articles, brands, and categories.
- Its primary responsibilities are CRUD operations on Article, Brand, and Category entities, stock-level tracking, token‑based authentication/authorization (Spring Security + JWT), and self‑documenting REST endpoints via Swagger/OpenAPI.

##### File structure
- Top level: Gradle build files, settings, wrapper → standard Spring Boot project.
- src/main/java/com/microstock/apistock:
- ApistockApplication.java: Spring Boot entry point.
- aplication/BeansConfig, exception/ControlAdvice → application‑level configuration & global exception handling.
- domain:
– model/ (Article, Brand, Category, Item)
– interfaces/ (IArticleService, IArticleRepositoryPort, etc.)
– services/ (ServiceArticleImpl, …) → business logic
– util/ (DTOs, pagination helpers)
- infraestructur (hexagonal “ports & adapters” split):
– driving_http/controllers (REST controllers)
– driving_http/dtos & mappers (request/response mapping)
– driven_rp/adapter (implements repository ports)
– driven_rp/entity & persistence (JPA entities + Spring Data repositories)
– security (JWT filters, entry points, security config)
- src/main/resources: application.properties → externalized configuration (DB URL, ports, JWT secrets).
- src/test/java: unit & integration tests for controllers, services, repositories, mappers.

##### README for additional insights
- Confirms microservice scope: article/brand/category management, stock tracking.
- Emphasizes Spring Security (JWT + roles).
- Swagger / OpenAPI for interactive docs on port 7070.
- Technology stack: Java17, Spring Boot, Gradle, SQL Database.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Clients & Documentation"
        HTTPClient["HTTP Client"]:::external
        SwaggerUI["Swagger UI"]:::external
    end

    HTTPClient -->|"REST Call"| SecurityFilterChain["Security Filter Chain"]:::http
    SwaggerUI -->|"View Docs"| ControllerArticle

    subgraph "Driving Adapters (HTTP Layer)"
        SecurityFilterChain --> ControllerArticle["ControllerArticle"]:::http
        SecurityFilterChain --> ControllerBrand["ControllerBrand"]:::http
        SecurityFilterChain --> ControllerCategory["ControllerCategory"]:::http

        ControllerArticle --> DTOMappers["DTO Mappers"]:::http
        ControllerBrand --> DTOMappers
        ControllerCategory --> DTOMappers
    end

    subgraph "Application & Domain"
        BeansConfig["BeansConfig"]:::domain
        ControlAdvice["ControlAdvice"]:::domain
        ServiceArticleImpl["ServiceArticleImpl"]:::domain
        ServiceBrandImpl["ServiceBrandImpl"]:::domain
        ServiceCategoryImpl["ServiceCategoryImpl"]:::domain
        IArticleService["IArticleService"]:::domain
        IBrandService["IBrandService"]:::domain
        ICategoryService["ICategoryService"]:::domain
        IArticleRepoPort["IArticleRepositoryPort"]:::domain
        IBrandRepoPort["IBrandRepositoryPort"]:::domain
        ICategoryRepoPort["ICategoryRepositoryPort"]:::domain
        ArticleDomainModel["Article, Brand, Category, Item Models"]:::domain

        DTOMappers --> ServiceArticleImpl
        DTOMappers --> ServiceBrandImpl
        DTOMappers --> ServiceCategoryImpl

        ServiceArticleImpl --> IArticleService
        ServiceBrandImpl --> IBrandService
        ServiceCategoryImpl --> ICategoryService

        IArticleService --> IArticleRepoPort
        IBrandService --> IBrandRepoPort
        ICategoryService --> ICategoryRepoPort
    end

    subgraph "Driven Adapters & Persistence"
        ArticleRepoImpl["ArticleRepositoryImpl"]:::infra
        BrandRepoImpl["BrandRepositoryImpl"]:::infra
        CategoryRepoImpl["CategoryRepositoryImpl"]:::infra
        EntityMappers["Entity Mappers"]:::infra
        JPARepos["Spring Data JPA Repositories"]:::infra
    end

    IArticleRepoPort --> ArticleRepoImpl
    IBrandRepoPort --> BrandRepoImpl
    ICategoryRepoPort --> CategoryRepoImpl

    ArticleRepoImpl --> EntityMappers
    BrandRepoImpl --> EntityMappers
    CategoryRepoImpl --> EntityMappers

    EntityMappers --> JPARepos
    JPARepos --> Database["SQL Database"]:::external

    subgraph "Security"
        ConfigFilter["ConfigFilter"]:::infra
        JwtFilter["JwtAutenticationFilter"]:::infra
        CustomEntryPoint["CustomEntryPoint"]:::infra
        SecurityFilterChain -.-> ConfigFilter
        SecurityFilterChain -.-> JwtFilter
        SecurityFilterChain -.-> CustomEntryPoint
    end

    Database -.->|"Reads/Writes"| JPARepos

    classDef http fill:#cce5ff,stroke:#036;
    classDef domain fill:#d4edda,stroke:#036;
    classDef infra fill:#fff3cd,stroke:#036;
    classDef external fill:#e2e3e5,stroke:#036;

    click ApistockApplication "https://github.com/estebanrcarmona/api-stock-emazon/blob/main/apistock/src/main/java/com/microstock/apistock/ApistockApplication.java"
    click BeansConfig "https://github.com/estebanrcarmona/api-stock-emazon/blob/main/apistock/src/main/java/com/microstock/apistock/aplication/BeansConfig.java"
    click ControlAdvice "https://github.com/estebanrcarmona/api-stock-emazon/blob/main/apistock/src/main/java/com/microstock/apistock/aplication/exception/ControlAdvice.java"
    click ArticleDomainModel "https://github.com/estebanrcarmona/api-stock-emazon/blob/main/apistock/src/main/java/com/microstock/apistock/domain/model/Article.java"
    click ArticleDomainModel "https://github.com/estebanrcarmona/api-stock-emazon/blob/main/apistock/src/main/java/com/microstock/apistock/domain/model/Brand.java"
    click ArticleDomainModel "https://github.com/estebanrcarmona/api-stock-emazon/blob/main/apistock/src/main/java/com/microstock/apistock/domain/model/Category.java"
    click ArticleDomainModel "https://github.com/estebanrcarmona/api-stock-emazon/blob/main/apistock/src/main/java/com/microstock/apistock/domain/model/Item.java"
    click IArticleService "https://github.com/estebanrcarmona/api-stock-emazon/blob/main/apistock/src/main/java/com/microstock/apistock/domain/interfaces/IArticleService.java"
    click IBrandService "https://github.com/estebanrcarmona/api-stock-emazon/blob/main/apistock/src/main/java/com/microstock/apistock/domain/interfaces/IBrandService.java"
    click ICategoryService "https://github.com/estebanrcarmona/api-stock-emazon/blob/main/apistock/src/main/java/com/microstock/apistock/domain/interfaces/ICategoryService.java"
    click IArticleRepoPort "https://github.com/estebanrcarmona/api-stock-emazon/blob/main/apistock/src/main/java/com/microstock/apistock/domain/interfaces/IArticleRepositoryPort.java"
    click IBrandRepoPort "https://github.com/estebanrcarmona/api-stock-emazon/blob/main/apistock/src/main/java/com/microstock/apistock/domain/interfaces/IBrandRepositoryPort.java"
    click ICategoryRepoPort "https://github.com/estebanrcarmona/api-stock-emazon/blob/main/apistock/src/main/java/com/microstock/apistock/domain/interfaces/ICategoryRepositoryPort.java"
    click ServiceArticleImpl "https://github.com/estebanrcarmona/api-stock-emazon/blob/main/apistock/src/main/java/com/microstock/apistock/domain/services/ServiceArticleImpl.java"
    click ServiceBrandImpl "https://github.com/estebanrcarmona/api-stock-emazon/blob/main/apistock/src/main/java/com/microstock/apistock/domain/services/ServiceBrandImpl.java"
    click ServiceCategoryImpl "https://github.com/estebanrcarmona/api-stock-emazon/blob/main/apistock/src/main/java/com/microstock/apistock/domain/services/ServiceCategoryImpl.java"
    click ControllerArticle "https://github.com/estebanrcarmona/api-stock-emazon/blob/main/apistock/src/main/java/com/microstock/apistock/infraestructur/driving_http/controllers/ControllerArticle.java"
    click ControllerBrand "https://github.com/estebanrcarmona/api-stock-emazon/blob/main/apistock/src/main/java/com/microstock/apistock/infraestructur/driving_http/controllers/ControllerBrand.java"
    click ControllerCategory "https://github.com/estebanrcarmona/api-stock-emazon/blob/main/apistock/src/main/java/com/microstock/apistock/infraestructur/driving_http/controllers/ControllerCategory.java"
    click DTOMappers "https://github.com/estebanrcarmona/api-stock-emazon/tree/main/apistock/src/main/java/com/microstock/apistock/infraestructur/driving_http/mappers/"
    click ArticleRepoImpl "https://github.com/estebanrcarmona/api-stock-emazon/blob/main/apistock/src/main/java/com/microstock/apistock/infraestructur/driven_rp/adapter/ArticleRepositoryImpl.java"
    click BrandRepoImpl "https://github.com/estebanrcarmona/api-stock-emazon/blob/main/apistock/src/main/java/com/microstock/apistock/infraestructur/driven_rp/adapter/BrandRepositoryImpl.java"
    click CategoryRepoImpl "https://github.com/estebanrcarmona/api-stock-emazon/blob/main/apistock/src/main/java/com/microstock/apistock/infraestructur/driven_rp/adapter/CategoryRepositoryImpl.java"
    click EntityMappers "https://github.com/estebanrcarmona/api-stock-emazon/tree/main/apistock/src/main/java/com/microstock/apistock/infraestructur/driven_rp/mapper/"
    click JPARepos "https://github.com/estebanrcarmona/api-stock-emazon/tree/main/apistock/src/main/java/com/microstock/apistock/infraestructur/driven_rp/persistence/"
    click ConfigFilter "https://github.com/estebanrcarmona/api-stock-emazon/blob/main/apistock/src/main/java/com/microstock/apistock/infraestructur/security/ConfigFilter.java"
    click CustomEntryPoint "https://github.com/estebanrcarmona/api-stock-emazon/blob/main/apistock/src/main/java/com/microstock/apistock/infraestructur/security/CustomEntryPoint.java"
    click JwtFilter "https://github.com/estebanrcarmona/api-stock-emazon/blob/main/apistock/src/main/java/com/microstock/apistock/infraestructur/security/jwt_configuration/JwtAutenticationFilter.java"
    click ApplicationProperties "https://github.com/estebanrcarmona/api-stock-emazon/blob/main/apistock/src/main/resources/application.properties"
```
