oms/backend/database/migrations/20260915001600-outbound-orders-receiver-express.js
liufumingren 39c19a4de7 feat(backend): 出入库记录与库存锁定链路、出库单快递/收件人与推送队列
- 出入库记录(库存流水):新增 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 为本地生成、不入库)
2026-09-14 00:59:23 +08:00

71 lines
4.2 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';
/**
* 出库单补齐 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);
}
},
};