WMS_MAIN/app/service/inbox/receiver.js
liufumingren e6f4d9f341 feat(inbox): 处理备注推送货主群、群类型清空接口与群按ID管理
- afterSale.handleWorkOrder: 处理备注发送到对应货主售后群(notifyGroup,内部流程不推),响应 notified_groups
- inbox.group.reset: 新增清空群类型接口(入参群主键ID),权限迁移 556
- 群登记以 group_id 为准: 移除同名群回填,群ID不存在直接新建,store_id/群信息均按 group_id 精确匹配
- changeAddr: 已有工单也把客户原文转发快递群并升级 pending_feedback(仅 pending 可升级)
- handleExpressFeedback: 工单描述售后类型显示中文(订单.物流异常)
- 同步 methods/system.json 与 changes 记录
2026-08-17 22:01:18 +08:00

230 lines
8.2 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

'use strict';
const Service = require('egg').Service;
/** 消息体大小上限 64KB */
const MAX_BODY_SIZE = 64 * 1024;
/**
* 站内信接收服务。
* 统一处理消息入站:幂等去重、写库。
* 暂不包含出站转发逻辑,纯入库管理。
*/
class InboxReceiverService extends Service {
/**
* 统一接收入口:幂等去重、写库。
* @param {Object} data 消息数据。
* @param {string} data.ext_id 外部唯一消息主键。
* @param {number} data.warehouse_id 所属仓库ID(服务端上下文注入,禁止外部传入)。
* @param {string} [data.direction='inbound'] 消息方向。
* @param {number} [data.parent_id] 关联消息ID(回信时指向原消息)。
* @param {string} data.source_type 来源类型:im / api / system。
* @param {string} [data.source_extra] 来源附加信息。
* @param {string} data.target_type 目标类型:im / api / webhook。
* @param {string} [data.group_name] 群名称(外部传入)。
* @param {string} [data.user_name] 用户名称(外部传入)。
* @param {string} [data.group_id] 外部群ID。
* @param {string} [data.user_id] 外部用户ID。
* @param {string} [data.content] 消息正文/摘要。
* @param {Object} [data.ext_data] 透传数据。
* @param {Object} [data.flags] 处理标记。
* @param {number} [data.send_time] 消息原始发送时间(毫秒时间戳,可选,用于历史消息过滤)。
* @return {Promise<{ok: boolean, id: number, ext_id: string}>} 接收结果。
*/
async receive(data = {}) {
const { ctx } = this;
const { InboxMessage } = ctx.model;
// 安全边界:校验 ext_id 不能为空
const extId = String(data.ext_id || '').trim();
if (!extId) {
throw new Error('ext_id 不能为空');
}
// 安全边界:warehouse_id 必须由服务端上下文提供
const warehouseId = Number(data.warehouse_id);
if (!Number.isFinite(warehouseId) || warehouseId <= 0) {
throw new Error('warehouse_id 无效');
}
// 枚举校验:direction
const VALID_DIRECTIONS = [ 'inbound', 'outbound' ];
const direction = VALID_DIRECTIONS.includes(data.direction) ? data.direction : 'inbound';
// 枚举校验:source_type
const VALID_SOURCE_TYPES = [ 'im', 'api', 'system' ];
const sourceType = VALID_SOURCE_TYPES.includes(data.source_type) ? data.source_type : (data.source_type || 'api');
// 枚举校验:target_type
const VALID_TARGET_TYPES = [ 'im', 'api', 'webhook' ];
const targetType = VALID_TARGET_TYPES.includes(data.target_type) ? data.target_type : (data.target_type || 'im');
// parent_id 存在性校验
const parentId = data.parent_id ? Number(data.parent_id) : null;
if (parentId) {
const parentExists = await InboxMessage.findOne({
where: { id: parentId, warehouse_id: warehouseId },
attributes: [ 'id' ],
});
if (!parentExists) {
throw new Error(`parent_id=${parentId} 对应的消息不存在`);
}
}
// 幂等检查:ext_id 已存在则直接返回
const exist = await InboxMessage.findOne({
where: { ext_id: extId },
attributes: [ 'id', 'ext_id' ],
paranoid: false,
});
if (exist) {
ctx.logger.info(`[inbox] 消息已存在,跳过入库 ext_id=${extId} id=${exist.id}`);
return {
ok: true,
id: exist.id,
ext_id: extId,
};
}
// 消息体大小限制
const checkBody = {
content: data.content || null,
ext_data: data.ext_data || null,
};
const bodySize = Buffer.byteLength(JSON.stringify(checkBody), 'utf8');
if (bodySize > MAX_BODY_SIZE) {
throw new Error(`消息体超过 64KB 限制(当前 ${Math.round(bodySize / 1024)}KB)`);
}
// flags 合并:消息发送时间统一存入 flags.send_time(毫秒),供 AI 历史消息过滤
const flags = { ...(data.flags || {}) };
if (!flags.send_time && data.send_time != null) {
const sendTime = Number(data.send_time);
if (Number.isFinite(sendTime) && sendTime > 0) {
flags.send_time = Math.floor(sendTime);
}
}
// 从群绑定查询货主ID(外部不再直接传入 store_id)
let storeId = null;
const extGroupId = String(data.group_id || '').trim();
if (extGroupId && warehouseId) {
try {
const group = await ctx.model.InboxGroup.findOne({
attributes: [ 'store_id' ],
where: { group_id: extGroupId, warehouse_id: warehouseId },
raw: true,
});
if (group && group.store_id) {
storeId = Number(group.store_id);
}
} catch (groupErr) {
ctx.logger.warn(`[inbox] 查找群货主失败: ${groupErr.message}`);
}
}
// 写库(暂不触发异步转发)
const record = await InboxMessage.create({
ext_id: extId,
warehouse_id: warehouseId,
store_id: storeId || null,
direction,
parent_id: parentId,
source_type: sourceType,
source_extra: data.source_extra || null,
target_type: targetType,
group_name: data.group_name || null,
user_name: data.user_name || null,
group_id: data.group_id || null,
user_id: data.user_id || null,
content: data.content || null,
ext_data: data.ext_data || null,
flags,
});
ctx.logger.info(`[inbox] 消息入库成功 ext_id=${extId} id=${record.id}`);
// 自动登记群:优先按 (group_id, warehouse_id) 幂等 upsert。
// 群ID不变、仅名称变化时只更新名称,不重复建群。
const groupName = String(data.group_name || '').trim();
if (groupName) {
try {
if (extGroupId) {
const group = await ctx.model.InboxGroup.findOne({
where: { group_id: extGroupId, warehouse_id: warehouseId },
});
if (group) {
// 群已存在:名称变化时更新名称,不新建
if (group.group_name !== groupName) {
const oldName = group.group_name;
await group.update({ group_name: groupName });
ctx.logger.info(
`[inbox] 群名称已更新 group_id=${extGroupId}: ${oldName} → ${groupName}`
);
}
} else {
// 群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,
});
ctx.logger.info(
`[inbox] 新建群记录 group_id=${extGroupId} name=${groupName}`
);
}
} else {
// 无群ID:按 (group_name, warehouse_id) 幂等登记(向后兼容)
await ctx.model.InboxGroup.findOrCreate({
where: { group_name: groupName, warehouse_id: warehouseId },
defaults: {
group_id: null,
store_id: storeId || null,
source_type: sourceType,
source_extra: data.source_extra || null,
ai_enabled: 0,
},
});
}
} catch (groupErr) {
ctx.logger.warn(`[inbox] 群登记失败: ${groupErr.message}`);
}
}
// source_type 分流:API 来源异步回执
if (sourceType === 'api') {
setImmediate(() => {
ctx.service.inbox.processor.handleApiMessage({
warehouse_id: warehouseId,
store_id: storeId,
parent_id: record.id,
ext_data: data.ext_data || null,
ext_id: extId,
content: data.content || '',
group_name: data.group_name || null,
user_name: data.user_name || null,
group_id: data.group_id || null,
user_id: data.user_id || null,
flags,
}).catch(err => {
ctx.logger.error(`[inbox] API 异步回执异常 ext_id=${extId}: ${err.message}`);
});
});
}
return {
ok: true,
id: record.id,
ext_id: extId,
};
}
}
module.exports = InboxReceiverService;