How estebanrcarmona/api-stock-emazon works
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.