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 de identidad, autenticación y autorización de usuarios, así como manejo de credenciales y sesiones frente a sistemas externos.
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.
Guías recientes
Ver todas →Event-Driven Architecture: De los Fundamentos a la Implementación Real
Una guía completa para entender y aplicar la arquitectura orientada a eventos en sistemas distribuidos, desde los conceptos básicos hasta patrones avanzados como Sagas y compensaciones.
wl-coder — Guía de referencia
CLI para generar microservicios White Label con estructura lista para producción, instrumentar proyectos existentes con flujos de trabajo de IA, e inspeccionar entornos de GitHub.
Flujo de trabajo AGF — comandos y fases
Referencia práctica de los comandos slash, las fases de trabajo y cuándo usar cada uno en el día a día con Claude Code en el ecosistema WL.