'use strict'; const MainService = require('../../main'); /** * 系统方法层:report.deliveryPlan(货主报表投递计划接口包装层)。 * 仅做出口包装与参数解构,业务逻辑下沉 systems/reportDelivery。 */ class ReportDeliveryPlanMethodService extends MainService { constructor(ctx) { super(ctx); const _noNeedLogin = ''; // 计划管理属于管理类操作:不声明免权限,仅通配符角色(超级管理员/仓库管理员)可用, // 后续由 wms_permission 同步流程按需授权,不扩大任何角色授权范围 const _noNeedRight = ''; const _noNeedLog = ''; const _noNeedAuth = ''; this.systemInit(_noNeedLogin, _noNeedRight, _noNeedLog, _noNeedAuth); } /** * 新增/更新投递计划(货主+报表定义ID唯一,存在则更新)。 * @param {Object} data 请求体 * @param {number} data.store_id 货主ID(必填) * @param {number} data.report_id 报表定义ID(必填,兼容 reportId) * @param {Array} data.schedule_times 每日投递时间点数组(HH:mm,自动去重排序) * @param {string} [data.channel='inbox'] 投递渠道(仅支持 inbox) * @param {number} [data.late_grace_minutes=60] 补投宽限分钟(0-1440) * @param {string|null} [data.name] 计划名称(可空;未传不覆盖,null/空串清空,非空 trim ≤100) * @param {string} [data.remark] 备注 * @param {string} [data.notify_template] 文本通知模板(≤500,白名单标签 {time}/{url}/{report_name}/{biz_date}) * @param {Array} [data.notify_group_ids] 通知群ID数组(wms_inbox_group.id,≤20) * @param {Array} [data.notify_member_ids] 通知成员ID数组(外部IM用户ID,≤100) * @return {Promise} 统一 success 包装 */ async save(data = {}) { const { service } = this; const { store_id: storeId, report_id: reportIdSnake, reportId: reportIdCamel, schedule_times: scheduleTimes, channel, late_grace_minutes: lateGraceMinutes, name, remark, notify_template: notifyTemplate, notify_group_ids: notifyGroupIds, notify_member_ids: notifyMemberIds, } = data; // 基础参数解构透传;通知类参数仅在入参存在时附加, // 保持旧调用形状与既有回归断言一致(undefined 不进入参数对象) const saveArgs = { storeId, reportId: reportIdCamel !== undefined ? reportIdCamel : reportIdSnake, scheduleTimes, channel, lateGraceMinutes, remark, }; if (name !== undefined) { saveArgs.name = name; } if (notifyTemplate !== undefined) { saveArgs.notifyTemplate = notifyTemplate; } if (notifyGroupIds !== undefined) { saveArgs.notifyGroupIds = notifyGroupIds; } if (notifyMemberIds !== undefined) { saveArgs.notifyMemberIds = notifyMemberIds; } const result = await service.systems.reportDelivery.savePlan(saveArgs); return this.success('ok', result); } /** * 快速复制投递计划到其他货主(目标已存在相同报表定义计划时跳过,不覆盖不报错)。 * @param {Object} data 请求体 * @param {number} data.id 源计划ID(必填,正整数) * @param {Array} data.store_ids 目标货主ID数组(必填,兼容 storeIds 驼峰) * @return {Promise} 统一 success 包装,data={ created, skipped } */ async copy(data = {}) { const { service } = this; const { id, store_ids: storeIdsSnake, storeIds: storeIdsCamel, } = data; // 兼容 storeIds 驼峰入参,优先取驼峰形式,保持与 save 的 reportId 兼容口径一致 const storeIds = storeIdsCamel !== undefined ? storeIdsCamel : storeIdsSnake; const result = await service.systems.reportDelivery.copyPlan({ id, storeIds }); return this.success('ok', result); } /** * 分页查询投递计划列表。 * @param {Object} data 请求体 * @param {Object} [data.where] 查询条件(store_id/report_id/enabled) * @param {Object} [data.pagination] 分页 { page, pageSize } * @param {Object} [data.sort] 排序 { sortField, sortOrder } * @return {Promise} 统一 success 包装 */ async list(data = {}) { const { service } = this; const { whereValue = {} } = this.prepareWhereContext(data); const { store_id: storeId, report_id: reportId, enabled, } = whereValue; const { pagination = {}, sort = {} } = data; const result = await service.systems.reportDelivery.listPlans({ storeId, reportId, enabled, pagination, sort, }); return this.success('ok', result); } } module.exports = ReportDeliveryPlanMethodService;