Catálogo de Arquitectura

Mapa de dominios y microservicios de la plataforma White Label

19 dominios 16 servicios 4 plataforma
White Label · Mapa Global

Servicio responsable de la autenticación en el sistema. Genera y valida access tokens y refresh tokens, y gestiona credenciales de sistemas externos como VTEX, almacenando cookies y sesiones en la base de datos de identidad.

Cart (legacy) Repo ↗

Servicio legado responsable del carrito de compras del cliente. Expone APIs gRPC/HTTP para: - Crear y recuperar carritos por identificador y usuario. - Añadir, actualizar, parchear y eliminar items del carrito. - Gestionar mensajes y comentarios asociados al carrito y a items específicos. - Actualizar datos de envío del carrito (dirección, tipo de entrega, tipo de dirección). - Validar el carrito en base a reglas de negocio, grupos de cliente y contexto de entrega. - Configurar el tipo de sustitución de productos en caso de falta de stock.

⚠ Reemplazado por el microservicio [Carts](/catalog/services/dc-wl-groceries-core-carts) (`dc-wl-groceries-core-carts`, notar la "s" final que distingue a ambos repos), una reimplementación completa que sí cumple con todas las definiciones de la arquitectura White Label y añade mejoras de performance y lógica de negocio. Carts ya está desplegado en producción en `br-prezunic`; el resto de los tenants está en proceso de revisión y rollout progresivo. Este servicio (Cart legacy) se irá deprecando tenant por tenant a medida que Carts se valida y despliega.

cart shipping legacy being-replaced deprecated-in-br-prezunic

Reimplementación completa del carrito de compras del cliente sobre la arquitectura White Label. Expone APIs gRPC/HTTP para: - Crear, recuperar y eliminar carritos por identificador y usuario. - Añadir, actualizar y eliminar items del carrito (patch masivo e individual). - Gestionar mensajes y comentarios asociados al carrito. - Actualizar datos de envío del carrito (dirección, tienda de despacho, tipo de entrega, tipo de dirección) y simular el carrito para un contexto dado. - Validar el carrito en base a reglas de negocio, grupos de cliente y contexto de entrega. - Configurar el tipo de sustitución de productos en caso de falta de stock.

⚠ Reemplaza a [Cart legacy](/catalog/services/dc-wl-groceries-core-cart) (`dc-wl-groceries-core-cart`, sin "s" final). A diferencia del servicio anterior, cumple con todas las definiciones de la arquitectura White Label (cuatro capas, API-first con Protobuf, multi-tenant por FX, eventos vía NATS) y suma mejoras de performance y de lógica de carrito/shipping. Ya está desplegado con éxito en `br-prezunic`; el resto de los tenants está en revisión y se irá habilitando de forma progresiva mientras se depreca el microservicio anterior.

cart shipping wl-architecture rollout-in-progress
Catalog Repo ↗

Servicio unificado de catálogo. Consolida en un solo microservicio, un solo contrato y una sola capa de cálculo de precios lo que antes vivía repartido entre [Product Search (legacy)](/catalog/services/dc-wl-groceries-core-search) y [Product Detail (legacy)](/catalog/services/dc-wl-groceries-core-products). Expone 21 RPCs gRPC + grpc-gateway HTTP, API-first sobre Protobuf, para: - Búsqueda/discovery: keyword search, navegación por categoría/colección, facets, autocomplete, autosuggest, productos relacionados, top searches (Constructor.io con fallback a VTEX/VIS). - Producto/detalle: obtención por id/sku/slug/ean (individual y batch), con resolución in-process del producto base (VTEX Catalog) más overlay de stock/precio en tiempo real (VIS). - Enriquecimiento por tenant: productType/food, PPUM formateado, showAddToCart, tags de promoción, info-tags, display ads (CMedia).

⚠ Construido y validado a paridad en vivo contra los dos servicios legacy en los 4 tenants activos (`ar-jumbo`, `ar-disco`, `co-jumbo`, `br-prezunic`), con un harness de paridad offline reproducible. Todavía en pruebas: hay que acelerar la validación para completar la migración y deprecar Search y Product legacy. Reduce ~44% del código de producción y pasa de operar 2 servicios a 1, eliminando el riesgo de que la lógica de precio/medida diverja entre búsqueda y detalle.

product search wl-architecture in-testing replaces-search-and-product

Plataforma

Servicios transversales e integraciones externas

Ver todos (4) →
BFF (Backend for Frontend) interno
Repo ↗

Punto de entrada unificado para la aplicación móvil White Label. Agrega y orquesta llamadas a múltiples microservicios internos para componer las respuestas que necesita cada pantalla. No implementa lógica de dominio propia: su responsabilidad es adaptar la API interna al contrato que espera el cliente móvil.

⚠ No pertenece a ningún dominio de negocio. Funciona como pieza transversal de orquestación hacia el cliente.

tenants: multi-tenant
bff orchestration
Business Manager externo
Docs ↗

Herramienta interna de Cencosud para gestionar configuraciones remotas de la plataforma White Label. Actúa como CMS de configuración: permite administrar parámetros, features y contenido que los microservicios consumen a través del dominio de Remote Config. Al ser transversal a casi todos los servicios, las relaciones individuales no se documentan explícitamente.

tenants: multi-tenant
cms remote-config configuration
Constructor externo
Docs ↗

Plataforma de búsqueda y descubrimiento de productos para ecommerce enterprise. Utiliza NLP, ranking con machine learning y personalización colaborativa para potenciar experiencias de búsqueda, navegación por categorías, recomendaciones y más. White Label la integra como motor de search y discovery de productos.

tenants: co-jumbo
search product-discovery provider
VTEX externo
Docs ↗

Plataforma externa de ecommerce utilizada como sistema de registro para catálogo de productos, gestión de órdenes, autenticación de clientes y configuración de sellers y tiendas. Varios microservicios de White Label consumen sus APIs para sincronizar estado y delegar operaciones comerciales.

tenants: multi-tenant
ecommerce provider