盘点作业数据(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>
142 lines
4.1 KiB
JavaScript
142 lines
4.1 KiB
JavaScript
'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;
|
||
};
|