优化了一键分配面试时间地点的接口，使其能对应面试时段表中的时间自动分配

Author: JJ20LOVE

mvnw

@@ -97,6 +97,13 @@
             <optional>true</optional>
         </dependency>
 
+        <!--swagger依赖-->
+        <dependency>
+            <groupId>org.springdoc</groupId>
+            <artifactId>springdoc-openapi-ui</artifactId>
+            <version>1.6.14</version>
+        </dependency>
+
         <dependency>
             <groupId>org.springframework.boot</groupId>
             <artifactId>spring-boot-starter-mail</artifactId>

pom.xml

@@ -77,4 +77,18 @@ public ResponseEntity<ResponseMessage<InterviewResult>> update(@PathVariable Int
                     .body(ResponseMessage.error(400, "更新面试结果失败"));
         }
     }
+
+    //根据resultId获取面试结果
+    @GetMapping("/get/{resultId}")
+    public ResponseEntity<ResponseMessage<InterviewResult>> get(@PathVariable Integer resultId) {
+        try {
+            log.info("获取面试结果");
+            InterviewResult result = interviewResultService.getById(resultId);
+            return ResponseEntity.ok(ResponseMessage.success(result));
+        } catch (Exception e) {
+            log.error("获取面试结果失败", e);
+            return ResponseEntity.badRequest()
+                    .body(ResponseMessage.error(400, "获取面试结果失败"));
+        }
+    }
 }

src/main/java/club/boyuan/official/controller/InterviewResultController.java

@@ -1,9 +1,14 @@
 package club.boyuan.official.controller;
 
-
-import org.springframework.web.bind.annotation.RequestMapping;
-
-import org.springframework.web.bind.annotation.RestController;
+import club.boyuan.official.dto.AutoAssignInterviewResponseDTO;
+import club.boyuan.official.dto.ResponseMessage;
+import club.boyuan.official.service.IInterviewScheduleService;
+import jakarta.validation.Valid;
+import lombok.AllArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.web.bind.annotation.*;
 
 /**
  * <p>
@@ -13,8 +18,33 @@
  * @author dhy
  * @since 2026-01-28
  */
+@Slf4j
 @RestController
-@RequestMapping("/interview-schedule")
+@RequestMapping("/api/interview/schedule")
+@AllArgsConstructor
 public class InterviewScheduleController {
 
-}
+    private final IInterviewScheduleService interviewScheduleService;
+
+    /**
+     * 一键分配面试成员面试时间地点（按招募周期）- 路径参数版本
+     * 
+     * @param cycleId 招募周期ID
+     * @return 分配结果
+     */
+    @PostMapping("/auto-assign/{cycleId}")
+    @PreAuthorize("hasAuthority(('resume:audit'))")
+    public ResponseEntity<ResponseMessage<AutoAssignInterviewResponseDTO>> autoAssignInterviewsByCycleId(
+            @PathVariable Integer cycleId) {
+        try {
+            log.info("开始一键分配面试，招募周期ID: {}", cycleId);
+            AutoAssignInterviewResponseDTO result = interviewScheduleService.autoAssignInterviews(cycleId);
+            log.info("一键分配面试完成，已分配 {} 人", result.getAssignedCount());
+            return ResponseEntity.ok(ResponseMessage.success(result));
+        } catch (Exception e) {
+            log.error("一键分配面试失败，招募周期ID: {}", cycleId, e);
+            return ResponseEntity.badRequest()
+                    .body(ResponseMessage.error(400, "分配失败: " + e.getMessage()));
+        }
+    }
+}

src/main/java/club/boyuan/official/controller/InterviewScheduleController.java

@@ -0,0 +1,18 @@
+package club.boyuan.official.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.time.LocalDate;
+import java.time.LocalTime;
+
+@Data
+@AllArgsConstructor
+@NoArgsConstructor
+public class SlotTimeDTO {
+    private LocalDate date;
+    private LocalTime startTime;
+    private LocalTime endTime;
+
+}

src/main/java/club/boyuan/official/dto/SlotTimeDTO.java

@@ -1,5 +1,6 @@
 package club.boyuan.official.service;
 
+import club.boyuan.official.dto.AutoAssignInterviewResponseDTO;
 import club.boyuan.official.entity.InterviewSchedule;
 import com.baomidou.mybatisplus.extension.service.IService;
 
@@ -13,4 +14,11 @@
  */
 public interface IInterviewScheduleService extends IService<InterviewSchedule> {
 
+    /**
+     * 一键分配面试成员面试时间地点（按招募周期）
+     * 
+     * @param cycleId  分配请求参数
+     * @return 分配结果
+     */
+    AutoAssignInterviewResponseDTO autoAssignInterviews(Integer cycleId);
 }

src/main/java/club/boyuan/official/service/IInterviewScheduleService.java

