WMS_MAIN/database/migrations/20261028010000-add-is-static-to-stock-check.js
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

26 lines
918 B
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

'use strict';
/**
* 库存盘点主表新增「是否静态盘点」标记:
*
* wms_stock_check 新增 is_static(TINYINT(1) NOT NULL DEFAULT 0):
* - 1 = 静态盘点(由静态盘点定式 pattern=static 创建,或创建任务时显式开启);
* - 0 = 普通盘点(存量数据默认值即 0,无需回填);
* - 纯标记字段,不参与盘点流程判定(不改变模式/状态机/差异口径)。
*/
const TABLE_NAME = 'wms_stock_check';
module.exports = {
up: async queryInterface => {
await queryInterface.sequelize.query(`
ALTER TABLE \`${TABLE_NAME}\`
ADD COLUMN \`is_static\` TINYINT(1) NOT NULL DEFAULT 0 COMMENT '是否静态盘点(1=静态盘点(静态定式创建或创建时开启),0=普通盘点)' AFTER \`store_id\`
`);
},
down: async queryInterface => {
await queryInterface.removeColumn(TABLE_NAME, 'is_static');
},
};