informe-comercial-alfa/app/tendencia/page.js

437 lines
20 KiB
JavaScript
Raw Normal View History

import { auth } from "../lib/auth";
import { ownerFilter } from "../lib/authz";
import { getClosed, getSystemUsers, resolveScopeOwnerIds, VENTA_TYPE_FILTER } from "../lib/queries";
import { EJECUTIVOS_VENTA, agg } from "../lib/derive";
import { getMetas, getMetaGlobal } from "../lib/metas";
import { parseFiltParam, applyFilt } from "../lib/filterState";
import LoginPrompt from "../components/LoginPrompt";
import OwnerControl from "../components/OwnerControl";
import ErrorNotice from "../components/ErrorNotice";
import SegTabs from "../components/SegTabs";
import FilterChips from "../components/FilterChips";
import Panel from "../components/pipeline/Panel";
import WonTable from "../components/pipeline/WonTable";
import BucketTabs from "../components/tendencia/BucketTabs";
import { money, money2 } from "../lib/constants";
export const dynamic = "force-dynamic";
// Simplificación consciente frente al sitio HTML: el grano de la serie es siempre MENSUAL (el HTML
// baja a semana/día para períodos cortos — requeriría consultas día a día a Dynamics, demasiado
// costoso en vivo). Por el mismo motivo no hay columna "Creadas" (viene de un JSON mantenido a mano
// fuera de este pipeline, sin equivalente en vivo todavía).
const TEND_MIN_N = 5; // cierres mínimos para que un ratio/observación sea interpretable — igual que el HTML.
const DIM_LABELS = { segmento: "Segmento", linea: "Línea", tipo: "Tipo" };
const PERIODOS = [
{ k: "3", lbl: "3 meses" },
{ k: "6", lbl: "6 meses" },
{ k: "12", lbl: "12 meses" },
{ k: "anio", lbl: "Año en curso" },
{ k: "trimestre", lbl: "Trimestre en curso" },
];
const MESLBL3 = ["Ene", "Feb", "Mar", "Abr", "May", "Jun", "Jul", "Ago", "Sep", "Oct", "Nov", "Dic"];
function mesKey(d) {
return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}`;
}
function mesLbl(m) {
const [y, mm] = m.split("-");
return `${MESLBL3[+mm - 1]} ${y}`;
}
function lastMonths(n) {
const out = [];
const d = new Date();
for (let i = n - 1; i >= 0; i--) out.push(mesKey(new Date(d.getFullYear(), d.getMonth() - i, 1)));
return out;
}
function mesesDePeriodo(periodo) {
const hoy = new Date();
if (periodo === "anio") {
const out = [];
for (let m = 0; m <= hoy.getMonth(); m++) out.push(mesKey(new Date(hoy.getFullYear(), m, 1)));
return out;
}
if (periodo === "trimestre") {
const qStart = Math.floor(hoy.getMonth() / 3) * 3;
const out = [];
for (let m = qStart; m <= hoy.getMonth(); m++) out.push(mesKey(new Date(hoy.getFullYear(), m, 1)));
return out;
}
return lastMonths(parseInt(periodo, 10) || 6);
}
function mediana(arr) {
if (!arr.length) return 0;
const s = [...arr].sort((a, b) => a - b);
const m = Math.floor(s.length / 2);
return s.length % 2 ? s[m] : (s[m - 1] + s[m]) / 2;
}
// Escala de color de magnitud por columna — mismo criterio que tendEscala() del HTML: azul de
// marca, más intenso cuanto más alto dentro de la columna, calculado solo sobre buckets fiables.
function escalaMag(v, min, max) {
if (v == null || max <= min) return {};
return { background: `rgba(30,113,184,${(0.05 + ((v - min) / (max - min)) * 0.28).toFixed(3)})` };
}
function escalaCumpl(p) {
if (p == null) return {};
return { background: p >= 70 ? "rgba(63,125,92,.20)" : p >= 50 ? "rgba(201,138,27,.22)" : "rgba(178,58,46,.16)" };
}
export default async function TendenciaPage({ searchParams }) {
const session = await auth();
if (!session?.email) return <LoginPrompt />;
const sp = await searchParams;
const scope = ownerFilter(session, sp.owner);
const periodo = PERIODOS.some((p) => p.k === sp.periodo) ? sp.periodo : "6";
const meses = mesesDePeriodo(periodo);
const bucketSel = sp.t || null;
const filt = parseFiltParam(sp.f);
// Un solo propietario → su meta individual · varios → la suma de las suyas · ninguno (todos) →
// la meta global del equipo. Mismo criterio que resumen/page.js — comparar lo que vendió una
// sola persona contra la meta de todo el equipo no informa nada (ver CLAUDE.md del proyecto).
const metas = getMetas();
const selectedEmails = scope.locked ? [session.email] : scope.emails;
const metaDen =
selectedEmails.length === 1
? metas[selectedEmails[0].toLowerCase()] || null
: selectedEmails.length > 1
? selectedEmails.reduce((s, e) => s + (metas[e.toLowerCase()] || 0), 0) || null
: getMetaGlobal();
let porMes, owners, wonAll, lostAll;
try {
const [{ ownerIds }, allUsers] = await Promise.all([
resolveScopeOwnerIds(scope, session.accessToken, EJECUTIVOS_VENTA),
getSystemUsers(session.accessToken),
]);
owners = allUsers.filter((u) => EJECUTIVOS_VENTA.includes(u.name));
const crudo = await Promise.all(
meses.map(async (m) => {
const [won, lost] = await Promise.all([
getClosed(session.accessToken, scope, 1, m, ownerIds, VENTA_TYPE_FILTER),
getClosed(session.accessToken, scope, 2, m, ownerIds, VENTA_TYPE_FILTER),
]);
return { mes: m, won, lost };
})
);
wonAll = crudo.flatMap((x) => x.won);
lostAll = crudo.flatMap((x) => x.lost);
const hoyMes = mesKey(new Date());
// sumW: TODO lo ganado del mes (para el gráfico/tabla, igual que Ganadas/Resumen). sumWMeta:
// solo los 4 tipos que cuentan para meta — Renovaciones y SAC quedan afuera del cumplimiento a
// propósito (ver CLAUDE.md, "Cumplimiento de meta — qué cuenta").
porMes = crudo.map(({ mes, won: wonRaw, lost: lostRaw }) => {
const won = applyFilt(wonRaw, filt);
const lost = applyFilt(lostRaw, filt);
const vals = won.map((o) => o.actual || 0).sort((a, b) => b - a);
const sumW = vals.reduce((a, v) => a + v, 0);
// won ya viene acotado a VENTA_TYPE_FILTER (los mismos 4 tipos de TIPOS_META).
const sumWMeta = sumW;
const depu = lost.filter((o) => o.motivo === "Descartada sin motivo (depuración)").length;
const denomReal = won.length + lost.length - depu;
return {
mes,
lbl: mesLbl(mes),
won: won.length,
lost: lost.length,
sumW,
mayor: vals[0] || 0,
pctMayor: sumW ? Math.round(((vals[0] || 0) / sumW) * 100) : 0,
mediana: mediana(vals),
arpu: won.length ? sumW / won.length : 0,
convReal: denomReal ? Math.round((won.length / denomReal) * 100) : null,
meta: metaDen,
cumpl: metaDen ? Math.round((sumWMeta / metaDen) * 100) : null,
enCurso: mes === hoyMes,
};
});
} catch (error) {
return <ErrorNotice error={error} />;
}
const bSel = porMes.find((b) => b.mes === bucketSel) || null;
// Ámbito: todo el período o el bucket aislado — con el cross-filter ya aplicado.
const wonFiltAll = applyFilt(wonAll, filt);
const lostFiltAll = applyFilt(lostAll, filt);
const enBucket = (o) => !bSel || (o.actualClose || "").slice(0, 7) === bSel.mes;
const won = wonFiltAll.filter(enBucket);
const lost = lostFiltAll.filter(enBucket);
// Base para los paneles de dimensión: el bucket aislado + todo el cross-filter activo, incluida
// la propia dimensión de cada panel — mismo criterio ya usado en ganadas/perdemos (a diferencia
// del HTML, que excluye la dimensión propia de cada panel para poder seguir cambiando de
// categoría sin limpiar el filtro primero; ver tendFilter(base, dim) en el HTML fuente).
const baseDim = wonFiltAll.filter(enBucket);
const vals = won.map((o) => o.actual || 0);
const ing = vals.reduce((a, v) => a + v, 0);
const depuN = lost.filter((o) => o.motivo === "Descartada sin motivo (depuración)").length;
const denomTotal = won.length + lost.length;
const denomReal = denomTotal - depuN;
const medianaT = mediana(vals);
const prom = won.length ? ing / won.length : 0;
const brecha = medianaT ? Math.round(((prom - medianaT) / medianaT) * 100) : 0;
const convTotal = denomTotal ? Math.round((won.length / denomTotal) * 100) : 0;
const convReal = denomReal ? Math.round((won.length / denomReal) * 100) : 0;
// El cumplimiento del KPI solo tiene sentido si el numerador cubre a las mismas personas que la
// meta: filtrar por propietario (control de arriba) sigue siendo comparable — usa su meta
// personal. Filtrar por segmento/línea/tipo no, porque nadie tiene una meta partida por producto.
const metaCmp = ["segmento", "linea", "tipo"].some((d) => filt[d]) ? null : metaDen;
// won ya viene acotado a VENTA_TYPE_FILTER (los mismos 4 tipos de TIPOS_META).
const sumWMetaKpi = ing;
const cumplKpi = metaCmp ? Math.round((sumWMetaKpi / metaCmp) * 100) : null;
const ambito = bSel ? bSel.lbl : PERIODOS.find((p) => p.k === periodo)?.lbl || "período";
// ---- Observaciones calculadas — solo aritmética verificable, nunca una conclusión causal (ver
// cabecera de tendencia.js en el sitio HTML: "¿puede estar equivocada? si la respuesta no es un
// no rotundo, no va"). ----
const cerrados = porMes.filter((b) => !b.enCurso);
const observaciones = [];
const ultimo = porMes[porMes.length - 1];
if (ultimo?.enCurso)
observaciones.push(`${ultimo.lbl} está en curso (datos a hoy) — no es comparable con un mes cerrado.`);
if (cerrados.length >= 2) {
const a = cerrados[cerrados.length - 2],
b = cerrados[cerrados.length - 1];
const d = b.sumW - a.sumW,
pct = a.sumW ? Math.round((d / a.sumW) * 100) : 0;
observaciones.push(
`De ${a.lbl} a ${b.lbl} el ingreso ${d >= 0 ? "subió" : "bajó"} ${money(Math.abs(d))} (${pct > 0 ? "+" : ""}${pct}%), con ${a.won} y ${b.won} cierres respectivamente.`
);
}
porMes
.filter((b) => b.won > 0 && b.pctMayor >= 30)
.forEach((b) =>
observaciones.push(`En ${b.lbl}, ${b.pctMayor}% del ingreso vino de una sola oportunidad (${money(b.mayor)} de ${money(b.sumW)}).`)
);
const flojos = porMes.filter((b) => b.won > 0 && b.won < TEND_MIN_N);
if (flojos.length)
observaciones.push(
`${flojos.length} ${flojos.length === 1 ? "mes tiene" : "meses tienen"} menos de ${TEND_MIN_N} cierres (${flojos.map((b) => b.lbl).join(", ")}) — sus promedios y porcentajes no son interpretables.`
);
// ---- Descomposición volumen × ticket — identidad aritmética exacta entre los extremos CERRADOS
// de la serie que se está viendo (no los dos últimos meses: con un año a la vista, "julio a
// agosto" no explica el año). ----
const cerradosConDatos = porMes.filter((b) => !b.enCurso && b.won > 0);
let desc = null;
if (cerradosConDatos.length >= 2) {
const a = cerradosConDatos[0],
b = cerradosConDatos[cerradosConDatos.length - 1];
const tA = a.sumW / a.won,
tB = b.sumW / b.won;
const efVol = (b.won - a.won) * tA,
efTicket = b.won * (tB - tA),
total = b.sumW - a.sumW;
const suma = Math.abs(efVol) + Math.abs(efTicket) || 1;
desc = { a, b, tA, tB, efVol, efTicket, total, suma, pctTot: a.sumW ? Math.round((total / a.sumW) * 100) : 0 };
}
const signo = (v) => `${v >= 0 ? "+" : "−"}${money(Math.abs(v))}`;
// ---- Tabla de detalle por mes ----
const rIng = (() => {
const vs = porMes.filter((b) => b.won > 0).map((b) => b.sumW);
return vs.length ? [Math.min(...vs), Math.max(...vs)] : [0, 0];
})();
const rMed = (() => {
const vs = porMes.filter((b) => b.won >= TEND_MIN_N).map((b) => b.mediana);
return vs.length ? [Math.min(...vs), Math.max(...vs)] : [0, 0];
})();
const rConv = (() => {
const vs = porMes.filter((b) => b.won >= TEND_MIN_N && b.convReal != null).map((b) => b.convReal);
return vs.length ? [Math.min(...vs), Math.max(...vs)] : [0, 0];
})();
return (
<div style={{ padding: 24 }}>
<div style={{ display: "flex", justifyContent: "space-between", alignItems: "center", flexWrap: "wrap", gap: 12 }}>
<h2>Tendencia</h2>
<OwnerControl
owners={owners}
current={scope.locked ? [session.email] : scope.emails}
locked={scope.locked}
lockedLabel={session.email}
/>
</div>
<div style={{ marginBottom: 12 }}>
<SegTabs tabs={PERIODOS} activeKey={periodo} paramName="periodo" />
</div>
<FilterChips dimLabels={DIM_LABELS} />
{observaciones.length > 0 && (
<div className="callout info">
<b>Observaciones del período</b>
<ul style={{ margin: "8px 0 0", paddingLeft: 18 }}>
{observaciones.map((o, i) => (
<li key={i} style={{ marginBottom: 4 }}>
{o}
</li>
))}
</ul>
</div>
)}
<div className="kpis">
<div className="kpi">
<span className="n">{money2(ing)}</span>
<span className="l">Ingreso — {ambito}</span>
</div>
<div className="kpi">
<span className="n">{won.length}</span>
<span className="l">Oportunidades ganadas</span>
</div>
<div className="kpi">
<span className="n">{money(medianaT)}</span>
<span className="l">Ticket mediano (el cierre típico)</span>
</div>
<div className="kpi">
<span className="n">{money(prom)}</span>
<span className="l">Ticket promedio{brecha > 0 ? ` · ${brecha}% sobre la mediana` : ""}</span>
</div>
<div className="kpi">
<span className="n">{convTotal}%</span>
<span className="l">Tasa de Ganancia Total</span>
</div>
<div className="kpi" title={`Excluye ${depuN} pérdida(s) descartadas sin motivo real (depuración de datos)`}>
<span className="n">{convReal}%</span>
<span className="l">Tasa de Ganancia Real</span>
</div>
<div className="kpi">
<span className={cumplKpi != null && cumplKpi < 70 ? "n pierde" : "n"}>{cumplKpi != null ? `${cumplKpi}%` : "n/d"}</span>
<span className="l">{metaCmp ? `Cumplimiento (meta ${money(metaCmp)})` : "Cumplimiento — n/d con filtros activos"}</span>
</div>
</div>
<BucketTabs buckets={porMes} />
{desc && (
<div className="panel">
<h3>
Qué movió el ingreso — {desc.a.lbl} a {desc.b.lbl}
</h3>
<p className="hint">
El ingreso solo puede cambiar por dos razones, y esto es exactamente cuánto aportó cada una: cuántos negocios se cerraron, y qué
tan grande fue cada negocio.
</p>
<div className="tdesc-tot">
<span className="val">{money(desc.a.sumW)}</span>
<span className="per">{desc.a.lbl}</span>
<span className="fl">→</span>
<span className="val">{money(desc.b.sumW)}</span>
<span className="per">{desc.b.lbl}</span>
<span className={`delta ${desc.total >= 0 ? "tdesc-up" : "tdesc-down"}`}>
{signo(desc.total)} ({desc.pctTot > 0 ? "+" : ""}
{desc.pctTot}%)
</span>
</div>
<div className="tdesc-grid">
<div className="tdesc-card">
<div className="lbl">{desc.b.won - desc.a.won >= 0 ? "Se cerraron más negocios" : "Se cerraron menos negocios"}</div>
<div className={`amt ${desc.efVol >= 0 ? "tdesc-up" : "tdesc-down"}`}>{signo(desc.efVol)}</div>
<div className="bar-cell">
<div
className={`bar-fill ${desc.efVol < 0 ? "pierde" : ""}`}
style={{ width: `${((Math.abs(desc.efVol) / desc.suma) * 100).toFixed(0)}%` }}
/>
</div>
<div className="det">
{desc.a.won} → {desc.b.won} cierres ({desc.b.won - desc.a.won >= 0 ? "+" : "−"}
{Math.abs(desc.b.won - desc.a.won)}) · {Math.round((Math.abs(desc.efVol) / desc.suma) * 100)}% del cambio
</div>
</div>
<div className="tdesc-card">
<div className="lbl">{desc.tB - desc.tA >= 0 ? "Cada negocio fue más grande" : "Cada negocio fue más chico"}</div>
<div className={`amt ${desc.efTicket >= 0 ? "tdesc-up" : "tdesc-down"}`}>{signo(desc.efTicket)}</div>
<div className="bar-cell">
<div
className={`bar-fill ${desc.efTicket < 0 ? "pierde" : ""}`}
style={{ width: `${((Math.abs(desc.efTicket) / desc.suma) * 100).toFixed(0)}%` }}
/>
</div>
<div className="det">
ticket {money(desc.tA)} → {money(desc.tB)} · {Math.round((Math.abs(desc.efTicket) / desc.suma) * 100)}% del cambio
</div>
</div>
</div>
</div>
)}
<div className="grid2">
<Panel title="Por segmento" hint="Clientes Nuevos (venta nueva) vs. Cartera Activa (ampliaciones)" rows={agg(baseDim, "segmento", (o) => o.actual)} dimKey="segmento" />
<Panel title="Por línea de negocio" hint="Qué producto sostiene el ingreso del período" rows={agg(baseDim, "linea", (o) => o.actual)} dimKey="linea" />
</div>
<div className="grid2">
<Panel title="Por tipo de oportunidad" hint="Venta nueva, ampliación, renovación o retención" rows={agg(baseDim, "tipo", (o) => o.actual)} dimKey="tipo" />
</div>
<div className="tw" style={{ marginTop: 18 }}>
<div className="tw-title">
<h3>Detalle por mes</h3>
<span className="tw-count">El ticket mediano es el cierre típico; a diferencia del promedio no se distorsiona con un negocio grande.</span>
</div>
<div className="ts">
<table>
<thead>
<tr>
<th>Mes</th>
<th className="num">Cierres</th>
<th className="num">Ingreso</th>
<th className="num">Ticket mediano</th>
<th className="num">Ticket promedio</th>
<th className="num">% Conv. Real</th>
<th className="num">Mayor deal</th>
<th className="num">Meta</th>
<th className="num">Cumpl.</th>
</tr>
</thead>
<tbody>
{porMes.map((b) => {
const flojo = b.won > 0 && b.won < TEND_MIN_N;
return (
<tr key={b.mes} style={bSel?.mes === b.mes ? { background: "var(--gana-soft)" } : undefined}>
<td>
{b.lbl}
{b.enCurso ? <span style={{ color: "var(--tinta-suave)", fontSize: 11 }}> · en curso</span> : null}
</td>
<td className="num">{b.won}</td>
<td className="num" style={escalaMag(b.sumW, rIng[0], rIng[1])}>
{money(b.sumW)}
</td>
<td className="num" style={{ ...escalaMag(flojo ? null : b.mediana, rMed[0], rMed[1]), opacity: flojo ? 0.45 : 1 }} title={flojo ? `Solo ${b.won} cierres — por debajo de ${TEND_MIN_N} este número no es interpretable` : undefined}>
{b.won ? money(b.mediana) : "—"}
</td>
<td className="num" style={{ opacity: flojo ? 0.45 : 1 }}>
{b.won ? money(b.arpu) : "—"}
</td>
<td className="num" style={{ ...escalaMag(flojo ? null : b.convReal, rConv[0], rConv[1]), opacity: flojo ? 0.45 : 1 }}>
{b.won ? (b.convReal == null ? "—" : `${b.convReal}%`) : "—"}
</td>
<td className="num" style={b.pctMayor >= 30 ? { color: "var(--alerta)", fontWeight: 700 } : undefined} title={b.pctMayor >= 30 ? "Una sola oportunidad concentra buena parte del ingreso de este período" : undefined}>
{b.won ? `${b.pctMayor}%` : "—"}
</td>
<td className="num">{b.meta ? money(b.meta) : "—"}</td>
<td className="num" style={escalaCumpl(b.cumpl)}>
{b.cumpl == null ? "—" : `${b.cumpl}%`}
</td>
</tr>
);
})}
</tbody>
</table>
</div>
</div>
<div style={{ marginTop: 18 }}>
<WonTable rows={won} title={`Oportunidades ganadas — ${ambito}`} locked={scope.locked} />
</div>
</div>
);
}