refactor(system): 用户头像预签名改为 @OssPresignUrl 声明式处理

在 AuthPermissionInfoRespVO、OAuth2UserInfoRespVO、UserProfileRespVO、 UserRespVO 的 avatar 字段添加 @OssPresignUrl 注解，移除 AuthController、OAuth2UserController、UserController、 UserProfileController 中手动调用 fileApi.presignGetUrl 的代码， Controller 回归薄层职责。 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-18 15:06:43 +08:00
parent ff153dd1a9
commit 78aba0d1ed
9 changed files with 608 additions and 636 deletions
--- a/viewsh-module-system/viewsh-module-system-server/src/main/java/com/viewsh/module/system/controller/admin/auth/AuthController.java
+++ b/viewsh-module-system/viewsh-module-system-server/src/main/java/com/viewsh/module/system/controller/admin/auth/AuthController.java
@@ -7,7 +7,6 @@ import com.viewsh.framework.common.enums.UserTypeEnum;
 import com.viewsh.framework.common.pojo.CommonResult;
 import com.viewsh.framework.security.config.SecurityProperties;
 import com.viewsh.framework.security.core.util.SecurityFrameworkUtils;
-import com.viewsh.module.infra.api.file.FileApi;
 import com.viewsh.module.system.controller.admin.auth.vo.*;
 import com.viewsh.module.system.convert.auth.AuthConvert;
 import com.viewsh.module.system.dal.dataobject.permission.MenuDO;
