liufumingren
562f63f18e
feat(stock.check): 商品视图按商品汇总、账面按静态标记取值、静态盘点锁定缓存与库存操作拦截
盘点作业数据(workData / workDataDetail)
- workData goods 视图按 stock_id 汇总为一行(同商品多库位明细合并):行级账面=各库位之和,
作业记录跨明细按库位合并,locations 每项补 detail_id/snapshot_quantity,行级不再返回 detail_id。
- workDataDetail 商品分支改为 id + stock_id 钻取,返回 summary(汇总)+ rows(按库位分行:
明细ID/库位ID/账面快照/当前账面/实盘/差异);兼容传商品范围 detail_id。
- 账面取值按任务 is_static 区分:静态盘点取明细快照(冻结基准),普通盘点取当前 wms_storage;
新增 storage_quantity / is_static / book_source 字段,差异统一为「实盘 - system_quantity」。
- report 的 detail_id 改为可选:商品行可只传 id + stock_id + space_id,服务端按库位明细反查。
静态盘点(is_static)
- wms_stock_check 新增 is_static(TINYINT(1) DEFAULT 0,迁移 20261028010000);create 支持 is_static
(仅商品盘点有效,库位盘点恒 0);静态定式 pattern=static 创建的任务自动置 1。
- 新增公共查询 stock.check.staticLockList:返回 is_static=1 且 approved/checking 任务的商品集合,
按仓库缓存(TTL 300s、状态流转先递增代次再重建、回源前后代次校验防脏读、空集合也缓存、
进程内 singleflight 防击穿),并提供 isStockStaticLocked / getStaticLockConflict 供内部判断。
- 审核通过时刷新商品明细账面快照(快照基准=开始盘点时点),finish 立即释放锁定并返回 released_stock_ids。
- 库存操作拦截:分配储位命中锁定商品时按「库存不足」同流程将该订单标记失败(storage_status=error +
order_flag),同批次其它订单继续;移库(transferLocation / transferByProduct)命中锁定直接 400。
其他
- 新增开发环境实测脚本 script/stock-check-goods-summary-verify.cjs。
- 测试:stock_check.test.js 覆盖汇总/钻取/静态标记/锁定缓存/账面口径;新增 static_lock_guard.test.js
覆盖分配与移库拦截;methods/system.json 与 changes 更新至 0.3.318。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-28 07:22:44 +08:00
..
2026-09-13 02:24:18 +08:00
2026-04-17 19:21:57 +08:00
2026-09-03 17:00:37 +08:00
2026-10-28 07:22:44 +08:00
2026-08-27 23:41:47 +08:00
2026-09-05 22:43:38 +08:00
2026-10-08 19:33:21 +08:00
2026-09-30 03:08:42 +08:00