Catálogo de Arquitectura
Mapa de dominios y microservicios de la plataforma White Label
Dominios
Ver todos (17) →Cart
1 servicioGestió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
1 servicioBandeja de entrada del cliente, notificaciones y popups, incluyendo su estado (leído, oculto, cerrado) asociado al usuario.
Servicios
Ver todos (10) →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 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.
⚠ Servicio actualmente en proceso de revisión y reimplementación completa, con el objetivo de acotar mejor sus responsabilidades y alinear el modelo de carrito y envío con los dominios de Cart y Shipping. Parte de la lógica de selección de tiendas/sellers se apoya en funcionalidades existentes en el servicio de Customers.
Servicio central de cliente que concentra múltiples responsabilidades. Expone APIs para: - Gestión del perfil de cliente (creación, actualización, desactivación, existencia). - Términos y consentimientos (OneTrust / Conta). - Notificaciones e inbox del cliente (incluyendo popups y su estado). - Direcciones del cliente y sincronización con sistemas externos como VTEX. - Preferencias (dietarias, marketing, suscripciones, tabaco). - Dispositivos asociados al cliente. - Historial y detalle de órdenes e invoices. - Información geográfica y de tiendas, consumida desde CMS/servicios externos. - Lógica para determinar tiendas/sellers que pueden despachar a una dirección, reutilizada por otros servicios a través de este endpoint.
⚠ Servicio sobrecargado que agrupa múltiples dominios funcionales. Actualmente en proceso de revisión para descomponerlo en varios microservicios más pequeños y alineados con límites de dominio claros.
Servicio central del dominio de fidelidad. Expone APIs gRPC/HTTP para: - Resumen de beneficios del cliente (puntos, nivel actual, progreso, categorías). - Consulta de niveles de loyalty y su configuración. - Gestión de la cuenta de cashback (Cencopay), incluyendo saldo, flags y bloqueos. - Historial de movimientos del programa de lealtad y pagos asociados. - Catálogo de ofertas de loyalty, categorías, vitrinas (showcases) y ofertas disponibles por nivel. - Activación, clip y unclip de ofertas vinculadas al cliente.
⚠ Existen varias APIs especializadas (benefits, Cencopay, offers) que podrían evolucionar en microservicios separados en el futuro, pero hoy se gestionan en un único microservicio.
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.