487 lines
15 KiB
JavaScript
487 lines
15 KiB
JavaScript
'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,
|
||
};
|
||
}
|
||
|
||
/**
|
||
* 手动重推失败(push_status=3)的站内信消息。
|
||
* 重置为待推送状态(push_status=0)并触发异步推送。
|
||
* @param {Object} params 重推参数。
|
||
* @param {number} params.warehouseId 仓库ID(必填,服务端上下文注入)。
|
||
* @param {number} params.id 消息ID。
|
||
* @return {Promise<Object>} { ok, id, ext_id, message }。
|
||
*/
|
||
async retry(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('消息不存在或无权访问');
|
||
}
|
||
if (record.push_status !== 3) {
|
||
throw new Error('仅失败状态的消息可以手动重推');
|
||
}
|
||
|
||
// 重置为待推送状态
|
||
await InboxMessage.update(
|
||
{ push_status: 0, push_response: null, push_started_at: null },
|
||
{ where: { id } }
|
||
);
|
||
|
||
// 回执记录 ext_id 形如 sys:ack:{原消息ext_id},反解出原消息 ext_id 以复用推送链路
|
||
const extId = String(record.ext_id || '');
|
||
const originalExtId = extId.startsWith('sys:ack:') ? extId.slice(8) : extId;
|
||
const hasUser = Boolean(record.user_id && record.user_name);
|
||
const pushData = {
|
||
warehouse_id: warehouseId,
|
||
ext_id: originalExtId,
|
||
parent_id: record.parent_id || null,
|
||
group_id: record.group_id || '',
|
||
group_name: record.group_name || '',
|
||
user_id: record.user_id || '',
|
||
user_name: record.user_name || '',
|
||
ext_data: record.ext_data || null,
|
||
};
|
||
|
||
// 触发异步推送
|
||
setImmediate(() => {
|
||
ctx.service.inbox.processor.writeOutboundReply(
|
||
pushData,
|
||
record.content || '',
|
||
hasUser ? 'ai_reply' : 'system'
|
||
).catch(async err => {
|
||
ctx.logger.error(`[inbox] 手动重推异步推送异常 id=${id}: ${err.message}`);
|
||
// 推送前校验失败时回写失败状态,避免消息卡在待推送
|
||
try {
|
||
await InboxMessage.update(
|
||
{ push_status: 3, push_response: { error: err.message } },
|
||
{ where: { id } }
|
||
);
|
||
} catch (updateErr) {
|
||
ctx.logger.error(`[inbox] 重推失败状态回写异常 id=${id}: ${updateErr.message}`);
|
||
}
|
||
});
|
||
});
|
||
|
||
return {
|
||
ok: true,
|
||
id: record.id,
|
||
ext_id: record.ext_id,
|
||
message: '已重置为待推送状态,正在异步重推',
|
||
};
|
||
}
|
||
}
|
||
|
||
module.exports = InboxMessageService;
|