WMS_MAIN/app/service/inbox/message.js
liufumingren 948f600689 feat(inbox): 回调推送、出站文档、搜索增强、日志与推送状态完善
出站回调:
- 新增 warehouse_notify.json 文档(notify.ping/notify.reply),与 warehouse.json 互跳
- 回调体统一 { method, code, data },method 放 query,body 为业务数据
- MD5 签名: sign=MD5(appSecret+timestamp+bodyJson)
- 回调响应: {code:200} 成功,非200/非code:200 视为失败
- docs 页面支持模拟推送调试

搜索增强(searchStock/searchWarehouseStock):
- 直接查 stock_warehouse,不再依赖 stock_store
- 新增字段: gross_weight/box_spec/packing_requirements/prohibited_type
- 管理标识: is_sn_mgmt/is_shelf_life_mgmt/is_batch_mgmt
- 条码关联: wms_stock_barcodes
- 图片: wms_file_reference(business_type=stock)+wms_file,返回数组
- id 修正为 stock_warehouse.id

推送状态完善:
- handleApiMessage 增加 push_status 更新(2成功/3失败)
- 未配回调地址 → push_status=3 + error 原因
- 回调异常 catch 也更新 push_status=3 + 写日志
- 出站日志写入 wms_warehouse_log 表(WN-前缀)

消息列表:
- keyword 兼容 content/keyword,支持数组
- keyword 搜索 content/group_name/user_name 三列
- 支持 where+operator 结构化查询(parseWhereConditions)
- storeId=-1 查询无货主消息; storeId=0→IS NULL
- 日期范围: startDate/endDate

其他:
- silent 动作: AI 识别无需回复时跳过回执
- ai_enabled 灰度开关(群级)
- bindCode 文档修正
- store_name 改用 StoreWarehouse.store_remask
2026-08-08 00:17:38 +08:00

