diff --git a/app/service/systems/stock_check.js b/app/service/systems/stock_check.js index ccaa2f6..5155556 100644 --- a/app/service/systems/stock_check.js +++ b/app/service/systems/stock_check.js @@ -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; } diff --git a/methods/changes/system.json b/methods/changes/system.json index 840100f..20e6f1b 100644 --- a/methods/changes/system.json +++ b/methods/changes/system.json @@ -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", diff --git a/methods/system.json b/methods/system.json index 364dec5..4da3aba 100644 --- a/methods/system.json +++ b/methods/system.json @@ -1,14 +1,14 @@ { "module": "system", "description": "系统接口标准入口,method 对应系统内置方法,全部使用 POST 请求,参数统一放在 body 内", - "version": "0.3.250", - "updatedAt": "2026-10-06", + "version": "0.3.257", + "updatedAt": "2026-10-09", "headers": [ { "name": "platform", "type": "string", "required": true, - "description": "客户端平台标识,如 web/pda/app/miniprogram", + "description": "客户端平台标识,如 web/pda/app/miniprogram/tv", "list": [ { "value": "web", @@ -26,6 +26,10 @@ "value": "miniprogram", "name": "微信端" }, + { + "value": "tv", + "name": "TV端" + }, { "value": "other", "name": "其他" @@ -2570,6 +2574,63 @@ "message": "查询已有 report_uuid 失败或批量写入失败(HTTP 200 + flag=failure,body 仅含 flag/code/message/timestamp)" } ] + }, + { + "method": "index.getWarehousePanelData", + "description": "仓库面板数据接口:按仓库做增量变更检测,is_change=false 时返回空 data(节约流量),data 已填充有数据源的字段(无数据源的字段暂不输出)", + "isNeedAuth": false, + "isNeedLogin": true, + "headers": [ + { + "name": "Authorization", + "type": "string", + "required": true, + "description": "Bearer token" + } + ], + "params": [ + { + "name": "last_change_at", + "type": "number", + "required": false, + "source": "body", + "description": "最后一次更改的时间戳(Unix 秒);常规调用(force=false)必填,小于缓存最后更改时间戳时返回 is_change=true;force=true 时可选,缺省视为 0" + }, + { + "name": "force", + "type": "boolean", + "required": false, + "source": "body", + "description": "首次拉取兼容入参(true/1/'true'),当前仅影响 last_change_at 是否可缺省" + } + ], + "response": [ + { + "name": "is_change", + "type": "boolean", + "required": true, + "description": "是否已改变:传入时间戳小于缓存最后更改时间戳时为 true,否则为 false(缓存无最后时间时恒为 true)" + }, + { + "name": "last_change_at", + "type": "number", + "required": true, + "description": "缓存最后更改时间戳(Unix 秒,一般由外部业务驱动;缓存无最后时间时为本接口拉取数据时刻);前端保存后作为下次轮询的 last_change_at 入参回传" + }, + { + "name": "data", + "type": "object", + "required": true, + "description": "面板数据对象;is_change=false 时为空对象(节约流量),is_change=true 时输出。已输出字段:title(仓库名)、fulfillment(订单履约链路 6 环节未/已 + total)、stageOverview(totalOrders/interceptOrders/stages 5 卡:receiving/shelf/pick/recheck/pack)、b2b(orders/goods/sku)、groupPicking、scatterPicking(orders/goods/sku/wave/top5)、packingRank(personal:orders/goods/sku/wave/top5)、trend(max/points 08:00-18:00 共 11 点)、weeklyEfficiency(days 7 天 intercept)" + } + ], + "errors": [], + "notes": [ + "缓存键 index:warehousePanel:lastChangeAt:{warehouseId},值为 { last_change_at, data },TTL 300 秒。拉取逻辑:缓存有最后更新时间且传入时间戳未过期 → is_change=false + 空 data 不查库;时间戳过期且缓存有数据 → 直接输出缓存数据;时间戳过期但缓存无数据(外部只驱动了时间戳)→ 查库拉数据补入缓存并保留外部时间戳;缓存无最后更新时间(未命中/过期)→ 查库拉数据并设置最后更新时间", + "最后更新时间一般由外部驱动:业务数据变化时由外部写入缓存键的 last_change_at(只写时间戳即可,数据由本接口下次拉取时补入)", + "未输出字段(数据源或口径未定):履约链路第 7 环节退件签收、stageOverview 质检卡、收货/上架卡的 today/abnormal、weeklyEfficiency 的 throughput/max、packingRank 的 group(组别口径未定)", + "口径:fulfillment 各环节按订单分表状态字段(post_status/print_status/pick_status/recheck_status/pack_status/outbound_status)未/已;groupPicking=wave_pick_task pick_mode 1,5,scatterPicking=2,3,4(今日创建任务,orders/wave 取任务快照,goods/sku 经任务订单关联表 join 订单分表 items_total/items_count);packingRank.personal 按 pack_task_packer.account_name 聚合(今日创建且非异常任务);trend 固定 08:00-18:00 按小时补零;weeklyEfficiency.days 时间锚点=COALESCE(intercept_time, create_at)" + ] } ] }, @@ -38591,7 +38652,7 @@ }, { "method": "stock.check.workData", - "description": "拉取盘点作业数据(视图由任务范围与 is_goods 入参驱动,view 入参已废弃忽略):入参 id(盘点任务ID)+ is_goods(可选,商品任务是否按商品视图返回——true=goods 视图;缺省 false=聚合库位 space 视图;兼容 isGoods 驼峰写法;库位任务无视该参数)+ keyword(可选,关键字:仅库位任务 location 视图生效——按行 location_code/location_name 模糊匹配(不区分大小写)过滤任务明细后再分页;非库位任务忽略;空/纯空白视为未传)+ only_abnormal(可选,只看未盘和差异:过滤在 keyword 之后、分页切片之前完成,三视图均生效——location 视图仅保留 status=unchecked 或含未知商品记录(has_unknown=true)的行;goods 视图仅保留未盘行(locations 均无 record_ids)或明盘差异行(is_diff=1,盲盘无数量字段仅按未盘过滤);space 视图按行内 goods 子项过滤(status=unchecked 或明盘 checked_quantity≠system_quantity),过滤后 goods 为空的行整体移除;兼容 onlyAbnormal 驼峰写法);返回 { view, rows, total, page, pageSize }(view=服务端实际解析出的视图类型 location/goods/space,供调用方判断 rows 行结构;不返回任务主表信息 check——任务信息请调用 stock.check.detail),rows 结构随解析视图不同(先构建全量行——location 视图且 keyword 非空时先按 location_code/location_name 过滤,only_abnormal=true 时再按未盘/差异过滤,最后按页切片,rows 为当前页行)、total=全部行数(未分页口径;keyword/only_abnormal 过滤后 total 为过滤后行数)、page=当前页码(默认 1)、pageSize=每页数量(默认 20,上限 200),任务无对应范围行时 rows 返回空数组。分页:入参 data.pagination({ page, pageSize }),未传或非法时默认 page=1、pageSize=20(上限 200),分页口径与 stock.check.list 一致。视图解析:任务范围为库位(type=location/all)一律按 location 视图;任务范围为商品(type=goods/store)默认 space 视图、仅 is_goods=true 时 goods 视图。location(库位结构):以任务库位范围行(scope_type=location)为列表(按明细 id 升序),行内挂该库位的盘点作业记录 goods 子列表(已知商品与未知商品记录均入内,未知商品 stock_id=null、item_code 用条码兜底;每项含 record_id 作业记录 ID(单条记录直接定位,可调 recordDelete/recheckClearLocation 移除)与 images 作业记录照片——FileReference business_type=stock_check_record 经 _attachRecordImages 挂载,与 result/recordList 口径一致,无照片为空数组)+ has_unknown 标记(该库位是否含未知商品记录)+ is_empty 标记(该库位是否存在空库位标记记录:空标记记录不计入 goods 子列表,存在空标记后该行 status=checked 视为已盘点);goods(商品结构):以任务商品范围行(scope_type=goods)为列表(按明细 id 升序),行内 locations 为商品所在全部库位列表(商品库存库位取自 wms_storage——启用未删除存储 DISTINCT space_id 按拣货路径排序,无库存但已有作业记录的库位追加在末尾;每项含 record_ids 该库位该商品全部作业记录 ID(按记录 id 升序)与 images 该库位该商品全部作业照片(扁平去重),供前端编辑/移除记录;未盘库位 checked_at=null、record_ids/images 为空数组),明盘(mode=open)返回账面快照/已盘合计/差异,每库位含 system_quantity(该库位账面数量=可用+锁定,wms_storage SUM(available_quantity+locked_quantity),无库存记录库位为 0)、locked_quantity(该库位锁定数量,wms_storage SUM(locked_quantity))与 quantity(该库位盘点数量,未盘库位为 0),盲盘(mode=blind)不返回任何数量字段(行级 images 仍为商品主图);space(聚合库位列表):库位集合=当前库存库位 ∪ 作业记录库位(当前库存库位:wms_storage 中任务 stock_id 集合的启用未删除存储 DISTINCT space_id;作业记录库位:wms_stock_check_record 的 location_id 已回填直接用、未回填的按 location_code 匹配 wms_location_space.space_code 补查,与库存库位去重后取并集),按拣货路径排序(pick_sequence 升序、pick_priority 降序、库位 id 升序兜底),行内 goods 为该库位下的任务商品(每项含 record_ids 该商品在该库位全部作业记录 ID(按记录 id 升序)与 images 该商品在该库位的作业照片聚合(扁平去重,不再输出商品主图),供前端编辑/移除记录),明盘含库位账面(可用+锁定)/锁定数量/已盘数量、盲盘不含数量;盘点前库存已出空但已有盘点作业记录的库位也能展示(该库位商品行账面 system_quantity 按 0、locked_quantity 按 0、checked_quantity 按该库位实盘合计)。状态限制:仅任务状态为 approved(审核完成)或 checking(盘点作业中)时可拉取盘点作业数据,其他状态(created 已创建/submitted 待审核/rejected 已驳回/completed 已完成/cancelled 已取消)返回 400「当前状态(xx)不允许拉取盘点作业数据,仅审核完成(approved)或盘点作业中(checking)的任务可拉取」。", + "description": "拉取盘点作业数据(视图由任务范围与 is_goods 入参驱动,view 入参已废弃忽略):入参 id(盘点任务ID)+ is_goods(可选,商品任务是否按商品视图返回——true=goods 视图;缺省 false=聚合库位 space 视图;兼容 isGoods 驼峰写法;库位任务无视该参数)+ keyword(可选,关键字:仅库位任务 location 视图生效——按行 location_code/location_name 模糊匹配(不区分大小写)过滤任务明细后再分页;非库位任务忽略;空/纯空白视为未传)+ only_abnormal(可选,只看未盘和差异:过滤在 keyword 之后、分页切片之前完成,三视图均生效——location 视图仅保留 status=unchecked 或含未知商品记录(has_unknown=true)的行;goods 视图仅保留未盘行(locations 均无 record_ids)或明盘差异行(is_diff=1,盲盘无数量字段仅按未盘过滤);space 视图按行内 goods 子项过滤(status=unchecked 或明盘 checked_quantity≠system_quantity),过滤后 goods 为空的行整体移除;兼容 onlyAbnormal 驼峰写法);返回 { view, rows, total, page, pageSize }(view=服务端实际解析出的视图类型 location/goods/space,供调用方判断 rows 行结构;不返回任务主表信息 check——任务信息请调用 stock.check.detail),rows 结构随解析视图不同(先构建全量行——location 视图且 keyword 非空时先按 location_code/location_name 过滤,only_abnormal=true 时再按未盘/差异过滤,最后按页切片,rows 为当前页行)、total=全部行数(未分页口径;keyword/only_abnormal 过滤后 total 为过滤后行数)、page=当前页码(默认 1)、pageSize=每页数量(默认 20,上限 200),任务无对应范围行时 rows 返回空数组。分页:入参 data.pagination({ page, pageSize }),未传或非法时默认 page=1、pageSize=20(上限 200),分页口径与 stock.check.list 一致。视图解析:任务范围为库位(type=location/all)一律按 location 视图;任务范围为商品(type=goods/store)默认 space 视图、仅 is_goods=true 时 goods 视图。location(库位结构):以任务库位范围行(scope_type=location)为列表(按明细 id 升序),行内挂该库位的盘点作业记录 goods 子列表(已知商品与未知商品记录均入内,未知商品 stock_id=null、item_code 用条码兜底;每项含 record_id 作业记录 ID(单条记录直接定位,可调 recordDelete/recheckClearLocation 移除)与 images 作业记录照片——FileReference business_type=stock_check_record 经 _attachRecordImages 挂载,与 result/recordList 口径一致,无照片为空数组)+ has_unknown 标记(该库位是否含未知商品记录)+ is_empty 标记(该库位是否存在空库位标记记录:空标记记录不计入 goods 子列表,存在空标记后该行 status=checked 视为已盘点);goods(商品结构):以任务商品范围行(scope_type=goods)为列表(按明细 id 升序),行内 locations 为商品所在全部库位列表(商品库存库位取自 wms_storage——启用未删除存储 DISTINCT space_id 按拣货路径排序,无库存但已有作业记录的库位追加在末尾;每项含 record_ids 该库位该商品全部作业记录 ID(按记录 id 升序)与 images 该库位该商品全部作业照片(扁平去重),供前端编辑/移除记录;未盘库位 checked_at=null、record_ids/images 为空数组),明盘(mode=open)返回账面快照/已盘合计/差异,每库位含 system_quantity(该库位账面数量=可用+锁定,wms_storage SUM(available_quantity+locked_quantity),无库存记录库位为 0)、locked_quantity(该库位锁定数量,wms_storage SUM(locked_quantity))与 quantity(该库位盘点数量,未盘库位为 0),盲盘(mode=blind)不返回任何数量字段(行级 images 仍为商品主图);space(聚合库位列表):库位集合=当前库存库位 ∪ 作业记录库位(当前库存库位:wms_storage 中任务 stock_id 集合的启用未删除存储 DISTINCT space_id;作业记录库位:wms_stock_check_record 的 location_id 已回填直接用、未回填的按 location_code 匹配 wms_location_space.space_code 补查,与库存库位去重后取并集),按拣货路径排序(pick_sequence 升序、pick_priority 升序、库位 id 升序兜底,与拣货模块 sort_by 规则一致),行内 goods 为该库位下的任务商品(每项含 record_ids 该商品在该库位全部作业记录 ID(按记录 id 升序)与 images 该商品在该库位的作业照片聚合(扁平去重,不再输出商品主图),供前端编辑/移除记录),明盘含库位账面(可用+锁定)/锁定数量/已盘数量、盲盘不含数量;盘点前库存已出空但已有盘点作业记录的库位也能展示(该库位商品行账面 system_quantity 按 0、locked_quantity 按 0、checked_quantity 按该库位实盘合计)。状态限制:仅任务状态为 approved(审核完成)或 checking(盘点作业中)时可拉取盘点作业数据,其他状态(created 已创建/submitted 待审核/rejected 已驳回/completed 已完成/cancelled 已取消)返回 400「当前状态(xx)不允许拉取盘点作业数据,仅审核完成(approved)或盘点作业中(checking)的任务可拉取」。", "isNeedAuth": false, "isNeedLogin": true, "headers": [ @@ -38725,7 +38786,7 @@ "代码依据:app/service/systemMethods/stock/check.js#workData(warehouse_id 由服务端从 ctx.user.store_id 自动注入,前端无需传递;const { id, is_goods: isGoodsSnake, isGoods: isGoodsCamel, pagination } = data || {},isGoods=is_goods 未定义时回退 isGoods(兼容 isGoods 驼峰写法);不再读取、不再校验 view,透传 { warehouseId, id, isGoods, pagination })+ app/service/systems/stock_check.js#workData(id 非正整数抛 400『盘点任务ID不能为空』;任务不存在(按 id+warehouse_id 查 wms_stock_check)抛 400『盘点任务不存在』;状态守卫:任务状态非 REPORT_ALLOWED_STATUSES(approved/checking)时抛 400『当前状态(xx)不允许拉取盘点作业数据,仅审核完成(approved)或盘点作业中(checking)的任务可拉取』;视图解析:normalizedType=String(check.type||'').trim(),type=location/all 一律 location 视图(无视 view/is_goods),否则 goodsViewRequested=isGoods===true||'true'||1 时 goods 视图、其余默认 space 视图;按解析视图分派 _buildLocationWorkRows/_buildGoodsWorkRows/_buildSpaceWorkRows,统一返回 { check: _formatCheckRow 口径, rows, total: rows.length, page, pageSize })。本次代码已改(view 入参废弃、is_goods 驱动视图)并测试通过 197/197、ESLint 0 错误。", "三视图口径(由任务范围 + is_goods 解析后分派):location=库位结构(库位范围任务一律该视图),以任务库位范围行(scope_type=location)为列表(按明细 id 升序),行内挂该库位盘点作业记录 goods 子列表(已知商品与未知商品记录均入内:已知商品 stock_id 有值,商品信息批量取自 stockWarehouse.getStockDetails 带缓存、货主名 _resolveStoreNameMap 解析;未知商品 stock_id=null,item_code 用条码兜底、item_name 用名称快照兜底条码、store_id/store_name 为 null;已知/未知商品的 images 均为作业记录照片(经 _attachRecordImages 挂载 FileReference business_type=stock_check_record,已知商品不再输出商品主图 image_url)),has_unknown 标记该库位是否含未知商品记录;goods=商品结构(商品范围任务且 is_goods=true 时该视图),以任务商品范围行(scope_type=goods)为列表(按明细 id 升序),行内 locations 为商品所在全部库位列表(商品库存库位取自 wms_storage 启用未删除存储 DISTINCT space_id 按拣货路径排序,无库存但已有作业记录的库位按首条记录 id 升序追加在末尾,空库位归 location_code=null 组排在最后;明盘每库位含 system_quantity 该库位账面数量与 quantity 该库位盘点数量(未盘库位 0),盲盘仅 location_code/checked_at/checker_name/record_ids/images);space=聚合库位列表(商品范围任务默认该视图),库位集合=当前库存库位 ∪ 作业记录库位——当前库存库位:wms_storage(warehouse_id + stock_id 在集合 + is_enabled=1 未删除)DISTINCT space_id;作业记录库位:wms_stock_check_record 的 location_id 已回填直接用、未回填的按 location_code 匹配 wms_location_space.space_code 补查,与库存库位去重后并集;行内 goods 为该库位下的任务商品;盘点前库存已出空但已有盘点作业记录的库位也能展示(该库位商品行账面 system_quantity 按 0、checked_quantity 按该库位实盘合计)。", "明盘/盲盘数量控制:明盘(mode=open)goods 视图行返回 system_quantity(明细账面快照)/checked_quantity(已盘合计=locations.quantity 合计)/diff_quantity(已盘-账面,仅存在作业记录的行计算)/is_diff(差异非 0 为 1),locations 各项含 system_quantity(该库位账面数量=可用+锁定,wms_storage 该库位 SUM(available_quantity+locked_quantity),无库存记录库位为 0)、locked_quantity(该库位锁定数量,wms_storage 该库位 SUM(locked_quantity))与 quantity(该库位盘点数量=实盘合计,未盘库位为 0);space 视图 goods 各项含 system_quantity(wms_storage space+stock SUM(available_quantity+locked_quantity) 账面,该库位无库存记录时按 0)/locked_quantity(wms_storage space+stock SUM(locked_quantity))/checked_quantity(该商品在该库位的实盘合计);盲盘(mode=blind)不返回任何数量字段(goods 视图 locations 仅 location_code/checked_at/checker_name/record_ids/images,space 视图 goods 仅商品信息+images/record_ids/status);goods 视图 locations 为商品所在全部库位列表(含未盘库位,无作业记录时各项为空信息),无作业记录的行明盘已盘合计恒 0、差异/is_diff 恒 0(避免未盘行误显盘亏差异)。", - "排序口径:space 视图库位按拣货路径排序——pick_sequence 升序、pick_priority 降序、同值按库位 id 升序兜底;space 行内 goods 按 stock_id 升序;location/goods 视图行按明细 id 升序;goods 视图 locations 按首条记录 id 升序。", + "排序口径:space 视图库位按拣货路径排序——pick_sequence 升序、pick_priority 升序、同值按库位 id 升序兜底(与拣货模块 sort_by 规则一致);space 行内 goods 按 stock_id 升序;location/goods 视图行按明细 id 升序;goods 视图 locations 按首条记录 id 升序。", "权限口径:随 ALL_METHOD_NAMES(22 个:create/list/addDetail/addLocationDetail/detailDelete/detail/result/workData/report/markEmpty/recordList/recordDelete/recheckClearLocation/finish/submit/cancel/audit/batchDelete/export/exportTaskProgress/patternList/patternCreate)免 API 权限(isNeedAuth=false)、免仓库有效期鉴权(_noNeedAuth)、必须登录(isNeedLogin=true,免登录清单为空);为查询类方法,加入免日志清单 _noNeedLog(list/detail/result/workData/recordList/export/exportTaskProgress/patternList),不记录操作日志。", "文档变更范围:methods/system.json 的 module=stock.check 分组新增 stock.check.workData 一条(位于 stock.check.result 之后);根版本 0.3.224 → 0.3.225、updatedAt 2026-10-01 → 2026-10-02;methods/changes/system.json 新增本条(插入数组首位);其余 19 条 method 未改动(stock.check 分组由 19 条增至 20 条)。", "状态限制口径:仅任务状态为 approved(审核完成)或 checking(盘点作业中)可拉取盘点作业数据;其他状态(created 已创建/submitted 待审核/rejected 已驳回/completed 已完成/cancelled 已取消)返回 400,message 为『当前状态({状态中文标签,无标签时回退状态值})不允许拉取盘点作业数据,仅审核完成(approved)或盘点作业中(checking)的任务可拉取』,状态标签取 STOCK_CHECK_STATUS_LABELS。状态守卫复用 REPORT_ALLOWED_STATUSES 常量,与 report(盘点作业上报)及 finish(完成盘点)一致。", @@ -38777,7 +38838,7 @@ }, { "method": "stock.check.workDataSpaceDetails", - "description": "拉取盘点作业数据(space 视图分页版):入参 id(盘点任务ID)+ location_id(库位ID,可选,兼容 locationId 驼峰写法)+ pagination({page,pageSize},缺省 page=1/pageSize=20,上限 200);warehouse_id 由服务端从当前上下文自动注入,前端无需传递。行结构与 workData space 视图行一致:id=库位ID(wms_location_space.id)/ space_code 库位编码 / custom_barcode 自定义条码 / custom_name 库位名称 / goods 该库位下的任务商品子列表(detail_id 明细ID / stock_id 商品库存ID / item_code 商品编码 / item_name 商品名称 / spec 规格 / store_id 货主ID / store_name 货主名 / barcode 条码 / images 作业照片 / record_ids 作业记录ID列表;明盘 mode=open 另含 system_quantity 账面数量(wms_storage 该库位该商品 SUM(available_quantity+locked_quantity))、locked_quantity 锁定数量(wms_storage 该库位该商品 SUM(locked_quantity))与 checked_quantity 已盘合计;盲盘 mode=blind 不返回任何数量字段;status=checked 该 (detail_id, location_code) 存在作业记录 / unchecked 未盘)。库位按拣货路径排序(pick_sequence 升序、pick_priority 降序,同值按库位 id 升序兜底);传入 location_id 时只返回该库位行(total=1),不传时按分页返回全部库位行;返回 { view:'space', rows, total, page, pageSize }(不返回任务主表信息,任务信息请调用 stock.check.detail)。仅任务状态 approved(审核完成)或 checking(盘点作业中)可拉取(与 workData 同口径)。权限口径:免 API 权限校验,仅需登录(与 stock.check 分组其他方法一致)。", + "description": "拉取盘点作业数据(space 视图分页版):入参 id(盘点任务ID)+ location_id(库位ID,可选,兼容 locationId 驼峰写法)+ pagination({page,pageSize},缺省 page=1/pageSize=20,上限 200);warehouse_id 由服务端从当前上下文自动注入,前端无需传递。行结构与 workData space 视图行一致:id=库位ID(wms_location_space.id)/ space_code 库位编码 / custom_barcode 自定义条码 / custom_name 库位名称 / goods 该库位下的任务商品子列表(detail_id 明细ID / stock_id 商品库存ID / item_code 商品编码 / item_name 商品名称 / spec 规格 / store_id 货主ID / store_name 货主名 / barcode 条码 / images 作业照片 / record_ids 作业记录ID列表;明盘 mode=open 另含 system_quantity 账面数量(wms_storage 该库位该商品 SUM(available_quantity+locked_quantity))、locked_quantity 锁定数量(wms_storage 该库位该商品 SUM(locked_quantity))与 checked_quantity 已盘合计;盲盘 mode=blind 不返回任何数量字段;status=checked 该 (detail_id, location_code) 存在作业记录 / unchecked 未盘)。库位按拣货路径排序(pick_sequence 升序、pick_priority 升序,同值按库位 id 升序兜底,与拣货模块 sort_by 规则一致);传入 location_id 时只返回该库位行(total=1),不传时按分页返回全部库位行;返回 { view:'space', rows, total, page, pageSize }(不返回任务主表信息,任务信息请调用 stock.check.detail)。仅任务状态 approved(审核完成)或 checking(盘点作业中)可拉取(与 workData 同口径)。权限口径:免 API 权限校验,仅需登录(与 stock.check 分组其他方法一致)。", "isNeedAuth": false, "isNeedLogin": true, "headers": [