Desafío técnico

.classpath

@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<classpath>
+	<classpathentry kind="src" output="bin/main" path="src/main/java">
+		<attributes>
+			<attribute name="gradle_scope" value="main"/>
+			<attribute name="gradle_used_by_scope" value="main,test"/>
+		</attributes>
+	</classpathentry>
+	<classpathentry kind="src" output="bin/main" path="src/main/resources">
+		<attributes>
+			<attribute name="gradle_scope" value="main"/>
+			<attribute name="gradle_used_by_scope" value="main,test"/>
+		</attributes>
+	</classpathentry>
+	<classpathentry kind="src" output="bin/test" path="src/test/java">
+		<attributes>
+			<attribute name="gradle_scope" value="test"/>
+			<attribute name="gradle_used_by_scope" value="test"/>
+			<attribute name="test" value="true"/>
+		</attributes>
+	</classpathentry>
+	<classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER/org.eclipse.jdt.internal.debug.ui.launcher.StandardVMType/JavaSE-11/"/>
+	<classpathentry kind="con" path="org.eclipse.buildship.core.gradleclasspathcontainer"/>
+	<classpathentry kind="output" path="bin/default"/>
+</classpath>

.gitignore

@@ -0,0 +1,93 @@
+# Compiled class file
+*.class
+
+# Log file
+*.log
+
+# BlueJ files
+*.ctxt
+
+# Mobile Tools for Java (J2ME)
+.mtj.tmp/
+
+# Package Files #
+*.jar
+*.war
+*.nar
+*.ear
+*.zip
+*.tar.gz
+*.rar
+
+# virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
+hs_err_pid*
+
+.metadata
+bin/
+tmp/
+*.tmp
+*.bak
+*.swp
+*~.nib
+local.properties
+.settings/
+.loadpath
+.recommenders
+
+# External tool builders
+.externalToolBuilders/
+
+# Locally stored "Eclipse launch configurations"
+*.launch
+
+# PyDev specific (Python IDE for Eclipse)
+*.pydevproject
+
+# CDT-specific (C/C++ Development Tooling)
+.cproject
+
+# CDT- autotools
+.autotools
+
+# Java annotation processor (APT)
+.factorypath
+
+# PDT-specific (PHP Development Tools)
+.buildpath
+
+# sbteclipse plugin
+.target
+
+# Tern plugin
+.tern-project
+
+# TeXlipse plugin
+.texlipse
+
+# STS (Spring Tool Suite)
+.springBeans
+
+# Code Recommenders
+.recommenders/
+
+# Annotation Processing
+.apt_generated/
+.apt_generated_test/
+
+# Scala IDE specific (Scala & Java development for Eclipse)
+.cache-main
+.scala_dependencies
+.worksheet
+
+# Gradle
+.gradle/
+!gradle/wrapper/gradle-wrapper.jar
+
+# Uncomment this line if you wish to ignore the project description file.
+# Typically, this file would be tracked if it contains build/dependency configurations:
+#.project
+
+## ignoring target file
+target/
+
+# End of https://mrkandreev.name/snippets/gitignore-generator/#Java,Eclipse,Java-Web

.project

@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<projectDescription>
+	<name>java-recruiting-hsa</name>
+	<comment>Project java-recruiting-hsa created by Buildship.</comment>
+	<projects>
+	</projects>
+	<buildSpec>
+		<buildCommand>
+			<name>org.eclipse.jdt.core.javabuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>org.eclipse.buildship.core.gradleprojectbuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>org.springframework.ide.eclipse.boot.validation.springbootbuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+	</buildSpec>
+	<natures>
+		<nature>org.eclipse.jdt.core.javanature</nature>
+		<nature>org.eclipse.buildship.core.gradleprojectnature</nature>
+	</natures>
+</projectDescription>

Dockerfile

@@ -0,0 +1,4 @@
+FROM amazoncorretto:11
+EXPOSE 8080
+COPY build/libs/java-recruiting-hsa-0.0.1-SNAPSHOT.jar java-recruiting-hsa-0.0.1-SNAPSHOT.jar
+ENTRYPOINT ["java","-jar","/java-recruiting-hsa-0.0.1-SNAPSHOT.jar"]

HELP.md

