// 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 }; }