fix(stock.check): workData space 视图库位排序对齐拣货模块(pick_priority 降序改升序,0.3.257)

This commit is contained in:
liufumingren 2026-10-09 22:08:56 +08:00
parent 05bef9210a
commit 9d3c6b31fd
3 changed files with 166 additions and 10 deletions

View File

@ -2631,7 +2631,7 @@ class StockCheckService extends Service {
* goods=商品结构,以任务商品范围行(scope_type=goods)为列表,行内挂按库位聚合的作业记录,
* 明盘(mode=open)返回账面快照/已盘合计/差异,盲盘(mode=blind)不返回任何数量字段;
* space=聚合库位列表,以任务商品所在库位为列表(按拣货路径 pick_sequence 升序、
* pick_priority 降序排序),行内挂该库位的任务商品与账面/实盘数量,盲盘不返回数量字段;
* pick_priority 升序排序,与拣货模块 sort_by 规则一致),行内挂该库位的任务商品与账面/实盘数量,盲盘不返回数量字段;
* 若任务无对应范围行(如 location 视图无库位范围行),rows 返回空数组。
* 分页:pagination.{page,pageSize}(与 stock_check.list 口径一致;未传或非法时默认 page=1、
* pageSize=20,上限 200),先构建全量行再按页切片;rows 为当前页行、total 为全部行数,
@ -3303,7 +3303,8 @@ class StockCheckService extends Service {
/**
* 构建 space 视图行:以任务商品(scope_type=goods 的 stock_id 集合)所在的库位为列表。
* 库位集合取 wms_storage(warehouse_id + stock_id 在集合内 + is_enabled=1 且未删除,DISTINCT space_id),
* 库位按拣货路径排序:pick_sequence 升序、pick_priority 降序(同值按库位 id 升序兜底);
* 库位按拣货路径排序:pick_sequence 升序、pick_priority 升序(同值按库位 id 升序兜底),
* 与拣货模块(pick.js sort_by)排序规则一致;
* 行内 goods 为该库位下的任务商品:明盘含 system_quantity(wms_storage space+stock
* SUM(available_quantity+locked_quantity))、locked_quantity(wms_storage space+stock SUM(locked_quantity))
* 与 checked_quantity(该商品在该库位的实盘合计),盲盘不返回任何数量字段;
@ -3417,13 +3418,14 @@ class StockCheckService extends Service {
raw: true,
});
// 库位按拣货路径排序:pick_sequence 升序、pick_priority 降序(同值按库位 id 升序兜底)
// 库位按拣货路径排序:pick_sequence 升序、pick_priority 升序(同值按库位 id 升序兜底),
// 与拣货模块(pick.js sort_by:[ pick_sequence, pick_priority, space_id, item_code ])一致
const sortedLocations = locationRows.sort((left, right) => {
const sequenceDiff = Number(left.pick_sequence || 0) - Number(right.pick_sequence || 0);
if (sequenceDiff !== 0) {
return sequenceDiff;
}
const priorityDiff = Number(right.pick_priority || 0) - Number(left.pick_priority || 0);
const priorityDiff = Number(left.pick_priority || 0) - Number(right.pick_priority || 0);
if (priorityDiff !== 0) {
return priorityDiff;
}

View File

@ -1,4 +1,97 @@
[
{
"version": "0.3.257",
"date": "2026-10-09",
"type": "updated",
"summary": "stock.check.workData / workDataSpaceDetails 空间视图库位排序对齐拣货模块:pick_priority 由降序改为升序(与拣货模块 sort_by [ pick_sequence, pick_priority, space_id, item_code ] 一致)(0.3.256 → 0.3.257)",
"methods": [
"stock.check.workData",
"stock.check.workDataSpaceDetails"
],
"notes": [
"变更内容:space 视图库位排序规则由「pick_sequence 升序、pick_priority 降序、同值按库位 id 升序兜底」改为「pick_sequence 升序、pick_priority 升序、同值按库位 id 升序兜底」,与拣货模块(app/service/systems/pick.js sort_by 声明:[ pick_sequence, pick_priority, space_id, item_code ])排序规则一致,保证盘点作业顺序与拣货路径一致;goods 视图 locations 排序不受影响。",
"代码依据:app/service/systems/stock_check.js#_buildSpaceWorkRows(sortedLocations 比较函数 priorityDiff 改为 left - right 升序;JSDoc 与 workData 方法注释同步);回归测试新增 space 视图排序用例(pick_sequence 升序 + pick_priority 升序两阶段断言,旧降序实现下第二阶段会失败),stock_check 全量 228 用例通过、ESLint 0 错误。",
"文档变更范围:methods/system.json 的 module=stock.check 分组仅更新 stock.check.workData 与 stock.check.workDataSpaceDetails 两条(description/notes 同步排序口径);根版本 0.3.256 → 0.3.257、updatedAt 保持 2026-10-09;methods/changes/system.json 新增本条(插入数组首位);其余 22 条 method 未改动(stock.check 分组仍为 24 条)。"
]
},
{
"version": "0.3.256",
"date": "2026-10-09",
"type": "updated",
"summary": "index.getWarehousePanelData is_change=false 时返回空 data 节约流量(传入时间戳未过期时不查库不输出数据;is_change=true 时仍优先输出缓存数据)(0.3.255 → 0.3.256)",
"methods": [
"index.getWarehousePanelData"
],
"notes": [
"代码依据:app/service/systems/warehouse_panel.js#getPanelData(缓存有最后更新时间时先算 isChange,false 直接返回 { is_change: false, last_change_at, data: {} } 不查库;true 时缓存有 data 直出、无 data 查库补数据保留外部时间戳;无最后更新时间仍查库+设置);app/service/systemMethods/index.js 注释同步;ESLint 0 错误;临时验证脚本 17 用例全 PASS(新增未变化空 data 不查库用例)。",
"文档变更范围:methods/system.json 的 module=index 基础模块分组仅更新 index.getWarehousePanelData 一条(description/response.data/notes 同步空 data 语义);根版本 0.3.255 → 0.3.256、updatedAt 保持 2026-10-09;methods/changes/system.json 新增本条(插入数组首位)。"
]
},
{
"version": "0.3.255",
"date": "2026-10-09",
"type": "updated",
"summary": "index.getWarehousePanelData 拉取逻辑改为外部驱动:缓存有最后更新时间且有数据直接输出;有最后时间无数据(外部只驱动时间戳)查库补数据并保留外部时间戳;无最后时间才查库并设置最后更新时间;缓存 TTL 10 秒 → 300 秒(0.3.254 → 0.3.255)",
"methods": [
"index.getWarehousePanelData"
],
"notes": [
"代码依据:app/service/systems/warehouse_panel.js#getPanelData(三段式拉取逻辑:命中直出 / 有外部时间戳无数据查库补 data 保留外部 ts / 无时间戳查库+设置 nowTs;PANEL_CACHE_TTL_SECONDS=300);app/service/systemMethods/index.js 注释同步(force 仅影响 last_change_at 是否可缺省);ESLint 0 错误;临时验证脚本 16 用例全 PASS(新增外部驱动时间戳查库补数据用例,断言保留外部时间戳 1800000000 且写缓存值一致)。",
"文档变更范围:methods/system.json 的 module=index 基础模块分组仅更新 index.getWarehousePanelData 一条(response.is_change/last_change_at 描述与 notes 缓存语义同步外部驱动);根版本 0.3.254 → 0.3.255、updatedAt 保持 2026-10-09;methods/changes/system.json 新增本条(插入数组首位)。"
]
},
{
"version": "0.3.254",
"date": "2026-10-09",
"type": "updated",
"summary": "index.getWarehousePanelData data 填充有数据源的字段(title/fulfillment/stageOverview/b2b/groupPicking/scatterPicking/packingRank.personal/trend/weeklyEfficiency.intercept),无数据源的字段暂不输出;缓存值升级为 { last_change_at, data }(TTL 10 秒,过期重算)(0.3.253 → 0.3.254)",
"methods": [
"index.getWarehousePanelData"
],
"notes": [
"代码依据:新增 app/service/systems/warehouse_panel.js(WarehousePanelService:getPanelData 增量判定与缓存、buildPanelData 8 个数据块并行聚合且单块容错、queryFulfillment/queryStageOverview/queryB2b/queryPickingBlock/queryPickingGoodsSku/queryPackingPersonal/queryTrend/queryWeeklyIntercept);app/service/systemMethods/index.js#getWarehousePanelData 改为参数校验后调用 systems 层(原 getWarehousePanelLastChangeCacheKey 移入 systems 层);ESLint 0 错误;临时逻辑脚本 15 用例全 PASS;真实库(127.0.0.1:3307)只读 SQL 验证仓库 100000/1000028 共 90 条查询全部可执行。",
"文档变更范围:methods/system.json 的 module=index 基础模块分组仅更新 index.getWarehousePanelData 一条(response.data 描述补充已输出字段、notes 补充缓存语义/口径/未输出字段清单);根版本 0.3.253 → 0.3.254、updatedAt 保持 2026-10-09;methods/changes/system.json 新增本条(插入数组首位)。"
]
},
{
"version": "0.3.253",
"date": "2026-10-09",
"type": "updated",
"summary": "index.getWarehousePanelData 响应新增 last_change_at(服务端最后更改时间戳,缓存未命中时为 0),供前端保存并作为下次轮询入参回传(0.3.252 → 0.3.253)",
"methods": [
"index.getWarehousePanelData"
],
"notes": [
"代码依据:app/service/systemMethods/index.js#getWarehousePanelData(读取缓存后 cachedAt 有效时返回其值,否则返回 0;is_change 判定逻辑不变);ESLint 0 错误,临时验证脚本 13 用例全 PASS(新增 last_change_at 断言:命中缓存返回缓存值、未命中返回 0)。",
"文档变更范围:methods/system.json 的 module=index 基础模块分组仅更新 index.getWarehousePanelData 一条(response 新增 last_change_at;description/notes 同步);根版本 0.3.252 → 0.3.253、updatedAt 保持 2026-10-09;methods/changes/system.json 新增本条(插入数组首位)。"
]
},
{
"version": "0.3.252",
"date": "2026-10-09",
"type": "updated",
"summary": "index.getWarehousePanelData 新增 force 入参(可选):首次拉取传 true 时 is_change 强制为 true 且 last_change_at 可缺省(0.3.251 → 0.3.252)",
"methods": [
"index.getWarehousePanelData"
],
"notes": [
"代码依据:app/service/systemMethods/index.js#getWarehousePanelData(force 解析兼容 true/'true'/1;force=true 时 last_change_at 缺省视为 0,传了仍做格式校验;is_change = force || (传入时间戳 < 缓存最后更改时间戳));ESLint 0 错误,临时验证脚本 13 用例全 PASS(含 force=true 缺省时间戳、force=1、force='true'、force=false 缺省时间戳仍报参数错误)。",
"文档变更范围:methods/system.json 的 module=index 基础模块分组仅更新 index.getWarehousePanelData 一条(params 新增 force、last_change_at 的 required 由 true 改为 false 并同步说明;description/response/notes 同步);根版本 0.3.251 → 0.3.252、updatedAt 保持 2026-10-09;methods/changes/system.json 新增本条(插入数组首位)。"
]
},
{
"version": "0.3.251",
"date": "2026-10-09",
"type": "added",
"summary": "基础模块新增 index.getWarehousePanelData 仓库面板数据接口:按仓库增量变更检测,入参 last_change_at 小于缓存最后更改时间戳时返回 is_change=true,data 暂为空(0.3.250 → 0.3.251)",
"methods": [
"index.getWarehousePanelData"
],
"notes": [
"代码依据:app/service/systemMethods/index.js#getWarehousePanelData + #getWarehousePanelLastChangeCacheKey;缓存键 index:warehousePanel:lastChangeAt:{warehouseId}(按仓库存储,通过 getCacheAsync 读取);需要登录(isNeedLogin=true),免权限/免鉴权/免系统日志,ESLint 0 错误。",
"文档变更范围:methods/system.json 的 module=index 基础模块分组新增 1 条 method(插在 index.loadWarehouses 之后);根版本 0.3.250 → 0.3.251、updatedAt 2026-10-06 → 2026-10-09;methods/changes/system.json 新增本条(插入数组首位)。"
]
},
{
"version": "0.3.250",
"date": "2026-10-06",

File diff suppressed because one or more lines are too long