From 39f6fca28e3f78abe48f08e474ec011abb990b36 Mon Sep 17 00:00:00 2001
From: liujie <1793218484@qq.com>
Date: 星期三, 09 九月 2026 10:39:21 +0800
Subject: [PATCH] update

---
 backend/src/main/java/com/tourguide/api/admin/AdminGuideUserController.java |   50 ++++++++++++++++++++++++++++++++++++++++++++++++--
 1 files changed, 48 insertions(+), 2 deletions(-)

diff --git a/backend/src/main/java/com/tourguide/api/admin/AdminGuideUserController.java b/backend/src/main/java/com/tourguide/api/admin/AdminGuideUserController.java
index fba712a..c2b6f32 100644
--- a/backend/src/main/java/com/tourguide/api/admin/AdminGuideUserController.java
+++ b/backend/src/main/java/com/tourguide/api/admin/AdminGuideUserController.java
@@ -2,11 +2,16 @@
 
 import com.tourguide.common.api.ApiResponse;
 import com.tourguide.common.api.PageResponse;
+import com.tourguide.common.exception.BusinessException;
 import com.tourguide.modules.user.dto.*;
 import com.tourguide.modules.user.service.GuideAutoDisableService;
+import com.tourguide.modules.user.service.GuideRegistrationDocumentStorageService;
 import com.tourguide.modules.user.service.GuideUserService;
+import com.tourguide.modules.user.service.MiniAvatarStorageService;
 import org.springframework.format.annotation.DateTimeFormat;
+import org.springframework.http.MediaType;
 import org.springframework.web.bind.annotation.*;
+import org.springframework.web.multipart.MultipartFile;
 import javax.validation.Valid;
 import java.time.LocalDate;
 import java.util.List;
@@ -20,11 +25,17 @@
 public class AdminGuideUserController {
     private final GuideUserService userService;
     private final GuideAutoDisableService autoDisableService;
+    private final MiniAvatarStorageService avatarStorageService;
+    private final GuideRegistrationDocumentStorageService documentStorageService;
 
     public AdminGuideUserController(GuideUserService userService,
-                                    GuideAutoDisableService autoDisableService) {
+                                    GuideAutoDisableService autoDisableService,
+                                    MiniAvatarStorageService avatarStorageService,
+                                    GuideRegistrationDocumentStorageService documentStorageService) {
         this.userService = userService;
         this.autoDisableService = autoDisableService;
+        this.avatarStorageService = avatarStorageService;
+        this.documentStorageService = documentStorageService;
     }
 
     /**
@@ -79,6 +90,40 @@
         return ApiResponse.success(userService.updateDetail(id, request));
     }
 
+    /**
+     * 上传并更新指定导游头像。
+     *
+     * @param id 导游账号主键
+     * @param file JPG、PNG 或 WebP 图片,最大 5MB
+     * @return 更新后的导游基础信息
+     */
+    @PostMapping(value = "/{id}/avatar", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
+    public ApiResponse<GuideUserResponse> updateAvatar(@PathVariable Long id,
+                                                       @RequestPart("file") MultipartFile file) {
+        String avatar = avatarStorageService.store(file);
+        return ApiResponse.success(userService.updateAvatarByAdmin(id, avatar));
+    }
+
+    /**
+     * 上传并更新指定导游的证件图片。
+     *
+     * @param id 导游账号主键
+     * @param documentType 证件字段名:idCardFrontUrl、idCardBackUrl、guideCertificateUrl 或 qualificationCertificateUrl
+     * @param file JPG、PNG 或 WebP 图片,最大 5MB
+     * @return 上传后保存的证件图片地址
+     */
+    @PostMapping(value = "/{id}/documents/{documentType}", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
+    public ApiResponse<GuideRegistrationDocumentResponse> uploadDocument(@PathVariable Long id,
+                                                                         @PathVariable String documentType,
+                                                                         @RequestPart("file") MultipartFile file) {
+        if (!userService.supportsDocumentType(documentType)) {
+            throw new BusinessException(400, "不支持的证件类型");
+        }
+        String documentUrl = documentStorageService.store(file);
+        return ApiResponse.success(new GuideRegistrationDocumentResponse(
+                userService.updateDocumentByAdmin(id, documentType, documentUrl)));
+    }
+
     @PostMapping("/{id}/scenic-configs")
     public ApiResponse<List<GuideScenicConfigResponse>> addScenicConfig(
             @PathVariable Long id,
@@ -106,6 +151,7 @@
 
     /**
      * 启用或禁用指定导游账号,禁用后导游无法继续使用导游端受保护接口。
+     * 自动禁用的导游必须先加入自动禁用白名单后才能手动启用。
      *
      * @param id 导游账号主键
      * @param request 目标状态,1 为启用、0 为禁用
@@ -156,7 +202,7 @@
     public ApiResponse<GuideAutoDisableConfigResponse> updateAutoDisableConfig(
             @Valid @RequestBody GuideAutoDisableConfigRequest request) {
         GuideAutoDisableConfigResponse config = userService.updateAutoDisableConfig(request);
-        autoDisableService.disableEligibleGuides();
+        autoDisableService.synchronizeGuideStatuses();
         return ApiResponse.success(config);
     }
 }

--
Gitblit v1.7.1