feat(inbox): 查退回函数兼容 v2 规则引擎 keyword 归并取号,补充售后类型 return/query_return 与 query_pack_video 配置链迁移

This commit is contained in:
liufumingren 2026-09-24 03:26:24 +08:00
parent 35d10f148b
commit 3026465218
3 changed files with 437 additions and 2 deletions

View File

@ -1656,15 +1656,24 @@ class InboxFunctionsService extends Service {
weight: 90,
keywords: [ '查退回', '查退件', '退回查询', '退回明细', '查拆包', '退件查询', '退回进度' ],
params: {
waybill_code: { type: 'string', required: true, description: '退回包裹运单号,支持多个(换行/逗号/空格分隔),如"查退回 465570943491370\nSF123456"' },
waybill_code: { type: 'string', required: true, description: '退回包裹运单号,支持多个(换行/逗号/空格分隔),如"查退回 465570943491370\nSF123456";v2 规则引擎将运单号归并进 keyword 键,函数内兼容两键读取' },
},
groups: [ GROUP.COMMON ],
/**
* 查退回处理器:按运单号查询退回收到/退回拆包/未退回登记状态,
* 已拆包返回拆包明细与录像地址,未退回自动登记到退回查询表。
* v2 规则引擎会把取号结果写入 params.keyword(waybill_no → keyword 归并),
* 故入参键兼容 waybill_code 与 keyword 两种来源。
* @param {Object} params 入参,包含 waybill_code 或 keyword(退回包裹运单号,可多单号)。
* @return {Promise<Object>} 处理结果,包含 success 与 data(message/messages/direct_reply)。
*/
handler: async (params = {}) => {
const { ctx } = this;
const warehouseId = Number(ctx.inboxContext?.warehouse_id || 0);
const storeId = Number(ctx.inboxContext?.store_id || 0);
let raw = String(params.waybill_code || '').trim();
// v2 引擎兼容:取号结果可能落在 keyword 键(v1/AI 路径使用 waybill_code)
let raw = String(params.waybill_code || params.keyword || '').trim();
if (!raw) return { success: false, error: '请提供退回包裹运单号' };
// 兼容把"查退回 123456"整体传入的情况

View File

@ -0,0 +1,225 @@
'use strict';
/**
* 新增系统级售后类型「退回」(return)与子类型「查退回」(query_return),
* 并补齐 v2 可配置回信引擎的完整配置链。
*
* 背景:
* - v1 引擎(inbox/rules.js STORE_RULES / WAREHOUSE_RULES)与代码函数表均有
* queryReturn(关键词:查退回/是否已退回/查退件/查件,waybill:true);
* - v2 的 wms_after_sale_type / wms_after_sale_sub_type 中没有「退回」类型与
* 「查退回」子类型,导致 v2 引擎无法把「查退回」类消息路由到 queryReturn 函数。
*
* 本次新增(幂等,先查后插):
* 1. 系统级类型 return(退回,sort_order=5,紧跟出库单之后、帮助之前);
* 2. 系统级子类型 return.query_return(查退回,sort_order=1);
* 3. 关键词 8 条:查退回/查退件/退回查询/退回明细/查拆包/退件查询/退回进度/是否已退回;
* 4. 群类型白名单:group_type='*' 全通配(queryReturn 函数 groups=[COMMON],所有群可用);
* 5. 子类型-函数关系:queryReturn;
* 6. 取号规则关联:运单号提取(waybill);
* 7. 系统级回复行:reply={back_text}、is_reply=1、create_work_order=0(纯查询不建工单)、
* no_number_hint=查退回专属引导语、is_enabled=1。
*/
const TYPE_TABLE = 'wms_after_sale_type';
const SUB_TYPE_TABLE = 'wms_after_sale_sub_type';
const KEYWORD_TABLE = 'wms_after_sale_keyword';
const GROUP_REL_TABLE = 'wms_after_sale_sub_type_group';
const FUNCTION_TABLE = 'wms_after_sale_function';
const FUNC_REL_TABLE = 'wms_after_sale_sub_type_function';
const RULE_TABLE = 'wms_inbox_number_rule';
const RULE_REL_TABLE = 'wms_after_sale_sub_type_rule';
const REPLY_TABLE = 'wms_after_sale_reply';
const TYPE_CODE = 'return';
const TYPE_NAME = '退回';
const SUB_TYPE_CODE = 'query_return';
const SUB_TYPE_NAME = '查退回';
const KEYWORDS = [ '查退回', '查退件', '退回查询', '退回明细', '查拆包', '退件查询', '退回进度', '是否已退回' ];
const FUNCTION_CODE = 'queryReturn';
const RULE_NAME = '运单号提取';
const HINT_DEFAULT = '请提供运单号(发送:查退回+运单号,多个单号用逗号或空格分隔)\n例:查退回 SF123';
module.exports = {
/**
* 新增系统级「退回」类型与「查退回」子类型配置链(幂等)。
* @param {Object} queryInterface Sequelize QueryInterface 实例。
* @return {Promise<void>} 无返回值。
*/
up: async queryInterface => {
const { sequelize } = queryInterface;
const tables = await queryInterface.showAllTables();
const exists = t => tables.some(x => (typeof x === 'string' ? x : x.tableName) === t);
if (!exists(SUB_TYPE_TABLE)) return;
const q = async (sql, replacements) => {
const [ rows ] = await sequelize.query(sql, { replacements });
return rows;
};
// ─── 1. 系统级类型 return(先查后插) ────────────────────────
if (exists(TYPE_TABLE)) {
const typeRows = await q(
'SELECT id FROM `' + TYPE_TABLE + '` WHERE type = :t AND warehouse_id IS NULL LIMIT 1',
{ t: TYPE_CODE }
);
if (typeRows.length === 0) {
await sequelize.query(
'INSERT INTO `' + TYPE_TABLE + '` '
+ '(warehouse_id, type, name, is_system, is_enabled, sort_order, created_at, updated_at) '
+ 'VALUES (NULL, :t, :n, 1, 1, :so, NOW(), NOW())',
{ replacements: { t: TYPE_CODE, n: TYPE_NAME, so: 5 } }
);
console.log(`[MIGRATION] 类型插入 ${TYPE_CODE}(${TYPE_NAME})`);
}
}
// ─── 2. 系统级子类型 return.query_return(先查后插) ─────────
let subRows = await q(
'SELECT id FROM `' + SUB_TYPE_TABLE + '` '
+ 'WHERE type = :t AND sub_type = :s AND warehouse_id IS NULL LIMIT 1',
{ t: TYPE_CODE, s: SUB_TYPE_CODE }
);
if (subRows.length === 0) {
await sequelize.query(
'INSERT INTO `' + SUB_TYPE_TABLE + '` '
+ '(warehouse_id, type, sub_type, name, is_system, is_enabled, sort_order, created_at, updated_at) '
+ 'VALUES (NULL, :t, :s, :n, 1, 1, 1, NOW(), NOW())',
{ replacements: { t: TYPE_CODE, s: SUB_TYPE_CODE, n: SUB_TYPE_NAME } }
);
subRows = await q(
'SELECT id FROM `' + SUB_TYPE_TABLE + '` '
+ 'WHERE type = :t AND sub_type = :s AND warehouse_id IS NULL LIMIT 1',
{ t: TYPE_CODE, s: SUB_TYPE_CODE }
);
console.log(`[MIGRATION] 子类型插入 ${TYPE_CODE}.${SUB_TYPE_CODE}`);
}
if (subRows.length === 0) {
console.warn(`[MIGRATION] 跳过:子类型 ${TYPE_CODE}.${SUB_TYPE_CODE} 缺失且插入失败`);
return;
}
const subTypeId = subRows[0].id;
// ─── 3. 关键词(先查后插) ──────────────────────────────────
if (exists(KEYWORD_TABLE)) {
let kwInserted = 0;
for (const [ idx, kw ] of KEYWORDS.entries()) {
const kwRows = await q(
'SELECT id FROM `' + KEYWORD_TABLE + '` WHERE keyword = :kw AND warehouse_id IS NULL LIMIT 1',
{ kw }
);
if (kwRows.length === 0) {
await sequelize.query(
'INSERT INTO `' + KEYWORD_TABLE + '` '
+ '(warehouse_id, sub_type_id, keyword, is_system, is_enabled, sort_order, created_at, updated_at) '
+ 'VALUES (NULL, :sid, :kw, 1, 1, :so, NOW(), NOW())',
{ replacements: { sid: subTypeId, kw, so: idx } }
);
kwInserted += 1;
}
}
console.log(`[MIGRATION] 关键词插入 ${kwInserted} 条`);
}
// ─── 4. 群类型白名单:全通配(函数 groups=[COMMON]) ─────────
if (exists(GROUP_REL_TABLE)) {
const grpRows = await q(
'SELECT id FROM `' + GROUP_REL_TABLE + '` WHERE sub_type_id = :sid AND group_type = :g LIMIT 1',
{ sid: subTypeId, g: '*' }
);
if (grpRows.length === 0) {
await sequelize.query(
'INSERT INTO `' + GROUP_REL_TABLE + '` '
+ '(sub_type_id, group_type, sub_group, is_system, sort_order, created_at, updated_at) '
+ 'VALUES (:sid, :g, :sg, 1, 0, NOW(), NOW())',
{ replacements: { sid: subTypeId, g: '*', sg: '' } }
);
console.log('[MIGRATION] 群白名单插入通配行');
}
}
// ─── 5. 子类型-函数关系:queryReturn ───────────────────────
if (exists(FUNC_REL_TABLE) && exists(FUNCTION_TABLE)) {
const fnRows = await q(
'SELECT id FROM `' + FUNCTION_TABLE + '` WHERE function_code = :code LIMIT 1',
{ code: FUNCTION_CODE }
);
if (fnRows.length > 0) {
await sequelize.query(
'INSERT IGNORE INTO `' + FUNC_REL_TABLE + '` '
+ '(sub_type_id, function_id, sort_order, created_at, updated_at) '
+ 'VALUES (:sid, :fid, 1, NOW(), NOW())',
{ replacements: { sid: subTypeId, fid: fnRows[0].id } }
);
console.log(`[MIGRATION] 函数关系插入 ${FUNCTION_CODE}`);
} else {
console.warn(`[MIGRATION] 跳过:未找到处理函数 ${FUNCTION_CODE}`);
}
}
// ─── 6. 运单号取号规则关联 ──────────────────────────────────
if (exists(RULE_REL_TABLE) && exists(RULE_TABLE)) {
const ruleRows = await q(
'SELECT id FROM `' + RULE_TABLE + '` WHERE name = :n LIMIT 1',
{ n: RULE_NAME }
);
if (ruleRows.length > 0) {
await sequelize.query(
'INSERT IGNORE INTO `' + RULE_REL_TABLE + '` '
+ '(sub_type_id, number_rule_id, sort_order, created_at, updated_at) '
+ 'VALUES (:sid, :rid, 1, NOW(), NOW())',
{ replacements: { sid: subTypeId, rid: ruleRows[0].id } }
);
console.log(`[MIGRATION] 取号规则关联插入 ${RULE_NAME}`);
} else {
console.warn(`[MIGRATION] 跳过:未找到取号规则 ${RULE_NAME}`);
}
}
// ─── 7. 系统级回复行(先查后插;纯查询不建工单) ─────────────
if (exists(REPLY_TABLE)) {
const replyRows = await q(
'SELECT id FROM `' + REPLY_TABLE + '` WHERE sub_type_id = :sid AND warehouse_id IS NULL LIMIT 1',
{ sid: subTypeId }
);
if (replyRows.length === 0) {
await sequelize.query(
'INSERT INTO `' + REPLY_TABLE + '` '
+ '(warehouse_id, sub_type_id, reply, is_reply, create_work_order, no_number_hint, is_enabled, created_at, updated_at) '
+ 'VALUES (NULL, :sid, :reply, 1, 0, :hint, 1, NOW(), NOW())',
{ replacements: { sid: subTypeId, reply: '{back_text}', hint: HINT_DEFAULT } }
);
console.log('[MIGRATION] 系统级回复行插入 1 行');
}
}
},
/**
* 回滚:删除「查退回」子类型的全部关联配置与子类型、类型行。
* @param {Object} queryInterface Sequelize QueryInterface 实例。
* @return {Promise<void>} 无返回值。
*/
down: async queryInterface => {
const { sequelize } = queryInterface;
const [ subRows ] = await sequelize.query(
'SELECT id FROM `' + SUB_TYPE_TABLE + '` '
+ 'WHERE type = :t AND sub_type = :s AND warehouse_id IS NULL LIMIT 1',
{ replacements: { t: TYPE_CODE, s: SUB_TYPE_CODE } }
);
if (subRows.length === 0) return;
const subTypeId = subRows[0].id;
await sequelize.query('DELETE FROM `' + REPLY_TABLE + '` WHERE sub_type_id = :sid AND warehouse_id IS NULL', { replacements: { sid: subTypeId } });
await sequelize.query('DELETE FROM `' + KEYWORD_TABLE + '` WHERE sub_type_id = :sid AND warehouse_id IS NULL', { replacements: { sid: subTypeId } });
await sequelize.query('DELETE FROM `' + GROUP_REL_TABLE + '` WHERE sub_type_id = :sid', { replacements: { sid: subTypeId } });
await sequelize.query('DELETE FROM `' + FUNC_REL_TABLE + '` WHERE sub_type_id = :sid', { replacements: { sid: subTypeId } });
await sequelize.query('DELETE FROM `' + RULE_REL_TABLE + '` WHERE sub_type_id = :sid', { replacements: { sid: subTypeId } });
await sequelize.query('DELETE FROM `' + SUB_TYPE_TABLE + '` WHERE id = :sid', { replacements: { sid: subTypeId } });
await sequelize.query(
'DELETE FROM `' + TYPE_TABLE + '` WHERE type = :t AND warehouse_id IS NULL',
{ replacements: { t: TYPE_CODE } }
);
},
};

View File

@ -0,0 +1,201 @@
'use strict';
/**
* 订单类型新增系统级子类型「打包视频查询」(query_pack_video),并补齐 v2 配置链。
*
* 背景:
* - v1 引擎(inbox/rules.js STORE_RULES / WAREHOUSE_RULES)与代码函数表均有
* queryPackVideo(关键词:打包视频/装箱视频,waybill:true);
* - v2 的 wms_after_sale_sub_type 中没有该子类型,导致 v2 引擎无法把
* 「打包视频」类消息路由到 queryPackVideo 函数。
*
* 本次新增(幂等,先查后插):
* 1. 系统级子类型 order.query_pack_video(打包视频查询,sort_order=20 末尾追加);
* 2. 关键词 5 条:打包视频/打包录像/装箱视频/打包监控/录像;
* 3. 群类型白名单:store:after_sales + warehouse:customer_service(与函数 groups 一致);
* 4. 子类型-函数关系:queryPackVideo;
* 5. 取号规则关联:运单号提取(waybill);
* 6. 系统级回复行:reply={back_text}、is_reply=1、create_work_order=0(纯查询不建工单)、
* no_number_hint=打包视频专属引导语、is_enabled=1。
*/
const SUB_TYPE_TABLE = 'wms_after_sale_sub_type';
const KEYWORD_TABLE = 'wms_after_sale_keyword';
const GROUP_REL_TABLE = 'wms_after_sale_sub_type_group';
const FUNCTION_TABLE = 'wms_after_sale_function';
const FUNC_REL_TABLE = 'wms_after_sale_sub_type_function';
const RULE_TABLE = 'wms_inbox_number_rule';
const RULE_REL_TABLE = 'wms_after_sale_sub_type_rule';
const REPLY_TABLE = 'wms_after_sale_reply';
const TYPE_CODE = 'order';
const SUB_TYPE_CODE = 'query_pack_video';
const SUB_TYPE_NAME = '打包视频查询';
const KEYWORDS = [ '打包视频', '打包录像', '装箱视频', '打包监控', '录像' ];
const GROUP_WHITELIST = [
{ group_type: 'store', sub_group: 'after_sales' },
{ group_type: 'warehouse', sub_group: 'customer_service' },
];
const FUNCTION_CODE = 'queryPackVideo';
const RULE_NAME = '运单号提取';
const HINT_DEFAULT = '请提供运单号(发送:打包视频+运单号,多个单号用逗号或空格分隔)\n例:打包视频 SF123';
module.exports = {
/**
* 新增系统级「打包视频查询」子类型配置链(幂等)。
* @param {Object} queryInterface Sequelize QueryInterface 实例。
* @return {Promise<void>} 无返回值。
*/
up: async queryInterface => {
const { sequelize } = queryInterface;
const tables = await queryInterface.showAllTables();
const exists = t => tables.some(x => (typeof x === 'string' ? x : x.tableName) === t);
if (!exists(SUB_TYPE_TABLE)) return;
const q = async (sql, replacements) => {
const [ rows ] = await sequelize.query(sql, { replacements });
return rows;
};
// ─── 1. 系统级子类型 order.query_pack_video(先查后插) ──────
let subRows = await q(
'SELECT id FROM `' + SUB_TYPE_TABLE + '` '
+ 'WHERE type = :t AND sub_type = :s AND warehouse_id IS NULL LIMIT 1',
{ t: TYPE_CODE, s: SUB_TYPE_CODE }
);
if (subRows.length === 0) {
await sequelize.query(
'INSERT INTO `' + SUB_TYPE_TABLE + '` '
+ '(warehouse_id, type, sub_type, name, is_system, is_enabled, sort_order, created_at, updated_at) '
+ 'VALUES (NULL, :t, :s, :n, 1, 1, :so, NOW(), NOW())',
{ replacements: { t: TYPE_CODE, s: SUB_TYPE_CODE, n: SUB_TYPE_NAME, so: 20 } }
);
subRows = await q(
'SELECT id FROM `' + SUB_TYPE_TABLE + '` '
+ 'WHERE type = :t AND sub_type = :s AND warehouse_id IS NULL LIMIT 1',
{ t: TYPE_CODE, s: SUB_TYPE_CODE }
);
console.log(`[MIGRATION] 子类型插入 ${TYPE_CODE}.${SUB_TYPE_CODE}`);
}
if (subRows.length === 0) {
console.warn(`[MIGRATION] 跳过:子类型 ${TYPE_CODE}.${SUB_TYPE_CODE} 缺失且插入失败`);
return;
}
const subTypeId = subRows[0].id;
// ─── 2. 关键词(先查后插) ──────────────────────────────────
if (exists(KEYWORD_TABLE)) {
let kwInserted = 0;
for (const [ idx, kw ] of KEYWORDS.entries()) {
const kwRows = await q(
'SELECT id FROM `' + KEYWORD_TABLE + '` WHERE keyword = :kw AND warehouse_id IS NULL LIMIT 1',
{ kw }
);
if (kwRows.length === 0) {
await sequelize.query(
'INSERT INTO `' + KEYWORD_TABLE + '` '
+ '(warehouse_id, sub_type_id, keyword, is_system, is_enabled, sort_order, created_at, updated_at) '
+ 'VALUES (NULL, :sid, :kw, 1, 1, :so, NOW(), NOW())',
{ replacements: { sid: subTypeId, kw, so: idx } }
);
kwInserted += 1;
}
}
console.log(`[MIGRATION] 关键词插入 ${kwInserted} 条`);
}
// ─── 3. 群类型白名单(INSERT IGNORE,与函数 groups 一致) ────
if (exists(GROUP_REL_TABLE)) {
let grpInserted = 0;
for (const [ idx, g ] of GROUP_WHITELIST.entries()) {
await sequelize.query(
'INSERT IGNORE INTO `' + GROUP_REL_TABLE + '` '
+ '(sub_type_id, group_type, sub_group, is_system, sort_order, created_at, updated_at) '
+ 'VALUES (:sid, :groupType, :subGroup, 1, :so, NOW(), NOW())',
{ replacements: { sid: subTypeId, groupType: g.group_type, subGroup: g.sub_group, so: idx + 1 } }
);
grpInserted += 1;
}
console.log(`[MIGRATION] 群白名单插入 ${grpInserted} 条`);
}
// ─── 4. 子类型-函数关系:queryPackVideo ─────────────────────
if (exists(FUNC_REL_TABLE) && exists(FUNCTION_TABLE)) {
const fnRows = await q(
'SELECT id FROM `' + FUNCTION_TABLE + '` WHERE function_code = :code LIMIT 1',
{ code: FUNCTION_CODE }
);
if (fnRows.length > 0) {
await sequelize.query(
'INSERT IGNORE INTO `' + FUNC_REL_TABLE + '` '
+ '(sub_type_id, function_id, sort_order, created_at, updated_at) '
+ 'VALUES (:sid, :fid, 1, NOW(), NOW())',
{ replacements: { sid: subTypeId, fid: fnRows[0].id } }
);
console.log(`[MIGRATION] 函数关系插入 ${FUNCTION_CODE}`);
} else {
console.warn(`[MIGRATION] 跳过:未找到处理函数 ${FUNCTION_CODE}`);
}
}
// ─── 5. 运单号取号规则关联 ──────────────────────────────────
if (exists(RULE_REL_TABLE) && exists(RULE_TABLE)) {
const ruleRows = await q(
'SELECT id FROM `' + RULE_TABLE + '` WHERE name = :n LIMIT 1',
{ n: RULE_NAME }
);
if (ruleRows.length > 0) {
await sequelize.query(
'INSERT IGNORE INTO `' + RULE_REL_TABLE + '` '
+ '(sub_type_id, number_rule_id, sort_order, created_at, updated_at) '
+ 'VALUES (:sid, :rid, 1, NOW(), NOW())',
{ replacements: { sid: subTypeId, rid: ruleRows[0].id } }
);
console.log(`[MIGRATION] 取号规则关联插入 ${RULE_NAME}`);
} else {
console.warn(`[MIGRATION] 跳过:未找到取号规则 ${RULE_NAME}`);
}
}
// ─── 6. 系统级回复行(先查后插;纯查询不建工单) ─────────────
if (exists(REPLY_TABLE)) {
const replyRows = await q(
'SELECT id FROM `' + REPLY_TABLE + '` WHERE sub_type_id = :sid AND warehouse_id IS NULL LIMIT 1',
{ sid: subTypeId }
);
if (replyRows.length === 0) {
await sequelize.query(
'INSERT INTO `' + REPLY_TABLE + '` '
+ '(warehouse_id, sub_type_id, reply, is_reply, create_work_order, no_number_hint, is_enabled, created_at, updated_at) '
+ 'VALUES (NULL, :sid, :reply, 1, 0, :hint, 1, NOW(), NOW())',
{ replacements: { sid: subTypeId, reply: '{back_text}', hint: HINT_DEFAULT } }
);
console.log('[MIGRATION] 系统级回复行插入 1 行');
}
}
},
/**
* 回滚:删除「打包视频查询」子类型的全部关联配置与子类型行。
* @param {Object} queryInterface Sequelize QueryInterface 实例。
* @return {Promise<void>} 无返回值。
*/
down: async queryInterface => {
const { sequelize } = queryInterface;
const [ subRows ] = await sequelize.query(
'SELECT id FROM `' + SUB_TYPE_TABLE + '` '
+ 'WHERE type = :t AND sub_type = :s AND warehouse_id IS NULL LIMIT 1',
{ replacements: { t: TYPE_CODE, s: SUB_TYPE_CODE } }
);
if (subRows.length === 0) return;
const subTypeId = subRows[0].id;
await sequelize.query('DELETE FROM `' + REPLY_TABLE + '` WHERE sub_type_id = :sid AND warehouse_id IS NULL', { replacements: { sid: subTypeId } });
await sequelize.query('DELETE FROM `' + KEYWORD_TABLE + '` WHERE sub_type_id = :sid AND warehouse_id IS NULL', { replacements: { sid: subTypeId } });
await sequelize.query('DELETE FROM `' + GROUP_REL_TABLE + '` WHERE sub_type_id = :sid', { replacements: { sid: subTypeId } });
await sequelize.query('DELETE FROM `' + FUNC_REL_TABLE + '` WHERE sub_type_id = :sid', { replacements: { sid: subTypeId } });
await sequelize.query('DELETE FROM `' + RULE_REL_TABLE + '` WHERE sub_type_id = :sid', { replacements: { sid: subTypeId } });
await sequelize.query('DELETE FROM `' + SUB_TYPE_TABLE + '` WHERE id = :sid', { replacements: { sid: subTypeId } });
},
};