405 lines
13 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;
const { parseWhereConditions } = require('../../lib/query_condition_parser');
/**
* 站内信消息查询/管理服务。
* 提供消息列表、详情、对话链、回复、统计等管理功能。
*/
class InboxMessageService extends Service {
/**
* 消息列表(多条件筛选,分页)。
* 支持两种参数风格:
* 1. 扁平风格:{ warehouseId, storeId, keyword, page, pageSize, ... }
* 2. 结构化风格:{ pagination: { page, pageSize }, where: { field: { operator, value } } }
* 时间字段使用 app.formatDate 统一格式化输出。
*
* @param {Object} params 查询参数。
* @param {number} params.warehouseId 仓库ID(必填,服务端上下文注入)。
* @param {Object} [params.pagination] 分页对象(结构化风格)。
* @param {Object} [params.where] 结构化 where 条件,字段映射同 DB 列名。
* @param {string|string[]} [params.storeId] 货主ID筛选。
* @param {string|string[]} [params.groupId] 群ID筛选。
* @param {string} [params.groupName] 群名称模糊搜索。
* @param {string} [params.userName] 用户名模糊搜索。
* @param {string} [params.content] 正文/keyword 模糊搜索。
* @param {string} [params.sourceType] 来源类型:im / api / system。
* @param {string} [params.direction] 消息方向:inbound / outbound。
* @param {number} [params.pushStatus] 推送状态:0/1/2/3。
* @param {string} [params.startDate] 开始日期。
* @param {string} [params.endDate] 结束日期。
* @param {number} [params.page=1] 页码。
* @param {number} [params.pageSize=20] 每页数量。
* @return {Promise<{list: Array, pagination: Object}>} 分页结果。
*/
async list(params = {}) {
const { ctx } = this;
const { Op } = ctx.app.Sequelize;
const { InboxMessage } = ctx.model;
const warehouseId = Number(params.warehouseId);
if (!Number.isFinite(warehouseId) || warehouseId <= 0) {
throw new Error('warehouseId 无效');
}
// 分页:优先取 pagination 对象,兜底扁平参数
const pag = params.pagination || {};
const page = Math.max(1, Number(pag.page || params.page) || 1);
const pageSize = Math.min(200, Math.max(1, Number(pag.pageSize || params.pageSize) || 20));
// 基础条件
const where = {
warehouse_id: warehouseId,
deleted_at: null,
};
// ── 结构化 where(operator 模式)──
if (params.where && typeof params.where === 'object') {
const parsed = parseWhereConditions({
where: params.where,
app: ctx.app,
specialFieldMap: {},
});
if (!parsed.ok) {
throw new Error(`where 参数解析失败: ${parsed.reason}`);
}
// 合并解析出的条件
if (Array.isArray(parsed.result.dynamicConditions)) {
Object.assign(where, ...parsed.result.dynamicConditions);
}
// 前端约定:store_id = 0 视为无货主消息 → IS NULL
if (where.store_id !== undefined && where.store_id !== null) {
const sid = where.store_id;
// Sequelize 将 [0] 展开为 IN (0),需转为 IS NULL
if (Array.isArray(sid) && sid.length === 1 && sid[0] === 0) {
where.store_id = { [Op.is]: null };
} else if (sid === 0 || sid === '0') {
where.store_id = { [Op.is]: null };
}
}
}
// ── 扁平参数(向后兼容,结构化 where 已设置的字段会被覆盖)──
// 货主ID(-1 = 无货主消息,即 store_id IS NULL)
const rawStoreId = params.storeId;
if (rawStoreId === -1 || rawStoreId === '-1') {
where.store_id = { [Op.is]: null };
} else {
const storeIds = this._normalizeIds(rawStoreId);
if (storeIds.length > 0) {
where.store_id = { [Op.in]: storeIds };
}
}
// 群ID
const groupIds = this._normalizeStrings(params.groupId);
if (groupIds.length > 0) {
where.group_id = { [Op.in]: groupIds };
}
// 群名称
const groupName = String(params.groupName || '').trim();
if (groupName) {
where.group_name = { [Op.like]: `%${groupName}%` };
}
// 用户名
const userName = String(params.userName || '').trim();
if (userName) {
where.user_name = { [Op.like]: `%${userName}%` };
}
// 关键词:content + group_name + user_name
const rawKw = params.content || params.keyword;
const keyword = Array.isArray(rawKw)
? String(rawKw.filter(Boolean)[0] || '').trim()
: String(rawKw || '').trim();
if (keyword) {
const like = { [Op.like]: `%${keyword}%` };
where[Op.or] = [
{ content: like },
{ group_name: like },
{ user_name: like },
];
}
// 来源类型
const VALID_SOURCE_TYPES = [ 'im', 'api', 'system' ];
const sourceType = String(params.sourceType || '').trim();
if (sourceType && VALID_SOURCE_TYPES.includes(sourceType)) {
where.source_type = sourceType;
}
// 日期范围(扁平参数兜底,结构化 where 已通过 created_at 处理)
if (!where.created_at) {
const startDate = params.startDate || params.start_date;
const endDate = params.endDate || params.end_date;
if (startDate || endDate) {
where.created_at = {};
if (startDate) where.created_at[Op.gte] = new Date(startDate);
if (endDate) where.created_at[Op.lte] = new Date(endDate);
}
}
// 方向
if (params.direction && [ 'inbound', 'outbound' ].includes(params.direction)) {
where.direction = params.direction;
}
// 推送状态
if (params.pushStatus !== undefined && params.pushStatus !== null && params.pushStatus !== '') {
const status = Number(params.pushStatus);
if ([ 0, 1, 2, 3 ].includes(status)) {
where.push_status = status;
}
}
const { count: total, rows } = await InboxMessage.findAndCountAll({
attributes: {
exclude: [ 'ext_data', 'push_response', 'target_channel' ],
},
where,
order: [[ 'created_at', 'DESC' ]],
offset: (page - 1) * pageSize,
limit: pageSize,
});
// 批量查货主备注名称(StoreWarehouse.store_remask)
const storeIdsInResult = [ ...new Set(rows.map(r => r.store_id).filter(Boolean)) ];
const storeNameMap = {};
if (storeIdsInResult.length > 0) {
const contracts = await ctx.model.StoreWarehouse.findAll({
attributes: [ 'store_id', 'store_remask' ],
where: {
store_id: { [Op.in]: storeIdsInResult },
warehouse_id: warehouseId,
},
raw: true,
});
for (const c of contracts) {
storeNameMap[c.store_id] = c.store_remask || '';
}
}
const formatDate = ctx.app.formatDate;
const list = rows.map(row => {
const obj = row && typeof row.toJSON === 'function' ? row.toJSON() : row;
return {
...obj,
store_name: storeNameMap[obj.store_id] || '',
created_at: obj.created_at ? formatDate(obj.created_at) : '',
updated_at: obj.updated_at ? formatDate(obj.updated_at) : '',
pushed_at: obj.pushed_at ? formatDate(obj.pushed_at) : '',
};
});
return {
list,
pagination: {
page,
pageSize,
total,
totalPages: Math.ceil(total / pageSize),
hasPrevious: page > 1,
hasNext: page * pageSize < total,
},
};
}
/**
* 将入参统一为数字ID数组。
* 支持逗号分隔字符串 "1,2,3" 或数组 [1,2,3]。
* @param {string|string[]|number[]|undefined} val 入参。
* @return {number[]} 去重后的数字数组。
*/
_normalizeIds(val) {
if (val === undefined || val === null) return [];
const arr = Array.isArray(val) ? val : String(val).split(',');
return [ ...new Set(arr.map(Number).filter(v => Number.isFinite(v) && v > 0)) ];
}
/**
* 将入参统一为字符串数组(去重去空)。
* @param {string|string[]|undefined} val 入参。
* @return {string[]} 去重后的非空字符串数组。
*/
_normalizeStrings(val) {
if (val === undefined || val === null) return [];
const arr = Array.isArray(val) ? val : String(val).split(',');
return [ ...new Set(arr.map(String).map(s => s.trim()).filter(Boolean)) ];
}
/**
* 消息详情(含 push_response)。
* @param {Object} params 查询参数。
* @param {number} params.warehouseId 仓库ID(必填)。
* @param {number} params.id 消息ID。
* @return {Promise<Object>} 消息详情。
*/
async detail(params = {}) {
const { ctx } = this;
const { InboxMessage } = ctx.model;
const warehouseId = Number(params.warehouseId);
const id = Number(params.id);
if (!Number.isFinite(warehouseId) || warehouseId <= 0) {
throw new Error('warehouseId 无效');
}
if (!Number.isFinite(id) || id <= 0) {
throw new Error('消息ID无效');
}
const record = await InboxMessage.findOne({
where: { id, warehouse_id: warehouseId, deleted_at: null },
});
if (!record) {
throw new Error('消息不存在或无权访问');
}
return record;
}
/**
* 对话链查询(原消息 + 所有回信),按 parent_id 递归。
* @param {Object} params 查询参数。
* @param {number} params.warehouseId 仓库ID(必填)。
* @param {number} params.id 消息ID。
* @return {Promise<Array>} 对话链列表。
*/
async thread(params = {}) {
const { ctx } = this;
const { InboxMessage } = ctx.model;
const warehouseId = Number(params.warehouseId);
const id = Number(params.id);
if (!Number.isFinite(warehouseId) || warehouseId <= 0) {
throw new Error('warehouseId 无效');
}
if (!Number.isFinite(id) || id <= 0) {
throw new Error('消息ID无效');
}
// 查找根消息
const root = await InboxMessage.findOne({
where: { id, warehouse_id: warehouseId },
});
if (!root) {
throw new Error('消息不存在或无权访问');
}
// 收集对话链:从根到叶
const MAX_THREAD_DEPTH = 50;
const thread = [ root ];
const visited = new Set([ root.id ]);
// 查找所有回信(以 root.id 为 parent_id)
const replies = await InboxMessage.findAll({
where: {
warehouse_id: warehouseId,
parent_id: root.id,
deleted_at: null,
},
order: [[ 'created_at', 'ASC' ]],
});
for (const reply of replies) {
if (!visited.has(reply.id) && thread.length < MAX_THREAD_DEPTH) {
visited.add(reply.id);
thread.push(reply);
}
}
// 如果当前消息不是根(有 parent_id),也向上查找原消息
if (root.parent_id) {
const parent = await InboxMessage.findOne({
where: {
id: root.parent_id,
warehouse_id: warehouseId,
deleted_at: null,
},
});
if (parent && !visited.has(parent.id) && thread.length < MAX_THREAD_DEPTH) {
visited.add(parent.id);
thread.unshift(parent);
}
}
return thread;
}
/**
* 推送统计(按仓库 + 方向汇总)。
* @param {Object} params 统计参数。
* @param {number} params.warehouseId 仓库ID(必填)。
* @return {Promise<Object>} 统计结果。
*/
async stats(params = {}) {
const { ctx } = this;
const { InboxMessage } = ctx.model;
const { Op } = ctx.app.Sequelize;
const warehouseId = Number(params.warehouseId);
if (!Number.isFinite(warehouseId) || warehouseId <= 0) {
throw new Error('warehouseId 无效');
}
const where = {
warehouse_id: warehouseId,
};
if (params.direction && [ 'inbound', 'outbound' ].includes(params.direction)) {
where.direction = params.direction;
}
// 按方向统计
const directionStats = await InboxMessage.findAll({
attributes: [
'direction',
[ ctx.app.Sequelize.fn('COUNT', ctx.app.Sequelize.col('id')), 'count' ],
],
where,
group: [ 'direction' ],
raw: true,
});
// 按推送状态统计
const statusStats = await InboxMessage.findAll({
attributes: [
'push_status',
[ ctx.app.Sequelize.fn('COUNT', ctx.app.Sequelize.col('id')), 'count' ],
],
where,
group: [ 'push_status' ],
raw: true,
});
// 最近24小时统计
const recentWhere = {
...where,
created_at: {
[Op.gte]: new Date(Date.now() - 24 * 60 * 60 * 1000),
},
};
const recentCount = await InboxMessage.count({ where: recentWhere });
return {
total_by_direction: directionStats,
total_by_status: statusStats,
recent_24h_count: recentCount,
};
}
}
module.exports = InboxMessageService;