Caso de estudio · Plataforma SaaS de fidelización · En producción
VecinoClub
Plataforma serverless de fidelización para comercios locales de Chile
El problema
Los comercios locales necesitan construir una relación con quienes vuelven a comprar, más allá de cada venta.
Muchos no tienen cómo agradecer la preferencia de sus clientes ni saber quiénes son o con qué frecuencia regresan.
Imaquinaria, tienda de manga y cultura japonesa en Temuco, es el primer comercio y banco de pruebas de VecinoClub.
La plataforma en uso
Interfaz real con datos de ejemplo. Camila Rojas es una persona ficticia; los saldos, compras y recompensas no corresponden a clientes reales.
VecinoClub × Imaquinaria
Una experiencia que acompaña cada visita
Del primer escaneo a la siguiente recompensa: así se ve VecinoClub en el celular de un cliente.
Recorrido del cliente
Explora cinco pasos para conocer las pantallas y decisiones de la experiencia.
Paso 01 de 05
Registro y escaneo
- El cliente escanea el QR del comercio para entrar desde el navegador.
- Su club y sus beneficios quedan disponibles en el celular, sin instalar una app.
Vistas móviles
Pantallas del celular
Desliza o usa las flechas para recorrer en ciclo continuo las vistas de cada pantalla en tema claro y oscuro.
La solución
Experiencia del cliente
- — Escanea un código QR para entrar, sin instalar una app
- — Consulta sellos y puntos desde el celular
- — Revisa sus compras y beneficios disponibles
- — Canjea recompensas del comercio
Panel del comercio
- — Define beneficios y condiciones del programa
- — Registra compras en caja
- — Gestiona recompensas y sellos
- — Consulta estadísticas de clientes y compras
Arquitectura
GitHub Actions — despliegue de frontend (S3 / CloudFront) y backend (sam deploy). Gate manual requerido antes de producción.
Decisiones técnicas clave
Multi-tenant desde el inicio
El sistema se diseñó desde el primer día para más de un comercio: cada consulta lleva el identificador del comercio, así que sumar uno nuevo es registrarlo, sin tocar la lógica de negocio. Imaquinaria sigue siendo el primer club y el programa Bushidō es una configuración de la plataforma, no su límite.
DynamoDB single-table
ADR-0006Más de diez entidades comparten una tabla. Las claves PK/SK se modelan según los patrones de acceso y cada consulta incorpora el identificador del comercio.
Pipeline con gate manual
ADR-0023GitHub Actions despliega a staging automáticamente. Producción requiere aprobación manual vía issue. Cinco bugs capturados en staging antes de llegar al sistema real.
Migraciones de datos como código
ADR-0019Runner Python idempotente integrado en el pipeline CI/CD. Cada cambio de datos en DynamoDB pasa por PR, se versiona en git, y se aplica automáticamente en el deploy — cero pasos manuales post-deploy.
Producción — métricas reales
Datos de CloudWatch · Lambda + API Gateway + DynamoDB · últimos 30 días
Architecture Decision Records
Cada decisión técnica no obvia quedó registrada con contexto, alternativas consideradas y consecuencias. El proyecto acumula 23 ADRs. Los cuatro más representativos están disponibles como documentos públicos:
Caso de uso: el Bushidō de Imaquinaria
El Bushidō de Imaquinaria
Sistema de niveles con multiplicadores de puntos — los multiplicadores no son arbitrarios: están calibrados para que el canje de recompensas sea atractivo exactamente en el volumen de compra promedio del cliente de Imaquinaria.