@@ -7,6 +7,8 @@
 import com.baomidou.mybatisplus.extension.service.IService;
 import jakarta.validation.Valid;
 
+import java.util.List;
+
 /**
  * <p>
  * 面试时段配置表 服务类
@@ -22,4 +24,19 @@ public interface IInterviewSlotService extends IService<InterviewSlot> {
     InterviewSlot updateInterviewSlot(Integer slotId, UpdateInterviewSlotDTO requestDTO);
 
     GetInterviewSlotListResponseDTO listInterviewSlots(Integer cycleId, String interviewDate, String startTime, String location, Integer status, Integer interviewType, Integer page, Integer size);
+
+    /**
+     * 根据招募周期ID获取可用的面试时间槽
+     * @param cycleId 招募周期ID
+     * @return 可用的面试时间槽列表
+     */
+    List<InterviewSlot> getAvailableSlotsByCycleId(Integer cycleId);
+
+    /**
+     * 根据招募周期ID获取所有面试时间槽（包括已占用的）
+     * @param cycleId 招募周期ID
+     * @return 所有面试时间槽列表
+     */
+    List<InterviewSlot> getAllSlotsByCycleId(Integer cycleId);
+
 }

src/main/java/club/boyuan/official/service/IInterviewSlotService.java

@@ -0,0 +1,72 @@
+package club.boyuan.official.service;
+
+import club.boyuan.official.entity.Resume;
+import club.boyuan.official.entity.ResumeFieldDefinition;
+
+import java.util.List;
+import java.util.Map;
+
+/**
+ * 简历数据服务接口
+ * 专门处理简历字段定义和字段值解析相关功能
+ */
+public interface ResumeDataService {
+    
+    /**
+     * 获取指定周期的面试时间字段定义
+     * @param cycleId 招募周期ID
+     * @return 面试时间字段定义，未找到返回null
+     */
+    ResumeFieldDefinition getInterviewTimeFieldDefinition(Integer cycleId);
+    
+    /**
+     * 获取指定周期的期望部门字段定义
+     * @param cycleId 招募周期ID
+     * @return 期望部门字段定义，未找到返回null
+     */
+    ResumeFieldDefinition getExpectedDepartmentsFieldDefinition(Integer cycleId);
+    
+    /**
+     * 批量获取用户面试时间偏好
+     * @param resumes 简历列表
+     * @param fieldId 时间字段ID
+     * @return Map<用户ID, 时间偏好列表>
+     */
+    Map<Integer, List<String>> getUserPreferredTimes(List<Resume> resumes, Integer fieldId);
+    
+    /**
+     * 批量获取用户期望部门
+     * @param resumes 简历列表
+     * @param fieldId 部门字段ID
+     * @return Map<用户ID, 部门偏好列表>
+     */
+    Map<Integer, List<String>> getUserPreferredDepartments(List<Resume> resumes, Integer fieldId);
+    
+    /**
+     * 从简历中获取姓名字段值
+     * @param resume 简历对象
+     * @return 姓名字段值
+     */
+    String getResumeName(Resume resume);
+    
+    /**
+     * 从简历中获取邮箱字段值
+     * @param resume 简历对象
+     * @return 邮箱字段值
+     */
+    String getResumeEmail(Resume resume);
+    
+    /**
+     * 从简历中获取专业字段值
+     * @param resume 简历对象
+     * @return 专业字段值
+     */
+    String getResumeMajor(Resume resume);
+    
+    /**
+     * 从简历中获取年级字段值
+     * @param resume 简历对象
+     * @return 年级字段值
+     */
+    String getResumeGrade(Resume resume);
+}

src/main/java/club/boyuan/official/service/ResumeDataService.java

@@ -49,7 +49,7 @@ public class InterviewAssignmentServiceImpl implements IInterviewAssignmentServi
     private static final int INTERVIEW_DURATION = 10; // 面试时长10分钟
 
     @Override
-    public InterviewAssignmentResultDTO assignInterviews(Integer cycleId) {
+    public InterviewAssignmentResultDTO   assignInterviews(Integer cycleId) {
         logger.info("开始为招募周期ID {} 分配面试时间", cycleId);
 
         // 获取招募周期信息

src/main/java/club/boyuan/official/service/impl/InterviewAssignmentServiceImpl.java

@@ -118,7 +118,6 @@ public InterviewResult update(Integer resultId, InterviewResultSaveDTO interview
         //从 Spring Security 获取userId
         Authentication authentication = SecurityContextHolder.getContext().getAuthentication();
         Integer userId = null;
-
         if (authentication != null) {
             Object principal = authentication.getPrincipal();
 
@@ -134,7 +133,6 @@ public InterviewResult update(Integer resultId, InterviewResultSaveDTO interview
                 userId = user != null ? user.getUserId() : null;
             }
         }
-
         if (userId != null) {
             interviewResult.setDecisionBy(userId);
         }