Catálogo de Arquitectura
Mapa de dominios y microservicios de la plataforma White Label
Dominios
Ver todos (19) →Cart
2 serviciosGestión del carrito de compras del cliente: creación, recuperación, actualización y validación del carrito, incluyendo items, mensajes, comentarios y reglas de sustitución.
Customer Address
1 servicioGestión de direcciones del cliente, incluyendo creación, actualización, borrado, búsqueda por código postal y sincronización con sistemas externos.
Customer Devices
1 servicioDispositivos asociados al cliente para notificaciones y funcionalidades específicas por plataforma.
Customer Notifications
2 serviciosBandeja de entrada del cliente, notificaciones y popups, incluyendo su estado (leído, oculto, cerrado) asociado al usuario. Incluye también el canal de notificaciones push al dispositivo.
Servicios
Ver todos (16) →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.
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.
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.
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.
Plataforma
Servicios transversales e integraciones externas
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.
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.
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.
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.