Servicios
9 serviciosServicio 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.
Servicio de integración orientado a recibir notificaciones de sistemas externos y traducirlas a eventos internos de la plataforma. Actualmente se utiliza para: - Consumir mensajes de cambios en el CMS / Remote Config a través de colas SQS. - Transformar esos mensajes en eventos propios del sistema. - Publicar dichos eventos en NATS para que otros microservicios actualicen sus configuraciones o caches.
⚠ A pesar del nombre, este servicio no gestiona notificaciones visibles para el usuario final. Actúa como bridge entre Remote Config/CMS y el bus interno (NATS). Candidato a ser renombrado en el futuro para reflejar mejor su rol orientado a Remote Config y sincronización de configuración.
Servicio responsable de la ficha de producto. Expone APIs HTTP para obtener información detallada de un producto, utilizando un modelo de datos muy similar al de Search, pero enriquecido con: - Detalles adicionales del producto. - Ingredientes y atributos específicos. - Recomendaciones de productos relacionados. - Información extendida para la pantalla de detalle.
⚠ Comparte esquema de datos de producto con el servicio de Search, lo que genera solapamiento entre ambos. Actualmente se utiliza sólo para la pantalla de detalles, mientras que Search cubre discovery y listados. Existe una discusión abierta sobre desmantelar este servicio y mover la responsabilidad de detalle de producto a Search, reduciendo duplicación de modelo y lógica.
Servicio responsable de la búsqueda y descubrimiento de productos. Expone APIs gRPC/HTTP para: - Top searches y sugerencias de búsqueda. - Autocomplete y autosuggest combinando términos y productos relacionados. - Búsqueda de productos por keyword, categoría y colección. - Obtención de facets y opciones de filtrado para resultados de búsqueda. - Información de paginación, ordenación y filtros aplicados sobre los resultados.
⚠ Servicio bien acotado al dominio de búsqueda de productos. Comparte el modelo de datos de producto con el microservicio de Product, que actualmente se usa para la pantalla de detalle. Existe una discusión abierta sobre consolidar ambas responsabilidades en Search y desmantelar el micro de Product.
Servicio responsable de calcular y devolver promociones aplicables a productos y/o carritos. Implementa reglas de priorización para determinar qué promociones son más beneficiosas para el usuario en un contexto dado, resolviendo conflictos entre múltiples ofertas y combinaciones posibles.
⚠ Servicio HTTP enfocado en lógica de negocio de promociones. Está pendiente de exponer también una interfaz gRPC para alinearse con el resto de los servicios core de la plataforma y facilitar su consumo desde otros micros.
Servicio legado que maneja autenticación y sesiones de usuarios, incluyendo generación de tokens y gestión de credenciales para sistemas externos como VTEX.
⚠ Está en proceso de estrangulación y deprecación en favor del servicio Auth.
Ningún servicio coincide con los filtros.