feat(taskcenter): V138 客户端任务管理迁移与设计文档

biz_file_task / brand_crawl_tasks 补 device_id 列(JWT 签名 claim,历史任务留空),
并挂载 admin_task_center 菜单:只写 columns 不写 user_column_permission,
管理员默认不可见,超管授权后可见。
This commit is contained in:
2026-09-28 22:33:49 +08:00
parent d087b0ff49
commit 0a7e1b9c01
3 changed files with 253 additions and 4 deletions
+4 -4
View File
@@ -1,14 +1,14 @@
# Flyway 迁移盘点(task-193)
> 生成方式:`src/test/java/com/nanri/aiimage/config/MigrationInventoryTest.java`(只读审计,可重复)。
> 快照日期:2026-09-27。
> 快照日期:2026-09-28。
## 概览
- 版本化迁移文件数:**136**(`src/main/resources/db/V*.sql`)
- 整数版本范围:**V1..V137**,其中 V132/V133 为已退役空号(见下),其余连续
- 版本化迁移文件数:**137**(`src/main/resources/db/V*.sql`)
- 整数版本范围:**V1..V138**,其中 V132/V133 为已退役空号(见下),其余连续
- 历史遗留小版本:**V25_1__shop_manage_group_bind_user.sql**(Flyway 语义 25.1,紧跟在 V25 之后、V26 之前执行,属历史命名,保留)
- 最新版本:**V137__hide_redundant_indexes_invisible.sql**
- 最新版本:**V138__client_task_console.sql**
- 重复版本:无
- 迁移命名:全部符合 `V<整数>(_<子版本>)?__<描述>.sql`,无空格
@@ -0,0 +1,61 @@
-- V138: 客户端任务管理(后台看板)—— 任务设备号 + 菜单
--
-- 设备号取自 JWT 签名的 deviceId claim(AdminAuthSupport.currentDeviceId),由各模块
-- 创建入口显式落库(方法参数从 controller 传入);历史任务为 NULL(界面显示「未记录」,不回填)。
-- 品牌检测任务自建 brand_crawl_tasks 表、不写 biz_file_task,故同样补列。
--
-- 菜单:只插 columns、不写 user_column_permission —— 管理员默认不可见(无授权记录即看不到),
-- 超管直通;超管在「用户管理 → 菜单权限」授权后管理员可见。
--
-- 幂等:列/索引/菜单行均仅当不存在时创建,重复执行安全。
-- 回滚(手工):
-- ALTER TABLE biz_file_task DROP KEY idx_file_task_device_created, DROP COLUMN device_id;
-- ALTER TABLE brand_crawl_tasks DROP COLUMN device_id;
-- DELETE FROM columns WHERE column_key = 'admin_task_center';
SET @db_name = DATABASE();
SET @col_exists := (
SELECT COUNT(*) FROM information_schema.COLUMNS
WHERE TABLE_SCHEMA = @db_name AND TABLE_NAME = 'biz_file_task' AND COLUMN_NAME = 'device_id'
);
SET @sql := IF(@col_exists = 0,
'ALTER TABLE biz_file_task ADD COLUMN device_id VARCHAR(128) NULL COMMENT ''device from signed JWT deviceId claim'' AFTER user_id',
'SELECT 1'
);
PREPARE stmt FROM @sql;
EXECUTE stmt;
DEALLOCATE PREPARE stmt;
SET @idx_exists := (
SELECT COUNT(*) FROM information_schema.STATISTICS
WHERE TABLE_SCHEMA = @db_name AND TABLE_NAME = 'biz_file_task' AND INDEX_NAME = 'idx_file_task_device_created'
);
SET @sql := IF(@idx_exists = 0,
'ALTER TABLE biz_file_task ADD KEY idx_file_task_device_created (device_id, created_at)',
'SELECT 1'
);
PREPARE stmt FROM @sql;
EXECUTE stmt;
DEALLOCATE PREPARE stmt;
SET @col_exists := (
SELECT COUNT(*) FROM information_schema.COLUMNS
WHERE TABLE_SCHEMA = @db_name AND TABLE_NAME = 'brand_crawl_tasks' AND COLUMN_NAME = 'device_id'
);
SET @sql := IF(@col_exists = 0,
'ALTER TABLE brand_crawl_tasks ADD COLUMN device_id VARCHAR(128) NULL COMMENT ''device from signed JWT deviceId claim'' AFTER user_id',
'SELECT 1'
);
PREPARE stmt FROM @sql;
EXECUTE stmt;
DEALLOCATE PREPARE stmt;
-- 后台菜单:客户端任务管理(挂在「记录与版本」分组下;幂等,仅当 column_key 不存在时插入)
INSERT INTO columns (name, column_key, menu_type, route_path, sort_order, parent_id)
SELECT '客户端任务管理', 'admin_task_center', 'admin', 'task-center/board', 84, parent.id
FROM columns parent
WHERE parent.column_key = 'admin_group_record'
AND NOT EXISTS (
SELECT 1 FROM columns WHERE column_key = 'admin_task_center'
);