'use strict'; /** * 文档站层级从「分类 → 栏目 → 内容页」收紧成两级:**栏目 → 内容页** * * - 原来的「分类」整表升级成「栏目」:`doc_categories` 改名 `doc_sections`, * `code` / `name` / `description` / `sort` / `status` 全部保留,页面地址 `/doc//.html` 不变; * - 原来的二级「栏目」表删掉,底下的内容页直接挂到顶层(`section_id` 改指原 `category_id`); * - `doc_articles.category_id` 不再需要(栏目就是顶层),一并删除。 * * 内容页一条不丢:只是从「分类 → 栏目 → 文章」压平成「栏目 → 文章」。 */ /** 索引存在才删(生产环境可能有人手工调整过) */ async function removeIndexIfExists(queryInterface, table, name) { const [rows] = await queryInterface.sequelize.query( 'SELECT 1 FROM information_schema.statistics WHERE table_schema = DATABASE() AND table_name = ? AND index_name = ? LIMIT 1', { replacements: [ table, name ] }, ); if (rows.length) await queryInterface.removeIndex(table, name); } module.exports = { async up(queryInterface) { // 1. 内容页改挂在顶层上(原分类 id),随后二级栏目表就没用了 await queryInterface.sequelize.query('UPDATE doc_articles SET section_id = category_id'); await removeIndexIfExists(queryInterface, 'doc_articles', 'idx_doc_articles_tree'); await removeIndexIfExists(queryInterface, 'doc_articles', 'idx_doc_articles_slug'); await queryInterface.removeColumn('doc_articles', 'category_id'); await queryInterface.dropTable('doc_sections'); // 2. 原「分类」表改名成「栏目」表(文章的 section_id 已经指过来了) await removeIndexIfExists(queryInterface, 'doc_categories', 'idx_doc_categories_status_sort'); await queryInterface.renameTable('doc_categories', 'doc_sections'); // 3. 表 / 字段注释跟着改语义(只改文案,不动类型与索引) await queryInterface.sequelize.query("ALTER TABLE `doc_sections` COMMENT = '文档栏目表'"); await queryInterface.sequelize.query( "ALTER TABLE `doc_sections` MODIFY COLUMN `name` VARCHAR(64) NOT NULL COMMENT '栏目名称(顶部 tab 文案)', MODIFY COLUMN `description` VARCHAR(255) NULL COMMENT '栏目说明(可选)'", ); await queryInterface.sequelize.query( "ALTER TABLE `doc_articles` MODIFY COLUMN `section_id` BIGINT UNSIGNED NOT NULL COMMENT '所属栏目 doc_sections.id'", ); // 4. 索引按新层级重建 await queryInterface.addIndex('doc_sections', [ 'status', 'sort' ], { name: 'idx_doc_sections_status_sort' }); await queryInterface.addIndex('doc_articles', [ 'section_id', 'sort' ], { name: 'idx_doc_articles_section_sort' }); await queryInterface.addIndex('doc_articles', [ 'section_id', 'slug' ], { name: 'idx_doc_articles_slug' }); // 5. 演示内容跟着新文案走(只改还有旧措辞的那一页) await queryInterface.sequelize.query( `UPDATE doc_articles SET content = REPLACE( REPLACE( REPLACE(content, '- 顶部 tab 是「分类」,点一下就能切换;', '- 顶部 tab 是「栏目」,点一下就能切换;'), '- 左侧是分类下的「栏目 → 内容页」;', '- 左侧直接列出当前栏目的内容页;'), '在「文档管理」里新建分类 / 栏目 / 内容页;', '在「文档管理」里新建栏目,再往栏目里加内容页;') WHERE slug = 'welcome' AND deleted_at IS NULL`, ); }, async down(queryInterface, Sequelize) { const { BIGINT, STRING, INTEGER, TINYINT, DATE } = Sequelize; // ---- 先按新结构把数据复制回「分类」,再重建二级栏目 ---- await queryInterface.addColumn('doc_articles', 'category_id', { type: BIGINT.UNSIGNED, allowNull: true, comment: '所属分类(冗余,列表用)', }); await queryInterface.sequelize.query('UPDATE doc_articles SET category_id = section_id'); await queryInterface.createTable('doc_categories', { id: { type: BIGINT.UNSIGNED, primaryKey: true, autoIncrement: true, allowNull: false }, code: { type: STRING(32), allowNull: false, unique: true, comment: 'URL 片段(/doc//)' }, name: { type: STRING(64), allowNull: false, comment: '分类名称(tab 文案)' }, description: { type: STRING(255), allowNull: true, comment: '分类说明(可选)' }, sort: { type: INTEGER.UNSIGNED, allowNull: false, defaultValue: 0, comment: '排序(小的在前)' }, status: { type: TINYINT.UNSIGNED, allowNull: false, defaultValue: 1, comment: '状态:1 展示 0 隐藏' }, created_at: { type: DATE, allowNull: false, defaultValue: Sequelize.literal('CURRENT_TIMESTAMP') }, updated_at: { type: DATE, allowNull: false, defaultValue: Sequelize.literal('CURRENT_TIMESTAMP') }, deleted_at: { type: DATE, allowNull: true }, }, { comment: '文档分类表' }); await queryInterface.sequelize.query( `INSERT INTO doc_categories (id, code, name, description, sort, status, created_at, updated_at, deleted_at) SELECT id, code, name, description, sort, status, created_at, updated_at, deleted_at FROM doc_sections`, ); await queryInterface.dropTable('doc_sections'); await queryInterface.createTable('doc_sections', { id: { type: BIGINT.UNSIGNED, primaryKey: true, autoIncrement: true, allowNull: false }, category_id: { type: BIGINT.UNSIGNED, allowNull: false, comment: '所属分类 doc_categories.id' }, name: { type: STRING(64), allowNull: false, comment: '栏目名称(侧边栏分组标题)' }, sort: { type: INTEGER.UNSIGNED, allowNull: false, defaultValue: 0, comment: '排序(小的在前)' }, status: { type: TINYINT.UNSIGNED, allowNull: false, defaultValue: 1, comment: '状态:1 展示 0 隐藏' }, created_at: { type: DATE, allowNull: false, defaultValue: Sequelize.literal('CURRENT_TIMESTAMP') }, updated_at: { type: DATE, allowNull: false, defaultValue: Sequelize.literal('CURRENT_TIMESTAMP') }, deleted_at: { type: DATE, allowNull: true }, }, { comment: '文档栏目表' }); // 每个分类补一个同名栏目,内容页都挂上去 await queryInterface.sequelize.query( `INSERT INTO doc_sections (category_id, name, sort, status, created_at, updated_at) SELECT id, name, 10, status, created_at, updated_at FROM doc_categories`, ); await queryInterface.sequelize.query( `UPDATE doc_articles a JOIN doc_sections s ON s.category_id = a.category_id SET a.section_id = s.id`, ); await queryInterface.changeColumn('doc_articles', 'category_id', { type: BIGINT.UNSIGNED, allowNull: false, comment: '所属分类(冗余,列表用)', }); // ---- 索引恢复成三级结构 ---- await removeIndexIfExists(queryInterface, 'doc_articles', 'idx_doc_articles_section_sort'); await removeIndexIfExists(queryInterface, 'doc_articles', 'idx_doc_articles_slug'); await removeIndexIfExists(queryInterface, 'doc_sections', 'idx_doc_sections_status_sort'); await queryInterface.addIndex('doc_categories', [ 'status', 'sort' ], { name: 'idx_doc_categories_status_sort' }); await queryInterface.addIndex('doc_sections', [ 'category_id', 'sort' ], { name: 'idx_doc_sections_category_sort' }); await queryInterface.addIndex('doc_articles', [ 'category_id', 'section_id', 'sort' ], { name: 'idx_doc_articles_tree' }); await queryInterface.addIndex('doc_articles', [ 'category_id', 'slug' ], { name: 'idx_doc_articles_slug' }); await queryInterface.sequelize.query( `UPDATE doc_articles SET content = REPLACE( REPLACE( REPLACE(content, '- 顶部 tab 是「栏目」,点一下就能切换;', '- 顶部 tab 是「分类」,点一下就能切换;'), '- 左侧直接列出当前栏目的内容页;', '- 左侧是分类下的「栏目 → 内容页」;'), '在「文档管理」里新建栏目,再往栏目里加内容页;', '在「文档管理」里新建分类 / 栏目 / 内容页;') WHERE slug = 'welcome' AND deleted_at IS NULL`, ); }, };