@@ -0,0 +1,14 @@
+# Getting Started
+
+### Reference Documentation
+For further reference, please consider the following sections:
+
+* [Official Gradle documentation](https://docs.gradle.org)
+* [Spring Boot Gradle Plugin Reference Guide](https://docs.spring.io/spring-boot/docs/2.7.5/gradle-plugin/reference/html/)
+* [Create an OCI image](https://docs.spring.io/spring-boot/docs/2.7.5/gradle-plugin/reference/html/#build-image)
+
+### Additional Links
+These additional references should also help you:
+
+* [Gradle Build Scans – insights for your project's build](https://scans.gradle.com#gradle)
+

README.md

@@ -1,76 +1,87 @@
 <a href="https://concrete.com.br/"><img src=".github/concrete_symbol.png" width="180px" align="right" /></a>
 
-# 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.
-
-### 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)
-
-### 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/).
-
----
-
-## 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.
-
-## Importante
-**No** intente hacer un PUSH directo a ESTE repositorio!
-
----
+# Desafio Java Concrete - Javier Vergara
+
+Api Rest para backend aplicación ecommerce
+
+### Tecnologías utilizadas
+
+- Java 11
+- Spring Boot
+- Swagger
+- Feign
+- Lombok
+- Docker
+
+### Instrucciones
+
+- Se requiere Java 11+.
+
+- Ingresar a ruta base del proyecto y ejecutar lo siguiente por terminal, en el mismo orden en que aparecen:
+
+```sh
+
+./gradlew clean
+
+./gradlew build
+
+./gradlew bootRun
+```
+- Una vez ejecutada la instrucción anterior la API ya estará inicializada.
+
+- Se incluye documentación gráfica por medio de Swagger en la ruta:
+
+```
+http://localhost:8080/swagger-ecommerce-app.html
+
+```
+
+- Para listar cupones no expirados (fecha de expiración mayor a la actual) realizar llamada GET a endpoint:
+
+```
+http://localhost:8080/coupons
+```
+
+- Para listar Top 5 categorías según su relevancia realizar llamada GET a endpoint: 
+
+```
+http://localhost:8080/categories/top
+```
+
+- Para listar las categorías no Top 5 según su relevancia realizar llamada GET a endpoint:
+
+```
+http://localhost:8080/categories/notop
+```
+
+### Ejecutar test del proyecto
+
+- Ingresar a ruta base del proyecto y ejecutar lo siguiente por terminal
+
+```bash
+./gradlew cleanTest test -i
+```
+Luego revisar el siguiente archivo para ver los resultados :
+
+- java-recruiting-hsa/build/reports/tests/test/index.html
+
+### Instrucciones Docker
+
+ Para construir la imagen Docker
+
+ ```
+docker build -t "ecommerce_backend" .
+ ```
+
+ Para levantar contenedor de imagen Docker creada
+
+ ```
+docker run -p 9090:8080 --name ecommerce_backend ecommerce_backend:latest
+ ```
+
+ - Se incluye documentación gráfica por medio de Swagger en la ruta:
+
+```
+http://localhost:9090/swagger-ecommerce-app.html
+
+```

build.gradle

@@ -0,0 +1,33 @@
+plugins {
+	id 'org.springframework.boot' version '2.7.5'
+	id 'io.spring.dependency-management' version '1.0.15.RELEASE'
+	id 'java'
+}
+
+group = 'com.ecommerce'
+version = '0.0.1-SNAPSHOT'
+sourceCompatibility = '11'
+
+repositories {
+	mavenCentral()
+}
+
+dependencies {
+	implementation 'org.springframework.boot:spring-boot-starter-web'
+	testImplementation 'org.springframework.boot:spring-boot-starter-test'
+
+	compileOnly 'org.projectlombok:lombok:1.18.24'
+	annotationProcessor 'org.projectlombok:lombok:1.18.24'
+
+	testCompileOnly 'org.projectlombok:lombok:1.18.24'
+	testAnnotationProcessor 'org.projectlombok:lombok:1.18.24'
+
+	implementation group: 'org.springdoc', name: 'springdoc-openapi-ui', version: '1.5.12'
+
+	implementation 'org.springframework.cloud:spring-cloud-starter-openfeign:3.1.5'
+
+}
+
+tasks.named('test') {
+	useJUnitPlatform()
+}

build/bootJarMainClassName

@@ -0,0 +1 @@
+com.ecommerce.JavaRecruitingHsaApplication

build/bootRunMainClassName

@@ -0,0 +1 @@
+com.ecommerce.JavaRecruitingHsaApplication