- 出入库记录(库存流水):新增 stock_records 表/模型/只读接口(列表 + 业务动作选项)与「出入库记录」菜单; 库存变动统一收敛到 app/utils/stockRecord.js#applyStockChange,与流水写入同事务(含变动前后总/锁定/可用数量) - 发货单:审核(1→2) 按明细锁定库存、发货确认(3→4) 扣减、推送失败退回/驳回/取消/作废释放(新增 stock_locked 列); 恢复(9→1) 时曾推送过的单据换号(WMS 取消后原单号仍被占用,沿用旧号重推会被判「订单已存在」) - 出库单:新增快递(express_code/express_name)、收件人(receiver_*) 与多运单号(express_codes) 字段; 推送报文补齐 logisticsCode/receiverInfo;新增出库单推送服务与定时任务 - 快递:多运单号回填、仓库快递映射(warehouse_express_mappings) 与快递字典补录等迁移 - 契约:补充出入库记录、出库单快递/收件人等定义(swagger.json 为本地生成、不入库)
71 lines
4.2 KiB
JavaScript
71 lines
4.2 KiB
JavaScript
'use strict';
|
||
|
||
/**
|
||
* 出库单补齐 stockout.create 所需字段:快递公司(express_code / express_name)+ 收件人(receiver_* 13 列)
|
||
*
|
||
* 背景:比对 WMS `stockout.create` 的请求报文(D:/wms/methods/openapi.json#stockout.create)发现,
|
||
* OMS 出库单(outbound_orders)只有 `customer`(客户/收货方)一个笼统字段,缺:
|
||
* - deliveryOrder.logisticsCode → express_code / express_name
|
||
* - deliveryOrder.receiverInfo(13 个字段) → receiver_*
|
||
* 这导致 OMS 建单时无处录入、推送时报文也带不过去(WMS 侧会落到 wms_order_stockout 的
|
||
* receiver_* 列,"供转订单与确认回传使用")。
|
||
*
|
||
* 命名口径:**对齐 WMS 对应表 `wms_order_stockout`**(见 D:/wms/app/model/order_stockout.js):
|
||
* express_code 快递公司编码(推送为 deliveryOrder.logisticsCode,如 SF/STO)
|
||
* express_name 快递公司名称(OMS 侧按 express_companies 字典解析的快照)
|
||
* receiver_name / receiver_company / receiver_zip_code / receiver_tel / receiver_mobile /
|
||
* receiver_email / receiver_country_code / receiver_province / receiver_city / receiver_area /
|
||
* receiver_town / receiver_detail_address / receiver_id(收件人证件号,奇门字段名为 id)
|
||
* (发货单 order_deliveries 的收件人是"扁平无前缀"命名,那是为对齐 wms_order_delivery,两者各自对齐各自的表)
|
||
*
|
||
* 明细侧无缺失(orderLineNo/ownerCode/itemCode/itemId/itemName/planQty/inventoryType 均已具备)。
|
||
* 幂等:迁移可重复执行(先 describeTable 判断列是否存在)。
|
||
*/
|
||
module.exports = {
|
||
async up(queryInterface, Sequelize) {
|
||
const { STRING } = Sequelize;
|
||
const existing = await queryInterface.describeTable('outbound_orders');
|
||
|
||
// 收件人列(字段名 → [类型长度, 注释],顺序即建列顺序)
|
||
const columns = [
|
||
[ 'express_code', [ STRING(50), '快递公司编码(推送 deliveryOrder.logisticsCode,如 SF/STO)' ] ],
|
||
[ 'express_name', [ STRING(200), '快递公司名称(按 express_companies 字典解析的快照)' ] ],
|
||
[ 'receiver_name', [ STRING(50), '收件人姓名(receiverInfo.name)' ] ],
|
||
[ 'receiver_company', [ STRING(200), '收件人公司名称(receiverInfo.company)' ] ],
|
||
[ 'receiver_tel', [ STRING(50), '收件人固定电话(receiverInfo.tel)' ] ],
|
||
[ 'receiver_mobile', [ STRING(50), '收件人移动电话(receiverInfo.mobile)' ] ],
|
||
[ 'receiver_email', [ STRING(100), '收件人邮箱(receiverInfo.email;WMS 侧为 50,此处放宽)' ] ],
|
||
[ 'receiver_country_code', [ STRING(50), '收件人国家二字码(receiverInfo.countryCode)' ] ],
|
||
[ 'receiver_province', [ STRING(50), '收件人省份(receiverInfo.province)' ] ],
|
||
[ 'receiver_city', [ STRING(50), '收件人城市(receiverInfo.city)' ] ],
|
||
[ 'receiver_area', [ STRING(50), '收件人区县(receiverInfo.area)' ] ],
|
||
[ 'receiver_town', [ STRING(50), '收件人街道/镇(receiverInfo.town)' ] ],
|
||
[ 'receiver_detail_address', [ STRING(200), '收件人详细地址(receiverInfo.detailAddress)' ] ],
|
||
[ 'receiver_zip_code', [ STRING(50), '收件人邮编(receiverInfo.zipCode)' ] ],
|
||
[ 'receiver_id', [ STRING(50), '收件人证件号(receiverInfo.id)' ] ],
|
||
];
|
||
|
||
let after = 'remark';
|
||
for (const [ name, [ type, comment ] ] of columns) {
|
||
if (existing[name]) {
|
||
after = name;
|
||
continue;
|
||
}
|
||
await queryInterface.addColumn('outbound_orders', name, { type, allowNull: true, comment, after });
|
||
after = name;
|
||
}
|
||
},
|
||
|
||
async down(queryInterface) {
|
||
const existing = await queryInterface.describeTable('outbound_orders');
|
||
const names = [
|
||
'receiver_id', 'receiver_zip_code', 'receiver_detail_address', 'receiver_town', 'receiver_area',
|
||
'receiver_city', 'receiver_province', 'receiver_country_code', 'receiver_email', 'receiver_mobile',
|
||
'receiver_tel', 'receiver_company', 'receiver_name', 'express_name', 'express_code',
|
||
];
|
||
for (const name of names) {
|
||
if (existing[name]) await queryInterface.removeColumn('outbound_orders', name);
|
||
}
|
||
},
|
||
};
|