fix: centraliza respuestas de error en Swagger
Resumen
Se centraliza la documentación de respuestas de error ApiError en Swagger/OpenAPI para evitar repetición en los controladores y mantener consistencia en la especificación.
Cambios
- Se agrega un
OpenApiCustomizerenSwaggerConfigpara completar automáticamente el schema de error en respuestas4xxy5xx - Se registra el schema
ApiErrorencomponents - Se simplifican las anotaciones
@ApiResponseenAuthControlleryUserController - Se ajusta el mensaje de conflicto en usuarios duplicados de
El username ya existeaEl usuario ya existe
Impacto
- Swagger muestra respuestas de error consistentes sin repetir
content/schemaen cada endpoint - Se reduce duplicación de configuración en controladores
- No cambia la lógica funcional de autenticación ni ABM de usuarios, salvo el texto del mensaje de conflicto
Validación
- Se revisó el diff y se dejó committeado en la branch
fix/swagger-api-error-responses - No se pudo correr compilación local en este entorno porque
javano está disponible yJAVA_HOMEno está configurado