weaver-work-cli 0.1.20 → 0.1.22

package/dist/shortcuts/meeting/operations/eb/decision.js

@@ -0,0 +1,385 @@
+/**
+ * 会议决议（决议概述 + 决议任务）与签到补签的**语义化操作**。
+ *
+ * 为什么要封装（2026-09-21 新增，需求：把会议内容汇总成决议任务）：
+ * EB 原生接口是「多张表 + 多个写接口」的拼装式 API，直接暴露给调用方有三个坑：
+ *
+ * 1. `create_mt_decision` 只写「决议概述 + 明细」，**不会**改会议自身状态；必须再用
+ *    `update_mt_isdecision` 写回 `is_decision=2` + `decision_Id` + `mt_status`，
+ *    否则会议页仍显示"未决议"、用户会以为决议没生效 —— 而这一步极易被漏掉（真实场景高频）。
+ * 2. `sign.create` 与 `sign.update` 字段几乎一致，**补签用错就会新增一条签到记录**（用户实测反馈）。
+ * 3. 决议明细一次可能十几条，若不指名"第几条、缺哪个字段"，调用方无法定位。
+ *
+ * 故提供两个语义化入口，把多步串成一次调用（仍走 prepare → 用户确认 → apply 的高风险写入链）：
+ * - `meeting.eb.decision.publish`：写决议（概述 + 明细）→ 自动写回会议为已决议（含部分失败语义）；
+ * - `meeting.eb.sign.mark`：按「会议 + 参会人」自动定位签到记录，走 update 补签 / 补签退。
+ */
+import { EB_BASE, ebBusinessSuccess, extractEbRows, fingerprint, normalizeEbWrite, queryBody, requireConfirm, verifyLease, writeBody, } from './factory.js';
+import { EB_ENDPOINTS } from './catalog.js';
+import { meetingSuccess } from '../types.js';
+import { meetingPartialError, meetingValidationError } from '../../errors.js';
+import { toIdString } from '../shared.js';
+const CONTINUATION_TTL_SECONDS = 600;
+const DATE_PATTERN = '^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}$';
+/** 决议状态：0未决议 / 1决议临时保存 / 2决议提交完成。 */
+const DECISION_DONE = '2';
+/** 会议状态「结束」：产生决议后会议即视为结束。 */
+const MT_STATUS_OVER = '8';
+function requireEndpoint(interfacePk) {
+    const endpoint = EB_ENDPOINTS.find((item) => item.interfacePk === interfacePk);
+    if (!endpoint)
+        throw new Error(`EB catalog 缺少 ${interfacePk}，请检查 catalog.ts 声明`);
+    return endpoint;
+}
+function businessFailed(response, interfacePk) {
+    const datajson = response?.datajson ?? {};
+    if (datajson.status === false) {
+        throw meetingValidationError('eb_write_not_applied', `${interfacePk} 返回 status=false，服务端未生效，请核对字段与权限后重试`);
+    }
+}
+/** 决议明细最少 1 条：没有明细就不会有决议任务，等于白建。 */
+function normalizeDecisionRows(input) {
+    if (input === undefined || input === null) {
+        throw meetingValidationError('missing_required_field', '缺少决议明细 detail1：至少 1 条（每条决议明细会由 ESB 联动生成一条决议任务）', { node: 'detail1', minRows: 1 });
+    }
+    if (!Array.isArray(input)) {
+        throw meetingValidationError('invalid_detail', 'detail1 必须是数组，每个元素为一条决议明细', { node: 'detail1' });
+    }
+    return input.map((row, index) => {
+        const source = (row && typeof row === 'object' ? row : {});
+        return {
+            // 明细序号与两个状态字段给默认值：调用方通常不关心，缺了会让列表顺序不稳/状态为空。
+            sort_number: String(index + 1),
+            decision_status: '0',
+            related_type: '0',
+            ...source,
+        };
+    });
+}
+const decisionPublishPrepare = {
+    name: 'meeting.eb.decision.publish.prepare',
+    resource: 'eb',
+    method: 'meeting.eb.decision.publish.prepare',
+    action: 'meeting.eb.decision.publish.prepare',
+    summary: '准备发布会议决议：写「决议概述 + 明细」，并把会议标记为已决议（生成确认预览，不写入）',
+    capability: 'eb.decision',
+    risk: 'read-before-write',
+    requiresConfirmation: true,
+    inputSchema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+            mt_id: { type: 'string', description: '会议 id（必填）' },
+            mt_content: { type: 'string', description: '决议概述文本（必填）：由调用方结合会议议题 / 纪要 / 用户提供的材料汇总' },
+            detail1: {
+                type: 'array',
+                minItems: 1,
+                description: '决议明细（至少 1 条）：每条 = 一项待办任务，ESB 联动据此生成决议任务；executors 必须传**员工 id**',
+                items: {
+                    type: 'object',
+                    additionalProperties: false,
+                    properties: {
+                        decision_title: { type: 'string', description: '决议标题（必填）' },
+                        executors: { type: 'string', description: '执行人**员工 id**（必填，多人用逗号分隔）' },
+                        begin_datetime: { type: 'string', pattern: DATE_PATTERN, description: '开始时间（必填，yyyy-MM-dd HH:mm）' },
+                        end_datetime: { type: 'string', pattern: DATE_PATTERN, description: '结束时间（必填，yyyy-MM-dd HH:mm）' },
+                        rummager: { type: 'string', description: '检查人**员工 id**（非必填）' },
+                        sort_number: { type: 'string', description: '明细序号（省略时按数组顺序自动编号）' },
+                        decision_status: { type: 'string', description: '决议状态（默认 0 未完成；0未完成/1已完成/2已延期）' },
+                        related_type: { type: 'string', description: '关联类型（默认 0 未关联；0未关联/1日程/2任务）' },
+                        relate_task: { type: 'string', description: '关联任务' },
+                        relate_agenda: { type: 'string', description: '关联日程' },
+                    },
+                    required: ['decision_title', 'executors', 'begin_datetime', 'end_datetime'],
+                },
+            },
+            mt_status: { type: 'string', description: `写回会议状态，默认 ${MT_STATUS_OVER}（结束）；产生决议即视为会议结束` },
+        },
+        required: ['mt_id', 'mt_content', 'detail1'],
+    },
+    handler: async (args, env) => {
+        const session = await env.host.getSession();
+        const create = normalizeEbWrite(requireEndpoint('create_mt_decision'), {
+            mt_id: args.mt_id,
+            mt_content: args.mt_content,
+            // 注意：**不要传 data_status** —— 2026-09-21 真机实测该接口拒绝该字段
+            // （DataError:dataKey:data_status,该字段不存在），提交状态由系统自动置 1。
+            detail1: normalizeDecisionRows(args.detail1),
+        }, session.userId);
+        const mtStatus = args.mt_status === undefined || args.mt_status === null || args.mt_status === ''
+            ? MT_STATUS_OVER
+            : String(args.mt_status);
+        const payload = { create, mtId: toIdString(args.mt_id, 'mt_id'), mtStatus };
+        const token = await env.continuation.issue({
+            operation: 'meeting.eb.decision.publish.apply',
+            baseUrl: session.baseUrl,
+            profile: session.profile,
+            userId: session.userId,
+            payload,
+            fingerprint: fingerprint(payload),
+        }, CONTINUATION_TTL_SECONDS * 1000);
+        return meetingSuccess('meeting.eb.decision.publish.prepare', {
+            status: 'AWAITING_CONFIRMATION',
+            preview: {
+                steps: [
+                    {
+                        step: 1,
+                        interfacePk: 'create_mt_decision',
+                        path: `${EB_BASE}/saveFormData/create_mt_decision`,
+                        mainTable: create.mainTable,
+                        detail1: create.details.detail1 ?? [],
+                    },
+                    {
+                        step: 2,
+                        interfacePk: 'update_mt_isdecision',
+                        mainTable: { id: payload.mtId, decision_Id: '<第 1 步返回的 dataIds[0]>', is_decision: DECISION_DONE, mt_status: mtStatus },
+                    },
+                ],
+                decisionCount: (create.details.detail1 ?? []).length,
+            },
+            continuation: token,
+            expiresInSeconds: CONTINUATION_TTL_SECONDS,
+        }, {
+            meta: {
+                notes: [
+                    '第 1 步写入决议概述与明细，第 2 步把会议写回为「已决议（is_decision=2）」并置会议状态。',
+                    '决议任务由 ESB 联动按明细生成，本操作不直接写任务表。',
+                ],
+            },
+        });
+    },
+};
+const decisionPublishApply = {
+    name: 'meeting.eb.decision.publish.apply',
+    resource: 'eb',
+    method: 'meeting.eb.decision.publish.apply',
+    action: 'meeting.eb.decision.publish.apply',
+    summary: '提交会议决议：写入决议概述 + 明细，并把会议标记为已决议；必须用户明确确认后调用',
+    capability: 'eb.decision',
+    risk: 'high-risk-write',
+    requiresConfirmation: true,
+    inputSchema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+            confirm: { const: true },
+            continuation: { type: 'string', minLength: 1 },
+        },
+        required: ['confirm', 'continuation'],
+    },
+    handler: async (args, env) => {
+        const applyName = 'meeting.eb.decision.publish.apply';
+        requireConfirm(args, applyName);
+        const lease = await verifyLease(args, applyName, env);
+        const payload = lease.payload;
+        if (lease.fingerprint !== fingerprint(payload)) {
+            throw meetingValidationError('target_changed', '提交内容与 prepare 时的快照不一致，请重新执行 prepare', {
+                expected: lease.payload,
+                actual: payload,
+            });
+        }
+        const session = await env.host.getSession();
+        const { create, mtId, mtStatus } = payload;
+        // 第 1 步：写决议概述 + 明细
+        // ⚠️ 真机教训（2026-09-21）：EB 写接口**报错不等于没写库** —— 实测一次因字段校验失败
+        // （data_status 不被接受）的 create_mt_decision，主表与明细其实已经落库；调用方若把"报错"
+        // 当"没写入"并重试，就会产生**重复决议 + 重复任务**（本次实测因此出现了 4 条任务）。
+        // 所以这里只要拿不到明确的成功证据，一律按「可能已写入」处理（抛 partial，提示先回查）。
+        let createResponse;
+        try {
+            createResponse = await env.host.request({
+                method: 'POST',
+                path: `${EB_BASE}/saveFormData/create_mt_decision`,
+                operation: applyName,
+                body: writeBody(session.userId, create),
+                acceptBusiness: ebBusinessSuccess,
+            });
+        }
+        catch (error) {
+            throw meetingPartialError(`决议写入请求失败：${error instanceof Error ? error.message : String(error)}。`
+                + '注意：EB 接口报错**不代表没有写入**（实测校验失败时主表也可能已落库）。'
+                + `请先用 meeting.eb.decision.list({ mt_id: "${mtId}" }) 回查该会议是否已生成决议，`
+                + '再决定是重试还是删除，**不要盲目重试以免产生重复决议与重复任务**。', { mtId, attempted: { interfacePk: 'create_mt_decision', body: create } }, { stage: applyName });
+        }
+        const createData = createResponse?.datajson ?? {};
+        if (createData.status === false) {
+            throw meetingPartialError('create_mt_decision 返回 status=false（服务端未确认成功）。'
+                + 'EB 接口报错/返回 false **不代表没有写入**，请先用 meeting.eb.decision.list({ mt_id: "'
+                + `${mtId}" }) 回查是否已生成决议，**不要盲目重试**。`, { mtId, attempted: { interfacePk: 'create_mt_decision', body: create }, response: createResponse }, { stage: applyName });
+        }
+        const rawIds = createData.dataIds ?? createData.ids;
+        const dataIds = Array.isArray(rawIds) ? rawIds : [];
+        const decisionId = dataIds.length > 0 ? String(dataIds[0]) : undefined;
+        if (!decisionId) {
+            // 决议可能已写入但拿不到 id → 无法关联会议。**不能**在这里重试创建（会重复）。
+            throw meetingPartialError('决议概述可能已写入，但接口未返回 dataIds（拿不到决议 id），无法自动写回会议。'
+                + `请先用 meeting.eb.decision.list({ mt_id: "${mtId}" }) 回查该会议是否已生成决议，再决定是否单独调用 meeting.eb.meeting.markDecided 标记；**不要**重复创建决议。`, { mtId, attempted: { interfacePk: 'create_mt_decision', body: create } }, { stage: applyName });
+        }
+        // 第 2 步：写回会议（关联决议 + 决议状态 + 会议状态）
+        const markMainTable = { id: mtId, decision_Id: decisionId, is_decision: DECISION_DONE, mt_status: mtStatus };
+        const markPayload = { mainTable: markMainTable, details: {}, operateType: {} };
+        try {
+            const markResponse = await env.host.request({
+                method: 'POST',
+                path: `${EB_BASE}/updateFormData/update_mt_isdecision`,
+                operation: applyName,
+                // 主键必须走 URL（updateFormData 端点统一要求，2026-09-21 真机实测）
+                query: { id: mtId },
+                body: writeBody(session.userId, markPayload),
+                acceptBusiness: ebBusinessSuccess,
+            });
+            businessFailed(markResponse, 'update_mt_isdecision');
+        }
+        catch (error) {
+            // 决议已经建成、只是"会议标记"没写上 —— 必须说清楚，否则用户会重复建决议。
+            throw meetingPartialError(`决议已创建成功（decision_Id=${decisionId}），但把会议标记为「已决议」失败：`
+                + `${error instanceof Error ? error.message : String(error)}。`
+                + '请**不要**重复创建决议；可稍后单独调用 meeting.eb.meeting.markDecided 重试标记，或到会议详情页确认。', { mtId, decisionId, attempted: { interfacePk: 'update_mt_isdecision', body: markMainTable } }, { stage: applyName });
+        }
+        return meetingSuccess(applyName, {
+            status: 'COMPLETE',
+            mtId,
+            decisionId,
+            isDecision: DECISION_DONE,
+            mtStatus,
+            result: createResponse,
+        });
+    },
+};
+const signMarkPrepare = {
+    name: 'meeting.eb.sign.mark.prepare',
+    resource: 'eb',
+    method: 'meeting.eb.sign.mark.prepare',
+    action: 'meeting.eb.sign.mark.prepare',
+    summary: '准备补签 / 补签退：按「会议 + 参会人」自动定位签到记录，生成确认预览（不写入）',
+    capability: 'eb.sign',
+    risk: 'read-before-write',
+    requiresConfirmation: true,
+    inputSchema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+            mt_id: { type: 'string', description: '会议 id（必填）' },
+            user_id: { type: 'string', description: '被补签人的**员工 id**（必填）' },
+            is_sign: { type: 'string', description: '签到状态：0缺席/1正常/2请假/3迟到/4早退；补签一般传 1' },
+            sign_time: { type: 'string', pattern: DATE_PATTERN, description: '签到时间（补签时必给，否则记录为空）' },
+            sign_out_status: { type: 'string', description: '签退状态：0已签退/1未签退/2早退' },
+            signback_time: { type: 'string', pattern: DATE_PATTERN, description: '签退时间（补签退时给）' },
+            sign_remark: { type: 'string', description: '签到日志 / 说明' },
+            attend_type: { type: 'string', description: '参会人员类型：0外部/1内部/2召集人/3联系人/4创建人' },
+        },
+        required: ['mt_id', 'user_id'],
+    },
+    handler: async (args, env) => {
+        const session = await env.host.getSession();
+        const mtId = toIdString(args.mt_id, 'mt_id');
+        const userId = toIdString(args.user_id, 'user_id');
+        const listResponse = await env.host.request({
+            method: 'POST',
+            path: `${EB_BASE}/getFormDataList/query_meeting_sign_list`,
+            operation: 'meeting.eb.sign.mark.prepare',
+            query: { mt_id: mtId, signMember: userId, pageNo: 1, pageSize: 50 },
+            // 分页必须进 body.pageInfo（EB 只认 body）：否则恒返回 10 条，参会人多的会议会找不到签到记录。
+            body: queryBody(session.userId, { pageNo: 1, pageSize: 50 }),
+            acceptBusiness: ebBusinessSuccess,
+        });
+        const { rows } = extractEbRows(listResponse);
+        const record = rows
+            .map((row) => row?.mainTable ?? row)
+            .find((main) => String(main?.user_id ?? '') === userId);
+        const recordId = record?.id === undefined || record?.id === null ? undefined : String(record.id);
+        if (!recordId) {
+            // 找不到记录时必须明确停手：改走 create 会新增一条，造成"同一人两条签到"。
+            throw meetingValidationError('sign_record_not_found', `未在该会议（${mtId}）中找到员工 ${userId} 的签到记录，无法补签。`
+                + '请先用 meeting.eb.sign.list 确认该会议是否已生成签到数据（若会议尚无签到记录，属建会初始化问题，需先用 meeting.eb.sign.create 初始化后再补签）。', { mtId, userId });
+        }
+        const update = normalizeEbWrite(requireEndpoint('update_meeting_sign_info'), { ...args, id: recordId, mt_id: mtId }, session.userId);
+        const payload = { mtId, signRecordId: recordId, update };
+        const token = await env.continuation.issue({
+            operation: 'meeting.eb.sign.mark.apply',
+            baseUrl: session.baseUrl,
+            profile: session.profile,
+            userId: session.userId,
+            payload,
+            fingerprint: fingerprint(payload),
+        }, CONTINUATION_TTL_SECONDS * 1000);
+        return meetingSuccess('meeting.eb.sign.mark.prepare', {
+            status: 'AWAITING_CONFIRMATION',
+            preview: {
+                interfacePk: 'update_meeting_sign_info',
+                // 主键必须走 URL（真机实测：只在 body 里传 id 会报「主键传入不能为空」）
+                path: `${EB_BASE}/updateFormData/update_meeting_sign_info?id=${recordId}`,
+                signRecordId: recordId,
+                before: { sign_time: record?.sign_time ?? '', is_sign: record?.is_sign ?? '', signback_time: record?.signback_time ?? '' },
+                after: update.mainTable,
+            },
+            continuation: token,
+            expiresInSeconds: CONTINUATION_TTL_SECONDS,
+        }, {
+            meta: {
+                notes: [
+                    '走的是**更新**（update_meeting_sign_info），不会新增签到记录。',
+                    '未传 sign_time 时签到时间仍为空，请按需补上。',
+                ],
+            },
+        });
+    },
+};
+const signMarkApply = {
+    name: 'meeting.eb.sign.mark.apply',
+    resource: 'eb',
+    method: 'meeting.eb.sign.mark.apply',
+    action: 'meeting.eb.sign.mark.apply',
+    summary: '提交补签 / 补签退（update_meeting_sign_info）；必须用户明确确认后调用',
+    capability: 'eb.sign',
+    risk: 'high-risk-write',
+    requiresConfirmation: true,
+    inputSchema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+            confirm: { const: true },
+            continuation: { type: 'string', minLength: 1 },
+        },
+        required: ['confirm', 'continuation'],
+    },
+    handler: async (args, env) => {
+        const applyName = 'meeting.eb.sign.mark.apply';
+        requireConfirm(args, applyName);
+        const lease = await verifyLease(args, applyName, env);
+        const payload = lease.payload;
+        if (lease.fingerprint !== fingerprint(payload)) {
+            throw meetingValidationError('target_changed', '提交内容与 prepare 时的快照不一致，请重新执行 prepare', {
+                expected: lease.payload,
+                actual: payload,
+            });
+        }
+        const session = await env.host.getSession();
+        const response = await env.host.request({
+            method: 'POST',
+            path: `${EB_BASE}/updateFormData/update_meeting_sign_info`,
+            operation: applyName,
+            // 主键走 URL query（真机实测要求）；body 里仍保留 id 以满足文档「id 必填」
+            query: { id: payload.signRecordId },
+            body: writeBody(session.userId, payload.update),
+            acceptBusiness: ebBusinessSuccess,
+        });
+        businessFailed(response, 'update_meeting_sign_info');
+        return meetingSuccess(applyName, {
+            status: 'COMPLETE',
+            mtId: payload.mtId,
+            signRecordId: payload.signRecordId,
+            applied: payload.update.mainTable,
+            result: response,
+        });
+    },
+};
+/** 决议 / 补签的语义化 operations。 */
+export const meetingEbDecisionOperations = [
+    decisionPublishPrepare,
+    decisionPublishApply,
+    signMarkPrepare,
+    signMarkApply,
+];
+/** 供测试与调用方复用的常量（避免魔法值散落）。 */
+export const EB_DECISION_CONSTANTS = { DECISION_DONE, MT_STATUS_OVER };