'use strict'; /** * wms_express_interface 增加 goods_description 列(物品描述)。 * * 背景:菜鸟等电子面单接口的 package_info.goods_description 需要按快递接口配置下发, * 原先在代码内硬编码为「化妆品」。现改为读取接口配置,未配置时仍回退到「化妆品」。 * * 幂等:列存在性判断后再执行,重复运行安全。 */ const TABLE_NAME = 'wms_express_interface'; const COLUMN_NAME = 'goods_description'; module.exports = { /** * 执行迁移:新增 goods_description 列。 * @param {import('sequelize').QueryInterface} queryInterface 查询接口。 * @param {Object} Sequelize Sequelize 类型集合。 * @return {Promise} 无返回值。 */ async up(queryInterface, Sequelize) { const { STRING } = Sequelize; const log = []; const columns = await queryInterface.describeTable(TABLE_NAME); if (!columns || Object.keys(columns).length === 0) { throw new Error(`表 ${TABLE_NAME} 不存在,无法新增 ${COLUMN_NAME}`); } if (!Object.prototype.hasOwnProperty.call(columns, COLUMN_NAME)) { await queryInterface.addColumn(TABLE_NAME, COLUMN_NAME, { type: STRING(255), allowNull: true, comment: '物品描述', }); log.push({ action: 'add-column', columnName: COLUMN_NAME }); } else { log.push({ action: 'skip-add-column', columnName: COLUMN_NAME, reason: 'exists' }); } console.log('[20261118200000-add-goods-description-to-express-interface] up results:', JSON.stringify(log)); }, /** * 回滚迁移:移除 goods_description 列。 * @param {import('sequelize').QueryInterface} queryInterface 查询接口。 * @return {Promise} 无返回值。 */ async down(queryInterface) { const log = []; const columns = await queryInterface.describeTable(TABLE_NAME); if (Object.prototype.hasOwnProperty.call(columns, COLUMN_NAME)) { await queryInterface.removeColumn(TABLE_NAME, COLUMN_NAME); log.push({ action: 'drop-column', columnName: COLUMN_NAME }); } console.log('[20261118200000-add-goods-description-to-express-interface] down results:', JSON.stringify(log)); }, };