feat(多公司): V143 建 company 与 users.company_id,配 12 例迁移护栏

一期只做账号归属:company 主表 + users.company_id,57 张业务表零 DDL、零回填,
公司维度全部由 user_id → users.company_id 派生。存量账号在迁移里归入「厦门米椿花」,
不需要另外拿脚本对着生产库 UPDATE。

两个不落进代码就会丢的判断:

1) 每条语句都写成幂等。MySQL 的 DDL 不进事务,NOT NULL 闸门失败时前面的建表/插数/加列
   已经落库,而 repair + 重启会让 Flyway 从第一条语句重跑整个文件;写成裸 CREATE TABLE /
   裸 INSERT 的话,恢复路径自己撞 1050/1060/1062,"补数据后重启"就变成"必须手工清库"。
2) 回滚是 docs/rollback-V143-company.sql,不是一条 V144 迁移。放进 src/main/resources/db/
   等于让 Flyway 在下次启动时自动执行回滚。这两条口径一并写进 migration-inventory.md 的
   约束段,供后续所有迁移引用。

闸门留 DEFAULT 1 只为混合版本窗口存在(旧 jar 建号不带 company_id),摘除时机改由启动期
巡检盯(下一步实现),不靠人记。

CompanyMigrationV143Test 12 例,断言打在剥掉注释后的可执行 SQL 上(否则"注释里写了这句话"
就算通过);16 条变异全部被抓到。全量 mvn test 3515 例 0 红。

