WMS_MAIN/app/model/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

142 lines
4.1 KiB
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';
/**
* 库存盘点主表模型。
* @param {import('egg').Application} app Egg 应用实例。
* @return {import('sequelize').ModelCtor<import('sequelize').Model>} Sequelize 模型。
*/
module.exports = app => {
const { BIGINT, STRING, INTEGER, TINYINT, DATE, JSON: JSON_TYPE } = app.Sequelize;
const StockCheck = app.model.define('wms_stock_check', {
id: {
type: BIGINT(20).UNSIGNED,
primaryKey: true,
autoIncrement: true,
comment: '主键',
},
warehouse_id: {
type: BIGINT(20).UNSIGNED,
allowNull: false,
comment: '仓库ID(数据隔离维度)',
},
check_no: {
type: STRING(50),
allowNull: false,
comment: '盘点单号,唯一,生成规则:PD+YYYYMMDD+6位序号',
},
title: {
type: STRING(200),
allowNull: true,
comment: '盘点名称/主题,非必填',
},
type: {
type: STRING(20),
allowNull: false,
defaultValue: 'location',
comment: '盘点范围类型:location=按库位(未传库位时自动全盘),store=按货主,goods=按商品',
},
mode: {
type: STRING(20),
allowNull: false,
defaultValue: 'open',
comment: '盘点方式:open=明盘(可见账面数量),blind=盲盘(不可见账面数量)',
},
store_id: {
type: BIGINT(20).UNSIGNED,
allowNull: true,
comment: '货主ID,按货主盘点时必填(type=store)',
},
is_static: {
type: TINYINT(1),
allowNull: false,
defaultValue: 0,
comment: '是否静态盘点(1=静态盘点(静态定式创建或创建时开启),0=普通盘点)',
},
scope_snapshot: {
type: JSON_TYPE,
allowNull: true,
comment: '盘点范围条件快照(JSON),如商品ID列表/库位ID列表,供盘点对比与追溯',
},
status: {
type: STRING(20),
allowNull: false,
defaultValue: 'pending',
comment: '盘点状态:pending=待盘点,in_progress=盘点中,checked=已盘待确认,confirmed=已确认,completed=已完成,cancelled=已取消',
},
detail_status: {
type: STRING(30),
allowNull: false,
defaultValue: 'none_checked',
comment: '明细盘点进度:none_checked=未盘,partial_checked=部分已盘,all_checked=全部已盘',
},
start_time: {
type: DATE,
allowNull: true,
comment: '盘点开始时间(第一个盘点明细写入的时间)',
},
end_time: {
type: DATE,
allowNull: true,
comment: '盘点结束时间(完成盘点的时间)',
},
creator_id: {
type: BIGINT(20).UNSIGNED,
allowNull: false,
comment: '创建人账户ID',
},
creator_name: {
type: STRING(50),
allowNull: true,
comment: '创建人名称快照',
},
total_items: {
type: INTEGER(11),
allowNull: false,
defaultValue: 0,
comment: '明细行数(盘点任务总行数)',
},
checked_items: {
type: INTEGER(11),
allowNull: false,
defaultValue: 0,
comment: '已盘行数',
},
diff_items: {
type: INTEGER(11),
allowNull: false,
defaultValue: 0,
comment: '差异行数(账面与实盘不一致的行数)',
},
remark: {
type: STRING(500),
allowNull: true,
comment: '备注',
},
}, {
tableName: 'wms_stock_check',
comment: '库存盘点主表',
timestamps: true,
createdAt: 'created_at',
updatedAt: 'updated_at',
paranoid: false,
indexes: [
{ name: 'uk_check_no', unique: true, fields: [ 'check_no' ] },
{ name: 'idx_warehouse_status', fields: [ 'warehouse_id', 'status' ] },
{ name: 'idx_store_id', fields: [ 'store_id' ] },
{ name: 'idx_creator_id', fields: [ 'creator_id' ] },
],
});
StockCheck.associate = function() {
const { StockCheckDetail } = app.model;
// 一个盘点单对应多条盘点明细
StockCheck.hasMany(StockCheckDetail, {
foreignKey: 'check_id',
as: 'details',
});
};
return StockCheck;
};