update

liujie

2026-09-11 4f6f15b818704079ff2e4e4719b798f48d68a335

 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 为禁用
@@ -136,6 +182,14 @@
        return ApiResponse.success();
    }

    /** 配置导游是否可直接接取精讲服务，独立于自动禁用白名单。 */
    @PutMapping("/{id}/premium-permission")
    public ApiResponse<Void> updatePremiumPermission(@PathVariable Long id,
                                                      @Valid @RequestBody GuidePremiumPermissionRequest request) {
        userService.updatePremiumPermission(id, request.getEnabled());
        return ApiResponse.success();
    }

    /**
     * 查询当前导游自动禁用规则配置，供后台设置页面回显。
     *
@@ -156,7 +210,7 @@
    public ApiResponse<GuideAutoDisableConfigResponse> updateAutoDisableConfig(
            @Valid @RequestBody GuideAutoDisableConfigRequest request) {
        GuideAutoDisableConfigResponse config = userService.updateAutoDisableConfig(request);
        autoDisableService.disableEligibleGuides();
        autoDisableService.synchronizeGuideStatuses();
        return ApiResponse.success(config);
    }
}