@@ -62,8 +61,6 @@ public class AuthController {

    @Resource
    private SecurityProperties securityProperties;
-    @Resource
-    private FileApi fileApi;

    @PostMapping("/login")
    @PermitAll
@@ -115,12 +112,7 @@ public class AuthController {
        menuList = menuService.filterDisableMenus(menuList);

        // 2. 拼接结果返回
-        AuthPermissionInfoRespVO respVO = AuthConvert.INSTANCE.convert(user, roles, menuList);
-        // 私有桶：对头像 URL 生成预签名访问地址
-        if (respVO.getUser() != null && StrUtil.isNotEmpty(respVO.getUser().getAvatar())) {
-            respVO.getUser().setAvatar(fileApi.presignGetUrl(respVO.getUser().getAvatar(), null).getCheckedData());
-        }
-        return success(respVO);
+        return success(AuthConvert.INSTANCE.convert(user, roles, menuList));
    }

    @PostMapping("/register")
--- a/viewsh-module-system/viewsh-module-system-server/src/main/java/com/viewsh/module/system/controller/admin/auth/vo/AuthPermissionInfoRespVO.java
+++ b/viewsh-module-system/viewsh-module-system-server/src/main/java/com/viewsh/module/system/controller/admin/auth/vo/AuthPermissionInfoRespVO.java
@@ -1,102 +1,104 @@
-package com.viewsh.module.system.controller.admin.auth.vo;
-
-import io.swagger.v3.oas.annotations.media.Schema;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Data;
-import lombok.NoArgsConstructor;
-
-import java.util.List;
-import java.util.Set;
-
-@Schema(description = "管理后台 - 登录用户的权限信息 Response VO，额外包括用户信息和角色列表")
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-public class AuthPermissionInfoRespVO {
-
-    @Schema(description = "用户信息", requiredMode = Schema.RequiredMode.REQUIRED)
-    private UserVO user;
-
-    @Schema(description = "角色标识数组", requiredMode = Schema.RequiredMode.REQUIRED)
-    private Set<String> roles;
-
-    @Schema(description = "操作权限数组", requiredMode = Schema.RequiredMode.REQUIRED)
-    private Set<String> permissions;
-
-    @Schema(description = "菜单树", requiredMode = Schema.RequiredMode.REQUIRED)
-    private List<MenuVO> menus;
-
-    @Schema(description = "用户信息 VO")
-    @Data
-    @NoArgsConstructor
-    @AllArgsConstructor
-    @Builder
-    public static class UserVO {
-
-        @Schema(description = "用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
-        private Long id;
-
-        @Schema(description = "用户昵称", requiredMode = Schema.RequiredMode.REQUIRED, example = "芋道源码")
-        private String nickname;
-
-        @Schema(description = "用户头像", requiredMode = Schema.RequiredMode.REQUIRED, example = "https://www.iocoder.cn/xx.jpg")
-        private String avatar;
-
-        @Schema(description = "部门编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "2048")
-        private Long deptId;
-
-        @Schema(description = "用户账号", requiredMode = Schema.RequiredMode.REQUIRED, example = "viewsh")
-        private String username;
-
-        @Schema(description = "用户邮箱", example = "viewsh@iocoder.cn")
-        private String email;
-
-    }
-
-    @Schema(description = "管理后台 - 登录用户的菜单信息 Response VO")
-    @Data
-    @NoArgsConstructor
-    @AllArgsConstructor
-    @Builder
-    public static class MenuVO {
-
-        @Schema(description = "菜单名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "芋道")
-        private Long id;
-
-        @Schema(description = "父菜单 ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
-        private Long parentId;
-
-        @Schema(description = "菜单名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "芋道")
-        private String name;
-
-        @Schema(description = "路由地址,仅菜单类型为菜单或者目录时，才需要传", example = "post")
-        private String path;
-
-        @Schema(description = "组件路径,仅菜单类型为菜单时，才需要传", example = "system/post/index")
-        private String component;
-
-        @Schema(description = "组件名", example = "SystemUser")
-        private String componentName;
-
-        @Schema(description = "菜单图标,仅菜单类型为菜单或者目录时，才需要传", example = "/menu/list")
-        private String icon;
-
-        @Schema(description = "是否可见", requiredMode = Schema.RequiredMode.REQUIRED, example = "false")
-        private Boolean visible;
-
-        @Schema(description = "是否缓存", requiredMode = Schema.RequiredMode.REQUIRED, example = "false")
-        private Boolean keepAlive;
-
-        @Schema(description = "是否总是显示", example = "false")
-        private Boolean alwaysShow;
-
-        /**
-         * 子路由
-         */
-        private List<MenuVO> children;
-
-    }
-
-}
+package com.viewsh.module.system.controller.admin.auth.vo;
+
+import com.viewsh.framework.web.core.presign.annotation.OssPresignUrl;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.util.List;
+import java.util.Set;
+
+@Schema(description = "管理后台 - 登录用户的权限信息 Response VO，额外包括用户信息和角色列表")
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class AuthPermissionInfoRespVO {
+
+    @Schema(description = "用户信息", requiredMode = Schema.RequiredMode.REQUIRED)
+    private UserVO user;
+
+    @Schema(description = "角色标识数组", requiredMode = Schema.RequiredMode.REQUIRED)
+    private Set<String> roles;
+
+    @Schema(description = "操作权限数组", requiredMode = Schema.RequiredMode.REQUIRED)
+    private Set<String> permissions;
+
+    @Schema(description = "菜单树", requiredMode = Schema.RequiredMode.REQUIRED)
+    private List<MenuVO> menus;
+
+    @Schema(description = "用户信息 VO")
+    @Data
+    @NoArgsConstructor
+    @AllArgsConstructor
+    @Builder
+    public static class UserVO {
+
+        @Schema(description = "用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+        private Long id;
+
+        @Schema(description = "用户昵称", requiredMode = Schema.RequiredMode.REQUIRED, example = "芋道源码")
+        private String nickname;
+
+        @Schema(description = "用户头像", requiredMode = Schema.RequiredMode.REQUIRED, example = "https://www.iocoder.cn/xx.jpg")
+        @OssPresignUrl
+        private String avatar;
+
+        @Schema(description = "部门编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "2048")
+        private Long deptId;
+
+        @Schema(description = "用户账号", requiredMode = Schema.RequiredMode.REQUIRED, example = "viewsh")
+        private String username;
+
+        @Schema(description = "用户邮箱", example = "viewsh@iocoder.cn")
+        private String email;
+
+    }
+
+    @Schema(description = "管理后台 - 登录用户的菜单信息 Response VO")
+    @Data
+    @NoArgsConstructor
+    @AllArgsConstructor
+    @Builder
+    public static class MenuVO {
+
+        @Schema(description = "菜单名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "芋道")
+        private Long id;
+
+        @Schema(description = "父菜单 ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+        private Long parentId;
+
+        @Schema(description = "菜单名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "芋道")
+        private String name;
+
+        @Schema(description = "路由地址,仅菜单类型为菜单或者目录时，才需要传", example = "post")
+        private String path;
+
+        @Schema(description = "组件路径,仅菜单类型为菜单时，才需要传", example = "system/post/index")
+        private String component;
+
+        @Schema(description = "组件名", example = "SystemUser")
+        private String componentName;
+
+        @Schema(description = "菜单图标,仅菜单类型为菜单或者目录时，才需要传", example = "/menu/list")
+        private String icon;
+
+        @Schema(description = "是否可见", requiredMode = Schema.RequiredMode.REQUIRED, example = "false")
+        private Boolean visible;
+
+        @Schema(description = "是否缓存", requiredMode = Schema.RequiredMode.REQUIRED, example = "false")
+        private Boolean keepAlive;
+
+        @Schema(description = "是否总是显示", example = "false")
+        private Boolean alwaysShow;
+
+        /**
+         * 子路由
+         */
+        private List<MenuVO> children;
+
+    }
+
+}
--- a/viewsh-module-system/viewsh-module-system-server/src/main/java/com/viewsh/module/system/controller/admin/oauth2/OAuth2UserController.java
+++ b/viewsh-module-system/viewsh-module-system-server/src/main/java/com/viewsh/module/system/controller/admin/oauth2/OAuth2UserController.java
@@ -1,10 +1,8 @@
 package com.viewsh.module.system.controller.admin.oauth2;

 import cn.hutool.core.collection.CollUtil;
-import cn.hutool.core.util.StrUtil;
 import com.viewsh.framework.common.pojo.CommonResult;
 import com.viewsh.framework.common.util.object.BeanUtils;
-import com.viewsh.module.infra.api.file.FileApi;
 import com.viewsh.module.system.controller.admin.oauth2.vo.user.OAuth2UserInfoRespVO;
 import com.viewsh.module.system.controller.admin.oauth2.vo.user.OAuth2UserUpdateReqVO;
 import com.viewsh.module.system.controller.admin.user.vo.profile.UserProfileUpdateReqVO;
@@ -49,8 +47,6 @@ public class OAuth2UserController {
    private DeptService deptService;
    @Resource
    private PostService postService;
-    @Resource
-    private FileApi fileApi;

    @GetMapping("/get")
    @Operation(summary = "获得用户基本信息")
@@ -69,10 +65,6 @@ public class OAuth2UserController {
            List<PostDO> posts = postService.getPostList(user.getPostIds());
            resp.setPosts(BeanUtils.toBean(posts, OAuth2UserInfoRespVO.Post.class));
        }
-        // 私有桶：对头像 URL 生成预签名访问地址
-        if (StrUtil.isNotEmpty(resp.getAvatar())) {
-            resp.setAvatar(fileApi.presignGetUrl(resp.getAvatar(), null).getCheckedData());
-        }
        return success(resp);
    }

--- a/viewsh-module-system/viewsh-module-system-server/src/main/java/com/viewsh/module/system/controller/admin/oauth2/vo/user/OAuth2UserInfoRespVO.java
+++ b/viewsh-module-system/viewsh-module-system-server/src/main/java/com/viewsh/module/system/controller/admin/oauth2/vo/user/OAuth2UserInfoRespVO.java
@@ -1,70 +1,72 @@
-package com.viewsh.module.system.controller.admin.oauth2.vo.user;
-
-import io.swagger.v3.oas.annotations.media.Schema;
-import lombok.AllArgsConstructor;
-import lombok.Data;
-import lombok.NoArgsConstructor;
-
-import java.util.List;
-
-@Schema(description = "管理后台 - OAuth2 获得用户基本信息 Response VO")
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-public class OAuth2UserInfoRespVO {
-
-    @Schema(description = "用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
-    private Long id;
-
-    @Schema(description = "用户账号", requiredMode = Schema.RequiredMode.REQUIRED, example = "芋艿")
-    private String username;
-
-    @Schema(description = "用户昵称", requiredMode = Schema.RequiredMode.REQUIRED, example = "芋道")
-    private String nickname;
-
-    @Schema(description = "用户邮箱", example = "viewsh@iocoder.cn")
-    private String email;
-    @Schema(description = "手机号码", example = "15601691300")
-    private String mobile;
-
-    @Schema(description = "用户性别，参见 SexEnum 枚举类", example = "1")
-    private Integer sex;
-
-    @Schema(description = "用户头像", example = "https://www.iocoder.cn/xxx.png")
-    private String avatar;
-
-    /**
-     * 所在部门
-     */
-    private Dept dept;
-
-    /**
-     * 所属岗位数组
-     */
-    private List<Post> posts;
-
-    @Schema(description = "部门")
-    @Data
-    public static class Dept {
-
-        @Schema(description = "部门编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
-        private Long id;
-
-        @Schema(description = "部门名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "研发部")
-        private String name;
-
-    }
-
-    @Schema(description = "岗位")
-    @Data
-    public static class Post {
-
-        @Schema(description = "岗位编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
-        private Long id;
-
-        @Schema(description = "岗位名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "开发")
-        private String name;
-
-    }
-
-}
+package com.viewsh.module.system.controller.admin.oauth2.vo.user;
+
+import com.viewsh.framework.web.core.presign.annotation.OssPresignUrl;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - OAuth2 获得用户基本信息 Response VO")
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+public class OAuth2UserInfoRespVO {
+
+    @Schema(description = "用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Long id;
+
+    @Schema(description = "用户账号", requiredMode = Schema.RequiredMode.REQUIRED, example = "芋艿")
+    private String username;
+
+    @Schema(description = "用户昵称", requiredMode = Schema.RequiredMode.REQUIRED, example = "芋道")
+    private String nickname;
+
+    @Schema(description = "用户邮箱", example = "viewsh@iocoder.cn")
+    private String email;
+    @Schema(description = "手机号码", example = "15601691300")
+    private String mobile;
+
+    @Schema(description = "用户性别，参见 SexEnum 枚举类", example = "1")
+    private Integer sex;
+
+    @Schema(description = "用户头像", example = "https://www.iocoder.cn/xxx.png")
+    @OssPresignUrl
+    private String avatar;
+
+    /**
+     * 所在部门
+     */
+    private Dept dept;
+
+    /**
+     * 所属岗位数组
+     */
+    private List<Post> posts;
+
+    @Schema(description = "部门")
+    @Data
+    public static class Dept {
+
+        @Schema(description = "部门编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+        private Long id;
+
+        @Schema(description = "部门名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "研发部")
+        private String name;
+
+    }
+
+    @Schema(description = "岗位")
+    @Data
+    public static class Post {
+
+        @Schema(description = "岗位编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+        private Long id;
+
+        @Schema(description = "岗位名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "开发")
+        private String name;
+
+    }
+
+}
--- a/viewsh-module-system/viewsh-module-system-server/src/main/java/com/viewsh/module/system/controller/admin/user/UserController.java
+++ b/viewsh-module-system/viewsh-module-system-server/src/main/java/com/viewsh/module/system/controller/admin/user/UserController.java
@@ -1,14 +1,12 @@
 package com.viewsh.module.system.controller.admin.user;

 import cn.hutool.core.collection.CollUtil;
-import cn.hutool.core.util.StrUtil;
 import com.viewsh.framework.apilog.core.annotation.ApiAccessLog;
 import com.viewsh.framework.common.enums.CommonStatusEnum;
 import com.viewsh.framework.common.pojo.CommonResult;
 import com.viewsh.framework.common.pojo.PageParam;
 import com.viewsh.framework.common.pojo.PageResult;
 import com.viewsh.framework.excel.core.util.ExcelUtils;
-import com.viewsh.module.infra.api.file.FileApi;
 import com.viewsh.module.system.controller.admin.user.vo.user.*;
 import com.viewsh.module.system.convert.user.UserConvert;
 import com.viewsh.module.system.dal.dataobject.dept.DeptDO;
@@ -47,8 +45,6 @@ public class UserController {
    private AdminUserService userService;
    @Resource
    private DeptService deptService;
-    @Resource
-    private FileApi fileApi;

    @PostMapping("/create")
    @Operation(summary = "新增用户")
@@ -113,12 +109,6 @@ public class UserController {
        Map<Long, DeptDO> deptMap = deptService.getDeptMap(
                convertList(pageResult.getList(), AdminUserDO::getDeptId));
        List<UserRespVO> userList = UserConvert.INSTANCE.convertList(pageResult.getList(), deptMap);
-        // 私有桶：对头像 URL 生成预签名访问地址
-        userList.forEach(vo -> {
-            if (StrUtil.isNotEmpty(vo.getAvatar())) {
-                vo.setAvatar(fileApi.presignGetUrl(vo.getAvatar(), null).getCheckedData());
-            }
-        });
        return success(new PageResult<>(userList, pageResult.getTotal()));
    }

@@ -143,12 +133,7 @@ public class UserController {
        }
        // 拼接数据
        DeptDO dept = deptService.getDept(user.getDeptId());
-        UserRespVO respVO = UserConvert.INSTANCE.convert(user, dept);
-        // 私有桶：对头像 URL 生成预签名访问地址
-        if (StrUtil.isNotEmpty(respVO.getAvatar())) {
-            respVO.setAvatar(fileApi.presignGetUrl(respVO.getAvatar(), null).getCheckedData());
-        }
-        return success(respVO);
+        return success(UserConvert.INSTANCE.convert(user, dept));
    }

    @GetMapping("/export-excel")
--- a/viewsh-module-system/viewsh-module-system-server/src/main/java/com/viewsh/module/system/controller/admin/user/UserProfileController.java
+++ b/viewsh-module-system/viewsh-module-system-server/src/main/java/com/viewsh/module/system/controller/admin/user/UserProfileController.java
@@ -5,7 +5,6 @@ import cn.hutool.core.util.StrUtil;
 import com.viewsh.framework.common.pojo.CommonResult;
 import com.viewsh.framework.common.util.http.HttpUtils;
 import com.viewsh.framework.datapermission.core.annotation.DataPermission;
-import com.viewsh.module.infra.api.file.FileApi;
 import com.viewsh.module.system.controller.admin.user.vo.profile.UserProfileRespVO;
 import com.viewsh.module.system.controller.admin.user.vo.profile.UserProfileUpdatePasswordReqVO;
 import com.viewsh.module.system.controller.admin.user.vo.profile.UserProfileUpdateReqVO;
@@ -49,8 +48,6 @@ public class UserProfileController {
    private PermissionService permissionService;
    @Resource
    private RoleService roleService;
-    @Resource
-    private FileApi fileApi;

    @GetMapping("/get")
    @Operation(summary = "获得登录用户信息")
@@ -64,12 +61,7 @@ public class UserProfileController {
        DeptDO dept = user.getDeptId() != null ? deptService.getDept(user.getDeptId()) : null;
        // 获得岗位信息
        List<PostDO> posts = CollUtil.isNotEmpty(user.getPostIds()) ? postService.getPostList(user.getPostIds()) : null;
-        UserProfileRespVO respVO = UserConvert.INSTANCE.convert(user, userRoles, dept, posts);
-        // 私有桶：对头像 URL 生成预签名访问地址
-        if (StrUtil.isNotEmpty(respVO.getAvatar())) {
-            respVO.setAvatar(fileApi.presignGetUrl(respVO.getAvatar(), null).getCheckedData());
-        }
-        return success(respVO);
+        return success(UserConvert.INSTANCE.convert(user, userRoles, dept, posts));
    }

    @PutMapping("/update")
--- a/viewsh-module-system/viewsh-module-system-server/src/main/java/com/viewsh/module/system/controller/admin/user/vo/profile/UserProfileRespVO.java
+++ b/viewsh-module-system/viewsh-module-system-server/src/main/java/com/viewsh/module/system/controller/admin/user/vo/profile/UserProfileRespVO.java
@@ -1,59 +1,61 @@
-package com.viewsh.module.system.controller.admin.user.vo.profile;
-
-import com.viewsh.module.system.controller.admin.dept.vo.dept.DeptSimpleRespVO;
-import com.viewsh.module.system.controller.admin.dept.vo.post.PostSimpleRespVO;
-import com.viewsh.module.system.controller.admin.permission.vo.role.RoleSimpleRespVO;
-import io.swagger.v3.oas.annotations.media.Schema;
-import lombok.Data;
-
-import java.time.LocalDateTime;
-import java.util.List;
-
-@Data
-@Schema(description = "管理后台 - 用户个人中心信息 Response VO")
-public class UserProfileRespVO {
-
-    @Schema(description = "用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
-    private Long id;
-
-    @Schema(description = "用户账号", requiredMode = Schema.RequiredMode.REQUIRED, example = "viewsh")
-    private String username;
-
-    @Schema(description = "用户昵称", requiredMode = Schema.RequiredMode.REQUIRED, example = "芋艿")
-    private String nickname;
-
-    @Schema(description = "用户邮箱", example = "viewsh@iocoder.cn")
-    private String email;
-
-    @Schema(description = "手机号码", example = "15601691300")
-    private String mobile;
-
-    @Schema(description = "用户性别，参见 SexEnum 枚举类", example = "1")
-    private Integer sex;
-
-    @Schema(description = "用户头像", example = "https://www.iocoder.cn/xxx.png")
-    private String avatar;
-
-    @Schema(description = "最后登录 IP", requiredMode = Schema.RequiredMode.REQUIRED, example = "192.168.1.1")
-    private String loginIp;
-
-    @Schema(description = "最后登录时间", requiredMode = Schema.RequiredMode.REQUIRED, example = "时间戳格式")
-    private LocalDateTime loginDate;
-
-    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED, example = "时间戳格式")
-    private LocalDateTime createTime;
-
-    /**
-     * 所属角色
-     */
-    private List<RoleSimpleRespVO> roles;
-    /**
-     * 所在部门
-     */
-    private DeptSimpleRespVO dept;
-    /**
-     * 所属岗位数组
-     */
-    private List<PostSimpleRespVO> posts;
-
-}
+package com.viewsh.module.system.controller.admin.user.vo.profile;
+
+import com.viewsh.framework.web.core.presign.annotation.OssPresignUrl;
+import com.viewsh.module.system.controller.admin.dept.vo.dept.DeptSimpleRespVO;
+import com.viewsh.module.system.controller.admin.dept.vo.post.PostSimpleRespVO;
+import com.viewsh.module.system.controller.admin.permission.vo.role.RoleSimpleRespVO;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Data
+@Schema(description = "管理后台 - 用户个人中心信息 Response VO")
+public class UserProfileRespVO {
+
+    @Schema(description = "用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Long id;
+
+    @Schema(description = "用户账号", requiredMode = Schema.RequiredMode.REQUIRED, example = "viewsh")
+    private String username;
+
+    @Schema(description = "用户昵称", requiredMode = Schema.RequiredMode.REQUIRED, example = "芋艿")
+    private String nickname;
+
+    @Schema(description = "用户邮箱", example = "viewsh@iocoder.cn")
+    private String email;
+
+    @Schema(description = "手机号码", example = "15601691300")
+    private String mobile;
+
+    @Schema(description = "用户性别，参见 SexEnum 枚举类", example = "1")
+    private Integer sex;
+
+    @Schema(description = "用户头像", example = "https://www.iocoder.cn/xxx.png")
+    @OssPresignUrl
+    private String avatar;
+
+    @Schema(description = "最后登录 IP", requiredMode = Schema.RequiredMode.REQUIRED, example = "192.168.1.1")
+    private String loginIp;
+
+    @Schema(description = "最后登录时间", requiredMode = Schema.RequiredMode.REQUIRED, example = "时间戳格式")
+    private LocalDateTime loginDate;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED, example = "时间戳格式")
+    private LocalDateTime createTime;
+
+    /**
+     * 所属角色
+     */
+    private List<RoleSimpleRespVO> roles;
+    /**
+     * 所在部门
+     */
+    private DeptSimpleRespVO dept;
+    /**
+     * 所属岗位数组
+     */
+    private List<PostSimpleRespVO> posts;
+
+}
--- a/viewsh-module-system/viewsh-module-system-server/src/main/java/com/viewsh/module/system/controller/admin/user/vo/user/UserRespVO.java
+++ b/viewsh-module-system/viewsh-module-system-server/src/main/java/com/viewsh/module/system/controller/admin/user/vo/user/UserRespVO.java
@@ -1,75 +1,77 @@
-package com.viewsh.module.system.controller.admin.user.vo.user;
-
-import com.viewsh.framework.excel.core.annotations.DictFormat;
-import com.viewsh.framework.excel.core.convert.DictConvert;
-import com.viewsh.module.system.enums.DictTypeConstants;
-import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
-import cn.idev.excel.annotation.ExcelProperty;
-import io.swagger.v3.oas.annotations.media.Schema;
-import lombok.Data;
-
-import java.time.LocalDateTime;
-import java.util.Set;
-
-@Schema(description = "管理后台 - 用户信息 Response VO")
-@Data
-@ExcelIgnoreUnannotated
-public class UserRespVO{
-
-    @Schema(description = "用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
-    @ExcelProperty("用户编号")
-    private Long id;
-
-    @Schema(description = "用户账号", requiredMode = Schema.RequiredMode.REQUIRED, example = "viewsh")
-    @ExcelProperty("用户名称")
-    private String username;
-
-    @Schema(description = "用户昵称", requiredMode = Schema.RequiredMode.REQUIRED, example = "芋艿")
-    @ExcelProperty("用户昵称")
-    private String nickname;
-
-    @Schema(description = "备注", example = "我是一个用户")
-    private String remark;
-
-    @Schema(description = "部门ID", example = "我是一个用户")
-    private Long deptId;
-    @Schema(description = "部门名称", example = "IT 部")
-    @ExcelProperty("部门名称")
-    private String deptName;
-
-    @Schema(description = "岗位编号数组", example = "1")
-    private Set<Long> postIds;
-
-    @Schema(description = "用户邮箱", example = "viewsh@iocoder.cn")
-    @ExcelProperty("用户邮箱")
-    private String email;
-
-    @Schema(description = "手机号码", example = "15601691300")
-    @ExcelProperty("手机号码")
-    private String mobile;
-
-    @Schema(description = "用户性别，参见 SexEnum 枚举类", example = "1")
-    @ExcelProperty(value = "用户性别", converter = DictConvert.class)
-    @DictFormat(DictTypeConstants.USER_SEX)
-    private Integer sex;
-
-    @Schema(description = "用户头像", example = "https://www.iocoder.cn/xxx.png")
-    private String avatar;
-
-    @Schema(description = "状态，参见 CommonStatusEnum 枚举类", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
-    @ExcelProperty(value = "帐号状态", converter = DictConvert.class)
-    @DictFormat(DictTypeConstants.COMMON_STATUS)
-    private Integer status;
-
-    @Schema(description = "最后登录 IP", requiredMode = Schema.RequiredMode.REQUIRED, example = "192.168.1.1")
-    @ExcelProperty("最后登录IP")
-    private String loginIp;
-
-    @Schema(description = "最后登录时间", requiredMode = Schema.RequiredMode.REQUIRED, example = "时间戳格式")
-    @ExcelProperty("最后登录时间")
-    private LocalDateTime loginDate;
-
-    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED, example = "时间戳格式")
-    private LocalDateTime createTime;
-
-}
+package com.viewsh.module.system.controller.admin.user.vo.user;
+
+import com.viewsh.framework.excel.core.annotations.DictFormat;
+import com.viewsh.framework.excel.core.convert.DictConvert;
+import com.viewsh.framework.web.core.presign.annotation.OssPresignUrl;
+import com.viewsh.module.system.enums.DictTypeConstants;
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+import java.util.Set;
+
+@Schema(description = "管理后台 - 用户信息 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class UserRespVO{
+
+    @Schema(description = "用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @ExcelProperty("用户编号")
+    private Long id;
+
+    @Schema(description = "用户账号", requiredMode = Schema.RequiredMode.REQUIRED, example = "viewsh")
+    @ExcelProperty("用户名称")
+    private String username;
+
+    @Schema(description = "用户昵称", requiredMode = Schema.RequiredMode.REQUIRED, example = "芋艿")
+    @ExcelProperty("用户昵称")
+    private String nickname;
+
+    @Schema(description = "备注", example = "我是一个用户")
+    private String remark;
+
+    @Schema(description = "部门ID", example = "我是一个用户")
+    private Long deptId;
+    @Schema(description = "部门名称", example = "IT 部")
+    @ExcelProperty("部门名称")
+    private String deptName;
+
+    @Schema(description = "岗位编号数组", example = "1")
+    private Set<Long> postIds;
+
+    @Schema(description = "用户邮箱", example = "viewsh@iocoder.cn")
+    @ExcelProperty("用户邮箱")
+    private String email;
+
+    @Schema(description = "手机号码", example = "15601691300")
+    @ExcelProperty("手机号码")
+    private String mobile;
+
+    @Schema(description = "用户性别，参见 SexEnum 枚举类", example = "1")
+    @ExcelProperty(value = "用户性别", converter = DictConvert.class)
+    @DictFormat(DictTypeConstants.USER_SEX)
+    private Integer sex;
+
+    @Schema(description = "用户头像", example = "https://www.iocoder.cn/xxx.png")
+    @OssPresignUrl
+    private String avatar;
+
+    @Schema(description = "状态，参见 CommonStatusEnum 枚举类", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @ExcelProperty(value = "帐号状态", converter = DictConvert.class)
+    @DictFormat(DictTypeConstants.COMMON_STATUS)
+    private Integer status;
+
+    @Schema(description = "最后登录 IP", requiredMode = Schema.RequiredMode.REQUIRED, example = "192.168.1.1")
+    @ExcelProperty("最后登录IP")
+    private String loginIp;
+
+    @Schema(description = "最后登录时间", requiredMode = Schema.RequiredMode.REQUIRED, example = "时间戳格式")
+    @ExcelProperty("最后登录时间")
+    private LocalDateTime loginDate;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED, example = "时间戳格式")
+    private LocalDateTime createTime;
+
+}