informe-comercial-alfa/app/lib/plan.js

445 lines
19 KiB
JavaScript
Raw Normal View History

// Plan del Día — arma las 5 secciones a partir de las actividades agendadas para un día.
// Especificación: Proyectos/Análisis e Informes/Analitica de CRM/requerimientos-plan-del-dia.md
import { actAncla } from "./derive";
// Hora de Nicaragua explícita (el servidor puede correr en otro huso).
export function hoyManagua() {
return new Intl.DateTimeFormat("en-CA", { timeZone: "America/Managua" }).format(new Date());
}
export function addDays(iso, n) {
const d = new Date(iso + "T12:00:00Z");
d.setUTCDate(d.getUTCDate() + n);
return d.toISOString().slice(0, 10);
}
// Semana lunes–domingo que contiene `iso` (igual que el resto del informe).
export function semanaDe(iso) {
const dow = (new Date(iso + "T12:00:00Z").getUTCDay() + 6) % 7;
const lunes = addDays(iso, -dow);
return { lunes, domingo: addDays(lunes, 6) };
}
// Día de la actividad: mismo criterio que Agenda/Actividades (ancla en Cita = inicio, Tarea/Llamada
// = vencimiento; fecha tomada del ISO sin convertir de huso, igual que AgendaClient).
export function diaDe(a) {
const f = actAncla(a);
return f ? String(f).slice(0, 10) : null;
}
export const SECCIONES = [
{ key: "cierre", titulo: "Cierre", sub: "Esperamos la aprobación de la oferta o el contrato firmado" },
{ key: "negociacion", titulo: "Negociación para cierre", sub: "Objetivo Negociación" },
{ key: "oferta", titulo: "Presentar oferta", sub: "Objetivo Presentar Oferta" },
{ key: "seguimientos", titulo: "Seguimientos", sub: "Otras actividades ligadas a una oportunidad, caso o cuenta" },
{ key: "renovaciones", titulo: "Renovaciones", sub: "Contrato vencido y próximo a vencer" },
];
// Grupo "7. Administrativo" del catálogo de Objetivo de Actividad: no es trabajo comercial.
const OBJ_ADMIN = new Set(["Planificación", "Gestión Admin.", "Otro"]);
// Contrato Vencido (100000002) y Próximo a Vencer (100000001) — ver REN_TYPE_FILTER en queries.js.
export const COD_RENOVACION = new Set([100000001, 100000002]);
// Prioridad entre secciones de VENTAS cuando una misma oportunidad tiene varias actividades el
// mismo día: gana la de menor número. Renovaciones va aparte (el tipo decide Ventas vs Renovación).
const PRIORIDAD = { cierre: 0, negociacion: 1, oferta: 2, seguimientos: 3 };
// Sección por objetivo (sirve tanto para oportunidades como para casos/cuentas).
function seccionPorObjetivo(objetivo) {
if (objetivo === "Firma Contrato-Adendum") return "cierre";
if (objetivo === "Negociación") return "negociacion";
if (objetivo === "Presentar Oferta") return "oferta";
return "seguimientos";
}
// Cierre = objetivo "Firma Contrato-Adendum", o la oportunidad está en forecast 80% (Proveedor
// Confirmado) / 90% (Firma de contrato) — la etiqueta ya trae el % adelante, ver CLAUDE.md.
function seccionDeOportunidad(a) {
const opp = a.oportunidad;
if (COD_RENOVACION.has(opp.tipoCodigo)) return "renovaciones";
const pct = parseInt(opp.forecast || "", 10) || 0;
if (pct === 80 || pct === 90) return "cierre";
return seccionPorObjetivo(a.objetivo);
}
// Entidades a las que puede apuntar "Referente a" sin ser oportunidad y que sí entran al plan
// (decisión de Marco, 2026-10-26: Caso y Cuenta; sin valor estimado).
const REF_SIN_OPP = new Set(["incident", "account"]);
// Tipos de actividad de una fila, en orden fijo, con cuántas hay de cada uno: [{ tipo: "Cita", n: 1 }, ...].
function contarTipos(acts) {
const m = {};
acts.forEach((a) => {
m[a.tipo] = (m[a.tipo] || 0) + 1;
});
return ["Cita", "Llamada", "Tarea"].filter((t) => m[t]).map((t) => ({ tipo: t, n: m[t] }));
}
// A qué (oportunidad / caso / cuenta) y a qué sección pertenece una actividad; null si no entra al
// plan (sin referente comercial, o del grupo Administrativo). Compartido por el plan de un día y el
// de un período (Plan de Actividades).
function clasificar(a) {
if (a.estado === "cancelada") return null;
if (a.objetivo && OBJ_ADMIN.has(a.objetivo)) return null;
if (a.oportunidad) {
return { ref: { ...a.oportunidad, etn: "opportunity" }, sec: seccionDeOportunidad(a) };
}
if (a.referente && REF_SIN_OPP.has(a.referente.tipo)) {
return {
ref: { id: a.referente.id, etn: a.referente.tipo, cliente: a.referente.nombre, nombre: a.referente.nombre, valor: null },
sec: a.objetivo === "Renovación" ? "renovaciones" : seccionPorObjetivo(a.objetivo),
};
}
return null;
}
// actividades: salida de getActividades(). dia: "YYYY-MM-DD". hoy: "YYYY-MM-DD" (para marcar
// Vencida en días pasados). Devuelve { secciones: [{...SECCIONES[i], filas, subtotal}], resumen }.
// Cada fila lleva `opp`: { id, etn, cliente, nombre, valor|null } — `valor` null = sin valor (caso/cuenta).
export function armarPlan(actividades, dia, hoy) {
const filas = new Map(); // oportunidad/caso/cuenta + propietario: una fila aunque tenga varias actividades
for (const a of actividades) {
if (diaDe(a) !== dia) continue;
const c = clasificar(a);
if (!c) continue;
const { ref, sec } = c;
const key = `${ref.id}|${a.owner}`;
let r = filas.get(key);
if (!r) {
r = { key, sec, owner: a.owner, opp: ref, objetivos: [], acts: [] };
filas.set(key, r);
} else if (sec !== "renovaciones" && r.sec !== "renovaciones" && PRIORIDAD[sec] < PRIORIDAD[r.sec]) {
r.sec = sec;
}
const obj = a.objetivo || "(sin objetivo)";
if (!r.objetivos.includes(obj)) r.objetivos.push(obj);
r.acts.push(a);
}
const secciones = SECCIONES.map((s) => {
const rows = [...filas.values()]
.filter((r) => r.sec === s.key)
.map((r) => {
const hechas = r.acts.filter((a) => a.estado === "completada").length;
const total = r.acts.length;
let estado = "Pendiente";
if (hechas === total) estado = "Completada";
else if (dia < hoy) estado = "Vencida";
return { ...r, hechas, total, estado, tipos: contarTipos(r.acts) };
})
.sort((x, y) => x.owner.localeCompare(y.owner) || (y.opp.valor || 0) - (x.opp.valor || 0));
return { ...s, filas: rows, subtotal: rows.reduce((t, r) => t + (r.opp.valor || 0), 0) };
});
const todas = secciones.flatMap((s) => s.filas);
const actTotal = todas.reduce((t, r) => t + r.total, 0);
const actHechas = todas.reduce((t, r) => t + r.hechas, 0);
return { secciones, resumen: { oportunidades: todas.length, actTotal, actHechas } };
}
// ---- Plan por período (Plan de Actividades: semana y mes) -------------------------------------
export const PERIODOS_ACT = [
{ k: "semana_pasada", lbl: "Semana pasada" },
{ k: "semana", lbl: "Esta semana" },
{ k: "semana_proxima", lbl: "Próxima semana" },
{ k: "mes_pasado", lbl: "Mes pasado" },
{ k: "mes", lbl: "Este mes" },
];
export function periodoActActivo(k) {
return PERIODOS_ACT.some((p) => p.k === k) ? k : "semana";
}
// Rango [desde, hasta] (ambos incluidos, "YYYY-MM-DD"). Semana comercial lunes–domingo.
export function rangoPeriodoAct(k, hoy) {
if (k.startsWith("semana")) {
const base = semanaDe(hoy).lunes;
const lunes = k === "semana_pasada" ? addDays(base, -7) : k === "semana_proxima" ? addDays(base, 7) : base;
return { tipo: "semana", desde: lunes, hasta: addDays(lunes, 6) };
}
const [y, m] = hoy.split("-").map(Number);
const off = k === "mes_pasado" ? -1 : 0;
const primero = new Date(Date.UTC(y, m - 1 + off, 1));
const ultimo = new Date(Date.UTC(y, m + off, 0));
return { tipo: "mes", desde: primero.toISOString().slice(0, 10), hasta: ultimo.toISOString().slice(0, 10) };
}
export function diasDelRango(desde, hasta) {
const out = [];
for (let d = desde; d <= hasta; d = addDays(d, 1)) out.push(d);
return out;
}
export const esHabil = (iso) => {
const dow = new Date(iso + "T12:00:00Z").getUTCDay();
return dow >= 1 && dow <= 5;
};
const DIAS_CORTOS = ["Dom", "Lun", "Mar", "Mié", "Jue", "Vie", "Sáb"];
// «Lun 26»
export const diaCorto = (iso) => `${DIAS_CORTOS[new Date(iso + "T12:00:00Z").getUTCDay()]} ${Number(iso.slice(8, 10))}`;
// «Lun» (para las fichas de la franja)
export const diaSemana = (iso) => DIAS_CORTOS[new Date(iso + "T12:00:00Z").getUTCDay()];
// Plan de un período: las mismas 5 secciones que el plan del día (una fila por oportunidad/caso/cuenta
// y propietario para TODO el período, con los días en que tiene actividad), más la cobertura por día y
// por ejecutivo y los indicadores de cumplimiento.
// Cumplimiento «a la fecha» = completadas ÷ lo que ya debía estar hecho = actividades de días ANTERIORES
// a hoy (hoy todavía no termina, así que a las 10 a. m. no cuenta como incumplido; el avance de hoy se
// ve en el Plan del Día). El universo son las actividades que entran al plan (ligadas a oportunidad,
// caso o cuenta, sin las administrativas).
export function armarPlanPeriodo(actividades, desde, hasta, hoy) {
const filas = new Map();
const elegibles = [];
for (const a of actividades) {
const dia = diaDe(a);
if (!dia || dia < desde || dia > hasta) continue;
const c = clasificar(a);
if (!c) continue;
elegibles.push({ a, dia });
const { ref, sec } = c;
const key = `${ref.id}|${a.owner}`;
let r = filas.get(key);
if (!r) {
r = { key, sec, owner: a.owner, opp: ref, objetivos: [], acts: [], dias: [] };
filas.set(key, r);
} else if (sec !== "renovaciones" && r.sec !== "renovaciones" && PRIORIDAD[sec] < PRIORIDAD[r.sec]) {
r.sec = sec;
}
const obj = a.objetivo || "(sin objetivo)";
if (!r.objetivos.includes(obj)) r.objetivos.push(obj);
if (!r.dias.includes(dia)) r.dias.push(dia);
r.acts.push(a);
}
const secciones = SECCIONES.map((s) => {
const rows = [...filas.values()]
.filter((r) => r.sec === s.key)
.map((r) => {
const hechas = r.acts.filter((a) => a.estado === "completada").length;
const total = r.acts.length;
const vencidas = r.acts.filter((a) => a.estado !== "completada" && diaDe(a) < hoy).length;
const estado = hechas === total ? "Completada" : vencidas > 0 ? "Vencida" : hechas > 0 ? "En curso" : "Pendiente";
return { ...r, dias: [...r.dias].sort(), hechas, total, vencidas, estado, tipos: contarTipos(r.acts) };
})
.sort((x, y) => x.owner.localeCompare(y.owner) || (y.opp.valor || 0) - (x.opp.valor || 0));
return {
...s,
filas: rows,
subtotal: rows.reduce((t, r) => t + (r.opp.valor || 0), 0),
actTotal: rows.reduce((t, r) => t + r.total, 0),
actHechas: rows.reduce((t, r) => t + r.hechas, 0),
};
});
const porDia = {};
const porOwner = {};
for (const { a, dia } of elegibles) {
const hecha = a.estado === "completada";
const d = (porDia[dia] ||= { total: 0, hechas: 0 });
d.total++;
if (hecha) d.hechas++;
const o = (porOwner[a.owner] ||= { total: 0, hechas: 0, debidas: 0, debidasHechas: 0, vencidas: 0, porDia: {} });
o.total++;
if (hecha) o.hechas++;
o.porDia[dia] = (o.porDia[dia] || 0) + 1;
if (dia < hoy) {
o.debidas++;
if (hecha) o.debidasHechas++;
}
if (!hecha && dia < hoy) o.vencidas++;
}
const total = elegibles.length;
const hechas = elegibles.filter(({ a }) => a.estado === "completada").length;
const debidas = elegibles.filter(({ dia }) => dia < hoy);
const debidasHechas = debidas.filter(({ a }) => a.estado === "completada").length;
const vencidas = elegibles.filter(({ a, dia }) => a.estado !== "completada" && dia < hoy).length;
const habiles = diasDelRango(desde, hasta).filter(esHabil);
const diasSinActividad = habiles.filter((d) => !porDia[d]).length;
return {
secciones,
porDia,
porOwner,
resumen: {
agendadas: total,
hechas,
debidas: debidas.length,
debidasHechas,
vencidas,
diasHabiles: habiles.length,
diasSinActividad,
pctFecha: debidas.length ? Math.round((debidasHechas / debidas.length) * 1000) / 10 : null,
},
};
}
// Objetivo de actividad sugerido según la etapa de forecast de la oportunidad (guía de planificación
// validada por Marco el 2026-10-26; es una orientación, no una obligación). Las renovaciones llevan
// «Renovación» en cualquier etapa. Los nombres son los del catálogo de Objetivo de Actividad.
const OBJETIVO_POR_ETAPA = {
20: "Diagnosticar Necesidades",
40: "Presentación de Servicio",
50: "Presentar Oferta",
60: "Negociación",
70: "Negociación",
80: "Firma Contrato-Adendum",
90: "Firma Contrato-Adendum",
};
export function objetivoSugerido(o) {
if (COD_RENOVACION.has(o.tipoCodigo)) return "Renovación";
const pct = parseInt(o.forecast || "", 10) || 0;
return OBJETIVO_POR_ETAPA[pct] || null;
}
// Huecos de planificación de un período: oportunidades abiertas con cierre estimado en el período y
// ninguna actividad en TODO el período, ordenadas por prioridad (primero las de forecast 80% y 90%,
// luego por valor) para que quien planifica sepa qué agendar primero.
export function sinActividadPeriodo(opps, actividades, desde, hasta) {
const conActividad = new Set();
for (const a of actividades) {
if (a.estado === "cancelada" || !a.oportunidad) continue;
const dia = diaDe(a);
if (dia && dia >= desde && dia <= hasta) conActividad.add(a.oportunidad.id);
}
return opps
.filter((o) => !conActividad.has(o.id))
.map((o) => {
const pct = parseInt(o.forecast || "", 10) || 0;
return { ...o, pct, prioridadAlta: pct >= 80 };
})
.sort((x, y) => y.pct - x.pct || y.valor - x.valor || x.cierre.localeCompare(y.cierre));
}
// ---- Plan cerrado (etapa 3) -------------------------------------------------------------------
// Foto del plan de UN ejecutivo: lo mínimo para comparar después (por id de actividad), no el
// plan completo con sus campos de pantalla.
export function crearFoto(plan, fecha) {
const filas = plan.secciones.flatMap((s) =>
s.filas.map((r) => ({
sec: s.key,
etn: r.opp.etn,
id: r.opp.id,
cliente: r.opp.cliente || r.opp.nombre || null,
valor: r.opp.valor,
acts: r.acts.map((a) => ({
id: a.id,
tipo: a.tipo,
asunto: a.asunto,
objetivo: a.objetivo || null,
estado: a.estado,
dia: diaDe(a),
})),
}))
);
return { fecha, filas, nActs: filas.reduce((t, f) => t + f.acts.length, 0) };
}
// Foto contra realidad. Resultado por actividad de la foto:
// Cumplida · No cumplida (sigue abierta, el día ya pasó) · Pendiente (hoy o futuro) ·
// Reprogramada (sigue abierta pero ya no es de ese día) · Cancelada · Eliminada (ya no existe)
// y «Agregada después» para lo que hoy está en el plan de ese día y no estaba en la foto.
// `actividades` = getActividades() del ejecutivo (ventana de 90 días: una actividad más vieja que
// eso aparecería como «Eliminada»); `plan` = armarPlan() actual de ese mismo día.
export function compararConFoto(foto, actividades, plan, hoy) {
const porId = new Map(actividades.map((a) => [a.id, a]));
const enFoto = new Set();
const lineas = [];
for (const f of foto.filas) {
for (const fa of f.acts) {
enFoto.add(fa.id);
const a = porId.get(fa.id);
let res;
let detalle = null;
if (!a) res = "Eliminada";
else if (a.estado === "cancelada") res = "Cancelada";
else if (a.estado === "completada") res = "Cumplida";
else {
const dia = diaDe(a);
if (dia && dia !== foto.fecha) {
res = "Reprogramada";
detalle = dia;
} else res = foto.fecha < hoy ? "No cumplida" : "Pendiente";
}
lineas.push({ sec: f.sec, etn: f.etn, id: f.id, cliente: f.cliente, valor: f.valor, tipo: fa.tipo, asunto: fa.asunto, objetivo: fa.objetivo, res, detalle });
}
}
const agregadas = [];
for (const s of plan.secciones) {
for (const r of s.filas) {
for (const a of r.acts) {
if (enFoto.has(a.id)) continue;
agregadas.push({
sec: s.key, etn: r.opp.etn, id: r.opp.id, cliente: r.opp.cliente || r.opp.nombre || null, valor: r.opp.valor,
tipo: a.tipo, asunto: a.asunto, objetivo: a.objetivo || null,
res: a.estado === "completada" ? "Agregada después (cumplida)" : "Agregada después", detalle: null,
});
}
}
}
const cuenta = (r) => lineas.filter((l) => l.res === r).length;
const resumen = {
enFoto: lineas.length,
cumplidas: cuenta("Cumplida"),
noCumplidas: cuenta("No cumplida"),
pendientes: cuenta("Pendiente"),
reprogramadas: cuenta("Reprogramada"),
canceladas: cuenta("Cancelada") + cuenta("Eliminada"),
agregadas: agregadas.length,
agregadasCumplidas: agregadas.filter((l) => l.res.includes("cumplida")).length,
};
return { lineas, agregadas, resumen };
}
// Oportunidades abiertas con cierre estimado en la semana y SIN ninguna actividad en ESA SEMANA (de `desde` a
// `hasta`, lunes a domingo; cuenta cualquier actividad no cancelada, abierta o completada). Antes miraba solo el
// día elegido, y una oportunidad con una visita el miércoles salía como «sin actividad» el martes (Marco, 2026-11-10).
// Solo pantalla: invita al ejecutivo a agendar. `opps`: salida de getOportunidadesSemana().
export function sinActividadAgendada(opps, actividades, desde, hasta) {
const conActividad = new Set();
for (const a of actividades) {
if (a.estado === "cancelada" || !a.oportunidad) continue;
const d = diaDe(a);
if (!d || d < desde || d > hasta) continue;
conActividad.add(a.oportunidad.id);
}
return opps
.filter((o) => !conActividad.has(o.id))
.sort((x, y) => x.owner.localeCompare(y.owner) || x.cierre.localeCompare(y.cierre) || y.valor - x.valor);
}
// Resumen por ejecutivo para el administrador (pantalla y PDF de equipo). `nombres`: ejecutivos a
// listar; `ventas`/`renovaciones`: oportunidades ganadas del mes (getClosedRange).
// Los totales de ventas/renovaciones salen de TODO lo ganado (como el encabezado); lo que no es de
// los ejecutivos listados va en `otros` para que la tabla cuadre con el encabezado.
export function resumenEquipo(plan, nombres, ventas, renovaciones) {
const lineas = nombres.map((nombre) => {
const secs = {};
let actTotal = 0, actHechas = 0, valor = 0, items = 0;
for (const s of plan.secciones) {
const rows = s.filas.filter((r) => r.owner === nombre);
secs[s.key] = { n: rows.length, acts: rows.reduce((t, r) => t + r.total, 0), valor: rows.reduce((t, r) => t + (r.opp.valor || 0), 0) };
rows.forEach((r) => { actTotal += r.total; actHechas += r.hechas; });
items += rows.length;
valor += secs[s.key].valor;
}
const suma = (rows) => rows.filter((o) => o.owner === nombre).reduce((t, o) => t + (o.actual || 0), 0);
return { nombre, secs, items, valor, actTotal, actHechas, ventasMes: suma(ventas), renovMes: suma(renovaciones) };
});
const total = { items: 0, valor: 0, actTotal: 0, actHechas: 0, ventasMes: 0, renovMes: 0, secs: {} };
for (const s of plan.secciones) total.secs[s.key] = { n: 0, acts: 0, valor: 0 };
for (const l of lineas) {
total.items += l.items; total.valor += l.valor; total.actTotal += l.actTotal; total.actHechas += l.actHechas;
for (const k of Object.keys(l.secs)) { total.secs[k].n += l.secs[k].n; total.secs[k].acts += l.secs[k].acts; total.secs[k].valor += l.secs[k].valor; }
}
const sumaTodo = (rows) => rows.reduce((t, o) => t + (o.actual || 0), 0);
total.ventasMes = sumaTodo(ventas);
total.renovMes = sumaTodo(renovaciones);
const otrosV = total.ventasMes - lineas.reduce((t, l) => t + l.ventasMes, 0);
const otrosR = total.renovMes - lineas.reduce((t, l) => t + l.renovMes, 0);
const otros = Math.abs(otrosV) > 0.5 || Math.abs(otrosR) > 0.5 ? { ventasMes: otrosV, renovMes: otrosR } : null;
return { lineas, total, otros };
}