Se realiza implementación del desafío técnico.

README.md

@@ -2,75 +2,60 @@
 
 # Desafio Java Concrete
 
-Desafio técnico para evaluar el conocimiento de los aspirantes a unirse al equipo de **Backend**.
-
-## Contenido
-- [El Desafio](#el-desafio)
-    - [Escenario](#escenario)
-    - [APIs](#apis)
-    - [Features](#features)
-    - [Puntos a Considerar](#puntos-a-considerar)
-- [¿Qué nos Gustaría Ver?](#qué-nos-gustaría-ver)
-    - [Deseables](#deseables)
-    - [Stack/Pool de Tecnologías](#stackpool-de-tecnologías)
-- [Forma de Entrega](#forma-de-entrega)
-- [Importante](#importante)
-
-## El Desafio
-
-### Escenario
-Recientemente te has unido a un equipo que esta desarrollando una aplicación mobile para una gran compañía de e-commerce.  
-Esta aplicación esta dirigida a dispositivos de **bajo rendimiento** hasta dispositivos con **gran poder de procesamiento**.  
-El cliente ya cuenta con un backend establecido que contiene todas las reglas e información de negocio, pero algunos sistemas dependen de **tecnologías legadas** que pueden ser **inestables**.    
-**Tu** eres responsable de construir la **API** que integrará con estos servicios y proveerá todas las informaciones que Mobile necesita.  
-Para las próximas iteraciones, el equipo va a trabajar en la **Pantalla de Início** y tu debes construir todo(s) los **endpoint(s)** que se requieran para integrar con los servicios y proveer la información para la pantalla.
+## Categories & Coupons API
 
-### APIs
-Necesitarás consumir los siguientes servicios:
-- **Categorias**: [https://cs-hsa-api-categories-rest.herokuapp.com/docs](https://cs-hsa-api-categories-rest.herokuapp.com/docs)
-- **Cupones**: [https://cs-hsa-api-coupons-rest.herokuapp.com/docs](https://cs-hsa-api-coupons-rest.herokuapp.com/docs)
+Este proyecto es una API de Spring Boot para manejar categorías y cupones. Utiliza Spring Boot 3 con Gradle, integración con clientes Feign para servicios externos, manejo de errores con Spring Retry, y documentación de API con Swagger.
 
-### Features
-El equipo Mobile necesita construir una pantalla de inicio que debe mostrar:
-
-- Carrusel con **Top 5** categorias.
-- Carrusel con cupones que no han expirado.
-- Tabla (Grid) con las categorias **restantes**.
-- Mobile **no** necesita de todas las imagenes del modelo de subcategorías, solamente la **imagen más pequeña**. Tu podrías tener que filtrar la respuesta, si tu quieres.
-
-### Puntos a Considerar
-- La API de Cupones es **inestable** y a veces demora en responder. ¿Qué podemos hacer para que este problema no se replique en otras capas? ¿Habrá algún patrón que nos ayude?
-- La API de Categorias responde un modelo complejo de manejar. ¿Qué podríamos hacer para simplificar este modelo y que las integraciones con su aplicación sean más sencillas?
-
-## ¿Qué nos Gustaría Ver? 
-Eres libre para implementar la solución de la forma que consideres mejor, 
-pero debes considerar el escenario, objetivo, implicaciones de performance y stack/pool de tecnología propuesta abajo.
-- Nos enfocamos mucho en la **calidad** de nuestros proyectos y nos gustaría ver alguna estrategia aplicada. Puedes usar, por ejemplo, **Pruebas Unitárias**.
-- No queremos que la experiencia de usuario se vea afectada por el rendimiento de los servicios;
-- **Usted tiene 1 semana para completar el desafio**. Si necesitas mas tiempo, no hay problema, puede hablar con nosotros y veremos que podemos hacer :)
-- Documentación de como configurar y ejecutar el proyecto. Puede sobrescribir el **README.md** para eso.
-
-### Deseables
-- Podría ser bueno una documentación de API. Sugerencia: [Swagger](https://swagger.io/).
-- Ejecutando con [Docker](https://www.docker.com/).
-
-### Stack/Pool de Tecnologías
-- **Java 8** o **superiores**.
-- Cualquier Framework Web. Sugerencia: [Spring Boot](https://spring.io/projects/spring-boot).
-- Cualquier API Client. Sugerencia: [Feign](https://github.com/OpenFeign/feign).
-- De preferencia [Gradle](https://gradle.org/) como sistema de compilación.
-- Tu eres libre para escoger librerias y frameworks de pruebas que mas te guste. Nuestra sugerencia es: [JUnit](https://junit.org/junit5/), [Mockito](https://site.mockito.org/).
+## Comenzando
 
----
+Instrucciones para obtener una copia del proyecto funcionando en tu máquina local para desarrollo y pruebas.
+
+### Prerrequisitos
+
+- JDK 17
+- Gradle
+
+### Instalación
+
+Clona el repositorio y navega al directorio del proyecto:
+
+```bash
+git clone https://github.com/BorisRand/java-recruiting-hsa.git
+cd .\java-recruiting-hsa\bff-categories-coupons\
+```
+
+### Configuración
+
+Configura las propiedades necesarias en `src/main/resources/application.properties`.
 
-## Forma de Entrega
-Siga los siguientes pasos para implementar y enviar este desafío:
-- Haga un **Fork** a este repositorio. Puedes mirar esta guía para mayores informaciones: [Como hacer fork de un repositorio](https://help.github.com/en/articles/fork-a-repo).
-- Implemente el desafío.
-- Después de completar el desafío, realice un **Pull Request** a este repositorio, utilizando la interface de **Github**. [Creando un Pull Request](https://help.github.com/en/articles/creating-a-pull-request-from-a-fork).
-- Si es posible, deja tu repositorio publico para hacer la revisión de código más sencilla.
+### Swagger API Docs
+La documentación de la API está disponible en Swagger UI, que se puede acceder en:
 
-## Importante
-**No** intente hacer un PUSH directo a ESTE repositorio!
+```bash
+http://localhost:8080/swagger-ui/index.html
+```
+
+### Spring Retry
+El proyecto utiliza Spring Retry para manejar reintentos en las llamadas a servicios externos de manera eficiente.
+
+## Construido con
+
+- [Spring Boot](https://spring.io/projects/spring-boot) - El framework web utilizado.
+- [Spring Cloud OpenFeign](https://spring.io/projects/spring-cloud-openfeign) - Cliente Feign para llamadas a servicios externos.
+- [SpringDoc OpenAPI](https://springdoc.org/) - Para la documentación Swagger.
+- [Spring Retry](https://docs.spring.io/spring-batch/docs/current/reference/html/retry.html) - Para el manejo de reintentos.
+
+## IDE utilizado
+
+- IntelliJ IDEA 2022.3.2 (Ultimate Edition)
+
+## Autores
+
+- **Boris Molina Igor** - Desarrollador - [BorisRand](https://github.com/BorisRand)
+
+### APIs
+Necesitarás consumir los siguientes servicios:
+- **Categorias**: [https://cs-hsa-api-categories-rest.herokuapp.com/docs](https://cs-hsa-api-categories-rest.herokuapp.com/docs)
+- **Cupones**: [https://cs-hsa-api-coupons-rest.herokuapp.com/docs](https://cs-hsa-api-coupons-rest.herokuapp.com/docs)
 
 ---

bff-categories-coupons/.gitignore

@@ -0,0 +1,37 @@
+HELP.md
+.gradle
+build/
+!gradle/wrapper/gradle-wrapper.jar
+!**/src/main/**/build/
+!**/src/test/**/build/
+
+### STS ###
+.apt_generated
+.classpath
+.factorypath
+.project
+.settings
+.springBeans
+.sts4-cache
+bin/
+!**/src/main/**/bin/
+!**/src/test/**/bin/
+
+### IntelliJ IDEA ###
+.idea
+*.iws
+*.iml
+*.ipr
+out/
+!**/src/main/**/out/
+!**/src/test/**/out/
+
+### NetBeans ###
+/nbproject/private/
+/nbbuild/
+/dist/
+/nbdist/
+/.nb-gradle/
+
+### VS Code ###
+.vscode/

bff-categories-coupons/build.gradle

@@ -0,0 +1,60 @@
+plugins {
+	id 'java'
+	id 'org.springframework.boot' version '3.1.6'
+	id 'io.spring.dependency-management' version '1.1.4'
+}
+
+group = 'cl.accenture'
+version = '0.0.1-SNAPSHOT'
+
+java {
+	sourceCompatibility = '17'
+}
+
+configurations {
+	compileOnly {
+		extendsFrom annotationProcessor
+	}
+}
+
+repositories {
+	mavenCentral()
+}
+
+ext {
+	set('springCloudVersion', "2022.0.4")
+}
+
+dependencies {
+	implementation 'org.springframework.boot:spring-boot-starter-web'
+
+	implementation 'org.springframework.cloud:spring-cloud-starter-openfeign'
+	implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:2.3.0'
+
+	implementation 'org.springframework.retry:spring-retry:2.0.3'
+	implementation 'org.springframework:spring-aspects:6.0.11'
+
+	implementation 'io.projectreactor:reactor-core'
+
+	compileOnly 'org.projectlombok:lombok'
+	annotationProcessor 'org.projectlombok:lombok'
+
+	testImplementation 'org.springframework.boot:spring-boot-starter-test'
+	testImplementation 'org.junit.jupiter:junit-jupiter-api:5.7.0'
+	testImplementation 'org.junit.jupiter:junit-jupiter-engine:5.7.0'
+	testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.7.0'
+}
+
+dependencyManagement {
+	imports {
+		mavenBom "org.springframework.cloud:spring-cloud-dependencies:${springCloudVersion}"
+	}
+}
+
+tasks.named('bootBuildImage') {
+	builder = 'paketobuildpacks/builder-jammy-base:latest'
+}
+
+tasks.named('test') {
+	useJUnitPlatform()
+}

bff-categories-coupons/gradle/wrapper/gradle-wrapper.properties

@@ -0,0 +1,7 @@
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.5-bin.zip
+networkTimeout=10000
+validateDistributionUrl=true
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists