feat(workbench-client): 新增数富AI工作台客户端包管理独立更新渠道

后台上传安装包,confirm 阶段由服务端从 MinIO 实物流式复算 sha256 后落库,
客户端经 /api/workbench-client/version/latest 自动检查更新;与 ShuFuAI 桌面端
的 nanri-image/versions/ 渠道隔离,包体落 client 桶 workbench-client/versions/。
This commit is contained in:
2026-10-24 12:49:51 +08:00
parent b94555f411
commit ba20f5ed42
22 changed files with 1789 additions and 53 deletions
@@ -0,0 +1,100 @@
-- =============================================================
-- 迁移 V167__workbench_client_package
--
-- 1. 变更目的:新增「数富AI工作台客户端包管理」独立渠道。
-- - 新表 biz_workbench_client_package 存版本号、文件名、MinIO 对象 key、大小、sha256、上传时间。
-- - 包体落公开 client 桶 workbench-client/versions/ 前缀,与桌面端 ShuFuAI 的
-- nanri-image/versions/ 隔离;客户端从 /api/workbench-client/version/latest 自动检查更新。
-- - 后台菜单 column_key='admin_workbench_client_package',
-- route_path='records/workbench-client-package',挂在「记录与版本」组下,排序 83。
--
-- 2. 口径:
-- - 最新包按 created_at DESC, id DESC 取第一条(不设 is_latest 标记);删掉最新包后
-- 客户端下一次检查自动回落到上一版。
-- - sha256 NOT NULL:后台上传 confirm 阶段由服务端从 MinIO 实物流式复算,空值直接拒绝落库。
-- - 菜单 company_id=1 为模板树;其余公司(含停用公司)逐家复制,子行 parent_id 必须认
-- 本公司的 admin_group_record 组行,严禁跨公司认父(V149/V164 同一口径)。
-- - 本迁移不预授 user_column_permission:该页是管理/平台页(后端 requireAdmin),
-- 管理员后续在「菜单权限配置」里按公司分配可见性。
--
-- 3. 影响表与数据量:新表 1 张;columns +N 行(N=公司数)。字典小表,毫秒级。
--
-- 4. 【可重跑性】建表 IF NOT EXISTS;两段菜单 INSERT 带 NOT EXISTS 守卫;重跑逐条 no-op。
--
-- 5. 回滚(如需):
-- DELETE FROM columns WHERE column_key='admin_workbench_client_package';
-- DROP TABLE IF EXISTS biz_workbench_client_package;
-- =============================================================
CREATE TABLE IF NOT EXISTS `biz_workbench_client_package` (
`id` BIGINT NOT NULL AUTO_INCREMENT,
`version` VARCHAR(64) NOT NULL COMMENT '客户端版本号(客户端据此判断是否升级)',
`file_name` VARCHAR(255) NOT NULL COMMENT '原始 zip 文件名(展示用)',
`object_key` VARCHAR(512) NOT NULL COMMENT 'MinIO 对象 key(client 桶,workbench-client/versions/ 前缀)',
`file_size` BIGINT NOT NULL DEFAULT 0 COMMENT '文件字节数',
`sha256` VARCHAR(64) NOT NULL COMMENT '更新包 sha256(hex 小写),客户端下载后的完整性锚点',
`created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '上传时间;最新一条即客户端更新目标',
PRIMARY KEY (`id`),
UNIQUE KEY `uk_workbench_client_object_key` (`object_key`),
KEY `idx_workbench_client_created_at` (`created_at`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='数富AI工作台客户端安装/更新包';
-- ---------- 1. 公司 1 模板行(认公司 1 的 admin_group_record 组行) ----------
INSERT INTO `columns` (`name`, `column_key`, `menu_type`, `route_path`, `sort_order`, `parent_id`, `company_id`)
SELECT '工作台客户端包管理', 'admin_workbench_client_package', 'admin', 'records/workbench-client-package', 83, grp.`id`, 1
FROM `columns` grp
WHERE grp.`company_id` = 1 AND grp.`column_key` = 'admin_group_record'
AND NOT EXISTS (
SELECT 1 FROM `columns`
WHERE `company_id` = 1
AND (`column_key` = 'admin_workbench_client_package'
OR (`menu_type` = 'admin' AND `route_path` = 'records/workbench-client-package'))
);
-- ---------- 2. 复制到其余公司(含停用公司),各自认本公司组行 ----------
INSERT INTO `columns` (`name`, `column_key`, `menu_type`, `route_path`, `sort_order`, `parent_id`, `company_id`)
SELECT '工作台客户端包管理', 'admin_workbench_client_package', 'admin', 'records/workbench-client-package', 83, grp.`id`, c.`id`
FROM `company` c
JOIN `columns` grp ON grp.`company_id` = c.`id` AND grp.`column_key` = 'admin_group_record'
WHERE c.`id` <> 1
AND NOT EXISTS (
SELECT 1 FROM `columns` col
WHERE col.`company_id` = c.`id`
AND (col.`column_key` = 'admin_workbench_client_package'
OR (col.`menu_type` = 'admin' AND col.`route_path` = 'records/workbench-client-package'))
);
-- ---------- 3. 自检闸门:不为 0 就抛 1048(V143/V149/V164 家族) ----------
CREATE TEMPORARY TABLE IF NOT EXISTS `_v167_gate` (`must_be_zero` INT NOT NULL);
-- 闸门 1:每家公司都必须恰好一行 admin_workbench_client_package(少一家=那家管理员静默看不到)
INSERT INTO `_v167_gate`
SELECT IF(COUNT(*) = 0, 0, NULL)
FROM (
SELECT c.`id`
FROM `company` c
LEFT JOIN `columns` col ON col.`company_id` = c.`id` AND col.`column_key` = 'admin_workbench_client_package'
GROUP BY c.`id`
HAVING COUNT(col.`id`) <> 1
) bad;
-- 闸门 2:admin/records/workbench-client-package 路由不允许被别的 column_key 占行
INSERT INTO `_v167_gate`
SELECT IF(COUNT(*) = 0, 0, NULL)
FROM `columns` col
WHERE col.`menu_type` = 'admin'
AND col.`route_path` = 'records/workbench-client-package'
AND col.`column_key` <> 'admin_workbench_client_package';
-- 闸门 3:该菜单行的父必须是本公司的 admin_group_record 组行
INSERT INTO `_v167_gate`
SELECT IF(COUNT(*) = 0, 0, NULL)
FROM (
SELECT col.`id`
FROM `columns` col
LEFT JOIN `columns` grp ON grp.`id` = col.`parent_id` AND grp.`column_key` = 'admin_group_record'
WHERE col.`column_key` = 'admin_workbench_client_package'
AND (grp.`id` IS NULL OR grp.`company_id` <> col.`company_id`)
) bad;
DROP TEMPORARY TABLE `_v167_gate`;