// Gestión de UNA actividad (completar, reprogramar, cancelar, deshacer) — solo servidor. Todo con el token // del usuario conectado (derechos del propio usuario) y SIN caché: se valida con el estado de este momento. // Diseño y decisiones: Proyectos/Análisis e Informes/Analitica de CRM/egm/concepts_brief.md import { dvFresh, dvWrite, odataString } from "./dataverse"; import { ENTIDAD_TIPO, aUtc, minAHora, horaAMin, localDeIso, AGENDADOR } from "./agendador"; import { GC, parseCodigos, formatCodigos } from "./participantes"; // [statecode, statuscode] de cada estado, por tipo (cancelar ya probado el 2026-10-27; completar y reabrir se // prueban en la oportunidad KUAI antes de publicar — ver sesion.md del 2026-11-06). const ESTADOS = { Llamada: { completada: [1, 2], cancelada: [2, 3] }, Cita: { completada: [1, 3], cancelada: [2, 4] }, Tarea: { completada: [1, 5], cancelada: [2, 6] }, }; // Citas: statecode 0 (Abierta) y 3 (Programada) cuentan como abiertas. const abierta = (statecode) => statecode === 0 || statecode === 3; const esc = (s) => String(s).replace(/&/g, "&").replace(//g, ">"); function selectDe(tipo) { const base = ["activityid", "subject", "statecode", "statuscode", "scheduledstart", "scheduledend", "_ownerid_value", "_regardingobjectid_value", "description", "actualend"]; if (tipo === "Cita") base.push("alfa_resultadodelavisita", "location", "alfa_participantes"); // Llamada: columna «Participantes» creada en Dynamics el 2026-11-10 (aprobada por Marco; Tarea NO la tiene). if (tipo === "Llamada") base.push("alfa_participantes"); if (tipo === "Tarea") base.push("percentcomplete"); return base.join(","); } // Lee la actividad con datos de este momento. Para citas cuenta los invitados (asistentes requeridos u // opcionales): reprogramar o cancelar una cita con invitados puede mandarles avisos, y eso no se deshace. export async function leerActividad(token, tipo, id) { const ent = ENTIDAD_TIPO[tipo]; const NAV_OBJ = { Llamada: "alfa_ObjetivodeActividad_PhoneCall", Cita: "alfa_ObjetivodeActividad_Appointment", Tarea: "alfa_ObjetivodeActividad_Task" }[tipo]; const expand = `&$expand=${tipo === "Cita" ? "appointment_activity_parties($select=participationtypemask)," : ""}${NAV_OBJ}($select=alfa_objetivo,alfa_objetivosdeactividadesid)`; const d = await dvFresh(`${ent}(${odataString(id)})?$select=${selectDe(tipo)}${expand}`, token); const invitados = tipo === "Cita" ? (d.appointment_activity_parties || []).filter((p) => p.participationtypemask === 5 || p.participationtypemask === 6).length : 0; return { id: d.activityid, tipo, etag: d["@odata.etag"] || null, asunto: d.subject || "(sin asunto)", statecode: d.statecode, statuscode: d.statuscode, estado: d.statecode === 1 ? "completada" : d.statecode === 2 ? "cancelada" : "abierta", scheduledstart: d.scheduledstart || null, scheduledend: d.scheduledend || null, ownerId: d._ownerid_value || null, owner: d["_ownerid_value@OData.Community.Display.V1.FormattedValue"] || "", referente: d["_regardingobjectid_value@OData.Community.Display.V1.FormattedValue"] || null, // Solo si «Referente a» es una oportunidad (también puede ser cuenta o caso): ahí se suma la participación. oppId: d["_regardingobjectid_value@Microsoft.Dynamics.CRM.lookuplogicalname"] === "opportunity" ? d._regardingobjectid_value : null, participantes: parseCodigos(d.alfa_participantes), description: d.description ?? null, resultadoVisita: d.alfa_resultadodelavisita ?? null, actualend: d.actualend || null, percentcomplete: d.percentcomplete ?? null, invitados, objetivo: d[NAV_OBJ]?.alfa_objetivo ? String(d[NAV_OBJ].alfa_objetivo).trim() : null, objetivoId: d[NAV_OBJ]?.alfa_objetivosdeactividadesid || null, lugar: d.location ?? null, }; } // Propiedad de navegación del objetivo de cada tipo (para escribirlo con @odata.bind). const NAV_OBJETIVO = { Llamada: "alfa_ObjetivodeActividad_PhoneCall", Cita: "alfa_ObjetivodeActividad_Appointment", Tarea: "alfa_ObjetivodeActividad_Task" }; // Nota ya guardada, como TEXTO plano para mostrarla (sin HTML, sin la línea técnica de origen). Cita → «Resultado de la // visita» (nunca la descripción: es la invitación al cliente); llamada y tarea → descripción. export function notaLegible(act) { let t = act.tipo === "Cita" ? act.resultadoVisita : act.description; if (!t) return ""; t = String(t) .replace(//gi, "\n") .replace(/<\/p>/gi, "\n") .replace(/<[^>]*>/g, "") .replace(/ /g, " ").replace(/&/g, "&").replace(/</g, "<").replace(/>/g, ">").replace(/"/g, '"').replace(/'/g, "'"); return t .split("\n") .map((l) => l.trim()) .filter((l) => l && !/^Creada (desde el informe comercial|por el agendador de actividades)/i.test(l)) .join("\n") .slice(0, 800); } // Editar una actividad ABIERTA sin completarla: objetivo, duración (llamada/visita), nota previa y participantes (solo // visitas: llamadas y tareas no tienen el campo). NO toca asunto, descripción ni invitados. Escribe con If-Match. // Devuelve null si no había nada que cambiar; si no, { previo, nuevo } para poder deshacer. export async function editarActividad(token, act, { objetivoId, duracionMin, nota, participantes }) { const url = `${ENTIDAD_TIPO[act.tipo]}(${odataString(act.id)})`; const campos = {}; const previo = {}; const nuevo = {}; if (objetivoId && objetivoId !== act.objetivoId) { campos[`${NAV_OBJETIVO[act.tipo]}@odata.bind`] = `/alfa_objetivosdeactividadeses(${objetivoId})`; previo.objetivoId = act.objetivoId; nuevo.objetivoId = objetivoId; } if (duracionMin && act.tipo !== "Tarea" && act.scheduledstart) { const fin = new Date(new Date(act.scheduledstart).getTime() + duracionMin * 60000).toISOString(); if (!act.scheduledend || new Date(act.scheduledend).getTime() !== new Date(fin).getTime()) { campos.scheduledend = fin; previo.scheduledend = act.scheduledend; nuevo.scheduledend = fin; } } const campoNota = camposDeNota(act, nota); if (Object.keys(campoNota).length) { Object.assign(campos, campoNota); if (act.tipo === "Cita") previo.resultadoVisita = act.resultadoVisita ?? null; else previo.description = act.description ?? null; nuevo.nota = true; } if ((act.tipo === "Cita" || act.tipo === "Llamada") && Array.isArray(participantes) && formatCodigos(participantes) !== formatCodigos(act.participantes)) { campos.alfa_participantes = participantes.length ? formatCodigos(participantes) : null; previo.participantes = act.participantes; nuevo.participantes = participantes; } if (!Object.keys(campos).length) return null; await dvWrite("PATCH", url, token, campos, act.etag ? { "If-Match": act.etag } : {}); return { previo, nuevo }; } // Deshace una edición: devuelve cada campo cambiado a su valor previo (la actividad debe seguir abierta). export async function deshacerEdicion(token, tipo, id, previo, nuevo) { const act = await leerActividad(token, tipo, id); if (!abierta(act.statecode)) return "CAMBIO"; const campos = {}; if ("objetivoId" in previo) campos[`${NAV_OBJETIVO[tipo]}@odata.bind`] = previo.objetivoId ? `/alfa_objetivosdeactividadeses(${previo.objetivoId})` : null; if ("scheduledend" in previo) campos.scheduledend = previo.scheduledend; if ("resultadoVisita" in previo) campos.alfa_resultadodelavisita = previo.resultadoVisita; if ("description" in previo) campos.description = previo.description; if ("participantes" in previo) campos.alfa_participantes = previo.participantes.length ? formatCodigos(previo.participantes) : null; if (!Object.keys(campos).length) return "ok"; await dvWrite("PATCH", `${ENTIDAD_TIPO[tipo]}(${odataString(id)})`, token, campos); return "ok"; } // Dónde va la nota de cada tipo. Cita → «Resultado de la visita» (texto enriquecido, HTML): NUNCA la // descripción, que lleva la invitación de Teams/Outlook que se envía al contacto. Llamada y tarea → descripción. // Siempre se ANTEPONE: lo que el ejecutivo ya había escrito no se pierde. function camposDeNota(act, nota) { const t = String(nota || "").trim(); if (!t) return {}; if (act.tipo === "Cita") { const previo = act.resultadoVisita || ""; return { alfa_resultadodelavisita: `

