'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); } }, };