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 get(@AuthenticationPrincipal AppUserPrincipal principal) { return ApiResponse.success(MiniUserResponse.from(userService.findEnabledById(principal.getUserId()))); } /** * 更新当前游客本人可维护的昵称、头像等个人资料。 * * @param principal 安全过滤器解析出的当前游客身份 * @param request 游客个人资料更新参数 * @return 更新后的游客基础资料 */ @PutMapping public ApiResponse 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 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 updateRealName(@AuthenticationPrincipal AppUserPrincipal principal, @Valid @RequestBody MiniRealNameUpdateRequest request) { return ApiResponse.success(userService.updateRealName(principal.getUserId(), request)); } }