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