PerfectApp

Resumen del Proyecto

PerfectApp es una plataforma B2B de automatización de fuerza de ventas y lealtad de clientes construida para empresas de consumo masivo (CPG) que operan en México. La landing page pública presenta el producto, pero detrás de la autenticación existe un sistema operativo completo que conecta representantes de ventas de campo, coordinadores, administradores y dueños de tiendas de retail a través de interfaces específicas por rol.

La plataforma digitaliza todo el flujo de ruta al mercado: los representantes de campo visitan clientes de retail, registran datos de competencia e inventario, generan órdenes de compra y recopilan evidencia fotográfica a través de un formulario estructurado multi-paso. Los administradores validan órdenes, otorgan puntos de lealtad y gestionan el calendario promocional. Los clientes de retail siguen su progreso de compras, acumulan puntos y canjean recompensas.

Arquitectura del Sistema

Control de Acceso Multi-Rol

La plataforma sirve múltiples roles de usuario, cada uno con su propia sección de la aplicación y control de acceso del lado del servidor:

• Admin - Panel de gestión back-office con módulos operativos para validación de prospectos, aprobación de órdenes, gestión de puntos, calendario promocional y exportación de datos.
• Representante de Campo - Dashboard con progreso de cuota mensual, métricas de efectividad por cliente y un wizard de registro de visitas multi-paso para registrar datos de campo.
• Coordinador - Vista de supervisión para monitorear el desempeño, cuotas y actividad de representantes de campo individuales.
• Cliente Retail - Portal de lealtad mostrando progreso de compras contra cuota, balance de puntos, banners promocionales y catálogo de recompensas.
• Analista - Acceso de solo lectura a dashboards de resumen y exportaciones de datos CSV.

Diseño Multi-Tenant

El sistema soporta múltiples empresas desde un solo despliegue. El aislamiento de datos entre tenants se maneja en la capa de aplicación a través de consultas con scope de sesión, de modo que cada empresa ve solo sus propios datos sin necesidad de infraestructura separada.

Funcionalidades Clave

Flujo de Visitas en Campo

El ciclo operativo central de la plataforma. Los representantes de campo completan un formulario de 3 etapas durante cada visita a cliente:

1. Evaluación - productos de competencia, precios y evidencia fotográfica.
2. Inventario y Órdenes - revisión de inventario, creación de orden de compra con selección de SKU y aplicación de promociones, o motivo de no compra.
3. Comunicación - estado de ejecución del plan de comunicación, revisión de materiales y fotos de evidencia.

El estado del formulario persiste entre recargas de página usando Redux Toolkit con persistencia local, lo cual es crítico para representantes de campo trabajando en dispositivos móviles con conectividad irregular. Al enviar, el sistema crea un registro de visita y una orden pendiente, y envía una notificación de resumen a los stakeholders relevantes.

Sistema de Puntos de Lealtad

El programa de lealtad incentiva a los clientes de retail a mantener volúmenes de compra consistentes:

• Los puntos se otorgan cuando los administradores validan órdenes de compra.
• Los valores de puntos son configurables por producto y nivel de cliente.
• Los clientes que exceden su cuota mensual de compras pueden ganar multiplicadores de bonificación.
• Los puntos se canjean por recompensas físicas a través de un catálogo en el portal del cliente.
• El flujo de validación asegura que los puntos solo se acreditan después de que las órdenes son revisadas y aprobadas.

Operaciones de Admin

El panel de admin centraliza las tareas de back-office:

• Revisar y aprobar órdenes pendientes para activar la asignación de puntos.
• Validar nuevos prospectos de clientes enviados por representantes de campo e incorporarlos al sistema.
• Configurar calendarios promocionales, valores de puntos y banners para clientes.
• Exportar datos de ventas, precios e inventario como archivos CSV para análisis offline.
• Monitorear cumplimiento de cuotas por zona y señalar clientes que excedieron objetivos.

Decisiones Técnicas

Capa de Base de Datos

El proyecto usa MongoDB con Prisma para definición de esquema y generación de tipos. Las consultas de negocio complejas (cálculos de cuota, consolidación de ventas en múltiples dimensiones, joins entre colecciones) se manejan a través de pipelines de agregación optimizados que serían difíciles de expresar con una API de consultas ORM estándar.

Gestión de Estado

Redux Toolkit maneja el estado de la aplicación, con persistencia local para el wizard de visitas. Esto resuelve un problema real: los representantes de campo en zonas rurales pierden conectividad a mitad de visita, y el formulario necesita sobrevivir una recarga de página sin perder datos.

Renderizado del Lado del Servidor

Cada página autenticada carga datos en el servidor y los pasa como props. Esto asegura que los usuarios siempre vean datos frescos y que el control de acceso por roles se aplique antes de que cualquier contenido llegue al cliente.

Stack Técnico

Capa	Tecnología
Framework	Next.js 14 (SSR)
Base de Datos	MongoDB + Prisma
Auth	NextAuth.js
Estado	Redux Toolkit
Formularios	React Hook Form + Zod
Estilos	SCSS Modules
Deploy	Vercel

Impacto

• Reemplazó flujos de trabajo manuales en hojas de cálculo con un proceso digital estructurado y auditable para operaciones de campo.
• El programa de lealtad crea un ciclo de incentivos medible entre la marca CPG y los dueños de tiendas de retail.
• Los administradores obtienen visibilidad en tiempo real sobre la ejecución en campo, cumplimiento de cuotas y pipelines de órdenes por zona.
• Las exportaciones CSV alimentan analítica downstream, permitiendo a los equipos de trade y marketing tomar decisiones basadas en datos.