迁移：新增业务菜单层级补丁

shierfeng-fastapi-backend/sql/patches/20260727_promote_business_menus_mysql.sql

@@ -0,0 +1,156 @@
+-- 本文件是人工执行的 MySQL 前向补丁，未自动执行。
+-- 执行前备份数据库，并在维护窗口使用独立连接运行标准 mysql batch。
+-- 旧状态和目标状态均可通过写前校验，因此本补丁可幂等重跑。
+-- 标准 mysql batch 遇错后必须退出并关闭连接，使未提交事务回滚；禁止使用 mysql --force。
+
+-- 在事务外准备六个固定菜单的稳定身份及完整旧/新层级状态。
+drop temporary table if exists promote_business_menus_expected;
+create temporary table promote_business_menus_expected (
+  menu_id bigint not null,
+  menu_name varchar(50) not null,
+  path varchar(200),
+  component varchar(255),
+  query varchar(255),
+  route_name varchar(50),
+  is_frame int,
+  is_cache int,
+  menu_type char(1),
+  visible char(1),
+  status char(1),
+  perms varchar(100),
+  icon varchar(100),
+  old_parent_id bigint not null,
+  old_order_num int not null,
+  new_parent_id bigint not null,
+  new_order_num int not null,
+  primary key (menu_id)
+) engine=innodb;
+
+insert into promote_business_menus_expected (
+  menu_id, menu_name, path, component, query, route_name,
+  is_frame, is_cache, menu_type, visible, status, perms, icon,
+  old_parent_id, old_order_num, new_parent_id, new_order_num
+) values
+(1, '系统管理', 'system', null, '', '', 1, 0, 'M', '0', '0', '', 'system', 0, 1, 0, 4),
+(2, '系统监控', 'monitor', null, '', '', 1, 0, 'M', '0', '0', '', 'monitor', 0, 2, 0, 5),
+(3, '系统工具', 'tool', null, '', '', 1, 0, 'M', '0', '0', '', 'tool', 0, 3, 0, 6),
+(121, '基础资料维护', 'businessMaster', null, '', '', 1, 0, 'M', '0', '0', '', '#', 1, 10, 0, 1),
+(122, '业务管理', 'businessOperation', null, '', '', 1, 0, 'M', '0', '0', '', '#', 1, 11, 0, 2),
+(123, '报表查询', 'businessReport', null, '', '', 1, 0, 'M', '0', '0', '', '#', 1, 12, 0, 3);
+
+drop temporary table if exists promote_business_menus_guard;
+create temporary table promote_business_menus_guard (
+  guard_token varchar(64) not null,
+  primary key (guard_token)
+) engine=innodb;
+
+start transaction;
+
+-- 锁定六个固定 ID，防止身份预检与永久更新之间被并发修改。
+select menu_id
+from sys_menu
+where menu_id in (1, 2, 3, 121, 122, 123)
+order by menu_id
+for update;
+
+-- 写前只接受六行全部处于旧状态或全部处于目标状态。
+-- 缺行、稳定身份漂移或新旧状态混合时，重复主键 token 会中止 batch。
+insert into promote_business_menus_guard (guard_token)
+select guard_token
+from (
+  select 'promote-business-menus-precondition-conflict' as guard_token
+  union all
+  select if(
+    count(actual.menu_id) = 6
+    and sum(
+      (binary actual.menu_name <=> binary expected.menu_name)
+      and (binary actual.path <=> binary expected.path)
+      and (binary actual.component <=> binary expected.component)
+      and (binary actual.query <=> binary expected.query)
+      and (binary actual.route_name <=> binary expected.route_name)
+      and (actual.is_frame <=> expected.is_frame)
+      and (actual.is_cache <=> expected.is_cache)
+      and (binary actual.menu_type <=> binary expected.menu_type)
+      and (binary actual.visible <=> binary expected.visible)
+      and (binary actual.status <=> binary expected.status)
+      and (binary actual.perms <=> binary expected.perms)
+      and (binary actual.icon <=> binary expected.icon)
+    ) = 6
+    and (
+      sum(
+        (actual.parent_id <=> expected.old_parent_id)
+        and (actual.order_num <=> expected.old_order_num)
+      ) = 6
+      or sum(
+        (actual.parent_id <=> expected.new_parent_id)
+        and (actual.order_num <=> expected.new_order_num)
+      ) = 6
+    ),
+    'promote-business-menus-precondition-verified',
+    'promote-business-menus-precondition-conflict'
+  ) as guard_token
+  from promote_business_menus_expected as expected
+  left join sys_menu as actual
+    on actual.menu_id = expected.menu_id
+) as precondition_guard_rows;
+
+-- 唯一永久 DML：只更新六个固定菜单的父级和显示顺序。
+update sys_menu
+set parent_id = case
+      when menu_id in (121, 122, 123) then 0
+      else parent_id
+    end,
+    order_num = case menu_id
+      when 121 then 1
+      when 122 then 2
+      when 123 then 3
+      when 1 then 4
+      when 2 then 5
+      when 3 then 6
+      else order_num
+    end
+where menu_id in (1, 2, 3, 121, 122, 123);
+
+-- 提交前再次核对六行稳定身份及完整目标状态。
+insert into promote_business_menus_guard (guard_token)
+select guard_token
+from (
+  select 'promote-business-menus-postcondition-conflict' as guard_token
+  union all
+  select if(
+    count(actual.menu_id) = 6
+    and sum(
+      (binary actual.menu_name <=> binary expected.menu_name)
+      and (binary actual.path <=> binary expected.path)
+      and (binary actual.component <=> binary expected.component)
+      and (binary actual.query <=> binary expected.query)
+      and (binary actual.route_name <=> binary expected.route_name)
+      and (actual.is_frame <=> expected.is_frame)
+      and (actual.is_cache <=> expected.is_cache)
+      and (binary actual.menu_type <=> binary expected.menu_type)
+      and (binary actual.visible <=> binary expected.visible)
+      and (binary actual.status <=> binary expected.status)
+      and (binary actual.perms <=> binary expected.perms)
+      and (binary actual.icon <=> binary expected.icon)
+    ) = 6
+    and sum(
+      (actual.parent_id <=> expected.new_parent_id)
+      and (actual.order_num <=> expected.new_order_num)
+    ) = 6,
+    'promote-business-menus-postcondition-verified',
+    'promote-business-menus-postcondition-conflict'
+  ) as guard_token
+  from promote_business_menus_expected as expected
+  left join sys_menu as actual
+    on actual.menu_id = expected.menu_id
+) as postcondition_guard_rows;
+
+commit;
+
+drop temporary table promote_business_menus_guard;
+drop temporary table promote_business_menus_expected;
+
+select menu_id, menu_name, parent_id, order_num, path, component, menu_type, visible, status, perms
+from sys_menu
+where menu_id in (1, 2, 3, 121, 122, 123)
+order by order_num, menu_id;