${esc(t).replace(/\n/g, "
")}

${previo}` }; } return { description: act.description ? `${t}\n\n${act.description}` : t }; } const sinInvitados = (act) => (act.tipo === "Cita" && act.invitados > 0 ? "CON_INVITADOS" : null); // Valida que la actividad se pueda tocar. Devuelve un código de error o null. export function problemaPara(act, accion) { if (!abierta(act.statecode)) return "CERRADA"; if ((accion === "reprogramar" || accion === "cancelar") && sinInvitados(act)) return "CON_INVITADOS"; return null; } // Foto de lo que se va a cambiar, para poder deshacerlo. const fotoDe = (act) => ({ statecode: act.statecode, statuscode: act.statuscode, scheduledstart: act.scheduledstart, scheduledend: act.scheduledend, description: act.description, resultadoVisita: act.resultadoVisita, actualend: act.actualend, percentcomplete: act.percentcomplete, participantes: act.participantes, }); async function cerrar(token, act, estado, nota, extra = {}) { const ent = ENTIDAD_TIPO[act.tipo]; const url = `${ent}(${odataString(act.id)})`; // 1) Los datos (nota, fecha real, avance) se escriben con la actividad todavía abierta y con `If-Match`: // si el ejecutivo la cambió en Dynamics mientras tanto, falla (412) y no se pisa nada. const campos = { ...camposDeNota(act, nota), ...extra }; if (Object.keys(campos).length) { await dvWrite("PATCH", url, token, campos, act.etag ? { "If-Match": act.etag } : {}); } // 2) El cambio de estado va aparte. const [statecode, statuscode] = ESTADOS[act.tipo][estado]; await dvWrite("PATCH", url, token, { statecode, statuscode }); } export async function completarActividad(token, act, nota, participantes = [], actualend = null) { const extra = { actualend: actualend || new Date().toISOString() }; if (act.tipo === "Tarea") extra.percentcomplete = 100; // Una actividad cerrada es de solo lectura en Dynamics: los participantes de la cita se escriben ANTES // de cerrarla (junto con la nota), nunca después. if ((act.tipo === "Cita" || act.tipo === "Llamada") && participantes.length) extra.alfa_participantes = formatCodigos(participantes); await cerrar(token, act, "completada", nota, extra); return { statecode: 1, statuscode: ESTADOS[act.tipo].completada[1] }; } export async function cancelarActividad(token, act, nota) { await cerrar(token, act, "cancelada", nota); return { statecode: 2, statuscode: ESTADOS[act.tipo].cancelada[1] }; } // Nueva fecha. Llamadas y citas conservan su duración (si no tienen, la duración estándar de AGENDADOR: llamada 10 min, visita 60); las tareas vencen a las 16:00. export async function reprogramarActividad(token, act, dia, hora) { const ent = ENTIDAD_TIPO[act.tipo]; let inicio; let fin; if (act.tipo === "Tarea") { inicio = aUtc(dia, minAHora(AGENDADOR.horaTarea)); fin = inicio; } else { let dur = AGENDADOR.duracion[act.tipo]; if (act.scheduledstart && act.scheduledend) { const m = Math.round((new Date(act.scheduledend) - new Date(act.scheduledstart)) / 60000); if (m > 0 && m <= 480) dur = m; } inicio = aUtc(dia, hora); fin = aUtc(dia, minAHora(horaAMin(hora) + dur)); } await dvWrite("PATCH", `${ent}(${odataString(act.id)})`, token, { scheduledstart: inicio, scheduledend: fin }, act.etag ? { "If-Match": act.etag } : {}); return { scheduledstart: inicio, scheduledend: fin }; } // ---- Participación en la oportunidad ------------------------------------------------------------------- // Gerencia Comercial → Sí/No `alfa_participaciondegv` (alimenta la puntuación); los demás roles → el campo // múltiple `alfa_participantes`. Solo SUMA (nunca quita ni baja un Sí a No) y se registra lo anterior para // poder deshacerlo. export async function leerParticipacionOpp(token, oppId) { const d = await dvFresh(`opportunities(${odataString(oppId)})?$select=alfa_participaciondegv,alfa_participantes,statecode`, token); return { id: oppId, etag: d["@odata.etag"] || null, gv: d.alfa_participaciondegv === true, participantes: parseCodigos(d.alfa_participantes), abierta: d.statecode === 0 }; } export async function sumarParticipacionOpp(token, oppId, codigos) { const o = await leerParticipacionOpp(token, oppId); // Gerencia Comercial va SOLO en el Sí/No de la oportunidad (decisión de Marco); el campo múltiple recibe // los demás roles. const union = parseCodigos(formatCodigos([...o.participantes, ...codigos.filter((c) => c !== GC)])); const cuerpo = {}; if (formatCodigos(union) !== formatCodigos(o.participantes)) cuerpo.alfa_participantes = formatCodigos(union); if (codigos.includes(GC) && !o.gv) cuerpo.alfa_participaciondegv = true; if (!Object.keys(cuerpo).length) return { cambio: false, yaTenia: { gv: o.gv, participantes: o.participantes } }; await dvWrite("PATCH", `opportunities(${odataString(oppId)})`, token, cuerpo, o.etag ? { "If-Match": o.etag } : {}); return { cambio: true, previo: { id: oppId, gv: o.gv, participantes: o.participantes }, nuevo: { id: oppId, gv: cuerpo.alfa_participaciondegv ?? o.gv, participantes: union }, }; } // Devuelve la oportunidad a como estaba, tocando SOLO lo que la acción cambió. export async function restaurarParticipacionOpp(token, previo, nuevo) { const cuerpo = {}; if (previo.gv !== nuevo.gv) cuerpo.alfa_participaciondegv = previo.gv; if (formatCodigos(previo.participantes) !== formatCodigos(nuevo.participantes)) cuerpo.alfa_participantes = previo.participantes.length ? formatCodigos(previo.participantes) : null; if (!Object.keys(cuerpo).length) return; await dvWrite("PATCH", `opportunities(${odataString(previo.id)})`, token, cuerpo); } // «Deshacer»: restaura la foto previa. Solo si la actividad sigue como la dejó la acción (si alguien la tocó // después, no se pisa). export async function deshacerAccion(token, tipo, id, accion, previo, nuevo) { const act = await leerActividad(token, tipo, id); const ent = ENTIDAD_TIPO[tipo]; const url = `${ent}(${odataString(id)})`; if (accion === "reprogramar") { // Se comparan como instantes: Dynamics devuelve «…:00Z» y nosotros guardamos «…:00.000Z». const mismo = act.scheduledstart && nuevo.scheduledstart && new Date(act.scheduledstart).getTime() === new Date(nuevo.scheduledstart).getTime(); if (!abierta(act.statecode) || !mismo) return "CAMBIO"; await dvWrite("PATCH", url, token, { scheduledstart: previo.scheduledstart, scheduledend: previo.scheduledend }); return "ok"; } // completar / cancelar: reabre (vuelve al estado previo) y devuelve la nota y la fecha real a como estaban. if (act.statecode !== nuevo.statecode) return "CAMBIO"; await dvWrite("PATCH", url, token, { statecode: previo.statecode, statuscode: previo.statuscode }); const campos = { actualend: previo.actualend ?? null }; if (tipo === "Cita") { campos.alfa_resultadodelavisita = previo.resultadoVisita ?? null; } else campos.description = previo.description ?? null; if (nuevo.escribioParticipantes && (tipo === "Cita" || tipo === "Llamada")) campos.alfa_participantes = previo.participantes?.length ? formatCodigos(previo.participantes) : null; if (tipo === "Tarea") campos.percentcomplete = previo.percentcomplete ?? 0; let resultado = "ok"; try { await dvWrite("PATCH", url, token, campos); } catch { // La actividad ya quedó abierta; si no se pudo devolver la nota, no se falla el deshacer entero. resultado = "ok_sin_nota"; } // La participación que la acción sumó a la oportunidad también se devuelve. if (previo.opp && nuevo.opp) { try { await restaurarParticipacionOpp(token, previo.opp, nuevo.opp); } catch { resultado = "ok_sin_opp"; } } return resultado; } export { fotoDe, localDeIso };