Arquitectura y decisiones de ingeniería
Documentación viva de nuestra plataforma: fundamentos, dominios, microservicios, integraciones y decisiones de arquitectura.
Por dónde empezar
Ver todos →Qué es White Label
Introducción al proyecto White Label: qué es, por qué existe, qué problema resuelve y cómo está organizado técnicamente.
Arquitectura White Label
Cómo está diseñado técnicamente el sistema: las cuatro capas, los principios que guían cada decisión y por qué la arquitectura toma la forma que toma.
El modelo multi-tenant
Cómo White Label soporta múltiples marcas sobre la misma base de código: un binario por tenant, inyección de dependencias con FX y una jerarquía clara para modelar las diferencias entre marcas.
Comunicación orientada a eventos
Cómo los microservicios de White Label se comunican a través de eventos: el modelo de mensajería, producers, consumers, observabilidad distribuida y la transición hacia un sistema desacoplado.
Catálogo de Arquitectura
Ver mapa completo →Gestión de identidad, autenticación y autorización de usuarios, así como manejo de credenciales y sesiones frente a sistemas externos.
Catálogo y experiencia de producto: definición y atributos de productos, búsqueda y descubrimiento (keyword, categoría, colección), detalles enriquecidos, recomendaciones y facets para filtrar resultados.
Gestió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.
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 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.
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.