oms/backend/database/migrations/20260915002300-outbound-orders-stock-locked.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

38 lines
1.8 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';
/**
* 出库单库存锁定标记:outbound_orders.stock_locked
*
* 背景:出库单改为「审核(1→2) 入队 → 定时任务自动推送(2→3)」后,推送可能失败并退回「待出库(1)」,
* 而库存锁定发生在推送过程中(占用可用,防超卖)。为了让「锁了就必须有人释放」可判定,这里补一个标记列
* (与 order_deliveries.stock_locked 同口径):
* - 1 = 该单当前占用着推送时锁定的库存(推送成功后保持,出库确认扣减时清零;推送失败退回/取消/作废/驳回时释放并清零)
* - 0 = 未锁定 / 已释放 / 已扣减
*
* 之所以需要它:推送无响应(超时)时单据保留在「已审核(2)」等待重试,此时库存是已锁定状态,
* 若重试时再次锁定会重复占用;若用户此时取消/作废,也需要按标记释放库存。
* 历史单据(本迁移之前)落 0:其状态为 3 时的取消/驳回路径仍按原有「已推送即已锁定」口径处理。
*
* 幂等:可重复执行(先 describeTable 判断列是否存在)。
*/
module.exports = {
async up(queryInterface, Sequelize) {
const columns = await queryInterface.describeTable('outbound_orders');
if (columns.stock_locked) return;
await queryInterface.addColumn('outbound_orders', 'stock_locked', {
type: Sequelize.TINYINT.UNSIGNED,
allowNull: false,
defaultValue: 0,
comment: '推送锁定库存标记:1=已锁定(重试不重复锁定,确认扣减/释放后置 0),0=未锁定',
after: 'stock_deducted',
});
},
async down(queryInterface) {
const columns = await queryInterface.describeTable('outbound_orders');
if (!columns.stock_locked) return;
await queryInterface.removeColumn('outbound_orders', 'stock_locked');
},
};