update

liujie

2026-07-30 280ef5100bece9b40ac51736aef037704a52a4ca

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
package com.tourguide.api.mini;
 
import com.tourguide.common.api.ApiResponse;
import com.tourguide.modules.user.dto.MiniProfileUpdateRequest;
import com.tourguide.modules.user.dto.MiniRealNameUpdateRequest;
import com.tourguide.modules.user.dto.MiniUserResponse;
import com.tourguide.modules.user.service.MiniAvatarStorageService;
import com.tourguide.modules.user.service.MiniUserService;
import com.tourguide.security.AppUserPrincipal;
import org.springframework.security.core.annotation.AuthenticationPrincipal;
import org.springframework.http.MediaType;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.multipart.MultipartFile;
import javax.validation.Valid;
 
/**
 * 游客小程序个人资料接口。
 * 游客只能读取和修改 MINI Token 对应的本人资料，不能指定或操作其他游客账号。
 */
@RestController
@RequestMapping("/api/mini/profile")
public class MiniProfileController {
    private final MiniUserService userService;
    private final MiniAvatarStorageService avatarStorageService;
 
    public MiniProfileController(MiniUserService userService, MiniAvatarStorageService avatarStorageService) {
        this.userService = userService;
        this.avatarStorageService = avatarStorageService;
    }
 
    /**
     * 查询当前已登录且处于启用状态的游客个人资料。
     *
     * @param principal 安全过滤器解析出的当前游客身份
     * @return 当前游客基础资料
     */
    @GetMapping
    public ApiResponse<MiniUserResponse> get(@AuthenticationPrincipal AppUserPrincipal principal) {
        return ApiResponse.success(MiniUserResponse.from(userService.findEnabledById(principal.getUserId())));
    }
 
    /**
     * 更新当前游客本人可维护的昵称、头像等个人资料。
     *
     * @param principal 安全过滤器解析出的当前游客身份
     * @param request 游客个人资料更新参数
     * @return 更新后的游客基础资料
     */
    @PutMapping
    public ApiResponse<MiniUserResponse> update(@AuthenticationPrincipal AppUserPrincipal principal,
                                                @Valid @RequestBody MiniProfileUpdateRequest request) {
        return ApiResponse.success(userService.updateProfile(principal.getUserId(), request));
    }
 
    @PostMapping(value = "/avatar", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
    public ApiResponse<MiniUserResponse> updateAvatar(@AuthenticationPrincipal AppUserPrincipal principal,
                                                      @RequestPart("file") MultipartFile file) {
        String avatar = avatarStorageService.store(file);
        return ApiResponse.success(userService.updateAvatar(principal.getUserId(), avatar));
    }
 
    /**
     * 保存当前游客的真实姓名和18位身份证号，完成或修改实名认证信息。
     * 身份证号会校验出生日期、校验位及账号间唯一性，响应仅返回脱敏号码。
     *
     * @param principal 安全过滤器解析出的当前游客身份
     * @param request 真实姓名和完整身份证号
     * @return 更新后的游客资料及脱敏实名认证信息
     */
    @PutMapping("/real-name")
    public ApiResponse<MiniUserResponse> updateRealName(@AuthenticationPrincipal AppUserPrincipal principal,
                                                        @Valid @RequestBody MiniRealNameUpdateRequest request) {
        return ApiResponse.success(userService.updateRealName(principal.getUserId(), request));
    }
}