WMS_MAIN/app/model/order_stockout.js
liufumingren ee7f08b192 feat(order): wms_order_b2b 表模型与迁移内容(order_delivery 附属表)
- app/model/order_b2b.js:ctx.model.OrderB2b,order_id 关联 wms_order_delivery
  分表 id,uk_order_id 唯一,warehouse_id/store_id 维度隔离,软删除
- order_stockout.js 回滚 hasOne(OrderStockoutB2b) 关联
- 迁移内容改为 wms_order_b2b + delivery_order_code 快照
- 开发库已执行核验 14 列;生产库待随发布执行
2026-10-08 21:58:02 +08:00

367 lines
9.4 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';
/**
* 出库单主表 Model。
*
* 对应数据库表 `wms_order_stockout`,存储奇门 stockout.create 接口下发的出库单信息。
*
* 业务类型枚举值:
* - JYCK:一般交易出库
* - HHCK:换货出库
* - BFCK:补发出库
* - QTCK:其他出库
* @param {import('egg').Application} app - Egg 应用实例
*/
module.exports = app => {
const { STRING, INTEGER, BIGINT, ENUM, TEXT, TINYINT, DATE, JSON: JSON_TYPE } = app.Sequelize;
const OrderStockout = app.model.define('wms_order_stockout', {
id: {
type: BIGINT(20).UNSIGNED,
primaryKey: true,
autoIncrement: true,
comment: '主键ID',
},
stockout_order_code: {
type: STRING(50),
allowNull: false,
comment: '出库单号(对应奇门 deliveryOrderCode)',
validate: {
notEmpty: true,
},
},
order_type: {
type: STRING(50),
allowNull: false,
comment: '业务类型(JYCK一般交易出库/HHCK换货出库/BFCK补发出库/QTCK其他出库等)',
validate: {
notEmpty: true,
},
},
total_order_lines: {
type: INTEGER(11),
allowNull: false,
defaultValue: 0,
comment: '单据总行数',
},
order_create_time: {
type: DATE,
allowNull: true,
comment: '订单创建时间(对应奇门 createTime)',
},
source_type: {
type: ENUM('WMS', 'API', 'QM'),
allowNull: false,
defaultValue: 'QM',
comment: '来源类型',
},
order_status: {
type: ENUM('CREATING', 'CREATED', 'PENDING', 'COMPLETED', 'CANCELLED', 'TRANSFERRED'),
allowNull: false,
defaultValue: 'CREATED',
comment: '订单状态:CREATING=创建中, CREATED=已创建待审核, PENDING=已审核, COMPLETED=已完成, CANCELLED=已作废, TRANSFERRED=已转订单',
},
sync_status: {
type: ENUM('PENDING', 'SUCCESS', 'FAILED'),
allowNull: false,
defaultValue: 'PENDING',
comment: '同步状态',
},
sync_message: {
type: TEXT,
allowNull: true,
comment: '同步返回信息',
},
warehouse_id: {
type: BIGINT(20).UNSIGNED,
allowNull: false,
comment: '仓库ID',
},
store_id: {
type: BIGINT(20).UNSIGNED,
allowNull: false,
comment: '货主ID',
},
store_name: {
type: STRING(200),
allowNull: true,
comment: '货主名称快照',
},
warehouse_name: {
type: STRING(200),
allowNull: true,
comment: '仓库名称快照',
},
qimen_owner_code: {
type: STRING(100),
allowNull: true,
comment: '奇门货主code(对应 ownerCode)',
},
qimen_warehouse_code: {
type: STRING(100),
allowNull: true,
comment: '奇门仓库code(对应 warehouseCode)',
},
remark: {
type: STRING(500),
allowNull: true,
comment: '备注',
},
receiver_company: {
type: STRING(200),
allowNull: true,
comment: '收件人公司名称(receiverInfo.company)',
},
receiver_name: {
type: STRING(50),
allowNull: true,
comment: '收件人姓名(receiverInfo.name)',
},
receiver_zip_code: {
type: STRING(50),
allowNull: true,
comment: '收件人邮编(receiverInfo.zipCode)',
},
receiver_tel: {
type: STRING(50),
allowNull: true,
comment: '收件人固定电话(receiverInfo.tel)',
},
receiver_mobile: {
type: STRING(50),
allowNull: true,
comment: '收件人移动电话(receiverInfo.mobile)',
},
receiver_email: {
type: STRING(50),
allowNull: true,
comment: '收件人电子邮箱(receiverInfo.email)',
},
receiver_country_code: {
type: STRING(50),
allowNull: true,
comment: '收件人国家二字码(receiverInfo.countryCode)',
},
receiver_province: {
type: STRING(50),
allowNull: true,
comment: '收件人省份(receiverInfo.province)',
},
receiver_city: {
type: STRING(50),
allowNull: true,
comment: '收件人城市(receiverInfo.city)',
},
receiver_area: {
type: STRING(50),
allowNull: true,
comment: '收件人区域(receiverInfo.area)',
},
receiver_town: {
type: STRING(50),
allowNull: true,
comment: '收件人村镇(receiverInfo.town)',
},
receiver_detail_address: {
type: STRING(200),
allowNull: true,
comment: '收件人详细地址(receiverInfo.detailAddress)',
},
receiver_id: {
type: STRING(50),
allowNull: true,
comment: '收件人证件号(receiverInfo.id)',
},
source_platform_code: {
type: STRING(50),
allowNull: true,
comment: '来源平台编码(转订单时优先使用,为空时兜底平台)',
},
source_platform_name: {
type: STRING(200),
allowNull: true,
comment: '来源平台名称快照',
},
express_code: {
type: STRING(50),
allowNull: true,
comment: '快递公司编码(如 SF、STO,用于出站回传 logisticsCode)',
},
express_name: {
type: STRING(200),
allowNull: true,
comment: '快递公司名称(由 express_code 自动解析,如 顺丰、申通)',
},
waybill_code: {
type: STRING(50),
allowNull: true,
comment: '运单号',
},
waybill_codes: {
type: JSON_TYPE,
allowNull: true,
comment: '运单号列表(JSON 数组,支持多包裹场景)',
},
express_codes: {
type: JSON_TYPE,
allowNull: true,
comment: '@deprecated 运单号列表,请使用 waybill_codes',
},
extend_props: {
type: JSON_TYPE,
allowNull: true,
comment: '扩展属性',
},
is_enabled: {
type: TINYINT(1),
allowNull: false,
defaultValue: 1,
comment: '是否启用',
},
created_at: {
type: DATE,
allowNull: false,
comment: '创建时间',
},
updated_at: {
type: DATE,
allowNull: false,
comment: '更新时间',
},
deleted_at: {
type: DATE,
allowNull: true,
comment: '软删除时间',
},
}, {
tableName: 'wms_order_stockout',
comment: '出库单主表',
timestamps: false,
indexes: [
{
name: 'uk_stockout_order_code',
unique: true,
fields: [ 'stockout_order_code', 'warehouse_id', 'store_id' ],
},
{
name: 'idx_order_type',
fields: [ 'order_type' ],
},
{
name: 'idx_order_status',
fields: [ 'order_status' ],
},
{
name: 'idx_sync_status',
fields: [ 'sync_status' ],
},
{
name: 'idx_source_type',
fields: [ 'source_type' ],
},
{
name: 'idx_warehouse_store',
fields: [ 'warehouse_id', 'store_id' ],
},
{
name: 'idx_order_create_time',
fields: [ 'order_create_time' ],
},
{
name: 'idx_is_enabled',
fields: [ 'is_enabled' ],
},
{
name: 'idx_deleted_at',
fields: [ 'deleted_at' ],
},
],
});
/**
* 关联关系定义。
* - 关联货主 / 仓库(均通过 Store 表)
* - 关联出库明细表
*/
OrderStockout.associate = function() {
const { OrderStockout, Store, OrderStockoutItems } = app.model;
// 关联仓库
OrderStockout.belongsTo(Store, {
foreignKey: 'warehouse_id',
as: 'warehouse',
});
// 关联货主
OrderStockout.belongsTo(Store, {
foreignKey: 'store_id',
as: 'store',
});
// 关联出库明细
OrderStockout.hasMany(OrderStockoutItems, {
foreignKey: 'order_id',
as: 'items',
});
};
// ---------- 状态机辅助方法 ----------
/** 判断订单是否处于"已创建"状态 */
OrderStockout.prototype.isCreated = function() {
return this.order_status === 'CREATED';
};
/** 判断订单是否处于"已审核"状态 */
OrderStockout.prototype.isPending = function() {
return this.order_status === 'PENDING';
};
/** 判断订单是否已完成 */
OrderStockout.prototype.isCompleted = function() {
return this.order_status === 'COMPLETED';
};
/** 判断订单是否已作废 */
OrderStockout.prototype.isCancelled = function() {
return this.order_status === 'CANCELLED';
};
/** 判断订单是否已转销售订单 */
OrderStockout.prototype.isTransferred = function() {
return this.order_status === 'TRANSFERRED';
};
/** 当前订单是否允许审核 */
OrderStockout.prototype.canConfirm = function() {
return [ 'CREATED', 'PENDING' ].includes(this.order_status);
};
/** 当前订单是否允许取消 */
OrderStockout.prototype.canCancel = function() {
return [ 'CREATED', 'PENDING' ].includes(this.order_status);
};
/** 当前订单是否允许完成 */
OrderStockout.prototype.canComplete = function() {
return [ 'PENDING' ].includes(this.order_status);
};
/** 同步是否成功 */
OrderStockout.prototype.isSyncSuccess = function() {
return this.sync_status === 'SUCCESS';
};
/** 同步是否失败 */
OrderStockout.prototype.isSyncFailed = function() {
return this.sync_status === 'FAILED';
};
/** 是否启用(未软删除) */
OrderStockout.prototype.isEnabled = function() {
return this.is_enabled === 1 && !this.deleted_at;
};
return OrderStockout;
};