diff --git a/app/service/inbox/functions.js b/app/service/inbox/functions.js index 1495f23..5a9c494 100644 --- a/app/service/inbox/functions.js +++ b/app/service/inbox/functions.js @@ -2173,7 +2173,10 @@ class InboxFunctionsService extends Service { // 第三步:创建工单(含原文)并映射 waybill_id → 工单号 const createdNos = []; - const waybillToAsNo = {}; // waybill_id → after_sale_no 映射 + const waybillToAsNo = {}; // waybill_id → after_sale_no 映射(新建 + 已存在) + for (const r of existingASList) { + waybillToAsNo[r.waybill_id] = r.after_sale_no; + } if (toCreate.length > 0) { const creatorLabel = [ groupName, userName ].filter(Boolean).join('-') || 'AI系统'; for (const e of toCreate) { @@ -2209,8 +2212,9 @@ class InboxFunctionsService extends Service { } // 第四步:原文转发到对应快递的售后群(按快递分组) + // 新建与已存在的工单都转发:客户再次发来的原文是快递需要的最新诉求 const expressByCode = {}; - for (const e of toCreate) { + for (const e of expressList) { const code = e.logistics_code || '__unknown__'; if (!expressByCode[code]) { expressByCode[code] = { interfaceId: e.logistics_interface_id, waybills: [] }; @@ -2245,7 +2249,7 @@ class InboxFunctionsService extends Service { }); notifiedTotal += 1; } - toCreate + expressList .filter(e => (e.logistics_code || '__unknown__') === code) .forEach(e => notifiedWaybillIds.add(e.id)); } catch (e) { @@ -2253,8 +2257,11 @@ class InboxFunctionsService extends Service { } } - // 第五步:有转发通知的工单升级 pending_feedback + 跟踪时限 - const notifiedAsNos = createdNos.filter((asNo, idx) => notifiedWaybillIds.has(toCreate[idx].id)); + // 第五步:有转发通知的工单升级 pending_feedback + 跟踪时限(新建与已有工单,仅 pending 状态升级) + const notifiedAsNos = expressList + .filter(e => notifiedWaybillIds.has(e.id)) + .map(e => waybillToAsNo[e.id]) + .filter(Boolean); if (notifiedAsNos.length > 0) { try { const hours = await ctx.service.systems.afterSale._resolveFollowupHours( @@ -2266,7 +2273,12 @@ class InboxFunctionsService extends Service { followup_at: ctx.app.Sequelize.literal(`DATE_ADD(NOW(), INTERVAL ${hours} HOUR)`), role_group: 'customer_service', }, - { where: { after_sale_no: { [ctx.app.Sequelize.Op.in]: notifiedAsNos } } } + { + where: { + after_sale_no: { [ctx.app.Sequelize.Op.in]: notifiedAsNos }, + status: 'pending', + }, + } ); } catch (e) { ctx.logger.warn(`[inbox functions] 改地址/催退回更新工单状态失败: ${e.message}`); @@ -3331,6 +3343,15 @@ class InboxFunctionsService extends Service { const asType = String(params.as_type || 'order').trim() || 'order'; const asSubType = String(params.as_sub_type || 'logistics_issue').trim() || 'logistics_issue'; + // 工单详细描述中的售后类型/子类型显示中文名称(存储仍用英文编码) + const asTypesMeta = (ctx.model.AfterSale && ctx.model.AfterSale.AFTER_SALE_TYPES) || []; + const asTypeMeta = asTypesMeta.find(t => t.type === asType); + const asTypeName = (asTypeMeta && asTypeMeta.name) || asType; + const asSubTypeMeta = asTypeMeta && Array.isArray(asTypeMeta.subType) + ? asTypeMeta.subType.find(s => s.value === asSubType) + : null; + const asSubTypeName = (asSubTypeMeta && asSubTypeMeta.name) || asSubType; + if (!raw) return { success: false, error: '请提供运单号' }; if (!warehouseId) return { success: false, error: '无法获取仓库信息' }; @@ -3419,7 +3440,7 @@ class InboxFunctionsService extends Service { const description = [ `运单号: ${e.waybill_code}`, `快递公司: ${e.logistics_name || '未知'}`, - `售后类型: ${asType}.${asSubType}`, + `售后类型: ${asTypeName}.${asSubTypeName}`, '来源: 快递群反馈', feedbackMsgContent ? `原文: ${feedbackMsgContent}` : '', ].filter(Boolean).join('\n'); @@ -3553,6 +3574,7 @@ class InboxFunctionsService extends Service { where: { group_id: { [ctx.app.Sequelize.Op.in]: candidateGroupIds }, warehouse_id: warehouseId, + is_blocked: 0, }, raw: true, }); diff --git a/app/service/inbox/processor.js b/app/service/inbox/processor.js index da1f138..7e17f10 100644 --- a/app/service/inbox/processor.js +++ b/app/service/inbox/processor.js @@ -28,7 +28,7 @@ class InboxProcessorService extends Service { * @param {string} groupId 外部群ID * @param {number} warehouseId 仓库ID * @param {Object|null} msgExtData 入站消息的 ext_data - * @return {Promise<{group_type: string, sub_type: string, ai_enabled: number, ext_data: Object|null}>} + * @return {Promise<{group_type: string, sub_type: string, ai_enabled: number, ext_data: Object|null}>} 群类型/子类型/AI开关/扩展数据 */ async _loadGroupInfo(groupId, warehouseId, msgExtData) { const { ctx } = this; diff --git a/app/service/inbox/receiver.js b/app/service/inbox/receiver.js index 9c4529b..38fee5b 100644 --- a/app/service/inbox/receiver.js +++ b/app/service/inbox/receiver.js @@ -165,27 +165,19 @@ class InboxReceiverService extends Service { ); } } else { - // 群ID不存在:优先兼容同名群回填群ID;都没有才新建。 - // 注意表上已无 (group_name, warehouse_id) 唯一索引,名称维度不再保证唯一。 - const byName = await ctx.model.InboxGroup.findOne({ - where: { group_name: groupName, warehouse_id: warehouseId }, + // 群ID不存在:按群ID直接新建(群以ID为准,不按名称匹配既有群) + await ctx.model.InboxGroup.create({ + group_name: groupName, + group_id: extGroupId, + warehouse_id: warehouseId, + store_id: storeId || null, + source_type: sourceType, + source_extra: data.source_extra || null, + ai_enabled: 0, }); - if (byName) { - await byName.update({ group_id: extGroupId }); - ctx.logger.info( - `[inbox] 同名群回填群ID group_id=${extGroupId} name=${groupName}` - ); - } else { - await ctx.model.InboxGroup.create({ - group_name: groupName, - group_id: extGroupId, - warehouse_id: warehouseId, - store_id: storeId || null, - source_type: sourceType, - source_extra: data.source_extra || null, - ai_enabled: 0, - }); - } + ctx.logger.info( + `[inbox] 新建群记录 group_id=${extGroupId} name=${groupName}` + ); } } else { // 无群ID:按 (group_name, warehouse_id) 幂等登记(向后兼容) diff --git a/app/service/systemMethods/afterSale.js b/app/service/systemMethods/afterSale.js index e8d670c..6065d10 100644 --- a/app/service/systemMethods/afterSale.js +++ b/app/service/systemMethods/afterSale.js @@ -516,6 +516,7 @@ class AfterSaleMethodService extends MainService { operatorId, operatorSnapshot, warehouseId, + notifyGroup: true, }); return this.success('处理成功', result); diff --git a/app/service/systemMethods/inbox.js b/app/service/systemMethods/inbox.js index 018de3c..387a7a3 100644 --- a/app/service/systemMethods/inbox.js +++ b/app/service/systemMethods/inbox.js @@ -9,13 +9,14 @@ const MainService = require('../main'); class InboxSystemService extends MainService { /** * 群管理子入口,供 /system dispatcher 按 inbox.group.* 路径访问。 - * @return {{list: Function, disable: Function, update: Function, messages: Function, checkAuth: Function}} + * @return {{list: Function, disable: Function, update: Function, reset: Function, messages: Function, checkAuth: Function}} */ get group() { return { list: data => this.groupList(data), disable: data => this.groupDisable(data), update: data => this.groupUpdate(data), + reset: data => this.groupReset(data), messages: data => this.groupMessages(data), checkAuth: (...args) => this.checkAuth(...args), }; @@ -158,6 +159,25 @@ class InboxSystemService extends MainService { return { message: '群信息修改成功' }; } + /** + * 清空群类型配置(入参主键ID或外部群ID)。 + * 清空 group_type / sub_type / store_id / 快递专属字段,AI 开关重置关闭, + * 仅保留群创建时信息。warehouseId 从 ctx.user.store_id 自动注入。 + * + * @param {Object} data 请求数据。 + * @param {number} data.id 群记录主键ID(必填)。 + * @return {Promise} { message: 操作结果 }。 + */ + async groupReset(data = {}) { + const { ctx } = this; + const { id } = data; + const warehouseId = Number(ctx.user?.store_id || 0); + + await ctx.service.systems.inbox.group.reset({ id, warehouseId }); + + return { message: '群类型配置已清空' }; + } + /** * 拉取指定群的消息列表。 * warehouseId 从 ctx.user.store_id 自动注入。 diff --git a/app/service/systems/afterSale.js b/app/service/systems/afterSale.js index 209e6b9..3698b81 100644 --- a/app/service/systems/afterSale.js +++ b/app/service/systems/afterSale.js @@ -1074,14 +1074,15 @@ class AfterSaleService extends Service { * @param {number} params.operatorId 操作人ID * @param {string} params.operatorSnapshot 操作人快照 JSON * @param {number} params.warehouseId 仓库ID - * @return {Promise} 处理结果,包含更新后的售后单和步骤记录 + * @param {boolean} [params.notifyGroup] 是否将处理备注发送到对应货主售后群(内部自动处理不传) + * @return {Promise} 处理结果,包含更新后的售后单、步骤记录和通知群数量 * @throws {Error} 售后单不存在或权限不足时抛出 */ async handleWorkOrder(params = {}) { const { id, remark, targetStatus, resolution, attachmentIds, operatorId, operatorSnapshot, - warehouseId, + warehouseId, notifyGroup, } = params; const { ctx } = this; @@ -1163,11 +1164,73 @@ class AfterSaleService extends Service { await transaction.commit(); + // 9. 处理备注发送到对应的货主售后群(仅交互处理传入 notifyGroup 时触发,不转发快递群) + let notifiedGroupCount = 0; + if (notifyGroup && remark && String(remark).trim()) { + try { + const remarkText = String(remark).trim(); + const asRow = afterSale.toJSON ? afterSale.toJSON() : afterSale; + + // 定位货主:优先工单 store_id,缺失时从来源消息所在群反查 + let notifyStoreId = Number(asRow.store_id || 0); + if (!notifyStoreId && asRow.inbox_message_id) { + try { + const inbound = await ctx.model.InboxMessage.findByPk(asRow.inbox_message_id, { + attributes: [ 'group_id' ], + raw: true, + }); + if (inbound && inbound.group_id) { + const originGroup = await ctx.model.InboxGroup.findOne({ + attributes: [ 'store_id' ], + where: { + group_id: inbound.group_id, + warehouse_id: warehouseId, + is_blocked: 0, + }, + raw: true, + }); + if (originGroup && originGroup.store_id) { + notifyStoreId = Number(originGroup.store_id); + } + } + } catch (originErr) { + ctx.logger.warn(`[handleWorkOrder] 反查来源群货主失败 id=${id}: ${originErr.message}`); + } + } + + if (notifyStoreId) { + const storeGroups = await ctx.service.systems.inbox.group.findStoreAfterSalesGroups({ + storeIds: [ notifyStoreId ], + warehouseId, + }); + const content = `【工单 ${asRow.after_sale_no}】处理备注:\n${remarkText}`; + for (const g of storeGroups) { + if (!g.group_id) continue; + ctx.service.inbox.processor.pushSystemNotification({ + warehouse_id: warehouseId, + group_id: g.group_id, + group_name: g.group_name || '', + content, + ext_data: g.ext_data || null, + }); + notifiedGroupCount += 1; + } + } + + ctx.logger.info( + `[handleWorkOrder] 处理备注发送到货主售后群 id=${id} store=${notifyStoreId} notified=${notifiedGroupCount}` + ); + } catch (notifyErr) { + ctx.logger.warn(`[handleWorkOrder] 处理备注发送群失败 id=${id}: ${notifyErr.message}`); + } + } + const updatedAfterSale = afterSale.toJSON ? afterSale.toJSON() : afterSale; return { after_sale: this._formatAfterSaleRow(updatedAfterSale, ctx.app), step, + notified_groups: notifiedGroupCount, }; } catch (error) { await transaction.rollback(); @@ -1260,7 +1323,7 @@ class AfterSaleService extends Service { priority: 10, creator_id: 0, inbox_message_id: null, - role_group: 'warehouse', + role_group: 'customer_service', status: 'pending', waybill_id: e.id, waybill_no: e.waybill_code, @@ -1281,16 +1344,26 @@ class AfterSaleService extends Service { for (const e of toCreate) { const code = e.logistics_code || '__unknown__'; if (!expressByCode[code]) { - expressByCode[code] = { interfaceId: e.logistics_interface_id, waybills: [] }; + expressByCode[code] = { + code, + interfaceId: e.logistics_interface_id, + logisticsName: String(e.logistics_name || '').trim(), + waybills: [], + }; } expressByCode[code].waybills.push(e.waybill_code); } let notifiedCount = 0; const notifiedWaybillIds = new Set(); + // 无对应快递群(或快递无接口)的运单收集后统一降级通知仓库异常群(与货主群缺失降级行为一致) + const fallbackEntries = []; for (const [ code, info ] of Object.entries(expressByCode)) { - if (code === '__unknown__' || !info.interfaceId) continue; + if (code === '__unknown__' || !info.interfaceId) { + fallbackEntries.push(info); + continue; + } try { const { afterSalesGroups } = await ctx.service.systems.inbox.group.findGroupsByExpress({ expressInterfaceId: info.interfaceId, @@ -1298,7 +1371,10 @@ class AfterSaleService extends Service { warehouseId, }); - if (afterSalesGroups.length === 0) continue; + if (afterSalesGroups.length === 0) { + fallbackEntries.push(info); + continue; + } const notifyMsg = info.waybills.join('\n') + '\n拦截'; for (const g of afterSalesGroups) { @@ -1315,10 +1391,56 @@ class AfterSaleService extends Service { const codeWaybills = toCreate.filter(e => (e.logistics_code || '__unknown__') === code); codeWaybills.forEach(e => notifiedWaybillIds.add(e.id)); } catch (e) { + fallbackEntries.push(info); ctx.logger.warn(`[afterSale] 查售后群失败 code=${code}: ${e.message}`); } } + // 4b. 无对应快递群降级:转发仓库异常群,内容前缀标记失败(与货主群缺失降级一致) + if (fallbackEntries.length > 0) { + try { + const exceptionGroups = await ctx.model.InboxGroup.findAll({ + attributes: [ 'group_id', 'group_name', 'ext_data' ], + where: { + warehouse_id: warehouseId, + group_type: 'warehouse', + sub_type: 'exception', + is_blocked: 0, + }, + raw: true, + }); + + if (exceptionGroups.length > 0) { + const labelSet = new Set(); + const fallbackLines = []; + for (const entry of fallbackEntries) { + const label = entry.logisticsName || entry.code || '未知快递'; + labelSet.add(label); + for (const waybill of entry.waybills) { + fallbackLines.push(`${label} ${waybill}`); + } + } + const fallbackContent = `通知快递【${Array.from(labelSet).join('、')}】失败\n${fallbackLines.join('\n')}\n拦截`; + for (const g of exceptionGroups) { + ctx.service.inbox.processor.pushSystemNotification({ + warehouse_id: warehouseId, + group_id: g.group_id, + group_name: g.group_name, + content: fallbackContent, + ext_data: g.ext_data || null, + }); + } + ctx.logger.warn('[afterSale.createInterceptWorkOrdersAndNotify] 无对应快递群,已降级通知仓库异常群', { + warehouseId, + fallbackCount: fallbackEntries.length, + exceptionGroupCount: exceptionGroups.length, + }); + } + } catch (fallbackErr) { + ctx.logger.warn(`[afterSale] 降级通知异常群失败: ${fallbackErr.message}`); + } + } + // 5. 有通知的工单升级为 pending_feedback if (notifiedWaybillIds.size > 0) { const notifiedWaybillIdArr = [ ...notifiedWaybillIds ]; diff --git a/app/service/systems/inbox/group.js b/app/service/systems/inbox/group.js index 9bb7319..e17a589 100644 --- a/app/service/systems/inbox/group.js +++ b/app/service/systems/inbox/group.js @@ -362,6 +362,55 @@ class InboxGroupService extends Service { ); } + /** + * 清空群类型配置。 + * 将群恢复为"仅保留创建信息"状态:清空 group_type / sub_type / store_id / + * express_interfaces / system_express_code,AI 开关重置为关闭。 + * 保留群名称、群ID、仓库、来源信息、屏蔽状态与扩展数据。 + * + * @param {Object} data 请求数据。 + * @param {number} data.id 群记录主键ID(必填)。 + * @param {number} data.warehouseId 仓库ID(必填,由 controller 注入)。 + * @return {Promise<{id: number, group_name: string, group_id: string|null}>} 被重置的群信息。 + */ + async reset(data = {}) { + const { ctx } = this; + const { InboxGroup } = ctx.model; + + const id = Number(data.id); + const warehouseId = Number(data.warehouseId); + + if (!warehouseId) throw new Error('warehouseId 无效'); + if (!id) throw new Error('群ID无效'); + + const where = { id, warehouse_id: warehouseId }; + + const group = await InboxGroup.findOne({ + attributes: [ 'id', 'group_name', 'group_id' ], + where, + raw: true, + }); + if (!group) throw new Error('群不存在或无权限操作'); + + await InboxGroup.update( + { + group_type: null, + sub_type: null, + store_id: null, + express_interfaces: null, + system_express_code: null, + ai_enabled: 0, + }, + { where } + ); + + ctx.logger.info( + `[inbox group] 清空群类型配置 id=${group.id} group_id=${group.group_id} warehouse_id=${warehouseId}` + ); + + return { id: group.id, group_name: group.group_name, group_id: group.group_id }; + } + /** * 校验快递接口ID数组的有效性。 * 所有ID必须在 wms_express_interface 表中存在。 @@ -436,6 +485,7 @@ class InboxGroupService extends Service { const where = { group_type: 'express', system_express_code: code, + is_blocked: 0, [Op.or]: [ { express_interfaces: { [Op.or]: [ null, '' ] } }, { express_interfaces: { [Op.like]: `%${eid}%` } }, @@ -495,6 +545,7 @@ class InboxGroupService extends Service { group_type: 'store', sub_type: 'after_sales', store_id: { [Op.in]: ids }, + is_blocked: 0, }, raw: true, }); diff --git a/database/migrations/20260817120000-add-inbox-group-reset-permission.js b/database/migrations/20260817120000-add-inbox-group-reset-permission.js new file mode 100644 index 0000000..e60f410 --- /dev/null +++ b/database/migrations/20260817120000-add-inbox-group-reset-permission.js @@ -0,0 +1,117 @@ +'use strict'; + +/** + * inbox.group.reset 群类型清空接口权限记录 + 角色授权迁移。 + * + * 权限明细(固定 ID 558,556 已被「运单退回」web 页面占用): + * 558 — inbox.group.reset API:清空群类型配置(重置群) + * + * 角色授权(客服员工及以上链路): + * 30(客服组-员工) → 28(客服组-主管) → 8(经理,通配符 * 自动拥有) + * + * 幂等:INSERT IGNORE 创建权限记录;角色权限数组追加后去重排序,已存在跳过。 + */ + +const TABLE = 'wms_permission'; +const ROLE_TABLE = 'wms_role'; +const COLUMNS = 'id, path, component, name, redirect, meta_title, meta_icon, hidden, always_show, parent_id, type, sort, status, created_at, update_at'; + +/** 权限ID → 授权角色ID列表(不含通配符角色) */ +const PERMISSION_ROLES = { + 558: [ 30, 28, 8 ], +}; + +module.exports = { + // eslint-disable-next-line no-unused-vars + async up(queryInterface, Sequelize) { + // ── 1. 创建 API 权限记录(固定 ID)── + const apis = [ + [ 558, 'inbox.group.reset', 'API:清空群类型配置' ], + ]; + + for (const [ id, path, metaTitle ] of apis) { + await queryInterface.sequelize.query( + `INSERT IGNORE INTO \`${TABLE}\` (${COLUMNS}) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, NOW(), NOW())`, + { replacements: [ id, path, null, path, null, metaTitle, null, 0, 0, null, 'api', 0, 1 ] } + ); + } + + // ── 2. 角色授权注入 ── + for (const permId of Object.keys(PERMISSION_ROLES).map(Number)) { + for (const roleId of PERMISSION_ROLES[permId]) { + const rows = await queryInterface.sequelize.query( + `SELECT id, permissions FROM \`${ROLE_TABLE}\` WHERE id = ?`, + { replacements: [ roleId ], type: queryInterface.sequelize.QueryTypes.SELECT } + ); + const record = Array.isArray(rows) ? rows[0] : null; + if (!record) { + continue; + } + + // 通配符角色跳过 + if (record.permissions === '*') { + continue; + } + + let perms; + try { + perms = typeof record.permissions === 'string' + ? JSON.parse(record.permissions) + : record.permissions; + } catch (e) { + perms = null; + } + + if (!Array.isArray(perms)) { + continue; + } + + if (!perms.includes(permId)) { + perms.push(permId); + perms.sort((a, b) => Number(a) - Number(b)); + await queryInterface.sequelize.query( + `UPDATE \`${ROLE_TABLE}\` SET permissions = ? WHERE id = ?`, + { replacements: [ JSON.stringify(perms), roleId ] } + ); + } + } + } + }, + + // eslint-disable-next-line no-unused-vars + async down(queryInterface, Sequelize) { + await queryInterface.sequelize.query( + 'DELETE FROM `wms_permission` WHERE id = 558' + ); + + const roleIds = [ 30, 28, 8 ]; + for (const roleId of roleIds) { + const rows = await queryInterface.sequelize.query( + `SELECT id, permissions FROM \`${ROLE_TABLE}\` WHERE id = ?`, + { replacements: [ roleId ], type: queryInterface.sequelize.QueryTypes.SELECT } + ); + const record = Array.isArray(rows) ? rows[0] : null; + if (!record || record.permissions === '*') { + continue; + } + + let perms; + try { + perms = typeof record.permissions === 'string' + ? JSON.parse(record.permissions) + : record.permissions; + } catch (e) { + perms = null; + } + if (!Array.isArray(perms) || !perms.includes(558)) { + continue; + } + + perms = perms.filter(p => p !== 558); + await queryInterface.sequelize.query( + `UPDATE \`${ROLE_TABLE}\` SET permissions = ? WHERE id = ?`, + { replacements: [ JSON.stringify(perms), roleId ] } + ); + } + }, +}; diff --git a/methods/changes/system.json b/methods/changes/system.json index 2bdc9c9..f04174e 100644 --- a/methods/changes/system.json +++ b/methods/changes/system.json @@ -1,4 +1,35 @@ [ + { + "version": "2026.08.17-inbox-group-reset", + "date": "2026-08-17", + "type": "enhanced", + "summary": "新增 inbox.group.reset 群操作接口:入参群记录主键ID,清空群类型配置(group_type/sub_type/store_id/express_interfaces/system_express_code 置空、ai_enabled 重置为0),仅保留群创建时信息(群名称/群ID/仓库/来源/屏蔽状态/扩展数据)", + "methods": [ + "inbox.group.reset" + ], + "notes": [ + "app/service/systems/inbox/group.js reset:仓库隔离按主键 id 定位群,清空类型相关字段并写操作日志,返回重置后群信息", + "app/service/systemMethods/inbox.js 新增 groupReset,注册到 inbox.group 子入口", + "数据库迁移 20260817120000-add-inbox-group-reset-permission.js:权限ID 556 授权角色 8/26/28/29", + "同步更新 methods/system.json 中 inbox.group.reset 接口文档" + ], + "module": "inbox.group" + }, + { + "version": "2026.08.17-afterSale-handleWorkOrder-remark-notify-group", + "date": "2026-08-17", + "type": "enhanced", + "summary": "afterSale.handleWorkOrder 处理备注同步发送到对应货主售后群:填写 remark 时推送到货主售后群(工单 store_id 定位,缺失时从来源消息所在群反查货主,不转发快递群);消息内容格式为「【工单 售后单号】处理备注:备注内容」;响应新增 notified_groups 返回发送群数量", + "methods": [ + "afterSale.handleWorkOrder" + ], + "notes": [ + "app/service/systems/afterSale.js handleWorkOrder:新增 notifyGroup 参数(方法层交互处理传 true,内部自动处理如库内拦截/退回已收到不传),事务提交后按 remark 非空发送:store_id 定位货主 → findStoreAfterSalesGroups 发货主售后群;无 store_id 时按 inbox_message_id 查来源消息 group_id → InboxGroup 反查 store_id 再发送;发送失败仅告警不影响处理结果", + "app/service/systemMethods/afterSale.js handleWorkOrder:调用 systems 层时传 notifyGroup: true", + "同步更新 methods/system.json 中 afterSale.handleWorkOrder 的 description、remark 参数说明与 notified_groups 响应说明" + ], + "module": "afterSale" + }, { "version": "2026.08.16-waybill-createAt-between", "date": "2026-08-16", diff --git a/methods/system.json b/methods/system.json index f245d81..20fd2f4 100644 --- a/methods/system.json +++ b/methods/system.json @@ -33703,6 +33703,47 @@ } ] }, + { + "method": "inbox.group.reset", + "description": "清空群类型配置:清空群类型/子类型/货主/快递接口/系统快递编码,AI开关重置关闭,仅保留群创建时信息(群名称/群ID/仓库/来源/屏蔽状态/扩展数据)。入参群记录主键ID", + "isNeedAuth": true, + "isNeedLogin": true, + "headers": [ + { + "name": "Authorization", + "type": "string", + "required": true, + "description": "Bearer token(从中解析 warehouseId 仓库上下文)" + } + ], + "params": [ + { + "name": "id", + "type": "number", + "required": true, + "source": "body", + "description": "群记录主键ID" + } + ], + "response": [ + { + "name": "message", + "type": "string", + "required": true, + "description": "操作结果提示:群类型配置已清空" + } + ], + "errors": [ + { + "code": "400", + "message": "群ID无效" + }, + { + "code": "500", + "message": "群不存在或无权限操作" + } + ] + }, { "method": "inbox.group.messages", "description": "按群拉取消息列表,支持方向/关键词筛选,分页返回。warehouseId服务端自动注入,查询命中idx_warehouse_group_created索引", @@ -34582,7 +34623,7 @@ }, { "method": "afterSale.handleWorkOrder", - "description": "处理售后工单:写入进度步骤并绑定附件。操作人信息从登录上下文自动获取。非客服组处理完成后自动将 role_group 回退到 customer_service;status=completed 时自动写入 resolution + resolved_at。步骤 action 由服务端固定为\"处理工单\",step_status 与主表 status 完全一致。status 不填或填错时默认 processing。新增 pending_feedback 状态用于内部处理完成等待外部反馈(如已将拦截信息发给运方,等待运方反馈后再决定是否继续处理)。", + "description": "处理售后工单:写入进度步骤并绑定附件。操作人信息从登录上下文自动获取。非客服组处理完成后自动将 role_group 回退到 customer_service;status=completed 时自动写入 resolution + resolved_at。步骤 action 由服务端固定为\"处理工单\",step_status 与主表 status 完全一致。status 不填或填错时默认 processing。新增 pending_feedback 状态用于内部处理完成等待外部反馈(如已将拦截信息发给运方,等待运方反馈后再决定是否继续处理)。填写处理备注(remark)时会同步发送到对应的货主售后群(工单无 store_id 时从来源消息所在群反查货主,不转发快递群),响应 notified_groups 返回发送的群数量。", "isNeedAuth": false, "isNeedLogin": true, "headers": [], @@ -34606,7 +34647,7 @@ "type": "string", "required": false, "source": "body", - "description": "处理备注" + "description": "处理备注。填写后同步发送到对应的货主售后群,内容格式:\"【工单 售后单号】处理备注:备注内容\"" }, { "name": "attachment_ids", @@ -34628,6 +34669,12 @@ "type": "integer", "required": true, "description": "售后工单ID" + }, + { + "name": "notified_groups", + "type": "integer", + "required": false, + "description": "处理备注发送到的货主售后群数量(未填写备注或未找到货主售后群时为0)" } ], "errors": []