// 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, "
")}