- 出入库记录(库存流水):新增 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 为本地生成、不入库)
38 lines
1.8 KiB
JavaScript
38 lines
1.8 KiB
JavaScript
'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');
|
||
},
|
||
};
|