Cierre de Ventas
Convierte el Excel mensual de indicadores del equipo de ventas en un dashboard interactivo y en un informe PDF que queda como constancia del cierre.
- Sin servidor ni base de datos. El Excel se procesa en el navegador; nada se sube ni se guarda.
- Comparación opcional con el Excel del mes anterior: variaciones por vendedor, cambios de estado e indicadores incumplidos dos meses seguidos.
- Informe PDF con la huella SHA-256 de cada archivo, para comprobar de qué Excel exacto salió.
Qué muestra
| Pestaña | Contenido |
|---|
| Resumen | Sacos y galones contra meta, puntaje promedio, venta cruzada, hallazgos priorizados, puntos perdidos por indicador, puntos al alcance y, si hay mes anterior, la evolución del puntaje de cada vendedor |
| Vendedores | Ranking con puntaje Pegutil/Pruven, mapa de cumplimiento (% de meta, lo que falta, puntos o cambio vs mes anterior), detalle por vendedor y revisión de inconsistencias del archivo |
| Zonas y productos | Ventas por zona contra meta, venta cruzada, participación, cumplimiento por producto Pruven y reconocimientos |
| Metas | Metas del próximo mes (hoja METAS): si son alcanzables, nivel de riesgo y detalle por producto frente a lo logrado en el mes |
| Simulador | Mueve el resultado de cada indicador y recalcula puntaje y estado del vendedor |
| Procedimiento | Excel frente al Procedimiento de KPI's, fórmulas y rangos, y tabla de incentivos oficial frente a RESULTADOS |
Formato del Excel
El lector sigue la estructura del libro INDICADORES.xlsx:
- Una hoja por vendedor o zona con dos bloques de indicadores (Pegutil y Pruven). Cada bloque tiene una fila de encabezado con
INDICADOR, OBJETIVO, REAL, %, CUMPLE y VALORACION, y un título como INDICADORES MENSUALES ... (ESTABLE). Debajo del último bloque van las filas META, VENTAS y % ALCANZADO de galones.
RESULTADOS: título RESULTADOS <MES> <AÑO>, tabla ZONA / Vendedor / Sacos Vendidos / Galones Vendidos con filas TOTAL, META y % ALCANZADO, y los bloques VARIABLE PEGUTL y VARIABLE PRUVEN.METAS: título METAS MES <MES> y tabla VENDEDOR / SACOS / CAUCHO / ....CALCULOS (opcional): sus bloques (VENDEDOR / Meta … / Ventas, TOTAL GALONES, CLIENTES NUEVOS …, ATENCION DE CARTERA …) se comparan con las hojas de vendedor y con RESULTADOS; cada diferencia aparece en Revisión del archivo.
Las celdas se buscan por su texto, no por posición fija, así que mover tablas de lugar no rompe la lectura. Si cambia el nombre de una columna o de una hoja, el ajuste se hace en src/lib/parser.ts.
Reglas y fuentes de cada cifra
Hay dos bases de cálculo de puntos y estados, que se eligen con el selector Puntos según: Procedimiento / Excel del dashboard. Las reglas de ambas están en src/lib/rules.ts.
- Procedimiento (por defecto): Procedimiento para cálculo de KPI's e incentivos para ventas (08/01/2025). Cuatro indicadores por línea con tramos de puntos:
- Crecimiento en ventas (ventas ÷ meta; sacos en Pegutil, galones en Pruven) y cobranza a tiempo: 3 pts desde el 100%, 1 pt desde el 90%.
- Atención de cartera (clientes que compraron ÷ cartera total, estimada como objetivo del Excel ÷ 0,7): 3 pts desde el 70%, 1 pt desde el 50%.
- Nuevos clientes: 3 pts si cumple.
- Estados (escala corregida por la gerencia, igual en las dos bases): Productivo más de 9, Estable más de 3 y hasta 9, Crítico 3 o menos. Reemplaza la del documento (≥ 7 / 4 a 6 / < 3) y la leyenda del Excel (> 10 / 4 a 9 / < 3), que dejaban puntajes sin clasificar.
- Las ventas por producto de Pruven se muestran como información, sin puntos.
- Excel: los puntos del libro (cumple con el 100%, cobranza con el 90%), con la misma escala de estados. Si el CUMPLE del Excel contradice esa regla, se marca como Revisar (o Crítico si cambia el estado).
La pestaña Procedimiento compara las dos bases indicador por indicador y valida la tabla de incentivos de RESULTADOS contra la oficial: porcentajes, ganadores (incluido el empate) y premios oficiales que el Excel no asigna. El premio "Mejor manejo de variables" del documento no se usa.
Fuente de cada cifra:
- Puntos, metas individuales y tarjetas de vendedor: la hoja de cada vendedor. Si RESULTADOS dice otra cosa, la tarjeta lo muestra.
- Ventas por zona y totales del equipo: RESULTADOS.
- Cumplimiento del equipo: ventas y meta de la misma base. Si la meta del equipo es la suma de las metas individuales, las zonas sin hoja (sin meta propia) se excluyen de las ventas y se informan aparte.
- Reconocimientos: se verifican contra las hojas de vendedor según los criterios del procedimiento. "Mayor incremento" se mide contra la meta (solo cuenta por encima del 100%).
Desarrollo
npm install
npm run dev
Abre http://localhost:3000 y usa Probar con archivos de ejemplo. Los ejemplos de public/ejemplos/ tienen datos ficticios y se regeneran con:
node scripts/generate-examples.mjs
Pruebas (lector, análisis, comparación y generación del PDF; los PDF de prueba quedan en tests/.output/):
npx vitest run
Publicar en Vercel
- Sube el repositorio a GitHub.
- En vercel.com/new, importa el repositorio. Vercel detecta Next.js; no hace falta configurar nada ni definir variables de entorno.
- Cada
git push a la rama principal publica una nueva versión.
El sitio es estático (output: 'export' en next.config.ts), así que también puede publicarse en cualquier hosting de archivos estáticos con el contenido de out/ tras npm run build.
Estructura
src/lib/ lectura del Excel, análisis, comparación y huella SHA-256 (sin dependencias de la interfaz)
src/components/ pantalla de carga, dashboard, gráficas (ECharts) e informe PDF (react-pdf)
scripts/ generador de los Excel de ejemplo
tests/ pruebas con Vitest
Colores
La paleta está en las variables de src/app/globals.css (bloque :root y su versión oscura). Para aplicar colores corporativos basta con cambiar ese bloque; el PDF usa los mismos tonos definidos al inicio de src/components/pdf/Report.tsx.
