fix(panel): fulfillment 已打包改 pack_status 存量口径,修复已打包大于已复核(0.3.287)
This commit is contained in:
parent
a22e788706
commit
d3e8421bdc
@ -237,9 +237,9 @@ class WarehousePanelService extends Service {
|
||||
*
|
||||
* 配送表补数:已出库订单会从常用表迁移到配送分表(outbound_status=fin);
|
||||
* 各环节未* = 池内未完成 + 配送表今日出库未完成(真实状态);
|
||||
* 各环节已* 口径:分配/打印/拣货从订单表状态获取(池内 fin + 配送表今日出库 fin,
|
||||
* 保证已分配≥已打印≥已拣货),复核=今日复核时间(recheck_time),
|
||||
* 打包=今日打包任务订单数、出库=今日出库数。
|
||||
* 各环节已* 口径:分配/打印/拣货/打包从订单表状态获取(池内 fin + 配送表今日出库 fin,
|
||||
* 保证已分配≥已打印≥已拣货≥已复核≥已打包的流程约束),
|
||||
* 复核=今日复核时间(recheck_time)双表、出库=今日出库数。
|
||||
*
|
||||
* 今日退回收件数/今日拆包件数:按 wms_return_received / wms_return_unpack
|
||||
* 的 created_at 落在今日(含今天 00:00)且仓库匹配统计,以两项追加在
|
||||
@ -268,21 +268,10 @@ class WarehousePanelService extends Service {
|
||||
|
||||
const totalCountPromise = currentModel.count({ where: pendingBase });
|
||||
const dispatchTodayCountPromise = dispatchModel.count({ where: dispatchTodayBase });
|
||||
// 今日打包任务订单数(pack_mode=2 团购模式按 pack_quantity 求和 + 散单每任务 1 单,与打包两块同口径),
|
||||
// 用于打包环节已*(避免跨天打包出库窗口错位导致已打包与打包两块对不上)
|
||||
const packTaskOrdersTodayPromise = model.query(
|
||||
`SELECT 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`,
|
||||
{ replacements: { warehouseId, start: todayStart, end: tomorrowStart }, type: model.QueryTypes.SELECT }
|
||||
).then(rows => {
|
||||
const first = Array.isArray(rows) && rows.length > 0 ? rows[0] : null;
|
||||
return Number(first && first.cnt || 0);
|
||||
});
|
||||
// 各环节已* 口径:分配/打印/拣货从订单表状态获取(池内 fin + 配送表今日出库 fin),
|
||||
// 保证已分配 ≥ 已打印 ≥ 已拣货 的流程约束;复核=今日复核时间;打包=今日打包任务;出库=今日出库
|
||||
// 各环节已* 口径:分配/打印/拣货/打包均从订单表状态获取(池内 fin + 配送表今日出库 fin),
|
||||
// 保证已分配 ≥ 已打印 ≥ 已拣货 ≥ 已复核 ≥ 已打包 的流程约束;
|
||||
// 注:打包环节此前用「今日打包任务订单数」口径,会大于已复核(打包任务快照含未复核/重复计入),
|
||||
// 已改回订单状态存量口径(pack_status=fin);复核=今日复核时间、出库=今日出库数
|
||||
const todayAllocOrdersPromise = Promise.all([
|
||||
currentModel.count({ where: { ...pendingBase, post_status: 'fin' } }),
|
||||
dispatchModel.count({ where: { ...dispatchTodayBase, post_status: 'fin' } }),
|
||||
@ -303,6 +292,10 @@ class WarehousePanelService extends Service {
|
||||
},
|
||||
}),
|
||||
]).then(([ currentCount, dispatchCount ]) => currentCount + dispatchCount);
|
||||
const todayPackOrdersPromise = Promise.all([
|
||||
currentModel.count({ where: { ...pendingBase, pack_status: 'fin' } }),
|
||||
dispatchModel.count({ where: { ...dispatchTodayBase, pack_status: 'fin' } }),
|
||||
]).then(([ currentCount, dispatchCount ]) => currentCount + dispatchCount);
|
||||
const todayRecheckOrdersPromise = Promise.all([
|
||||
currentModel.count({ where: { status: { [Op.ne]: 'cancel' }, recheck_time: todayRange } }),
|
||||
dispatchModel.count({
|
||||
@ -320,7 +313,7 @@ class WarehousePanelService extends Service {
|
||||
where: { warehouse_id: warehouseId, created_at: todayRange },
|
||||
});
|
||||
const stageCounts = await Promise.all(FULFILLMENT_STAGES.map(async stage => {
|
||||
const [ undoneCurrent, dispatchFin, dispatchTodayOutbound, todayAlloc, todayPrint, todayPick, todayRecheck, packTaskOrdersToday ] = await Promise.all([
|
||||
const [ undoneCurrent, dispatchFin, dispatchTodayOutbound, todayAlloc, todayPrint, todayPick, todayRecheck, todayPack ] = await Promise.all([
|
||||
currentModel.count({
|
||||
where: {
|
||||
...pendingBase,
|
||||
@ -338,7 +331,7 @@ class WarehousePanelService extends Service {
|
||||
todayPrintOrdersPromise,
|
||||
todayPickOrdersPromise,
|
||||
todayRecheckOrdersPromise,
|
||||
packTaskOrdersTodayPromise,
|
||||
todayPackOrdersPromise,
|
||||
]);
|
||||
// 已* 按环节取今日作业口径数据源;出库环节=今日出库数;
|
||||
// 未* = 池内未完成 + 配送表今日出库未完成(真实状态)
|
||||
@ -347,7 +340,7 @@ class WarehousePanelService extends Service {
|
||||
print_status: todayPrint,
|
||||
pick_status: todayPick,
|
||||
recheck_status: todayRecheck,
|
||||
pack_status: packTaskOrdersToday,
|
||||
pack_status: todayPack,
|
||||
outbound_status: dispatchTodayOutbound,
|
||||
};
|
||||
const doneToday = doneTodayMap[stage.field] || 0;
|
||||
|
||||
@ -1,4 +1,18 @@
|
||||
[
|
||||
{
|
||||
"version": "0.3.287",
|
||||
"date": "2026-10-12",
|
||||
"type": "updated",
|
||||
"summary": "index.getWarehousePanelData fulfillment 已打包改订单状态存量口径(pack_status=fin 池内+配送今日出库),修复已打包大于已复核(0.3.286 → 0.3.287)",
|
||||
"methods": [
|
||||
"index.getWarehousePanelData"
|
||||
],
|
||||
"notes": [
|
||||
"变更内容:fulfillment 打包环节已* 由「今日打包任务订单数」(wms_pack_task 窗口内 pack_mode=2 按 pack_quantity 求和 + 散单每任务 1 单)改回订单状态存量口径(池内 pack_status=fin + 配送表今日出库 pack_status=fin),与分配/打印/拣货口径一致;修复打包任务快照含未复核/重复计入导致已打包(16013)大于已复核(15385)的问题,改后已打包=14739 ≤ 已复核。stageOverview 打包卡 today 仍为今日打包任务订单数口径(与打包卡语义一致)。",
|
||||
"代码依据:app/service/systems/warehouse_panel.js#queryFulfillment(新增 todayPackOrdersPromise 池内+配送双表 pack_status=fin,doneTodayMap.pack_status 改取该值,删除 packTaskOrdersToday 查询);ESLint 0 错误;egg 直调验证环节约束通过。",
|
||||
"文档变更范围:methods/system.json 的 module=index 分组仅更新 index.getWarehousePanelData 一条(response.data.description 与 notes 补打包环节已* 口径);根版本 0.3.286 → 0.3.287、updatedAt 保持 2026-10-12;methods/changes/system.json 新增本条(插入数组首位);其余 method 未改动。"
|
||||
]
|
||||
},
|
||||
{
|
||||
"version": "0.3.286",
|
||||
"date": "2026-10-12",
|
||||
|
||||
@ -1,7 +1,7 @@
|
||||
{
|
||||
"module": "system",
|
||||
"description": "系统接口标准入口,method 对应系统内置方法,全部使用 POST 请求,参数统一放在 body 内",
|
||||
"version": "0.3.286",
|
||||
"version": "0.3.287",
|
||||
"updatedAt": "2026-10-12",
|
||||
"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 }——created_count=业务日窗口内下单量(池内待处理 + 配送表今日出库订单按订单创建时间落桶,窗口即业务日 [自然日开始时间, 次日自然日开始时间):未到次日自然日开始时间时=今日自然日开始时间起,凌晨(已过零点)时=昨日自然日开始时间起)并按小时累计(最后一点=业务日内下单总量);total=今日总单量(与 fulfillment.total 同口径:待处理订单池 + 配送表今日出库))、weeklyEfficiency(days 7 天 intercept)"
|
||||
"description": "面板数据对象;is_change=false 时为空对象(节约流量),is_change=true 时输出。已输出字段:title(仓库名)、fulfillment(订单履约链路 6 环节未/已 + total + items 末尾两项今日退件/今日拆包;各环节未/已均含配送表今日出库按环节状态拆分补数,打包环节已* 用订单状态存量口径(池内 pack_status=fin + 配送表今日出库 pack_status=fin,保证已复核≥已打包))、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=业务日窗口内下单量(池内待处理 + 配送表今日出库订单按订单创建时间落桶,窗口即业务日 [自然日开始时间, 次日自然日开始时间):未到次日自然日开始时间时=今日自然日开始时间起,凌晨(已过零点)时=昨日自然日开始时间起)并按小时累计(最后一点=业务日内下单总量);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(业务日窗口内下单量:池内待处理 + 配送表今日出库订单按订单创建时间落桶,窗口即业务日 [自然日开始时间, 次日自然日开始时间),凌晨(已过零点)时为 [昨日自然日开始时间, 今日自然日开始时间))按小时累计(最后一点=业务日内下单总量);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_status=fin + 配送表今日出库 pack_status=fin,保证已复核≥已打包;此前「今日打包任务订单数」口径会大于已复核(打包任务快照含未复核订单),已改回)、出库=今日出库数;出库环节未+已=total,其余环节已* 为状态/今日作业口径、未* 为真实状态口径;面板全部今日统计窗口按仓库配置自然日开始时间 day_start_time(默认 06:00)划分:今日=[当日06:00, 次日06:00),当前时间早于当日 06:00 时窗口为 [昨日06:00, 当日06:00)(昨日 06:00 后的订单视为今日);trend 按业务日窗口双值:横轴 24 点从自然日开始时间起到次日自然日开始时间,created_count(业务日窗口内下单量:池内待处理 + 配送表今日出库订单按订单创建时间落桶,窗口即业务日 [自然日开始时间, 次日自然日开始时间),凌晨(已过零点)时为 [昨日自然日开始时间, 今日自然日开始时间))按小时累计(最后一点=业务日内下单总量);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