weaver-work-cli 0.1.7 → 0.1.20

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

@@ -0,0 +1,390 @@
+/**
+ * 会议 EB 版（eBuilder 低代码应用）接口目录 —— 声明式清单。
+ *
+ * 全部 interfacePk 与字段契约来自源资料
+ * `skill汇总/非cli/weaver-e10-meeting/references/meeting-business-logic.md`
+ * 「第二部分：EB 版接口契约」（interfacePk 清单 / URL query 参数清单 / 写操作 body 字段清单）。
+ *
+ * 通用调用约定（资料核实）：
+ * - saveFormData / updateFormData / deleteFormData / getFormDataByPk / getFormDataList / getFormDataCount
+ *   路径前缀 `/api/ebuilder/form/formdata/v2/`。
+ * - list / count：筛选条件走 **URL query**（参数名为 eBuilder 配置的占位符名，不是表 dataKey），
+ *   body 仍必须带 datajson；count 与 list 必须用**相同筛选条件**。
+ * - 详情 / 写：只用 body（详情 body 顶层 mainTable；写操作 body 用 datas 数组包裹 mainTable）。
+ * - 写操作日期字段统一 `yyyy-MM-dd HH:mm`（不带秒）；create 不传 id，update/delete 必传 id。
+ */
+const MEETING_FIELDS_CREATE = [
+    'mt_creator', 'mt_name', 'begin_datetime', 'end_datetime', 'mt_status', 'operate_type',
+    'is_decision', 'mt_type', 'caller', 'contacter', 'mt_format', 'mt_desc', 'mt_hours',
+    'address', 'org_members', 'hrm_members', 'total_member',
+];
+const MEETING_FIELDS_CHANGE = [
+    'id', 'operate_type', 'mt_creator', 'inviters', 'topic_presenter', 'project', 'mt_address_hrms',
+    'mt_name', 'decision_Id', 'quicktimedesc', 'is_decision', 'mt_type', 'video_url', 'with_secauth',
+    'caller', 'contacter', 'project_files', 'mt_format', 'mt_desc', 'mt_accessorys',
+    'begin_datetime', 'end_datetime', 'all_day', 'mt_hours', 'address', 'customize_address',
+    'org_members', 'hrm_members', 'total_member', 'other_members', 'crm_members', 'crm_total_member',
+    'next_occur_date', 'repeat_status', 'repeat_id', 'request_id', 'mt_status',
+    'attend_user', 'reporting_user',
+];
+const ROOM_FIELDS = [
+    'id', 'room_name', 'hrm_ids', 'org_id', 'status', 'mr_type', 'place', 'room_attr',
+    'allow_minnum', 'allow_maxnum', 'rs_style', 'room_desc', 'equipments', 'dsporder', 'images',
+    'work_place', 'vrm_check', 'slaver_rooms', 'arrange_seat',
+    'min_numchk', 'min_numchk_type', 'max_numchk', 'max_numchk_type',
+    'can_orderday', 'only_workday', 'max_orderday',
+];
+export const EB_ENDPOINTS = [
+    {
+        domain: 'meeting',
+        operation: 'meeting.eb.meeting.list',
+        kind: 'list',
+        interfacePk: 'query_mtDetail_list',
+        countPk: 'query_mtDetail_count',
+        queryParams: [
+            'mt_id', 'creator', 'mt_name', 'mt_status', 'mt_type', 'caller', 'contacter',
+            'enddatetime', 'begindatetime', 'address', 'hrmmember', 'attend_user', 'reporting_user',
+            'topic_presenter', 'request_id',
+        ],
+        summary: 'EB 版会议列表（query_mtDetail_list + count）：URL query 传筛选条件，body 带 datajson',
+        notes: [
+            'hrmmember 等人员参数必须传员工 id，不能传姓名文本。',
+            'mt_status：0草稿/1审批中/2未开始/3退回/4取消/5提前结束/6删除/7锁定/8结束/9进行中/10审批中(变更)/11审批中(取消)。',
+            'enddatetime=开始时间<(lt)、begindatetime=结束时间>(gt)。',
+        ],
+    },
+    {
+        domain: 'meeting',
+        operation: 'meeting.eb.meeting.detail',
+        kind: 'detail',
+        interfacePk: 'query_mtDetail_info',
+        summary: 'EB 版会议详情（query_mtDetail_info，body 顶层 mainTable 传 id）',
+    },
+    {
+        domain: 'meeting',
+        operation: 'meeting.eb.meeting.create',
+        kind: 'create',
+        interfacePk: 'create_meeting',
+        fields: MEETING_FIELDS_CREATE,
+        requiredFields: ['mt_creator', 'mt_name', 'begin_datetime', 'end_datetime', 'mt_status', 'operate_type'],
+        dateFields: ['begin_datetime', 'end_datetime'],
+        summary: 'EB 版新建会议（create_meeting）：datas[].mainTable 传字段，不传 id',
+        notes: [
+            'caller/contacter 未指明时默认当前操作人。',
+            'mt_hours 由 CLI 按 begin/end 自动计算（小时，支持小数）。',
+        ],
+    },
+    {
+        domain: 'meeting',
+        operation: 'meeting.eb.meeting.change',
+        kind: 'update',
+        interfacePk: 'change_meeting',
+        fields: MEETING_FIELDS_CHANGE,
+        requiredFields: ['id', 'operate_type'],
+        dateFields: ['begin_datetime', 'end_datetime', 'next_occur_date'],
+        summary: 'EB 版变更会议（change_meeting）：必传 id + operate_type；取消会议也用本接口',
+        notes: ['变更用 CHANGE；取消用 CANCEL 并置 mt_status=4。'],
+    },
+    {
+        domain: 'meeting',
+        operation: 'meeting.eb.meeting.delete',
+        kind: 'delete',
+        interfacePk: 'delete_mtDetail',
+        summary: 'EB 版删除会议（delete_mtDetail）：仅传 id',
+    },
+    {
+        domain: 'room',
+        operation: 'meeting.eb.room.list',
+        kind: 'list',
+        interfacePk: 'query_meeting_room_list',
+        countPk: 'query_meeting_room_count',
+        queryParams: ['manager', 'departmentId', 'mr_type', 'room_attr'],
+        summary: 'EB 版会议室列表（query_meeting_room_list + count）',
+        notes: ['room_attr：0实体/1虚拟/2组合。'],
+    },
+    {
+        domain: 'room',
+        operation: 'meeting.eb.room.detail',
+        kind: 'detail',
+        interfacePk: 'query_room_info',
+        summary: 'EB 版会议室详情（query_room_info，body 顶层 mainTable 传 id）',
+    },
+    {
+        domain: 'room',
+        operation: 'meeting.eb.room.create',
+        kind: 'create',
+        interfacePk: 'create_room',
+        fields: ROOM_FIELDS,
+        requiredFields: ['room_name', 'hrm_ids', 'org_id', 'status'],
+        summary: 'EB 版新建会议室（create_room）：必填 room_name / hrm_ids / org_id / status',
+        notes: ['equipments：0电视/1电话/2投影仪/3白板/4视频会议，逗号分隔；status：0正常/1封存。'],
+    },
+    {
+        domain: 'room',
+        operation: 'meeting.eb.room.update',
+        kind: 'update',
+        interfacePk: 'update_room',
+        fields: ROOM_FIELDS,
+        requiredFields: ['id'],
+        summary: 'EB 版更新会议室（update_room）：仅 id 必填',
+    },
+    {
+        domain: 'room',
+        operation: 'meeting.eb.room.delete',
+        kind: 'delete',
+        interfacePk: 'delete_room',
+        summary: 'EB 版删除会议室（delete_room）：仅传 id',
+    },
+    {
+        domain: 'roomUsage',
+        operation: 'meeting.eb.roomUsage.list',
+        kind: 'list',
+        interfacePk: 'query_roomusage_list',
+        countPk: 'query_roomusage_count',
+        queryParams: ['mt_id', 'address', 'enddatetime', 'begindatetime'],
+        summary: 'EB 版会议室占用列表（query_roomusage_list + count）',
+    },
+    {
+        domain: 'roomUsage',
+        operation: 'meeting.eb.roomUsage.detail',
+        kind: 'detail',
+        interfacePk: 'query_roomusage',
+        summary: 'EB 版会议室占用详情（query_roomusage，body 顶层 mainTable 传 id）',
+    },
+    {
+        domain: 'roomUsage',
+        operation: 'meeting.eb.roomUsage.create',
+        kind: 'create',
+        interfacePk: 'create_roomusage',
+        fields: ['mt_id', 'room_id', 'startdate', 'enddate', 'from_module', 'agenda_id'],
+        requiredFields: ['mt_id'],
+        dateFields: ['startdate', 'enddate'],
+        summary: 'EB 版新建会议室占用（create_roomusage）：必填 mt_id',
+    },
+    {
+        domain: 'roomUsage',
+        operation: 'meeting.eb.roomUsage.delete',
+        kind: 'delete',
+        interfacePk: 'delete_roomusage',
+        summary: 'EB 版删除会议室占用（delete_roomusage）：取消会议释放占用，仅传 id',
+    },
+    {
+        domain: 'sign',
+        operation: 'meeting.eb.sign.list',
+        kind: 'list',
+        interfacePk: 'query_meeting_sign_list',
+        countPk: 'query_meeting_sign_count',
+        queryParams: ['mt_id', 'signMember', 'sign_status', 'sign_back_status'],
+        summary: 'EB 版签到列表（query_meeting_sign_list + count）',
+        notes: [
+            'sign_status：0缺席/1正常/2请假/3迟到/4早退/5未签退/6迟到未签退/7迟到早退；sign_back_status：0已签退/1未签退/2早退。',
+            '未签到判断：sign_time 为空或查不到记录。',
+            '已知偶发：fields 同时含 sign_flag 与 attend_type 可能触发后端 500。',
+        ],
+    },
+    {
+        domain: 'sign',
+        operation: 'meeting.eb.sign.detail',
+        kind: 'detail',
+        interfacePk: 'query_meeting_sign_info',
+        summary: 'EB 版签到详情（query_meeting_sign_info，body 顶层 mainTable 传 id）',
+    },
+    {
+        domain: 'sign',
+        operation: 'meeting.eb.sign.create',
+        kind: 'create',
+        interfacePk: 'create_meeting_sign',
+        fields: [
+            'mt_id', 'hylx', 'site', 'sign_flag', 'user_id', 'attend_type', 'sign_time', 'sign_reson',
+            'is_sign', 'longitude', 'latitude', 'sign_remark', 'signback_time', 'backsite', 'map_type',
+            'allow_late_time', 'external_flag', 'sub_dept', 'department', 'sign_out_status',
+        ],
+        requiredFields: ['mt_id'],
+        dateFields: ['sign_time', 'signback_time', 'allow_late_time'],
+        summary: 'EB 版新建签到记录（create_meeting_sign）：必填 mt_id',
+    },
+    {
+        domain: 'sign',
+        operation: 'meeting.eb.sign.update',
+        kind: 'update',
+        interfacePk: 'update_meeting_sign_info',
+        fields: [
+            'id', 'mt_id', 'hylx', 'site', 'sign_flag', 'user_id', 'attend_type', 'sign_time', 'sign_reson',
+            'is_sign', 'longitude', 'latitude', 'sign_remark', 'signback_time', 'backsite', 'map_type',
+            'allow_late_time', 'external_flag', 'sub_dept', 'department', 'sign_out_status',
+        ],
+        requiredFields: ['id', 'mt_id'],
+        dateFields: ['sign_time', 'signback_time', 'allow_late_time'],
+        summary: 'EB 版更新签到记录（update_meeting_sign_info）：必传 id + mt_id',
+    },
+    {
+        domain: 'receipt',
+        operation: 'meeting.eb.receipt.list',
+        kind: 'list',
+        interfacePk: 'query_meeting_receipt_list',
+        countPk: 'query_meeting_receipt_count',
+        queryParams: ['mt_id', 'hrmmember', 'is_attend'],
+        summary: 'EB 版回执列表（query_meeting_receipt_list + count）',
+        notes: ['is_attend：0否/1是。'],
+    },
+    {
+        domain: 'receipt',
+        operation: 'meeting.eb.receipt.detail',
+        kind: 'detail',
+        interfacePk: 'query_meeting_receipt',
+        summary: 'EB 版回执详情（query_meeting_receipt，body 顶层 mainTable 传 id）',
+    },
+    {
+        domain: 'receipt',
+        operation: 'meeting.eb.receipt.create',
+        kind: 'create',
+        interfacePk: 'create_meeting_receipt',
+        fields: [
+            'mt_id', 'member_type', 'member_id', 'member_manager', 'attend_status', 'book_room',
+            'room_stander', 'book_ticket', 'ticket_stander', 'other_member', 'remark', 'ticket_type',
+            'request_id', 'invite_person', 'arrive_date_time', 'return_date_time',
+            'crm_member_id', 'crm_member', 'msg_id',
+        ],
+        requiredFields: ['mt_id', 'member_type', 'member_id', 'member_manager'],
+        dateFields: ['arrive_date_time', 'return_date_time'],
+        summary: 'EB 版新建回执（create_meeting_receipt）：member_manager 取值等于 member_id',
+        notes: ['member_type：1参会人员/2参会客户/3其他人员。'],
+    },
+    {
+        domain: 'receipt',
+        operation: 'meeting.eb.receipt.update',
+        kind: 'update',
+        interfacePk: 'update_meeting_receipt',
+        fields: [
+            'id', 'mt_id', 'member_type', 'member_id', 'member_manager', 'attend_status', 'book_room',
+            'room_stander', 'book_ticket', 'ticket_stander', 'other_member', 'remark', 'ticket_type',
+            'request_id', 'invite_person', 'arrive_date_time', 'return_date_time',
+            'crm_member_id', 'crm_member', 'msg_id',
+        ],
+        requiredFields: ['id', 'mt_id', 'member_id', 'attend_status'],
+        dateFields: ['arrive_date_time', 'return_date_time'],
+        summary: 'EB 版更新回执（update_meeting_receipt）：attend_status 0否/1是',
+    },
+    {
+        domain: 'minute',
+        operation: 'meeting.eb.minute.list',
+        kind: 'list',
+        interfacePk: 'query_meeting_minute_list',
+        countPk: 'query_meeting_minute_count',
+        queryParams: ['mt_id'],
+        summary: 'EB 版会议纪要列表（query_meeting_minute_list + count，按 mt_id 查）',
+        notes: ['创建纪要的自定义接口未提供（走 OpenAPI），CLI 未实现该写操作。'],
+    },
+    {
+        domain: 'type',
+        operation: 'meeting.eb.type.list',
+        kind: 'list',
+        interfacePk: 'query_mt_type_list',
+        countPk: 'query_mt_type_count',
+        queryParams: ['mt_type_name'],
+        summary: 'EB 版会议类型列表（query_mt_type_list + count）',
+    },
+    {
+        domain: 'type',
+        operation: 'meeting.eb.type.create',
+        kind: 'create',
+        interfacePk: 'create_mt_type',
+        fields: ['type_name', 'dsporder', 'org_id', 'room_range'],
+        requiredFields: ['type_name'],
+        summary: 'EB 版新建会议类型（create_mt_type）：必填 type_name',
+        notes: ['caller_range/member_range 不支持新建/更新。'],
+    },
+    {
+        domain: 'type',
+        operation: 'meeting.eb.type.delete',
+        kind: 'delete',
+        interfacePk: 'delete_mt_type',
+        summary: 'EB 版删除会议类型（delete_mt_type）：仅传 id',
+    },
+    {
+        domain: 'topicType',
+        operation: 'meeting.eb.topicType.list',
+        kind: 'list',
+        interfacePk: 'query_mt_topicType_list',
+        countPk: 'query_mt_topicType_count',
+        queryParams: [],
+        summary: 'EB 版议题类型列表（query_mt_topicType_list + count）',
+    },
+    {
+        domain: 'topicType',
+        operation: 'meeting.eb.topicType.detail',
+        kind: 'detail',
+        interfacePk: 'query_mt_topicType_info',
+        summary: 'EB 版议题类型详情（query_mt_topicType_info，body 顶层 mainTable 传 id）',
+    },
+    {
+        domain: 'topicType',
+        operation: 'meeting.eb.topicType.update',
+        kind: 'update',
+        interfacePk: 'update_mt_topicType_info',
+        fields: ['id', 'name', 'topic_type_num', 'topic_type_name', 'data_status'],
+        requiredFields: ['id'],
+        summary: 'EB 版更新议题类型（update_mt_topicType_info）：必传 id',
+    },
+    {
+        domain: 'topicType',
+        operation: 'meeting.eb.topicType.delete',
+        kind: 'delete',
+        interfacePk: 'delete_mt_topicType_info',
+        summary: 'EB 版删除议题类型（delete_mt_topicType_info）：仅传 id',
+    },
+    {
+        domain: 'topic',
+        operation: 'meeting.eb.topic.list',
+        kind: 'list',
+        interfacePk: 'query_mt_topic_list',
+        countPk: 'query_mt_topic_count',
+        queryParams: [],
+        summary: 'EB 版会议议题列表（query_mt_topic_list + count）',
+        notes: ['议题表 uf_mt_topic 在部分租户未注册，返回空数组属正常。'],
+    },
+    {
+        domain: 'topic',
+        operation: 'meeting.eb.topic.detail',
+        kind: 'detail',
+        interfacePk: 'query_mt_topic_info',
+        summary: 'EB 版会议议题详情（query_mt_topic_info，body 顶层 mainTable 传 id）',
+    },
+    {
+        domain: 'topic',
+        operation: 'meeting.eb.topic.update',
+        kind: 'update',
+        interfacePk: 'update_mt_topic_info',
+        fields: [
+            'id', 'name', 'relate_topic', 'topic_status', 'topic_presenter', 'topic_type', 'topic_no',
+            'attend_user', 'attending_units', 'reporting_user', 'reporting_unit', 'start_time', 'end_time',
+            'topic_materials', 'mt_id', 'row_id', 'data_status',
+        ],
+        requiredFields: ['id'],
+        dateFields: ['start_time', 'end_time'],
+        summary: 'EB 版更新会议议题（update_mt_topic_info）：必传 id',
+        notes: ['topic_status：0待开始/1进行中/2已结束。'],
+    },
+    {
+        domain: 'topic',
+        operation: 'meeting.eb.topic.delete',
+        kind: 'delete',
+        interfacePk: 'delete_mt_topic_info',
+        summary: 'EB 版删除会议议题（delete_mt_topic_info）：仅传 id',
+    },
+    {
+        domain: 'baseSet',
+        operation: 'meeting.eb.baseSet.get',
+        kind: 'get',
+        interfacePk: 'query_meeting_baseset',
+        summary: 'EB 版会议应用设置（query_meeting_baseset，返回 1 条，多条取第一条）',
+        notes: [
+            '关键字段：open_mt_approve / only_flow_create / mt_new_wf / mt_approve_cancel / mt_approve_change。',
+            '据此判断 EB 版建会是否需走流程（审批开启 → 走 workflow，不由 CLI 直接建会）。',
+        ],
+    },
+];
+/** 写操作（create/update/delete）需要确认链。 */
+export function isWriteKind(kind) {
+    return kind === 'create' || kind === 'update' || kind === 'delete';
+}