后端 modules/company、两端前端、DEFAULT 摘除巡检尚未开始。
This commit is contained in:
2026-10-04 03:27:27 +08:00
parent 7ad4932bd5
commit 5633898a0d
5 changed files with 637 additions and 74 deletions
@@ -0,0 +1,120 @@
-- =============================================================
-- 迁移 V143__company_and_users_company_id
-- 模板:docs/flyway-migration-template.md
-- 设计:crawler-plugin/docs/ops/company-multi-tenant-design-2026-10-04.md
--
-- 1. 变更目的:为多公司(租户)场景引入主表 company,给 users 挂 company_id,并把现有全部
-- 账号归属「厦门米椿花」。业务表零 DDL——公司维度一律由 user_id → users.company_id 派生,
-- 不给 57 张业务表冗余 company_id(与"数据按账号归属、公司维度跟着账号走"的定案一致)。
-- 2. 影响表与数据量:company(新建,1 行);users(全表 UPDATE 一次,行数以生产实查为准——
-- aiimage.sql 快照的 AUTO_INCREMENT 有跳号,不等于行数);columns(+1 行后台菜单)。
-- 三张表都是百行量级,业务表 0 张受影响。
-- 3. 锁表风险:低。MySQL 8 的 ADD COLUMN 为 INSTANT;ADD INDEX 为 INPLACE;
-- MODIFY ... NOT NULL 触发 COPY 重建,但 users 只百行量级(毫秒级)。
-- 不碰 biz_task_file_job 等锁热点表。
-- 4. 验证 SQL:见文件末尾「验证」段。
-- 5. 回滚步骤:执行人工补丁脚本 docs/rollback-V143-company.sql(在 Flyway 扫描路径之外)。
-- 顺序:停两台应用 → 跑脚本 → 删 flyway_schema_history 的本版本行 → 回滚 jar → 起应用。
-- 6. 上线窗口:随 jar 双节点滚动发布,Flyway 在应用启动期执行,第二节点见"已应用"即跳过。
-- 建议业务低峰 02:00-06:00。
--
-- 【可重跑性】MySQL 的 DDL 不进事务。本迁移若在 NOT NULL 闸门处失败,前面的建表/插数/加列
-- 已经落库;按「补数据 → flyway repair → 重启」恢复时 Flyway 会从第一条语句重跑整个文件,
-- 所以每一条都写成幂等形式(IF NOT EXISTS / INSERT IGNORE / information_schema 条件 DDL /
-- WHERE 限定 / NOT EXISTS 守卫)。
-- =============================================================
-- ---------- 1. 公司(租户)主表 ----------
-- 与紫鸟语义的 company_name 字段(biz_ziniao_memory_store / biz_publish_file,自由文本无外键)
-- 不是同一回事,那两个保持原名不动。
CREATE TABLE IF NOT EXISTS `company` (
`id` bigint NOT NULL AUTO_INCREMENT COMMENT '主键',
`company_name` varchar(128) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL COMMENT '公司名称',
`status` tinyint NOT NULL DEFAULT 1 COMMENT '1=启用 0=停用',
`remark` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NULL DEFAULT NULL COMMENT '备注',
`created_at` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
`updated_at` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
PRIMARY KEY (`id`) USING BTREE,
UNIQUE INDEX `uk_company_name`(`company_name` ASC) USING BTREE,
INDEX `idx_company_status`(`status` ASC) USING BTREE
) ENGINE = InnoDB AUTO_INCREMENT = 2 CHARACTER SET = utf8mb4 COLLATE = utf8mb4_general_ci COMMENT = '公司(租户)主表' ROW_FORMAT = Dynamic;
-- id 显式钉为 1:下一步 users.company_id 的 DEFAULT 只能是字面量(MySQL 不允许 DEFAULT 子查询),
-- 存量回填也写死 = 1。id 若由 AUTO_INCREMENT 决定,这两处就会指向一个不存在的公司。
-- IGNORE 只为重跑服务:id 已钉死 + 公司名唯一,能撞上的只有一模一样的这一行。
INSERT IGNORE INTO `company` (`id`, `company_name`, `status`, `remark`)
VALUES (1, '厦门米椿花', 1, '初始公司:现有全部账号与数据归属');
-- ---------- 2. users 挂所属公司 ----------
SET @db_name = DATABASE();
SET @col_exists := (
SELECT COUNT(*) FROM information_schema.COLUMNS
WHERE TABLE_SCHEMA = @db_name AND TABLE_NAME = 'users' AND COLUMN_NAME = 'company_id'
);
-- 先建成可空:下一节的 UPDATE 才有行可回填,再靠 MODIFY 收成 NOT NULL。
-- 列与索引在同一条 ALTER 里,MySQL 保证整条原子,故只需按列存在性判一次。
SET @sql := IF(@col_exists = 0,
'ALTER TABLE `users` ADD COLUMN `company_id` bigint NULL DEFAULT NULL COMMENT ''所属公司(company.id)'' AFTER `created_by_id`, ADD INDEX `idx_users_company_id`(`company_id` ASC) USING BTREE',
'SELECT 1'
);
PREPARE stmt FROM @sql;
EXECUTE stmt;
DEALLOCATE PREPARE stmt;
-- ---------- 3. 存量账号全部归厦门米椿花 ----------
-- WHERE 限定 NULL,重跑时是 no-op;不会覆盖任何已经人工指定过公司的行。
UPDATE `users` SET `company_id` = 1 WHERE `company_id` IS NULL;
-- 自检闸门:上一句若漏掉任何一行,这里抛 ER_INVALID_USE_OF_NULL 让迁移失败,
-- 而不是留一堆 NULL 静默通过(NULL 意味着这些账号在公司维度上整体失明)。
--
-- DEFAULT 1 是【临时】的,唯一存在理由是混合版本窗口:发布期间一台新 jar、一台旧 jar,
-- /api 经主机 B 的 clb 打到两台,旧 jar 的 AdminUserService.create 不给 company_id 赋值,
-- 列若无 DEFAULT,严格模式报 "Field 'company_id' doesn't have a default value",
-- 打到旧节点的建号请求全失败。两台同版后新代码永远显式写 company_id,DEFAULT 变成死重,
-- 但必须在第二家公司开通前摘除——否则之后每个不传公司的建号都被静默塞进厦门米椿花。
-- 摘除时机由启动期巡检盯(见设计文档 §6.3),不在本迁移里处理。
ALTER TABLE `users`
MODIFY COLUMN `company_id` bigint NOT NULL DEFAULT 1 COMMENT '所属公司(company.id)';
-- ---------- 4. 后台「公司管理」菜单 ----------
-- 挂在「账号与权限」分组(admin_group_account,V103 建)下,与
-- admin_users→account/users、admin_group_manage→account/groups 同一命名口径(V109)。
-- route_path 必须与 admin-frontend-vue/src/router/routes.ts 的 path 逐字一致,否则菜单点进去 404。
-- sort_order 按同级最大值 +5 自算:现有子菜单的 sort_order 来自初始数据,从未被任何迁移设定过,
-- 写字面量等于猜。幂等写法照 V103/V106(columns.column_key 上有 uk_column_key,重复插会直接报错)。
INSERT INTO `columns` (`name`, `column_key`, `menu_type`, `route_path`, `sort_order`, `parent_id`)
SELECT '公司管理', 'admin_companies', 'admin', 'account/companies',
(SELECT COALESCE(MAX(sib.sort_order), 0) + 5
FROM `columns` sib
WHERE sib.parent_id = parent.id),
parent.id
FROM `columns` parent
WHERE parent.`column_key` = 'admin_group_account'
AND NOT EXISTS (SELECT 1 FROM `columns` x WHERE x.`column_key` = 'admin_companies');
-- =============================================================
-- 验证 SQL(迁移后在库上执行)
-- SELECT COUNT(*) AS company_rows FROM `company`;
-- -> 期望 1
-- SELECT `id`, `company_name`, `status` FROM `company`;
-- -> 期望 1 | 厦门米椿花 | 1(id 必须是 1,DEFAULT 1 与回填都指着它)
-- SELECT COUNT(*) AS users_total,
-- SUM(company_id IS NULL) AS null_company,
-- SUM(company_id = 1) AS in_xiamen_michunghua
-- FROM `users`;
-- -> 期望 null_company = 0 且 users_total = in_xiamen_michunghua
-- SHOW COLUMNS FROM `users` LIKE 'company_id';
-- -> 期望 Null = NO,Default = 1(Default 一旦不该再是 1,说明公司已 >1 家而临时 DEFAULT 未摘)
-- SHOW INDEX FROM `users` WHERE Key_name = 'idx_users_company_id';
-- -> 期望 1 行
-- SELECT c.`id`, c.`name`, c.`column_key`, c.`route_path`, c.`sort_order`, p.`column_key` AS parent_key
-- FROM `columns` c LEFT JOIN `columns` p ON p.`id` = c.`parent_id`
-- WHERE c.`column_key` = 'admin_companies';
-- -> 期望 1 行,parent_key = admin_group_account,route_path = account/companies
-- =============================================================