feat(device): 应用图标改存云存储并修复版本号唯一键冲突

sql/app_icon.sql

@@ -11,11 +11,16 @@
 -- 约定：
 --   - 同一 package_name 下 status=1（当前生效）的记录有且仅有一条
 --   - 历史版本（status=0）仅用于展示与选取锁定，不物理删除
---   - 图标文件按 {md5}.{ext} 内容寻址存储，访问路径由后端拼接为 /static/app_icon/{md5}.{ext}
---     （该前缀与 WebMvcConfig 注册的静态资源映射一致；内容变更必然导致文件名变更，故可长缓存）
+--   - 版本号生成规则（必须严格遵守）：
+--       version = 该 package_name 下所有记录的 MAX(version) + 1
+--     统计范围必须包含 is_deleted=1 的逻辑删除行，版本号只增不减、永不复用。
+--     原因：uk_package_version 不包含 is_deleted，若用「当前生效版本+1」或从 1 重新开始，
+--     当前生效记录被删除/缺失时会与残留版本号撞唯一键（Duplicate entry '包名-1'）。
+--   - 图标文件统一存入 storage.type 配置的存储（当前为阿里云 OSS），icon_url 为可直接访问的完整 URL
 --
 -- 部署规范：不直连库，由 DBA 执行；先 DROP 再 CREATE 确保结构与实体完全一致
 --           （DROP 会清空历史图标数据，可由设备端重新上报补齐）。
+-- 存量库修复：不重建表的场景，先执行 sql/app_icon_version_repair.sql 清理脏数据。
 -- =============================================================================
 
 DROP TABLE IF EXISTS `app_icon`;
@@ -25,11 +30,11 @@ CREATE TABLE `app_icon`
     `id`           BIGINT       NOT NULL AUTO_INCREMENT COMMENT '主键ID',
     `package_name` VARCHAR(255) NOT NULL COMMENT '应用包名（全局唯一维度，同包名多版本共存）',
     `app_name`     VARCHAR(128) DEFAULT NULL COMMENT '应用名称（上报时的展示名，可为空；新版本上报时刷新）',
-    `icon_url`     VARCHAR(500) NOT NULL COMMENT '图标访问地址（相对路径，如 /static/app_icon/{md5}.png）',
+    `icon_url`     VARCHAR(500) NOT NULL COMMENT '图标访问地址（存储服务返回的完整 URL）',
     `icon_md5`     VARCHAR(64)  DEFAULT NULL COMMENT '图标文件MD5（内容指纹，用于去重与换图标检测）',
     `icon_sha1`    VARCHAR(64)  DEFAULT NULL COMMENT '图标文件SHA1',
     `icon_sha256`  VARCHAR(64)  DEFAULT NULL COMMENT '图标文件SHA256',
-    `version`      INT          NOT NULL DEFAULT 1 COMMENT '版本号（同包名内自增，从1开始）',
+    `version`      INT          NOT NULL DEFAULT 1 COMMENT '版本号（同包名内自增，取所有记录含逻辑删除的 MAX(version)+1，不复用）',
     `status`       TINYINT      NOT NULL DEFAULT 1 COMMENT '状态（1当前生效 0历史版本）',
     `locked`       TINYINT      NOT NULL DEFAULT 0 COMMENT '是否锁定（0未锁定 1已锁定，锁定后不可上传覆盖）',
     `source`       VARCHAR(20)  NOT NULL DEFAULT 'device' COMMENT '图标来源（device设备端上报 admin管理端上传）',