weaver-work-cli 0.1.29 → 0.1.31

package/dist/shortcuts/meeting/operations/invitation.js

@@ -0,0 +1,458 @@
+/**
+ * 会议邀请函 docx 生成（需求 ⑦）—— 只生成、不发送。
+ *
+ * 场景（2026-10-23 用户定稿）：在小E 智能体工作台里，按会议真实数据生成一份邀请函 docx，
+ * 项目人员拿到后自行修改再对外发出。
+ *
+ * 已锁定的产品决策：
+ * - 邀请对象是**一个组织**（不是个人）⇒ 单份文档，不做逐人循环、不做发送。
+ * - 模板固定为「泛微标准模板」，**不支持替换**（无 templatePath 入参）。
+ * - 取不到的字段渲染成**黄色高亮 + 【待补充】**，让人工一眼看到要改哪里。
+ * - 租户自定义字段（如「来访客户名称」）**接口不会返回**，只能由 `extra` 传入；
+ *   实现上仍保留「接口有值优先、extra 覆盖」的顺序，便于将来接口补字段时零改动。
+ * - 数据源必须是 `meeting.eb.meeting.list` 单查（47 字段）；
+ *   `meeting.eb.meeting.detail` 在该环境只回 `{id}`，不可用。
+ */
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { meetingValidationError } from '../errors.js';
+import { meetingStateDir } from './env.js';
+import { renderDocx } from '../invitation/docx.js';
+import { meetingSuccess, SCHEMA_ID } from './types.js';
+/** 模板随 CLI 包分发（`templates/` 已在 package.json 的 files 白名单内）。 */
+function templatePath() {
+    const override = process.env.WEAVER_MEETING_INVITATION_TEMPLATE;
+    if (override)
+        return resolve(override);
+    // 本文件编译后位于 <pkg>/dist/shortcuts/meeting/operations/，向上四级即包根
+    const here = dirname(fileURLToPath(import.meta.url));
+    return resolve(here, '../../../../templates/meeting/invitation.docx');
+}
+const WEEKDAYS = ['星期日', '星期一', '星期二', '星期三', '星期四', '星期五', '星期六'];
+/**
+ * 落款公司全称的兜底值。
+ *
+ * 口径（2026-10-23 用户确认）：落款默认用**公司全称**，不是部门；泛微场景下就是这一串。
+ * 对外开放时客户不需要改代码 —— 传 `extra.company_name` 即可覆盖（优先级最高）。
+ * 之所以不做成"取 E10 根组织名"：组织树里只有「泛微网络」，没有工商全称。
+ */
+const DEFAULT_COMPANY_NAME = '上海泛微网络科技股份有限公司';
+function pad(value) {
+    return String(value).padStart(2, '0');
+}
+/** 解析 `yyyy-MM-dd HH:mm`（接口返回口径，不带秒）。 */
+function parseDateTime(raw) {
+    const text = String(raw ?? '').trim();
+    const match = /^(\d{4})-(\d{2})-(\d{2})[ T](\d{2}):(\d{2})/.exec(text);
+    if (!match)
+        return null;
+    const [, y, m, d, hh, mm] = match;
+    const date = new Date(Number(y), Number(m) - 1, Number(d), Number(hh), Number(mm));
+    return Number.isNaN(date.getTime()) ? null : date;
+}
+function formatDate(date) {
+    return `${date.getFullYear()}年${pad(date.getMonth() + 1)}月${pad(date.getDate())}日`;
+}
+function formatTime(date) {
+    return `${pad(date.getHours())}:${pad(date.getMinutes())}`;
+}
+/** 姓名串：接口给的是英文逗号分隔，正式函件需要中文顿号。 */
+function humanizeMembers(raw) {
+    const text = String(raw ?? '').trim();
+    if (!text)
+        return '';
+    return text
+        .split(/[,，;；]/)
+        .map((item) => item.trim())
+        .filter(Boolean)
+        .join('、');
+}
+function safeFileName(text) {
+    return text.replace(/[\\/:*?"<>|\r\n]+/g, '_').replace(/\s+/g, ' ').trim().slice(0, 80) || '未命名会议';
+}
+const AGENDA_HEADER_KEYWORD = '议程';
+/** 时间段文案：`14:00-14:45`；只有起点时给起点；都没有返回空串。 */
+function formatTimeRange(start, end) {
+    if (start && end)
+        return `${formatTime(start)}-${formatTime(end)}`;
+    if (start)
+        return formatTime(start);
+    return '';
+}
+/**
+ * 取会议议题并转成议程表行。
+ *
+ * 口径（2026-10-23 与用户确认）：**有议题就按议题填，没有就保留模板原样**。
+ * 议题表在部分租户未注册（返回空数组属正常），所以这里任何失败都静默降级为空，
+ * 由调用方继续走「extra → 模板原样」的兜底，绝不能因为取议题失败让邀请函生成失败。
+ */
+export async function loadAgendaFromTopics(env, mtId) {
+    try {
+        const { getMeetingOperation } = await import('./registry.js');
+        const operation = getMeetingOperation('meeting.eb.topic.list');
+        const result = await operation.handler({ mt_id: mtId, pageNo: 1, pageSize: 200 }, env);
+        const rows = (result.data?.rows ?? []);
+        const topics = rows.map((item) => item?.mainTable ?? item);
+        const items = topics
+            .filter((topic) => String(topic?.mt_id ?? '').trim() === mtId)
+            .map((topic) => ({
+            // 2026-10-28 用户纠正：议题名称用 `topic_title`，不能用 `name`
+            // （那是 eBuilder 自动标题「议题库-张三 2026-10-27 18:18」，不是业务字段）。
+            title: String(topic?.topic_title ?? '').trim(),
+            // 议程内容 = 议题内容概要
+            content: String(topic?.topic_content ?? '').trim(),
+            num: String(topic?.topic_num ?? '').trim(),
+            start: null,
+            end: null,
+        }))
+            .filter((item) => item.title !== '');
+        // 时间段在**会议议题明细**（detail1）里，议题库表没有 start/end——
+        // 按 topic_num ↔ detail1.topic_no 匹配；匹配不上就留空，不阻塞议程。
+        try {
+            const detailOp = getMeetingOperation('meeting.eb.meeting.detail');
+            const detail = await detailOp.handler({ id: mtId }, env);
+            const detail1 = (detail.data?.details?.detail1 ?? []);
+            const timeByNum = new Map();
+            for (const row of detail1) {
+                const no = String(row?.topic_no ?? '').trim();
+                if (!no)
+                    continue;
+                timeByNum.set(no, {
+                    start: parseDateTime(row?.start_time),
+                    end: parseDateTime(row?.end_time),
+                });
+            }
+            for (const item of items) {
+                const times = item.num ? timeByNum.get(item.num) : undefined;
+                if (times) {
+                    item.start = times.start;
+                    item.end = times.end;
+                }
+            }
+        }
+        catch {
+            // 明细取不到（旧环境 detail 不回明细）→ 时间列留空，议程其余照常
+        }
+        // 有开始时间的排前面并按时间升序，没有时间的排后面（保持接口原顺序）
+        const indexed = items.map((item, index) => ({ ...item, index }));
+        indexed.sort((left, right) => {
+            const leftTime = left.start ? left.start.getTime() : Number.POSITIVE_INFINITY;
+            const rightTime = right.start ? right.start.getTime() : Number.POSITIVE_INFINITY;
+            return leftTime === rightTime ? left.index - right.index : leftTime - rightTime;
+        });
+        // 列顺序 = 模板列顺序（议程安排 | 议程内容 | 议程时间），2026-10-28 用户纠正
+        return indexed.map((item) => [
+            item.title,
+            item.content,
+            formatTimeRange(item.start, item.end),
+        ]);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * `extra.agenda` 兜底：按行拆分（换行或分号），每行写成 `议程安排|议程内容|议程时间`
+ * （即 模板列顺序直传：议题名称|内容概要|时间段，2026-10-28 用户纠正列语义后同步调整）。
+ */
+function parseAgendaFromExtra(raw) {
+    const text = String(raw ?? '').trim();
+    if (!text)
+        return [];
+    return text
+        .split(/[\r\n;；]+/u)
+        .map((line) => line.trim())
+        .filter(Boolean)
+        .map((line) => {
+        const parts = line.split('|').map((part) => part.trim());
+        const [name = '', content = '', timeRange = ''] = parts.length > 1 ? parts : [parts[0], '', ''];
+        return [name, content, timeRange];
+    })
+        .filter((row) => row[0] !== '');
+}
+/**
+ * 把会议接口返回的任意字段值压成可渲染文本。
+ * - 字符串/数字/布尔：直接返回
+ * - 数组：逐个取值后用「、」拼接（人员多选/部门多选常见）
+ * - 对象：优先 name / label / text（EB 的人员、部门、关联记录控件都是这种形态）
+ * 取不到返回 undefined，交由调用方走【待补充】。
+ */
+function flattenFieldValue(raw) {
+    if (raw === undefined || raw === null)
+        return undefined;
+    if (typeof raw === 'string')
+        return raw.trim() ? raw : undefined;
+    if (typeof raw === 'number' || typeof raw === 'boolean')
+        return String(raw);
+    if (Array.isArray(raw)) {
+        const parts = raw.map((item) => flattenFieldValue(item)).filter((item) => Boolean(item));
+        return parts.length > 0 ? parts.join('、') : undefined;
+    }
+    if (typeof raw === 'object') {
+        const record = raw;
+        for (const key of ['name', 'label', 'text', 'value', 'title']) {
+            const candidate = flattenFieldValue(record[key]);
+            if (candidate)
+                return candidate;
+        }
+    }
+    return undefined;
+}
+/**
+ * 取「发起人所属组织」。
+ *
+ * 背景（2026-10-23 用户口径）：落款单位默认应该是**发起人的所属组织**，而不是会议的
+ * `org_members`（很多会议该字段为空，真机实测 `会议申请流程-李四-2026-10-16` 就是空串）。
+ *
+ * 数据来源：会议行的 `creator` 字段是**人员 id**（真机实测 `6064722198805071427`），
+ * 用它调 `hrm.employee.batch`（按人员 id 批量取部门/上级公司）即可。
+ * 直接复用 hrm 业务线已实现的 operation，不复制接口契约，也不改它的代码。
+ *
+ * 失败一律**静默降级为 null**（落款继续走【待补充】），不能因为查人失败让整个邀请函生成失败。
+ */
+async function resolveIssuerOrganization(env, creatorId) {
+    try {
+        const { hrmEmployeeOperations } = await import('../../hrm/operations/employee.js');
+        const batch = hrmEmployeeOperations.find((operation) => operation.name === 'hrm.employee.batch');
+        if (!batch)
+            return null;
+        const result = await batch.handler({ ids: [creatorId] }, env);
+        const row = (result?.data?.rows ?? [])[0];
+        if (!row)
+            return null;
+        const department = String(row.department ?? '').trim();
+        const subCompany = String(row.subCompany ?? '').trim();
+        if (!department && !subCompany)
+            return null;
+        return {
+            ...(department ? { department } : {}),
+            ...(subCompany ? { subCompany } : {}),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/** 组装占位符解析器：派生字段 → 会议标准字段 → extra（租户自定义字段）→ 待补充。 */
+export function buildResolver(row, extra, issuerOrg) {
+    const begin = parseDateTime(row.begin_datetime);
+    const end = parseDateTime(row.end_datetime);
+    const derived = {
+        // 落款日期用「生成日期」，不是会议日期（邀请函是今天开出去的）
+        issue_date: formatDate(new Date()),
+    };
+    if (begin) {
+        derived.begin_date = formatDate(begin);
+        derived.begin_weekday = WEEKDAYS[begin.getDay()];
+        derived.begin_time = formatTime(begin);
+    }
+    if (end) {
+        derived.end_date = formatDate(end);
+        derived.end_time = formatTime(end);
+    }
+    if (begin && end) {
+        // 同日会议不重复日期（2026-10-28 用户纠正）：模板写的是 `会议时间：{begin_datetime}~{end_datetime}`，
+        // 原始字段直接拼接会渲染成「2026-10-28 09:00~2026-10-28 10:16」。
+        // 派生层覆写：同日 → end 只给时间（09:00~10:16）；跨日 → end 带完整日期。`~` 分隔。
+        // 日期部分取原始字段（2026-10-28），不用 formatDate（那是「2026年10月28日」中文落款格式）。
+        const beginDateIso = String(row.begin_datetime ?? '').trim().slice(0, 10) || formatDate(begin);
+        const sameDay = beginDateIso === String(row.end_datetime ?? '').trim().slice(0, 10);
+        const endPart = sameDay ? formatTime(end) : `${String(row.end_datetime ?? '').trim().slice(0, 10)} ${formatTime(end)}`;
+        derived.begin_datetime = `${beginDateIso} ${formatTime(begin)}`;
+        derived.end_datetime = endPart;
+        derived.time_range = `${beginDateIso} ${formatTime(begin)}~${endPart}`;
+    }
+    // 落款单位：优先会议自带的参会部门；为空时回落到**发起人所属组织**（部门 → 上级公司）。
+    // 真机实测 `org_members` 常年为空串，只用它会让落款永远是【待补充】。
+    const meetingOrg = humanizeMembers(row.org_members);
+    const issuerDepartment = issuerOrg?.department ?? '';
+    const issuerCompany = issuerOrg?.subCompany ?? '';
+    const orgMembers = meetingOrg || issuerDepartment || issuerCompany;
+    const orgSource = meetingOrg ? 'meeting.org_members'
+        : issuerDepartment ? 'issuer.department'
+            : issuerCompany ? 'issuer.subCompany'
+                : 'none';
+    const standard = {
+        mt_name: String(row.mt_name ?? ''),
+        mt_desc: String(row.mt_desc ?? ''),
+        address: String(row.address ?? ''),
+        hrm_members: humanizeMembers(row.hrm_members),
+        org_members: orgMembers,
+        // 落款公司全称：`extra.company_name` 可覆盖（对外开放时客户传自己的公司名）
+        company_name: String(extra.company_name ?? '').trim() || DEFAULT_COMPANY_NAME,
+        // 单独暴露上级公司，模板需要「公司级落款」时可直接用
+        issuer_company: issuerCompany,
+        other_members: humanizeMembers(row.other_members),
+        total_member: row.total_member === undefined || row.total_member === null ? '' : String(row.total_member),
+        video_url: String(row.video_url ?? ''),
+        // 召集人：会议没填 `caller` 时回落到**创建人** ——
+        // 否则整句「{caller} 诚邀您参加…」变成【待补充】，而用户明明能看到"召集人：张三"
+        // （那是创建人/参会人里的信息）。来源单独回报，别让调用方误以为是会议填的。
+        caller: String(row.caller ?? '').trim() || String(row.mt_creator ?? '').trim(),
+        contacter: String(row.contacter ?? ''),
+        topic_presenter: String(row.topic_presenter ?? ''),
+        mt_format: String(row.mt_format ?? ''),
+        mt_type: String(row.mt_type ?? ''),
+        mt_creator: String(row.mt_creator ?? ''),
+        with_secauth: String(row.with_secauth ?? ''),
+        begin_datetime: String(row.begin_datetime ?? ''),
+        end_datetime: String(row.end_datetime ?? ''),
+        create_time: String(row.create_time ?? ''),
+        request_id: String(row.request_id ?? ''),
+    };
+    const lookup = (key) => {
+        if (key in derived)
+            return derived[key];
+        if (key in standard)
+            return standard[key];
+        if (key.startsWith('extra.') && key.slice(6) in extra)
+            return extra[key.slice(6)];
+        if (key in extra)
+            return extra[key];
+        // 兜底：会议接口返回的**任意字段**都能直接用 `{dataKey}` 引用。
+        // 读侧（meeting.eb.meeting.list）不投影、不过滤字段，所以租户在 eBuilder 接口里
+        // 新增自定义字段（如「来访客户名称」）后，只要模板写 `{该字段的 dataKey}` 就能取值，
+        // CLI 不用改代码、不用发版。（对象型字段取 name，数组取各元素 name 拼接）
+        const raw = row[key];
+        const flattened = flattenFieldValue(raw);
+        if (flattened)
+            return flattened;
+        return undefined;
+    };
+    return {
+        resolver: (key) => {
+            const value = lookup(key);
+            const text = String(value ?? '').trim();
+            if (!text)
+                return { text: key, pending: true };
+            return { text };
+        },
+        labelOf: (key) => key,
+        orgSource,
+    };
+}
+const meetingInvitationRender = {
+    name: 'meeting.invitation.render',
+    resource: 'invitation',
+    method: 'render',
+    action: 'meeting.invitation.render',
+    summary: '按会议真实数据生成邀请函 docx（只读，不发送）：数据取 meeting.eb.meeting.list 单查；议程有议题就按议题自动填、没有则保留模板示例行；取不到的字段渲染成黄色高亮【待补充】；租户自定义字段用 extra 传入',
+    capability: 'invitation',
+    risk: 'read',
+    inputSchema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+            mtId: { ...SCHEMA_ID, description: '会议 id（EB 版 mt_detail 主键）' },
+            extra: {
+                type: 'object',
+                additionalProperties: { type: 'string' },
+                description: '租户自定义字段（如 guest_org=来访客户名称）。接口不会返回这类字段，只能从这里传；模板里写 {extra.guest_org} 或 {guest_org} 引用。另有保留键 agenda=议程（每行「内容」或「内容|时长|时间段」，换行分隔），仅在会议没有议题时生效',
+            },
+            outputPath: {
+                type: 'string',
+                description: '输出文件完整路径（可选）。缺省写到 ~/.weaver-work-cli/meeting/invitations/邀请函-{会议名}-{日期}.docx',
+            },
+        },
+        required: ['mtId'],
+    },
+    handler: async (args, env) => {
+        const mtId = String(args.mtId ?? '').trim();
+        if (!mtId) {
+            throw meetingValidationError('mt_id_required', '必须提供会议 id（mtId）');
+        }
+        const extra = {};
+        if (args.extra && typeof args.extra === 'object') {
+            for (const [key, value] of Object.entries(args.extra)) {
+                if (value !== undefined && value !== null)
+                    extra[key] = String(value);
+            }
+        }
+        // 复用已实现的 EB 列表操作（内部先 count 再 list，筛选走 URL query）
+        const { getMeetingOperation } = await import('./registry.js');
+        const listOperation = getMeetingOperation('meeting.eb.meeting.list');
+        let row;
+        try {
+            const listed = await listOperation.handler({ mt_id: mtId, pageNo: 1, pageSize: 1 }, env);
+            const rows = (listed.data?.rows ?? []);
+            row = rows[0]?.mainTable ?? rows[0];
+        }
+        catch (error) {
+            throw meetingValidationError('invitation_source_unavailable', `读取会议数据失败（邀请函当前依赖 EB 版会议列表）：${error instanceof Error ? error.message : String(error)}`, { mtId });
+        }
+        if (!row) {
+            throw meetingValidationError('not_found', `未找到会议 id=${mtId}，或当前账号无权限查看`, { mtId });
+        }
+        // 落款单位回落：会议 org_members 为空时，用「发起人（creator 人员 id）的所属组织」
+        const creatorId = String(row.creator ?? '').trim();
+        const needsIssuerOrg = !String(row.org_members ?? '').trim() && creatorId !== '';
+        const issuerOrg = needsIssuerOrg ? await resolveIssuerOrganization(env, creatorId) : null;
+        const { resolver, orgSource } = buildResolver(row, extra, issuerOrg);
+        // 议程：议题表 → extra.agenda → 保留模板里的示例行（用户口径：没有就这样）
+        let agendaRows = await loadAgendaFromTopics(env, mtId);
+        let agendaSource = agendaRows.length > 0 ? 'meeting.topic' : 'template';
+        if (agendaRows.length === 0) {
+            const fromExtra = parseAgendaFromExtra(extra.agenda);
+            if (fromExtra.length > 0) {
+                agendaRows = fromExtra;
+                agendaSource = 'extra';
+            }
+        }
+        let template;
+        try {
+            template = await readFile(templatePath());
+        }
+        catch (error) {
+            throw meetingValidationError('template_missing', `邀请函模板缺失：${templatePath()}（CLI 包应自带 templates/meeting/invitation.docx）`, { error: error instanceof Error ? error.message : String(error) });
+        }
+        const rendered = renderDocx(template, resolver, {
+            agenda: { headerKeyword: AGENDA_HEADER_KEYWORD, rows: agendaRows },
+        });
+        const begin = parseDateTime(row.begin_datetime);
+        const dateTag = begin ? `${begin.getFullYear()}${pad(begin.getMonth() + 1)}${pad(begin.getDate())}` : '未知日期';
+        const fileName = `邀请函-${safeFileName(String(row.mt_name ?? ''))}-${dateTag}.docx`;
+        const target = args.outputPath
+            ? resolve(String(args.outputPath))
+            : join(meetingStateDir(env.ctx), 'invitations', fileName);
+        await mkdir(dirname(target), { recursive: true });
+        await writeFile(target, rendered.buffer);
+        const warnings = [];
+        if (rendered.pending.length > 0) {
+            warnings.push(`以下字段取不到值，已渲染成黄色高亮【待补充】，请人工补充：${rendered.pending.join('、')}`);
+        }
+        if (rendered.skippedParagraphs > 0) {
+            warnings.push(`有 ${rendered.skippedParagraphs} 个含复杂结构（图片/超链接/域）的段落未做替换，请人工检查`);
+        }
+        if (agendaSource === 'template') {
+            warnings.push('该会议没有议题，议程表保留模板里的示例行（“15分钟/泛微公司介绍”等），请人工改成真实议程');
+        }
+        // 召集人缺失要讲清楚"为什么缺"，否则调用方会误以为"会议明明有召集人却让补"
+        // （2026-10-28 用户反馈的真实困惑：那是创建人/参会人，不是会议表的 caller 字段）。
+        if (String(row.caller ?? '').trim() === '') {
+            warnings.push(String(row.mt_creator ?? '').trim()
+                ? `会议未填「召集人」（caller 字段），邀请函已用**创建人**「${String(row.mt_creator).trim()}」代替；如不对可传 extra.caller 覆盖`
+                : '会议既没填「召集人」（caller）也没有创建人，邀请函里该处为【待补充】；可传 extra.caller 指定');
+        }
+        return meetingSuccess('meeting.invitation.render', {
+            filePath: target,
+            fileName,
+            bytes: rendered.buffer.length,
+            meetingId: mtId,
+            meetingName: String(row.mt_name ?? ''),
+            filledFields: rendered.filled,
+            pendingFields: rendered.pending,
+            // 落款单位的实际来源，便于调用方判断是否需要人工改写
+            orgSource,
+            // 召集人来源：meeting.caller=会议自己填的 / meeting.mt_creator=回落到创建人 / none=都没有
+            callerSource: String(row.caller ?? '').trim()
+                ? 'meeting.caller'
+                : (String(row.mt_creator ?? '').trim() ? 'meeting.mt_creator' : 'none'),
+            // 议程来源：meeting.topic=按议题自动填 / extra=调用方传入 / template=保留模板示例行
+            agendaSource,
+            agendaRows: agendaRows.length,
+            agendaTableFilled: rendered.agenda?.filled ?? false,
+        }, warnings.length > 0 ? { warnings } : undefined);
+    },
+};
+export const meetingInvitationOperations = [meetingInvitationRender];