feat(panel): trend 移除 pack_count 打包数,仅保留总单量累计(0.3.285)
This commit is contained in:
parent
606928194f
commit
2452cef4f1
@ -187,7 +187,7 @@ class WarehousePanelService extends Service {
|
||||
.catch(error => this.logBlockError('groupPacking', error)),
|
||||
this.queryPackingBlock(warehouseId, businessStart, businessEnd, false)
|
||||
.catch(error => this.logBlockError('scatterPacking', error)),
|
||||
this.queryTrend(currentModel, warehouseId, businessStart, businessEnd)
|
||||
this.queryTrend(currentModel, dispatchModel, pendingBase, businessStart, businessEnd)
|
||||
.catch(error => this.logBlockError('trend', error)),
|
||||
this.queryWeeklyIntercept(currentModel, dispatchModel, todayStart)
|
||||
.catch(error => this.logBlockError('weeklyEfficiency', error)),
|
||||
@ -856,20 +856,19 @@ class WarehousePanelService extends Service {
|
||||
|
||||
/**
|
||||
* 今日订单实时趋势(业务日窗口 24 点,label 从仓库自然日开始时间起每小时一点,到次日自然日开始时间)。
|
||||
* created_count:订单创建时间落桶后按小时累计(自然日零点起统计,早于自然日开始时间的并入第一点);
|
||||
* pack_count:打包订单数按打包任务创建时间落桶后按小时累计(口径与打包卡 today 一致:
|
||||
* pack_mode=2 团购按 pack_quantity 求和 + 散单每任务 1 单,非异常未删除)。
|
||||
* 每点输出累计值(截至该小时结束的总数,最后一点=全天总数)。
|
||||
* created_count:总单量按订单创建时间落桶后按小时累计(与 fulfillment.total 同口径:
|
||||
* 待处理订单池(pendingBase)+ 配送表今日出库订单;早于统计窗口起点的并入第一点,
|
||||
* 累计最后一点=今日总单量)。
|
||||
*
|
||||
* @param {Object} currentModel 常用分表模型
|
||||
* @param {number} warehouseId 仓库 ID
|
||||
* @param {Object} dispatchModel 配送分表模型
|
||||
* @param {Object} pendingBase 待处理基础过滤
|
||||
* @param {Date} todayStart 业务日开始时间(仓库自然日 day_start_time)
|
||||
* @param {Date} tomorrowStart 业务日结束时间(次日自然日开始时间)
|
||||
* @return {Promise<Object>} { max, points },points 每项 { label, created_count, pack_count }
|
||||
* @return {Promise<Object>} { max, points },points 每项 { label, created_count }
|
||||
*/
|
||||
async queryTrend(currentModel, warehouseId, todayStart, tomorrowStart) {
|
||||
async queryTrend(currentModel, dispatchModel, pendingBase, todayStart, tomorrowStart) {
|
||||
const { Op, fn, col, literal } = this.app.Sequelize;
|
||||
const { model } = this.ctx;
|
||||
|
||||
// 横轴 24 点:从自然日开始时间起每小时一点(跨天,label=桶起点 HH:00)
|
||||
const points = [];
|
||||
@ -880,53 +879,66 @@ class WarehousePanelService extends Service {
|
||||
points.push({
|
||||
label: `${String(bucketStart.getHours()).padStart(2, '0')}:00`,
|
||||
created_count: 0,
|
||||
pack_count: 0,
|
||||
});
|
||||
}
|
||||
// 统计窗口:自然日零点(业务日当天 00:00)起,到业务日结束;早于自然日开始时间的小时并入第一点
|
||||
// 统计窗口:自然日零点(业务日当天 00:00)起,到业务日结束;早于窗口起点的小时并入第一点
|
||||
const midnight = new Date(todayStart.getFullYear(), todayStart.getMonth(), todayStart.getDate());
|
||||
const bucketIndexOf = hour => {
|
||||
const bucket = bucketByHour.get(Number(hour));
|
||||
return bucket === undefined ? 0 : bucket;
|
||||
};
|
||||
|
||||
// 创建趋势:全部订单(仅排除已取消)按创建小时落桶
|
||||
const createdRows = await currentModel.findAll({
|
||||
attributes: [
|
||||
[ fn('HOUR', col('create_at')), 'hour' ],
|
||||
[ fn('COUNT', literal('*')), 'count' ],
|
||||
],
|
||||
where: { status: { [Op.ne]: 'cancel' }, create_at: { [Op.gte]: midnight, [Op.lt]: tomorrowStart } },
|
||||
group: [ 'hour' ],
|
||||
raw: true,
|
||||
});
|
||||
// 打包趋势:打包订单数按打包任务创建小时落桶(与打包卡 today 同口径)
|
||||
const packRows = await model.query(
|
||||
`SELECT HOUR(create_time) AS hour,
|
||||
COALESCE(SUM(CASE WHEN pack_mode = 2 THEN pack_quantity ELSE 1 END), 0) AS cnt
|
||||
FROM wms_pack_task
|
||||
WHERE warehouse_id = :warehouseId
|
||||
AND create_time >= :start AND create_time < :end
|
||||
AND status != 3 AND deleted_at IS NULL
|
||||
GROUP BY HOUR(create_time)`,
|
||||
{ replacements: { warehouseId, start: midnight, end: tomorrowStart }, type: model.QueryTypes.SELECT }
|
||||
);
|
||||
// 总单量按创建时间落桶(与 fulfillment.total 同口径:池内待处理 + 配送表今日出库)
|
||||
const dispatchTodayBase = {
|
||||
status: { [Op.ne]: 'cancel' },
|
||||
outbound_status: 'fin',
|
||||
delivery_time: { [Op.gte]: todayStart, [Op.lt]: tomorrowStart },
|
||||
dispatch_lane: { [Op.in]: [ 'm4', 'm5' ] },
|
||||
};
|
||||
const [
|
||||
createdRows,
|
||||
dispatchCreatedRows,
|
||||
earlyCurrentCount,
|
||||
earlyDispatchCount,
|
||||
] = await Promise.all([
|
||||
currentModel.findAll({
|
||||
attributes: [
|
||||
[ fn('HOUR', col('create_at')), 'hour' ],
|
||||
[ fn('COUNT', literal('*')), 'count' ],
|
||||
],
|
||||
where: { ...pendingBase, create_at: { [Op.gte]: midnight, [Op.lt]: tomorrowStart } },
|
||||
group: [ 'hour' ],
|
||||
raw: true,
|
||||
}),
|
||||
dispatchModel.findAll({
|
||||
attributes: [
|
||||
[ fn('HOUR', col('create_at')), 'hour' ],
|
||||
[ fn('COUNT', literal('*')), 'count' ],
|
||||
],
|
||||
where: { ...dispatchTodayBase, create_at: { [Op.gte]: midnight, [Op.lt]: tomorrowStart } },
|
||||
group: [ 'hour' ],
|
||||
raw: true,
|
||||
}),
|
||||
currentModel.count({
|
||||
where: { ...pendingBase, create_at: { [Op.lt]: midnight } },
|
||||
}),
|
||||
dispatchModel.count({
|
||||
where: { ...dispatchTodayBase, create_at: { [Op.lt]: midnight } },
|
||||
}),
|
||||
]);
|
||||
|
||||
(createdRows || []).forEach(row => {
|
||||
points[0].created_count += Number(earlyCurrentCount || 0) + Number(earlyDispatchCount || 0);
|
||||
[ ...(createdRows || []), ...(dispatchCreatedRows || []) ].forEach(row => {
|
||||
points[bucketIndexOf(row.hour)].created_count += Number(row.count || 0);
|
||||
});
|
||||
(Array.isArray(packRows) ? packRows : []).forEach(row => {
|
||||
points[bucketIndexOf(row.hour)].pack_count += Number(row.cnt || 0);
|
||||
});
|
||||
|
||||
// 累计口径:每点为截至该小时结束的累计总数(最后一点=全天总数)
|
||||
// 累计口径:每点为截至该小时结束的累计总数(最后一点=今日总单量)
|
||||
for (let index = 1; index < points.length; index++) {
|
||||
points[index].created_count += points[index - 1].created_count;
|
||||
points[index].pack_count += points[index - 1].pack_count;
|
||||
}
|
||||
|
||||
const peak = points.reduce(
|
||||
(maxValue, point) => Math.max(maxValue, point.created_count, point.pack_count),
|
||||
(maxValue, point) => Math.max(maxValue, point.created_count),
|
||||
0
|
||||
);
|
||||
const max = Math.max(Math.ceil(peak / 10) * 10, 10);
|
||||
|
||||
@ -1,4 +1,18 @@
|
||||
[
|
||||
{
|
||||
"version": "0.3.285",
|
||||
"date": "2026-10-11",
|
||||
"type": "updated",
|
||||
"summary": "index.getWarehousePanelData trend 移除 pack_count 打包数(仅保留总单量累计)(0.3.284 → 0.3.285)",
|
||||
"methods": [
|
||||
"index.getWarehousePanelData"
|
||||
],
|
||||
"notes": [
|
||||
"变更内容:trend points 每项由 { label, created_count, pack_count } 改为 { label, created_count },移除打包数(打包数口径与总单量不同源、易引起误解);created_count 保持总单量按订单创建时间落桶后按小时累计(与 fulfillment.total 同口径),max 仅按 created_count 峰值。",
|
||||
"代码依据:app/service/systems/warehouse_panel.js#queryTrend(删除 pack 查询与 pack_count 落桶/累计;签名移除 warehouseId);ESLint 0 错误。",
|
||||
"文档变更范围:methods/system.json 的 module=index 分组仅更新 index.getWarehousePanelData 一条(response.data.description 与 notes 移除 pack_count 描述);根版本 0.3.284 → 0.3.285、updatedAt 保持 2026-10-11;methods/changes/system.json 新增本条(插入数组首位);其余 method 未改动。"
|
||||
]
|
||||
},
|
||||
{
|
||||
"version": "0.3.284",
|
||||
"date": "2026-10-11",
|
||||
|
||||
@ -1,7 +1,7 @@
|
||||
{
|
||||
"module": "system",
|
||||
"description": "系统接口标准入口,method 对应系统内置方法,全部使用 POST 请求,参数统一放在 body 内",
|
||||
"version": "0.3.284",
|
||||
"version": "0.3.285",
|
||||
"updatedAt": "2026-10-11",
|
||||
"headers": [
|
||||
{
|
||||
@ -2621,7 +2621,7 @@
|
||||
"name": "data",
|
||||
"type": "object",
|
||||
"required": true,
|
||||
"description": "面板数据对象;is_change=false 时为空对象(节约流量),is_change=true 时输出。已输出字段:title(仓库名)、fulfillment(订单履约链路 6 环节未/已 + total + items 末尾两项今日退件/今日拆包;各环节未/已均含配送表今日出库按环节状态拆分补数,打包环节已* 用今日打包任务口径与 groupPacking/scatterPacking 一致)、stageOverview(totalOrders/interceptOrders/stages 5 卡:receiving/shelf/pick/recheck/pack)、b2b(orders/goods/sku)、groupPicking、scatterPicking(orders/goods/sku/wave/top5)、groupPacking、scatterPacking(各含 orders/goods/sku/wave/top5,按波次范围 wave_scope 区分:团购块 top 按打包台、散单块 top 按打包员)、trend(max/total/points 业务日 24 点:label 从仓库自然日开始时间(day_start_time)起到次日自然日开始时间,每点 { label, created_count, pack_count }——created_count=订单创建时间落桶(自然日零点起统计、全部订单仅排除已取消,早于自然日开始时间的并入第一点)、pack_count=打包订单数按打包任务创建时间落桶(pack_mode=2 按 pack_quantity 求和 + 散单每任务 1 单,非异常未删除,与打包卡 today 同口径);双值均按小时累计(截至该小时结束的总数,最后一点=全天总数);total=今日总单量(与 fulfillment.total 同口径:待处理订单池 + 配送表今日出库))、weeklyEfficiency(days 7 天 intercept)"
|
||||
"description": "面板数据对象;is_change=false 时为空对象(节约流量),is_change=true 时输出。已输出字段:title(仓库名)、fulfillment(订单履约链路 6 环节未/已 + total + items 末尾两项今日退件/今日拆包;各环节未/已均含配送表今日出库按环节状态拆分补数,打包环节已* 用今日打包任务口径与 groupPacking/scatterPacking 一致)、stageOverview(totalOrders/interceptOrders/stages 5 卡:receiving/shelf/pick/recheck/pack)、b2b(orders/goods/sku)、groupPicking、scatterPicking(orders/goods/sku/wave/top5)、groupPacking、scatterPacking(各含 orders/goods/sku/wave/top5,按波次范围 wave_scope 区分:团购块 top 按打包台、散单块 top 按打包员)、trend(max/total/points 业务日 24 点:label 从仓库自然日开始时间(day_start_time)起到次日自然日开始时间,每点 { label, created_count }——created_count=总单量按订单创建时间落桶(与 fulfillment.total 同口径:待处理订单池 + 配送表今日出库订单,早于统计窗口起点的并入第一点)并按小时累计(截至该小时结束的累计总数,最后一点=全天总单量);total=今日总单量(与 fulfillment.total 同口径:待处理订单池 + 配送表今日出库))、weeklyEfficiency(days 7 天 intercept)"
|
||||
}
|
||||
],
|
||||
"errors": [],
|
||||
@ -2629,7 +2629,7 @@
|
||||
"缓存键 index:warehousePanel:lastChangeAt:{warehouseId},值为 { last_change_at, data },TTL 300 秒。拉取逻辑:缓存有最后更新时间且传入时间戳未过期 → is_change=false + 空 data 不查库;时间戳过期且缓存有数据 → 直接输出缓存数据;时间戳过期但缓存无数据(外部只驱动了时间戳)→ 查库拉数据补入缓存并保留外部时间戳;缓存无最后更新时间(未命中/过期)→ 查库拉数据并设置最后更新时间",
|
||||
"最后更新时间一般由外部驱动:业务数据变化时由外部写入缓存键的 last_change_at(只写时间戳即可,数据由本接口下次拉取时补入)",
|
||||
"未输出字段(数据源或口径未定):履约链路第 7 环节退件签收、stageOverview 质检卡、收货/上架卡的 today/abnormal、weeklyEfficiency 的 throughput/max",
|
||||
"口径:fulfillment 各环节未* = 常用表池内未完成 + 配送分表今日出库未完成(真实状态);已* 口径:分配/打印/拣货均从订单表状态获取(池内 fin + 配送表今日出库 fin,保证已分配≥已打印≥已拣货的流程约束),复核=今日复核时间(recheck_time 双表)、打包=今日打包任务订单数(pack_mode=2 按 pack_quantity 求和 + 散单每任务 1 单,与 groupPacking/scatterPacking 严格一致)、出库=今日出库数;出库环节未+已=total,其余环节已* 为状态/今日作业口径、未* 为真实状态口径;面板全部今日统计窗口按仓库配置自然日开始时间 day_start_time(默认 06:00)划分:今日=[当日06:00, 次日06:00),当前时间早于当日 06:00 时窗口为 [昨日06:00, 当日06:00)(昨日 06:00 后的订单视为今日);trend 按业务日窗口双值:横轴 24 点从自然日开始时间起到次日自然日开始时间,created_count(订单创建,自然日零点起统计、早于自然日开始时间的并入第一点)与 pack_count(打包订单数,与打包卡 today 同口径)双值输出,双值均按小时累计(截至该小时结束的总数,最后一点=全天总数);trend 另含 total(今日总单量,与 fulfillment.total 同口径);weeklyEfficiency(7 日)仍按自然日;fulfillment 的 items 末尾两项(今日退件/今日拆包)按 wms_return_received/wms_return_unpack 的 warehouse_id 隔离 + created_at 今日 [00:00, 次日 00:00) 计数;",
|
||||
"口径:fulfillment 各环节未* = 常用表池内未完成 + 配送分表今日出库未完成(真实状态);已* 口径:分配/打印/拣货均从订单表状态获取(池内 fin + 配送表今日出库 fin,保证已分配≥已打印≥已拣货的流程约束),复核=今日复核时间(recheck_time 双表)、打包=今日打包任务订单数(pack_mode=2 按 pack_quantity 求和 + 散单每任务 1 单,与 groupPacking/scatterPacking 严格一致)、出库=今日出库数;出库环节未+已=total,其余环节已* 为状态/今日作业口径、未* 为真实状态口径;面板全部今日统计窗口按仓库配置自然日开始时间 day_start_time(默认 06:00)划分:今日=[当日06:00, 次日06:00),当前时间早于当日 06:00 时窗口为 [昨日06:00, 当日06:00)(昨日 06:00 后的订单视为今日);trend 按业务日窗口双值:横轴 24 点从自然日开始时间起到次日自然日开始时间,created_count(总单量按订单创建时间落桶:池内待处理 + 配送表今日出库,与 fulfillment.total 同口径,早于统计窗口起点的并入第一点)按小时累计(最后一点=全天总单量);trend 另含 total(今日总单量,与 fulfillment.total 同口径);weeklyEfficiency(7 日)仍按自然日;fulfillment 的 items 末尾两项(今日退件/今日拆包)按 wms_return_received/wms_return_unpack 的 warehouse_id 隔离 + created_at 今日 [00:00, 次日 00:00) 计数;",
|
||||
"groupPicking/scatterPicking 汇总(orders/goods/sku/wave)按订单表状态口径:池内 pick fin + 配送表今日出库 pick fin,团购=wave_scope IN (1,3)、散单=NOT IN (1,3),团购+散单=已拣货;top 仍按今日创建任务(pick_mode 1,5 团购 / 2,3,4 散单)按人聚合(任务口径,订单表无拣货人);",
|
||||
"stageOverview 的 pack 卡 today 与 fulfillment 已打包同口径(今日打包任务订单数:pack_mode=2 按 pack_quantity 求和 + 散单每任务 1 单、窗口内非异常未删除),doing/abnormal 为任务数(打包中/异常任务);"
|
||||
]
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user