diff --git a/app/service/systems/warehouse_panel.js b/app/service/systems/warehouse_panel.js index 25194e3..877e17d 100644 --- a/app/service/systems/warehouse_panel.js +++ b/app/service/systems/warehouse_panel.js @@ -195,6 +195,12 @@ class WarehousePanelService extends Service { const [ fulfillment, stageOverview, b2b, groupPicking, scatterPicking, groupPacking, scatterPacking, trend, weeklyEfficiency ] = blocks; + // 趋势补充总单量字段(与 fulfillment.total 同口径:待处理订单池 + 配送表今日出库; + // fulfillment 块失败时兜底 0) + if (trend) { + trend.total = fulfillment ? (fulfillment.total || 0) : 0; + } + const data = { title: ctx.user?.store_name || '', fulfillment, diff --git a/methods/changes/system.json b/methods/changes/system.json index 79091f7..1d707bb 100644 --- a/methods/changes/system.json +++ b/methods/changes/system.json @@ -1,4 +1,18 @@ [ + { + "version": "0.3.284", + "date": "2026-10-11", + "type": "updated", + "summary": "index.getWarehousePanelData trend 补充 total 总单量字段(与 fulfillment.total 同口径)(0.3.283 → 0.3.284)", + "methods": [ + "index.getWarehousePanelData" + ], + "notes": [ + "变更内容:trend 响应由 { max, points } 补充为 { max, total, points },total=今日总单量(与 fulfillment.total 同口径:待处理订单池 + 配送表今日出库;fulfillment 块失败时兜底 0)。", + "代码依据:app/service/systems/warehouse_panel.js#buildPanelData(组装数据时把 fulfillment.total 挂到 trend.total);ESLint 0 错误。", + "文档变更范围:methods/system.json 的 module=index 分组仅更新 index.getWarehousePanelData 一条(response.data.description 与 notes 补 total 字段);根版本 0.3.283 → 0.3.284、updatedAt 保持 2026-10-11;methods/changes/system.json 新增本条(插入数组首位);其余 method 未改动。" + ] + }, { "version": "0.3.283", "date": "2026-10-11", @@ -12144,4 +12158,4 @@ ], "module": "order" } -] \ No newline at end of file +] diff --git a/methods/system.json b/methods/system.json index 3a5bdbc..955b049 100644 --- a/methods/system.json +++ b/methods/system.json @@ -1,7 +1,7 @@ { "module": "system", "description": "系统接口标准入口,method 对应系统内置方法,全部使用 POST 请求,参数统一放在 body 内", - "version": "0.3.283", + "version": "0.3.284", "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/points 业务日 24 点:label 从仓库自然日开始时间(day_start_time)起到次日自然日开始时间,每点 { label, created_count, pack_count }——created_count=订单创建时间落桶(自然日零点起统计、全部订单仅排除已取消,早于自然日开始时间的并入第一点)、pack_count=打包订单数按打包任务创建时间落桶(pack_mode=2 按 pack_quantity 求和 + 散单每任务 1 单,非异常未删除,与打包卡 today 同口径);双值均按小时累计(截至该小时结束的总数,最后一点=全天总数))、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, pack_count }——created_count=订单创建时间落桶(自然日零点起统计、全部订单仅排除已取消,早于自然日开始时间的并入第一点)、pack_count=打包订单数按打包任务创建时间落桶(pack_mode=2 按 pack_quantity 求和 + 散单每任务 1 单,非异常未删除,与打包卡 today 同口径);双值均按小时累计(截至该小时结束的总数,最后一点=全天总数);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 同口径)双值输出,双值均按小时累计(截至该小时结束的总数,最后一点=全天总数);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(订单创建,自然日零点起统计、早于自然日开始时间的并入第一点)与 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) 计数;", "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 为任务数(打包中/异常任务);" ]