Miniso México — Backend de Integración para Programa de Lealtad
El backend de integración en producción del programa de lealtad de Miniso México, que conecta la tienda en VTEX, Aptos CRM y la app móvil.
En resumen
- 01Problema
- El programa de lealtad de Miniso México abarca tres sistemas: la tienda en VTEX, Aptos CRM y una app móvil. Los clientes se registran y consultan sus puntos desde cualquiera de los dos canales, y cada dato tiene que venir del sistema que lo controla.
- 02Mi responsabilidad
- Implementé y fui responsable, por mi cuenta, de la capa de integración del backend en producción, dentro de una arquitectura de alto nivel definida por mi manager: los servicios que conectan VTEX, Aptos CRM y la app móvil, además de la persistencia, la recuperación, la conciliación y los reportes.
- 03Reto de arquitectura
- VTEX controla el registro de clientes y Aptos controla los puntos de lealtad, mientras que el registro a través de VTEX Master Data V1 podía fallar de forma intermitente. El backend tiene que mantener ambos flujos en marcha sin convertirse en una fuente de verdad que compita con ellos.
- 04Resultado
- Una capa de integración en producción por la que pasaban todos los flujos de registro y de puntos, con recuperación programada, conciliación automática y manual, y reportes de negocio.
Arquitectura
Tres sistemas, una capa de integración
Canales
- Tienda VTEXRegistro de clientes y consulta de puntos de lealtad
- App móvilRegistro de clientes y consulta de puntos de lealtad
Capa de integración
- Backend de integración · Node.js / ExpressTodos los flujos relevantes pasan por él. Desplegado en CentOS 8.
- Orquesta los flujos de registro y de puntos
- Guarda datos de registro y de transacciones (MongoDB)
- Recuperación cada hora de operaciones pendientes
- Conciliación automática y manual
- Reportes de negocio y operación
- Backend de integración · Node.js / ExpressTodos los flujos relevantes pasan por él. Desplegado en CentOS 8.
Sistemas de registro
- VTEXFuente de verdad del registro de clientes
- Aptos CRMFuente de verdad de los puntos de lealtad
Fuente de verdad
Principio de arquitectura
Fuentes de verdad explícitas
La arquitectura, definida por mi manager, le da a cada sistema una responsabilidad: VTEX es la fuente de verdad del registro de clientes y Aptos CRM es la fuente de verdad de los puntos de lealtad. El backend que implementé orquesta los flujos y guarda sus propios registros para recuperación, conciliación y reportes, pero nunca un saldo de puntos autoritativo. Si los valores de puntos difieren, prevalece Aptos.
Flujos y operación
Cómo pasan el registro y los puntos por el backend
Flujo de registro
- 01VTEX o app móvilEl cliente se registra
- 02Backend de integraciónRecibe y registra la solicitud
- 03VTEX + Aptos CRMRegistro del cliente en VTEX; registro de lealtad propagado a Aptos
Flujo de puntos de lealtad
- 01VTEX o app móvilSolicita información de lealtad
- 02Backend de integraciónConsulta a Aptos en nombre del canal
- 03Aptos CRMDevuelve los puntos actuales
- 04Backend de integraciónDevuelve la respuesta
- 05Canal solicitanteMuestra los puntos actuales
Flujo de registro
El registro empieza en la tienda en VTEX o en la app móvil y siempre pasa por el backend. VTEX controla el registro del cliente, y el backend propaga a Aptos CRM el registro de lealtad correspondiente.
Flujo de puntos de lealtad
Cuando la tienda o la app piden los puntos de un cliente, el backend consulta a Aptos CRM y devuelve el valor actual al canal que lo pidió. Los puntos se leen de Aptos, no de los datos propios del backend.
Resiliencia operativa
El registro a través de VTEX Master Data V1 podía fallar de forma intermitente. Implementé un proceso programado cada hora que reprocesa en lotes los registros y las operaciones pendientes, con las operaciones recuperables encoladas para una corrida posterior. Algunos errores venían de fuera del control del backend y no podían recuperarse automáticamente.
Conciliación
El backend permite la conciliación automática y manual de operaciones y datos relacionados con la lealtad.
Métricas y reportes
Reportes solicitados por el Director de E-commerce, generados a partir de los flujos de registro y de transacciones: usuarios registrados, usuarios que activaron su registro de lealtad, usuarios registrados que no lo activaron, las selecciones hechas durante el registro e información relacionada con las transacciones.
Para lectores técnicos
Detalle técnico
Contexto
El programa de lealtad de Miniso México, entregado como proyecto de Corebiz. Los clientes se registran en la tienda en VTEX o en la app móvil y consultan sus puntos desde cualquiera de los dos canales. El backend es la capa de integración entre VTEX, Aptos CRM y la app móvil, y todos los flujos relevantes pasan por él.
Responsabilidad
- Implementé la capa de integración del backend en producción; trabajé solo en el backend.
- Construí los servicios que conectan VTEX, Aptos CRM y la app móvil, incluidos los servicios que la app consume para el registro y la consulta de puntos.
- Implementé los flujos de persistencia, sincronización, recuperación, conciliación y reportes.
- La arquitectura de alto nivel la definió mi manager; yo fui responsable de su implementación en el backend.
Complejidad
- Tres sistemas con responsabilidades distintas, y dos de ellos autoritativos para datos distintos.
- Fallas intermitentes de registro en VTEX Master Data V1, algunas fuera del control del backend.
- Dos canales, la tienda y la app móvil, que comparten los mismos flujos de registro y de lealtad.
Arquitectura
- Servicios REST en Node.js y Express, consumidos por la tienda y por la app móvil.
- MongoDB para los datos del lado del backend, incluida información de registro de usuarios y de transacciones. No guarda el saldo de puntos autoritativo.
- Un proceso programado cada hora con una cola para las operaciones recuperables, procesadas en lotes.
- Desplegado y operado sobre CentOS 8.
Alternativas y trade-offs
- La recuperación corre de forma programada, así que un registro recuperado se completa en una corrida posterior y no de inmediato.
- Los errores que se originan fuera del backend no pueden recuperarse automáticamente y requieren seguimiento manual; para eso existe la conciliación manual.
Resultado
- Una sola capa de integración para el registro y los puntos de lealtad entre la tienda, la app móvil y Aptos CRM.
- Propiedad clara de los datos, con Aptos CRM como autoridad de los puntos y VTEX del registro de clientes.
- Recuperación programada de las fallas intermitentes de registro, además de conciliación automática y manual.
- Reportes de negocio y de operación para la dirección de e-commerce.