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

435 lines
20 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

import { auth } from "../lib/auth";
import { ownerFilter } from "../lib/authz";
import { getClosed, getSystemUsers, resolveScopeOwnerIds, VENTA_TYPE_FILTER } from "../lib/queries";
import { PROPIETARIOS_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),
getSystemUsers(session.accessToken),
]);
owners = allUsers.filter((u) => PROPIETARIOS_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">
Aporte de cada causa: cuántos negocios se cerraron y qué tan grande fue cada uno.
</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">Ticket mediano = cierre típico, sin distorsión por 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>
);
}