{"id":30894851,"url":"https://github.com/mikybars/spring-boot-prices-mic","last_synced_at":"2026-05-05T17:33:25.005Z","repository":{"id":284954462,"uuid":"956608772","full_name":"mikybars/spring-boot-prices-mic","owner":"mikybars","description":null,"archived":false,"fork":false,"pushed_at":"2025-07-30T14:11:15.000Z","size":90,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-16T14:35:29.758Z","etag":null,"topics":["approval-testing","archunit","gradle","hexagonal-architecture","junit5","mockito","openapi-generator","spring-boot"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mikybars.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-03-28T14:45:04.000Z","updated_at":"2025-08-05T06:37:23.000Z","dependencies_parsed_at":null,"dependency_job_id":"7c062369-e3fe-4003-b2dc-1b03d9435a3d","html_url":"https://github.com/mikybars/spring-boot-prices-mic","commit_stats":null,"previous_names":["mikybars/code-challenge","mikybars/spring-boot-prices-mic"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mikybars/spring-boot-prices-mic","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mikybars%2Fspring-boot-prices-mic","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mikybars%2Fspring-boot-prices-mic/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mikybars%2Fspring-boot-prices-mic/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mikybars%2Fspring-boot-prices-mic/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mikybars","download_url":"https://codeload.github.com/mikybars/spring-boot-prices-mic/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mikybars%2Fspring-boot-prices-mic/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32660358,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-05T11:29:49.557Z","status":"ssl_error","status_checked_at":"2026-05-05T11:29:48.587Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["approval-testing","archunit","gradle","hexagonal-architecture","junit5","mockito","openapi-generator","spring-boot"],"created_at":"2025-09-08T21:34:32.487Z","updated_at":"2026-05-05T17:33:24.987Z","avatar_url":"https://github.com/mikybars.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build and Test](https://github.com/mikybars/code-challenge/actions/workflows/test.yml/badge.svg)](https://github.com/mikybars/code-challenge/actions/workflows/test.yml)\n[![Coverage Status](https://coveralls.io/repos/github/mikybars/code-challenge/badge.svg?branch=main)](https://coveralls.io/github/mikybars/code-challenge?branch=main)\n\n# Servicio de precios\n\n## Descripción\n\nEsta aplicación implementa un servicio para la gestión y consulta de precios de productos en un \ncomercio electrónico expuesto a través de una API REST. Permite obtener el precio aplicable a un\nproducto específico según la fecha de consulta y la cadena comercial, teniendo en cuenta las\ndiferentes tarifas y prioridades configuradas en el sistema.\n\n## Uso\n\n### Requisitos previos\n\n* JDK ≥ 21 (por ejemplo [Eclipse Temurin](https://adoptium.net/temurin/releases/?version=21))\n\n### Ejecutar los tests\n\n```bash\n./gradlew test\n```\n\n### Probar la aplicación\n\nPrimero será necesario levantar la aplicación:\n```bash\n./gradlew bootRun --args='--spring.profiles.active=standalone'\n```\n\nLa aplicación usará el puerto 8080 de forma predeterminada y tendrá los siguientes datos preconfigurados:\n\n| BRAND ID | START DATE          | END DATE            | PRICE LIST | PRODUCT ID | RANK | AMOUNT | CURRENCY |\n| -------- | ------------------- | ------------------- | ---------- | ---------- |------|--------|----------|\n| 1        | 2020-06-14-00.00.00 | 2020-12-31-23.59.59 | 1          | 35455      | 0    | 35.50  | EUR      |\n| 1        | 2020-06-14-15.00.00 | 2020-06-14-18.30.00 | 2          | 35455      | 1    | 25.45  | EUR      |\n| 1        | 2020-06-15-00.00.00 | 2020-06-15-11.00.00 | 3          | 35455      | 1    | 30.50  | EUR      |\n| 1        | 2020-06-15-16.00.00 | 2020-12-31-23.59.59 | 4          | 35455      | 1    | 38.95  | EUR      |\n\nPara enviar una petición de consulta, el proyecto incluye una colección y un entorno de Postman.\nAlternativamente se puede utilizar la siguiente orden:\n\n```bash\ncurl --location 'http://localhost:8080/prices?applicationDate=2020-06-14T15%3A00%3A00Z\u0026productId=35455\u0026brandId=1'\n```\n\n## Stack tecnológico\n\n### Principal\n- Spring Boot 3.4.4\n- Java 21\n- Gradle 8.13\n- Spring Web MVC\n- Spring Data JPA\n\n### Base de datos\n- H2: Base de datos en memoria\n\n### Herramientas de desarrollo\n- MapStruct: Mapeo de objetos\n- Lombok: Reducción de código boilerplate\n- [OpenAPI Generator](https://github.com/OpenAPITools/openapi-generator): Generación de código a partir de especificaciones OpenAPI\n- [Spring Boot starter para la gestión de errores mediante configuración](https://github.com/wimdeblauwe/error-handling-spring-boot-starter)\n\n### Testing\n- JUnit 5\n- AssertJ\n- Mockito\n- [Spring Test Slices](https://docs.spring.io/spring-boot/appendix/test-auto-configuration/slices.html)\n- [Approval Tests](https://www.youtube.com/watch?v=QEdpE0chA-s): verificación de tests simplificada para objetos complejos\n- [ArchUnit](https://www.archunit.org/): tests de arquitectura y convenciones de programación\n\n## Arquitectura\n\nEl proyecto implementa una [arquitectura hexagonal](https://alistair.cockburn.us/hexagonal-architecture/) (también conocida como _Ports and Adapters_)\nque [se ve reflejada en su estructura](https://blog.cleancoder.com/uncle-bob/2011/09/30/Screaming-Architecture.html) y que es [verificada mediante el uso\nde tests unitarios](https://www.archunit.org/).\n\nAdemás sigue un enfoque API First, por el cual los componentes encargados de manejar las peticiones\nREST son autogenerados a partir de una especificación previa.\n\n## Testing\n\nEl proyecto cuenta con una batería completa de pruebas que incluye:\n\n* Tests unitarios para verificar la correcta interacción entre los componentes del sistema con el\napoyo de mocks\n* Tests de validación de contrato OpenAPI\n* Tests de integración para las consultas de base de datos\n* Tests E2E con el camino esperado\n* Tests de validación de arquitectura y buenas prácticas de codificación\n\n## API REST\n\n```\nGET /prices\n```\n\nEste endpoint permite consultar precios de productos según varios criterios.\n\n### Parámetros requeridos\n\n| Parámetro     | Tipo     | Descripción                                |\n|---------------|----------|-------------------------------------------|\n| productId     | Long     | Identificador del producto                |\n| brandId       | Long     | Identificador de la cadena del grupo      |\n| date          | String   | Fecha de aplicación (formato: yyyy-MM-dd-HH.mm.ss) |\n\n### Ejemplo de uso\n\nPetición:\n```\nGET /prices?productId=35455\u0026brandId=1\u0026date=2020-06-14-10.00.00\n```\n\nRespuesta:\n```json\n{\n    \"productId\": 35455,\n    \"brandId\": 1,\n    \"priceList\": 1,\n    \"startDate\": \"2020-06-14-00.00.00\",\n    \"endDate\": \"2020-12-31-23.59.59\",\n    \"price\": 35.50\n}\n```\n\n### Códigos de respuesta\n\n- 200: Éxito - Retorna el precio aplicable\n- 400: Error de validación - Parámetros incorrectos\n- 404: No encontrado - No existe precio para los criterios especificados\n- 500: Error interno del servidor\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmikybars%2Fspring-boot-prices-mic","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmikybars%2Fspring-boot-prices-mic","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmikybars%2Fspring-boot-prices-mic/lists"}