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.
¿Eres nuevo en el equipo?
Levanta el ambiente local paso a paso — desde cero hasta tu primera petición a la API.
Catálogo de Arquitectura
Ver mapa completo →Catálogo y experiencia de producto: definición y atributos de productos, búsqueda y descubrimiento (keyword, categoría, colección), detalles enriquecidos, facets para filtrar resultados, y recomendaciones de productos (frecuentes, similares, bestsellers y personalizadas).
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.
Bandeja 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.
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. - Premios y beneficios del cliente (loyalty prizes). - 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. - Gestión de puntos del programa JumboMas (`ar-jumbo`). - 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 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.
Guías recientes
Ver todas →Component Testing: la estrategia de pruebas estándar en White Label
Por qué reemplazamos las pruebas unitarias por component tests contra la API real, sus ventajas y desventajas, y un tutorial paso a paso con código real de core-lists y engine-promotions.
Convención de PRs y Commits (v2)
Fuente de verdad para nombrar Pull Requests y commits en los servicios del rancho WL.
Decisiones de diseño: fusión de convención de commits y PRs
Registro de las decisiones de diseño detrás de la convención de PRs y commits del rancho WL.