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

247 lines
11 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"]);
// 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 (a.estado === "cancelada") continue;
if (diaDe(a) !== dia) continue;
if (a.objetivo && OBJ_ADMIN.has(a.objetivo)) continue;
let ref, sec;
if (a.oportunidad) {
ref = { ...a.oportunidad, etn: "opportunity" };
sec = seccionDeOportunidad(a);
} else if (a.referente && REF_SIN_OPP.has(a.referente.tipo)) {
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);
} else continue;
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 };
})
.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 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 ese día
// (solo pantalla: invita al ejecutivo a agendar). `opps`: salida de getOportunidadesSemana().
export function sinActividadAgendada(opps, actividades, dia) {
const conActividad = new Set();
for (const a of actividades) {
if (a.estado === "cancelada" || !a.oportunidad || diaDe(a) !== dia) 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, 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, 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].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 };
}