Repository navigation
Releases
Releases · Gabrieldrc/Product-Management-API
v1.0.0
Added
- Comprehensive API Documentation: Se agregó y actualizó el archivo
README.mdpara incluir una descripción
detallada de la API, instrucciones de configuración y ejecución, guía de autenticación, endpoints de monitoreo,
documentación interactiva de Swagger UI, y decisiones arquitectónicas clave.
v0.11.0
Added
- Item Detail API Expansion: Ampliación del modelo
Producty DTOs para incluirdescription,seller_info(name,
rating) yshipping_info(cost, delivery). - SQL Data Seed Migration: Implementación de
data.sqlpara la carga inicial de datos persistentes, sustituyendo el
antiguoProductDataSeeder. - Advanced JSON Assertions: Actualización de la suite de pruebas
httpXX.jsonpara validar estructuras anidadas y
jerárquicas en las respuestas de la API.
Changed
- Java 21 Syntax Refinement: Aplicación estricta de
final varpara variables locales y parámetros de método en
toda la capa de servicio y controladores. - DTO Structural Refactoring: Migración de
ProductResponsehacia un diseño de records estáticos anidados para
mejorar la cohesión de la información del vendedor y envío. - Database Initialization Flow: Configuración de
defer-datasource-initializationpara sincronizar la ejecución de
scripts SQL con el ciclo de vida de Hibernate.
Fixed
- Integration Test Payloads: Corrección de errores 400 en
SecurityIntegrationTestmediante la actualización de los
cuerpos JSON de prueba con los nuevos campos obligatorios. - Service Layer Visibilidad: Ajuste de modificadores de acceso en Records para permitir el mapeo correcto entre
paquetes de DTO y Servicio.
Removed
- Legacy Seeder: Eliminación de
ProductDataSeeder.javaen favor del estándardata.sqlbasado en archivos de
recursos.
v0.10.0
Added
- Contextual User Logging (MDC): Implementación de Mapped Diagnostic Context para inyectar automáticamente el nombre
del usuario autenticado en cada línea de log. - Strategic Service Logging: Cobertura total de logs en inglés técnico para el ciclo de vida de productos (Create,
Update, Delete, Get, Pagination) siguiendo niveles INFO, DEBUG y WARN. - Smart Log Patterns: Configuración de un patrón de consola dinámico que muestra
[user]o[system](fallback)
con resaltado de sintaxis en el perfil de desarrollo. - Security Audit Logs: Registro de intentos de autenticación exitosos y fallidos en el
AuthControllery filtros de
seguridad.
Changed
- Logback Refactoring: Actualización de
logback-spring.xmlpara soportar tanto logs estructurados JSON para
contenedores como logs legibles para humanos en local. - Filter Optimization: Refactorización del
JwtAuthenticationFiltermediante métodos privados y Guard Clauses para
manejar la limpieza del contexto del hilo (MDC.clear()) de forma segura.
Fixed
- Thread Context Leak: Garantizada la limpieza de los datos del usuario en los hilos de ejecución mediante bloques
try-finallyen los filtros, evitando que la información se filtre entre peticiones.
v0.9.0
Added
- Multi-Stage Docker Architecture: Implementación de un
Dockerfileoptimizado con etapas diferenciadas para
Desarrollo (Hot-reload), Construcción (Maven) y Producción (JRE Alpine). - Advanced Observability: - Configuración de Structured Logging en formato JSON mediante Logback y Logstash
Encoder.- Implementación de Métricas de Negocio personalizadas con Micrometer (
api.products.created).
- Implementación de Métricas de Negocio personalizadas con Micrometer (
- Docker Compose Orchestration: Creación de entornos segregados (
docker-compose.yamlpara dev y
docker-compose.test.ymlpara integración). - Production-Ready Security: Refuerzo de la entropía de la clave JWT (256 bits) para cumplir con el estándar RFC
7518.
Changed
- Runtime Optimization: Migración a imágenes base
eclipse-temurin:21-jre-alpinereduciendo el tamaño de la imagen
final en un 60%. - Container Security: Implementación de ejecución mediante usuario no-root (
spring:spring) dentro del contenedor. - Developer Experience: Configuración de volúmenes para persistencia del
maven-cachey sincronización de código en
tiempo real.
Fixed
- WeakKeyException: Solucionado el error de arranque del contenedor debido a claves JWT de longitud insuficiente.
- Docker Path Mismatch: Corrección de la ejecución del comando
mvn spring-boot:runpara entornos con volúmenes
montados.
v0.8.0
Added
- JWT Security Architecture: Implementación de seguridad sin estado (Stateless) mediante tokens JWT.
- Bearer Authentication in Swagger: Configuración de
SecuritySchemeen OpenAPI 3.0 para permitir pruebas
autenticadas desde Swagger UI. - Standardized Error RFC 7807: Adopción total del estándar internacional
ProblemDetailpara todas las respuestas
de error (400, 401, 404, 429). - Type-Safe Configuration: Implementación de
JwtPropertiesutilizando Java Records y@ConfigurationProperties.
Changed
- Java 21 Refactoring: Aplicación de estándares modernos: uso de
var, parámetrosfinal, y Records para DTOs e
infraestructura. - Unified Exception Handling: Sincronización de errores de Spring Security y Rate Limiting con el
GlobalExceptionHandler. - Logic Cleanup: Implementación de "Guard Clauses" en filtros y servicios para mejorar la legibilidad.
Fixed
- Rate Limiting Consistency: Corrección del formato de salida del
RateLimitingFilterpara alinearse con el esquema
global RFC 7807. - Security Integration Tests: Actualización de las aserciones de
MockMvcpara validar los nuevos paths de JSON (
$.detailen lugar de$.message).
v0.7.0
Added
- Spring Boot Actuator Integration: Implementación de endpoints de observabilidad (
/health,/metrics,/info)
para monitoreo del estado del servicio. - Single Source of Truth (Version sync): Configuración de Maven Resource Filtering para sincronizar automáticamente
la versión delpom.xmlcon los endpoints de Actuator y la documentación de Swagger. - Health Indicators: Activación de detalles de salud para verificar la conectividad de la base de datos en tiempo
real.
Changed
- Maven Build Lifecycle: Actualización del
spring-boot-maven-pluginpara generar información de compilación (
build-info) automáticamente. - Project Configuration: Migración de valores estáticos en
application.propertiesa variables dinámicas de Maven (
@project.version@).
v0.6.0
Added
- Full English Localization: Refactorización total de mensajes de error en
GlobalExceptionHandler, DTOs y modelos
al inglés técnico. - Global Rate Limit Visibility: Documentación del error 429 (Too Many Requests) en todos los endpoints del
controlador.
Fixed
- Ghost Documentation Fix: Desactivada la inferencia automática de respuestas de error mediante
springdoc.override-with-generic-response=false, eliminando respuestas 404 erróneas en endpoints de creación y
listado. - Test Consistency: Actualización de la suite de pruebas JSON para alinearse con los nuevos mensajes de error en
inglés.
v0.5.0
Added
- OpenAPI/Swagger Integration: Implementación de
springdoc-openapicon metadatos profesionales. - Advanced Documentation: Uso de
@Operationy@ExampleObjectpara mostrar múltiples escenarios de error con
ejemplos reales. - UI Optimization: Implementación de
@ParameterObjectpara una interfaz de paginación limpia.
v0.4.0
Added
- Aislamiento de Base de Datos: Implementación de
resetDatabaseState()con SQL nativo (
TRUNCATE RESTART IDENTITY) para garantizar IDs limpios. - Resiliencia Multi-Entorno: Soporte para nombres de tablas en plural y singular.
- Consistencia de Errores: Alineación del formato JSON de error del
RateLimitingFiltercon el
GlobalExceptionHandler.
Changed
- Arquitectura de Filtros: Refactorización del
RateLimitingFilterpara seguir el estándar del DTOErrorResponse. - Optimización de Tests: Inyección directa de
EntityManagerpara limpieza de tablas.
Fixed
- SQLGrammarException: Corregido el error de "Table PRODUCT not found" en entornos H2 estrictos.
- ID Mismatch: Eliminada la deriva de IDs mediante reinicio forzado de secuencias.