Cobrar con cupones: desarrollo de una solución de integración

Abstract

[ES] “Cobrar con cupones” es un proyecto enmarcado dentro de una solución que busca atender las necesidades de las tiendas de Mercadona en Portugal, debido a un próximo cambio legislativo. El alcance del proyecto se podría resumir en la solución mediante el desarrollo de un subsistema que permitirá la gestión de lo que en el negocio se conocen como “cupones”, que serán expedidos por máquinas expendedoras a cambio de envases reciclables. Tiene una talla media, que permite que su ciclo de vida completo pueda ser abordado en un tiempo bastante acotado. El proyecto se ha concebido para no tener dependencias con desarrollos legacy, permitiendo elegir las mejores tecnologías y herramientas actuales, además de los procesos. Su integración se ha realizado mediante estándares (APIs REST, Kafka). Se trata de un proyecto de tipo Cloud Native, que se implantará en Nube de Google Cloud, a través de GKE (implementación de Kubernetes en Google Cloud). El proceso de desarrollo sigue metodologías ágiles. Utilizamos Scrum, con sprints de dos semanas. En ellas, se realizarán estimaciones de esfuerzos respecto a las tareas, para abordar el caudal de cada sprint. Para su desarrollo se ha programado las pruebas unitarias previas al diseño y codificación de la solución que se establezca, realizando de esta forma desarrollo por TDD (Test-Driven Development). Se ha diseñado la solución para el proyecto junto con el resto de miembros del equipo, y su posterior codificación en Java Spring Boot. Esta solución ha conllevado, el desarrollo de controladores para los endpoints de la API REST. La programación de un suscriptor a tópicos, para su integración con Kafka (arquitectura EDA), cuya integración se hace mediante librerías aportadas por el Framework de Mercadona. El modelado del dominio y los casos de uso, siguiendo la arquitectura hexagonal (patrón Ports and Adapters). Diseño y programación de la persistencia a través una base de datos relacional con JPA. El desarrollo de este proyecto esta guiado para su posterior despliegue en microservicios, con lo cual, herramientas como Helm han sido utilizadas durante el mismo. La integración contínua se realiza con CloudBees (Jenkins) y la entrega contínua mediante Spinnaker. La solución se irá desplegando sobre Kubernetes, en Nube de Google Cloud, en distintos entornos de staging: DEV (development), ITG (integración) y PRE (preparación), antes de la implantación definitiva en PRO (producción).

[EN] "Cashing with coupons" is a project framed within a solution that seeks to meet the needs of Mercadona stores in Portugal, due to an upcoming legislative change. The scope of the project could be summarized in the solution through the development of a subsystem that will allow the management of what in the business are known as "coupons", which will be issued by vending machines in exchange for recyclable packaging. It has a medium size, which allows its complete life cycle to be addressed in a fairly short time. The project has been conceived not to have dependencies with legacy developments, allowing to choose the best current technologies and tools, in addition to the processes. Its integration will be done through standards (REST APIs, Kafka). It is a Cloud Native type project, which will be implemented in Google Cloud, through GKE (Kubernetes implementation in Google Cloud). The development process follows agile methodologies. We use Scrum, with two-week sprints. In them, effort estimations will be made with respect to tasks, to address the flow of each sprint. Programming of unit tests prior to the design and coding of the solution to be established, thus performing development by TDD (Test-Driven Development). The solution for the project will be designed together with the rest of the team members, and its subsequent coding in Java Spring Boot. This solution will involve the development of drivers for the REST API endpoints. The programming of a subscriber to topics, for its integration with Kafka (EDA architecture), whose integration will be done through libraries provided by the Mercadona Framework. The modeling of the domain and use cases, following the hexagonal architecture (Ports and Adapters pattern). Design and programming of the persistence through a relational database with JPA. The development of this project will be guided for its later deployment in microservices, so tools such as Helm will be used during the project. The continuous integration will be done with CloudBees (Jenkins) and the continuous delivery with Spinnaker. The solution will be deployed on Kubernetes, in Google Cloud, in different staging environments: DEV (development), ITG (integration) and PRE (preparation), before the final implementation in PRO (production).

[CA] “Cobrar amb cupons” és un projecte emmarcat dins d’una solució que busca atendre les necessitats de les botigues de Mercadona a Portugal, a causa d’un pròxim canvi legislatiu. L’abast del projecte es podria resumir en la solució mitjançant el desenvolupament d’un subsistema que permetrà la gestió del que en el negoci es coneixen com a “cupons”, que seran expedits per màquines expenedores a canvi d’envasos reciclables. Té una talla mitjana, que permet que el seu cicle de vida complet puga ser abordat en un temps bastant delimitat. El projecte s’ha concebut per a no tindre dependències amb desenvolupaments legacy, permetent triar les millors tecnologies i eines actuals, a més dels processos. La seua integració es farà mitjançant estàndards (APIs REST, Kafka). Es tracta d’un projecte de tipus Cloud Native, que s’implantarà en Núvol de Google Cloud, a través de GKE (implementació de Kubernetes en Google Cloud). El procés de desenvolupament segueix metodologies àgils. Utilitzem Scrum, amb sprints de dues setmanes. En elles, es realitzaran estimacions d’esforços respecte a les tasques, per a abordar el cabal de cada sprint. Programació de les proves unitàries prèvies al disseny i codificació de la solució que s’establisca, realitzant d’aquesta manera desenvolupe per TDD (Test-Driven Development). Es dissenyarà la solució per al projecte juntament amb la resta de membres de l’equip, i la seua posterior codificació a Java Spring Boot. Aquesta solució comportarà, el desenvolupament de controladors per als endpoints de la API REST. La programació d’un subscriptor a tòpics, per a la seua integració amb Kafka (arquitectura EDA), la integració de la qual es farà mitjançant llibreries aportades pel Framework de Mercadona. El modelatge del domini i els casos d’ús, seguint l’arquitectura hexagonal (patró Ports and Adapters). Disseny i programació de la persistència a través una base de dades relacional amb JPA. El desenvolupament d’aquest projecte estarà guiat per al seu posterior desplegament en microserveis, amb la qual cosa, eines com Helm seran utilitzades durant aquest. La integració contínua es realitzarà amb CloudBees (Jenkins) i el lliurament contínua mitjançant Spinnaker. La solució s’anirà desplegant sobre Kubernetes, en Núvol de Google Cloud, en diferents entorns de staging: DEV (development), ITG (integració) i PRE (preparació), abans de la implantació definitiva en PRO (producció).