merca y ch

experiencometro.md

@@ -0,0 +1,293 @@
+Quiero que me ayudes a diseñar e implementar un apartado separado dentro de mi plataforma llamado Experienciómetro.
+
+Contexto del negocio
+
+El Experienciómetro es un módulo pensado para medir la experiencia que vive un cliente en cada sucursal/local de la marca. La idea no es solo calificar si “lo atendieron bien”, sino evaluar todo el recorrido del cliente dentro y alrededor de la sucursal: desde la llegada, la imagen exterior, la bienvenida, el ambiente, el servicio, la limpieza y los detalles que hacen que la experiencia suba o baje.
+
+Este módulo debe funcionar como una mezcla entre:
+
+dashboard de sucursales
+sistema de evaluación tipo survey/checklist
+scoring/rating por sucursal
+seguimiento de hallazgos detectados
+
+La intención es que cada sucursal tenga una calificación visible y dinámica, alimentada por evaluaciones que llenan ciertos usuarios internos (por ejemplo padrinos de casa o responsables operativos). Esa calificación debe representar la experiencia general de la sucursal.
+
+Objetivo del módulo
+
+Construir un apartado independiente dentro de la plataforma donde:
+
+Se puedan ver todas las sucursales con su score de experiencia.
+Se pueda entrar al detalle de cada sucursal.
+Exista una encuesta/checklist estructurada para evaluar la experiencia.
+Cada evaluación impacte automáticamente la calificación general de la sucursal.
+Se puedan registrar observaciones, hallazgos y áreas de mejora.
+El gerente o responsable pueda ver retroalimentación clara de su sucursal.
+Concepto del Experienciómetro
+
+El módulo debe representar la experiencia del cliente como un sistema medible.
+La experiencia no depende de una sola cosa, sino de varias dimensiones operativas.
+
+Las categorías base a evaluar serían:
+
+Exterior y llegada
+limpieza exterior
+fachada
+acceso
+señalización
+Entrada y bienvenida
+puerta abierta / acceso disponible
+recepción
+saludo
+actitud
+tiempo de respuesta
+Ambiente
+orden visual
+aroma
+música
+limpieza general
+temperatura
+mobiliario / confort
+Servicio
+rapidez
+amabilidad
+seguimiento
+atención al detalle
+actitud del personal
+Hospitalidad / detalles extra
+detalles memorables
+anticipación a necesidades
+pequeños extras que elevan la experiencia
+Operación visible
+baños
+mesas / áreas comunes
+objetos fuera de lugar
+mantenimiento visible
+
+Cada evaluación debe convertirse en un score cuantificable.
+
+Cómo debe funcionar el scoring
+
+Cada categoría tiene varios reactivos/preguntas.
+Cada reactivo debe calificarse con una escala simple, por ejemplo:
+
+0 = mal
+1 = regular
+2 = bien
+3 = excelente
+
+El sistema debe:
+
+calcular un score por categoría
+calcular un score general por evaluación
+actualizar el score general histórico de la sucursal
+
+La calificación general de la sucursal puede ser un promedio de evaluaciones recientes o un promedio ponderado. Diseña la estructura para que esto se pueda ajustar fácilmente después.
+
+Flujo del módulo
+1. Vista general del Experienciómetro
+
+Debe existir una pantalla principal separada llamada Experienciómetro.
+
+En esta vista se deben mostrar todas las sucursales como cards o filas de tabla con información como:
+
+nombre de sucursal
+score general actual
+color o semáforo
+última evaluación realizada
+cantidad de evaluaciones
+tendencia (subió, bajó o se mantuvo)
+hallazgos abiertos
+
+Esta pantalla debe permitir:
+
+buscar sucursales
+filtrar por score
+filtrar por estatus/semaforo
+entrar al detalle de cada sucursal
+iniciar una nueva evaluación
+2. Detalle de sucursal
+
+Cada sucursal debe tener una vista individual donde se vea:
+
+Header
+nombre de sucursal
+score actual
+semáforo visual
+última evaluación
+gerente / responsable
+cantidad total de evaluaciones
+Secciones principales
+resumen general
+historial de evaluaciones
+breakdown por categorías
+hallazgos / observaciones
+acciones o retroalimentación
+Visualización recomendada
+score general grande
+barras por categoría
+gráfica de tendencia histórica
+lista de últimas evaluaciones
+lista de hallazgos abiertos
+3. Formulario de evaluación / survey
+
+Debe existir una pantalla o modal para llenar una nueva evaluación.
+
+Esta evaluación debe estar organizada por bloques/categorías:
+
+Ejemplo de bloques
+
+Exterior y llegada
+
+fachada limpia
+acceso libre
+señalización clara
+
+Bienvenida
+
+puerta abierta
+alguien recibe al cliente
+saludo adecuado
+actitud positiva
+
+Ambiente
+
+música adecuada
+aroma agradable
+limpieza visual
+orden general
+temperatura cómoda
+
+Servicio
+
+rapidez
+atención
+seguimiento
+trato amable
+
+Hospitalidad
+
+hubo algún detalle extra
+el servicio fue memorable
+se anticiparon necesidades
+
+Operación visible
+
+baños limpios
+áreas comunes ordenadas
+mantenimiento visible correcto
+
+Cada reactivo debe permitir:
+
+seleccionar score
+agregar comentario opcional
+marcar observación
+adjuntar evidencia si aplica
+
+Al final del formulario:
+
+observaciones generales
+fortalezas detectadas
+áreas de mejora
+score automático calculado por el sistema
+4. Impacto en la calificación de la sucursal
+
+Cada vez que se envía una evaluación:
+
+se guarda el registro completo
+se recalcula el score promedio de la sucursal
+se actualiza la vista general
+se reflejan las nuevas métricas en dashboard y detalle
+5. Retroalimentación y hallazgos
+
+Además del survey, el módulo debe permitir guardar hallazgos/observaciones.
+
+Ejemplos:
+
+baño sucio
+recepción vacía
+bocina sin funcionar
+objeto fuera de lugar
+mala presentación visual
+
+Cada hallazgo puede tener:
+
+título
+descripción
+categoría
+prioridad
+estatus
+fecha
+responsable
+relación con una evaluación específica
+
+Esto servirá para que el gerente vea retroalimentación más accionable, no solo un número.
+
+Cómo debe verse en UI/UX
+Vista principal
+
+Quiero un módulo visual, ejecutivo y fácil de leer.
+Debe sentirse como un dashboard operativo moderno.
+
+Elementos visuales sugeridos
+cards por sucursal
+score grande y destacado
+badges tipo semáforo:
+verde = excelente
+amarillo = atención
+rojo = crítico
+barras de progreso por categoría
+gráficas de tendencia
+tabla o timeline de evaluaciones
+Navegación
+
+El Experienciómetro debe ser un apartado separado del resto de la plataforma, no algo escondido dentro de otra sección.
+
+Idealmente tendría navegación como:
+
+Experienciómetro / Resumen
+Sucursales
+Evaluaciones
+Hallazgos
+Requerimientos funcionales
+
+Diseña este módulo con arquitectura limpia y escalable.
+
+Debe contemplar:
+
+listado de sucursales
+detalle de sucursal
+formulario de evaluación
+historial de evaluaciones
+cálculo automático de score
+almacenamiento de comentarios y observaciones
+visualización de hallazgos
+dashboard general
+Requerimientos técnicos
+
+Quiero que propongas la mejor forma de estructurarlo en frontend y backend.
+
+Necesito que plantees:
+
+componentes necesarios
+vistas/páginas
+modelos de datos
+lógica de score
+relaciones entre sucursal, evaluación, categorías y hallazgos
+
+Piensa el módulo de forma reusable y mantenible.
+
+Resultado esperado
+
+Quiero que me entregues una propuesta completa para este módulo, incluyendo:
+
+estructura del apartado
+flujo del usuario
+componentes de interfaz
+modelo de datos recomendado
+lógica de scoring
+propuesta visual del dashboard
+cómo conectar la evaluación con la calificación general de cada sucursal
+
+No uses datos hardcodeados en la solución final.
+Diseña todo para que sea dinámico y escalable.