WMS_MAIN/app/model/stock_check_detail.js
liufumingren 190d3cf9e5 feat(stock.check): 盘点模块功能扩展并同步接口文档(0.3.227)
- 盘点明细/记录支持未知商品(stock_id 可空)与库位范围,模式/状态口径修正
- 新增静态盘点任务、公告相关模型与迁移,stock_warehouse 增加预警数量
- methods/system.json 同步盘点接口文档;headers platform 微信端取值 wx 修正为 miniprogram
2026-10-02 15:43:49 +08:00

120 lines
3.7 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';
/**
* 库存盘点明细表模型(盘点范围行:商品或库位)。
* 商品行(scope_type=goods):stock_id + 商品快照 + 账面数量快照;
* 库位行(scope_type=location):location_id/location_code + stock_id/item_code 为空。
* 库位/数量等盘点作业信息存放在 wms_stock_check_record。
* @param {import('egg').Application} app Egg 应用实例。
* @return {import('sequelize').ModelCtor<import('sequelize').Model>} Sequelize 模型。
*/
module.exports = app => {
const { BIGINT, STRING, INTEGER } = app.Sequelize;
const StockCheckDetail = app.model.define('wms_stock_check_detail', {
id: {
type: BIGINT(20).UNSIGNED,
primaryKey: true,
autoIncrement: true,
comment: '主键',
},
check_id: {
type: BIGINT(20).UNSIGNED,
allowNull: false,
comment: '关联盘点主表 wms_stock_check.id',
},
warehouse_id: {
type: BIGINT(20).UNSIGNED,
allowNull: false,
comment: '仓库ID(冗余,隔离查询)',
},
scope_type: {
type: STRING(20),
allowNull: false,
defaultValue: 'goods',
comment: '盘点范围类型:goods=商品,location=库位',
},
stock_id: {
type: BIGINT(20).UNSIGNED,
allowNull: true,
comment: '库存商品ID,关联 wms_stock_warehouse.id;库位盘点行为空',
},
location_id: {
type: BIGINT(20).UNSIGNED,
allowNull: true,
comment: '库位ID,关联 wms_location_space.id;库位盘点行为空',
},
location_code: {
type: STRING(50),
allowNull: true,
comment: '库位编码(space_code);库位盘点行为空',
},
item_code: {
type: STRING(50),
allowNull: true,
comment: '商品编码快照;库位盘点行为空',
},
item_name: {
type: STRING(255),
allowNull: true,
comment: '商品名称快照',
},
spec: {
type: STRING(100),
allowNull: true,
comment: '规格快照(sku_property)',
},
batch_no: {
type: STRING(100),
allowNull: true,
comment: '批次号,批次管理商品时记录',
},
system_quantity: {
type: INTEGER(12),
allowNull: false,
defaultValue: 0,
comment: '账面数量快照(生成盘点明细时的系统库存,用于差异对比;库位行固定为 0,账面按 wms_storage 现算)',
},
remark: {
type: STRING(500),
allowNull: true,
comment: '备注',
},
}, {
tableName: 'wms_stock_check_detail',
comment: '库存盘点明细表(盘点范围行:商品或库位)',
timestamps: true,
createdAt: 'created_at',
updatedAt: 'updated_at',
paranoid: false,
indexes: [
{ name: 'idx_check_id', fields: [ 'check_id' ] },
{ name: 'idx_warehouse_stock', fields: [ 'warehouse_id', 'stock_id' ] },
{ name: 'idx_stock_id', fields: [ 'stock_id' ] },
{ name: 'uk_check_stock', unique: true, fields: [ 'check_id', 'stock_id' ] },
{ name: 'uk_check_location', unique: true, fields: [ 'check_id', 'location_code' ] },
],
});
StockCheckDetail.associate = function() {
const { StockCheck, StockWarehouse, StockCheckRecord } = app.model;
// 关联盘点主表
StockCheckDetail.belongsTo(StockCheck, {
foreignKey: 'check_id',
as: 'check',
});
// 关联库存商品
StockCheckDetail.belongsTo(StockWarehouse, {
foreignKey: 'stock_id',
as: 'stockWarehouse',
});
// 一条明细对应多条盘点作业记录
StockCheckDetail.hasMany(StockCheckRecord, {
foreignKey: 'detail_id',
as: 'records',
});
};
return StockCheckDetail;
};