Merge remote-tracking branch 'origin/feat/#45-1' into feat/#45-1

Author: ysw789

src/main/java/dmu/dasom/api/domain/interview/dto/InterviewReservationRequestDto.java

@@ -1,5 +1,6 @@
 package dmu.dasom.api.domain.interview.dto;
 
+import io.swagger.v3.oas.annotations.media.Schema;
 import jakarta.validation.constraints.NotNull;
 import jakarta.validation.constraints.Pattern;
 import lombok.*;
@@ -9,12 +10,15 @@
 @NoArgsConstructor
 @AllArgsConstructor
 @Builder
+@Schema(name = "InterviewReservationResponseDto", description = "면접 예약 응답 DTO")
 public class InterviewReservationRequestDto {
 
     @NotNull(message = "슬롯 ID는 필수 값입니다.")
+    @Schema(description = "예약할 면접 슬롯의 ID", example = "1")
     private Long slotId; // 예약할 슬롯 ID
 
     @NotNull(message = "예약 코드는 필수 값입니다.")
     @Pattern(regexp = "^[0-9]{8}[0-9]{4}$", message = "예약 코드는 학번 전체와 전화번호 뒤 4자리로 구성되어야 합니다.")
+    @Schema(description = "학번 전체와 전화번호 뒤 4자리로 구성된 예약 코드", example = "202500010542")
     private String reservationCode; // 학번 전체 + 전화번호 뒤 4자리 조합 코드
 }

src/main/java/dmu/dasom/api/domain/interview/dto/InterviewReservationResponseDto.java

@@ -1,5 +1,6 @@
 package dmu.dasom.api.domain.interview.dto;
 
+import io.swagger.v3.oas.annotations.media.Schema;
 import jakarta.validation.constraints.NotNull;
 import lombok.*;
 
@@ -8,18 +9,23 @@
 @NoArgsConstructor
 @AllArgsConstructor
 @Builder
+@Schema(name = "InterviewSlotCreateRequestDto", description = "면접 슬롯 생성 요청 DTO")
 public class InterviewReservationResponseDto {
 
     @NotNull(message = "예약 ID는 필수 값입니다.")
+    @Schema(description = "예약의 고유 ID", example = "1")
     private Long reservationId; // 예약 ID
 
     @NotNull(message = "슬롯 ID는 필수 값입니다.")
+    @Schema(description = "예약된 면접 슬롯의 ID", example = "10")
     private Long slotId; // 슬롯 ID
 
     @NotNull(message = "지원자 ID는 필수 값입니다.")
+    @Schema(description = "예약한 지원자의 ID", example = "1001")
     private Long applicantId; // 지원자 ID
 
     @NotNull(message = "예약 코드는 필수 값입니다.")
+    @Schema(description = "학번 전체와 전화번호 뒤 4자리로 구성된 예약 코드", example = "202500010542")
     private String reservationCode; // 예약 코드 (학번+전화번호 조합)
 
 }

src/main/java/dmu/dasom/api/domain/interview/dto/InterviewSlotCreateRequestDto.java

@@ -1,5 +1,6 @@
 package dmu.dasom.api.domain.interview.dto;
 
+import io.swagger.v3.oas.annotations.media.Schema;
 import jakarta.validation.constraints.NotNull;
 import lombok.*;
 
@@ -11,17 +12,22 @@
 @NoArgsConstructor
 @AllArgsConstructor
 @Builder
+@Schema(name = "InterviewSlotCreateRequestDto", description = "면접 슬롯 생성 요청 DTO")
 public class InterviewSlotCreateRequestDto {
 
     @NotNull(message = "시작 날짜는 필수 값입니다.")
+    @Schema(description = "면접 시작 날짜", example = "2025-03-12")
     private LocalDate startDate; // 면접 시작 날짜
 
     @NotNull(message = "종료 날짜는 필수 값입니다.")
+    @Schema(description = "면접 종료 날짜", example = "2025-03-14")
     private LocalDate endDate; // 면접 종료 날짜
 
     @NotNull(message = "시작 시간은 필수 값입니다.")
+    @Schema(description = "하루의 시작 시간", example = "10:00")
     private LocalTime startTime; // 하루의 시작 시간
 
     @NotNull(message = "종료 시간은 필수 값입니다.")
+    @Schema(description = "하루의 종료 시간", example = "17:00")
     private LocalTime endTime; // 하루의 종료 시간
 }

src/main/java/dmu/dasom/api/domain/interview/dto/InterviewSlotRequestDto.java

@@ -1,5 +1,6 @@
 package dmu.dasom.api.domain.interview.dto;
 
+import io.swagger.v3.oas.annotations.media.Schema;
 import jakarta.validation.constraints.Max;
 import jakarta.validation.constraints.Min;
 import jakarta.validation.constraints.NotNull;
@@ -13,19 +14,24 @@
 @NoArgsConstructor
 @AllArgsConstructor
 @Builder
+@Schema(name = "InterviewSlotRequestDto", description = "면접 슬롯 요청 DTO")
 public class InterviewSlotRequestDto {
 
     @NotNull(message = "면접 날짜는 필수 입력 값입니다.")
+    @Schema(description = "면접이 진행되는 날짜", example = "2025-03-12")
     private LocalDate interviewDate; // 면접 날짜
 
     @NotNull(message = "시작 시간은 필수 입력 값입니다.")
+    @Schema(description = "면접 시작 시간", example = "10:00")
     private LocalTime startTime; // 시작 시간
 
     @NotNull(message = "종료 시간은 필수 입력 값입니다.")
+    @Schema(description = "면접 종료 시간", example = "10:20")
     private LocalTime endTime; // 종료 시간
 
     @NotNull(message = "최대 지원자 수는 필수 입력 값입니다.")
     @Min(value = 1, message = "최대 지원자 수는 최소 1명 이상이어야 합니다.")
-    @Max(value = 100, message = "최대 지원자 수는 최대 100명까지 가능합니다.") // 필요에 따라 수정 가능
+    @Max(value = 100, message = "최대 지원자 수는 최대 100명까지 가능합니다.")
+    @Schema(description = "해당 슬롯에서 허용되는 최대 지원자 수", example = "2")
     private Integer maxCandidates; // 최대 지원자 수
 }

src/main/java/dmu/dasom/api/domain/interview/dto/InterviewSlotResponseDto.java

@@ -1,6 +1,7 @@
 package dmu.dasom.api.domain.interview.dto;
 
 import dmu.dasom.api.domain.interview.entity.InterviewSlot;
+import io.swagger.v3.oas.annotations.media.Schema;
 import jakarta.validation.constraints.Max;
 import jakarta.validation.constraints.Min;
 import jakarta.validation.constraints.NotNull;
@@ -14,27 +15,34 @@
 @NoArgsConstructor
 @AllArgsConstructor
 @Builder
+@Schema(name = "InterviewSlotResponseDto", description = "면접 슬롯 응답 DTO")
 public class InterviewSlotResponseDto {
 
     @NotNull(message = "슬롯 ID는 필수 입력 값입니다.")
+    @Schema(description = "슬롯의 고유 ID", example = "1")
     private Long id; // 슬롯 ID
 
     @NotNull(message = "면접 날짜는 필수 입력 값입니다.")
+    @Schema(description = "면접이 진행되는 날짜", example = "2025-03-12")
     private LocalDate interviewDate; // 면접 날짜
 
     @NotNull(message = "시작 시간은 필수 입력 값입니다.")
+    @Schema(description = "면접 시작 시간", example = "10:00")
     private LocalTime startTime; // 시작 시간
 
     @NotNull(message = "종료 시간은 필수 입력 값입니다.")
+    @Schema(description = "면접 종료 시간", example = "10:20")
     private LocalTime endTime; // 종료 시간
 
     @NotNull(message = "최대 지원자 수는 필수 입력 값입니다.")
     @Min(value = 1, message = "최대 지원자 수는 최소 1명 이상이어야 합니다.")
     @Max(value = 100, message = "최대 지원자 수는 최대 100명까지 가능합니다.")
+    @Schema(description = "해당 슬롯에서 허용되는 최대 지원자 수", example = "2")
     private Integer maxCandidates; // 최대 지원자 수
 
     @NotNull(message = "현재 예약된 지원자 수는 필수 입력 값입니다.")
     @Min(value = 0, message = "현재 예약된 지원자 수는 0명 이상이어야 합니다.")
+    @Schema(description = "현재 해당 슬롯에 예약된 지원자 수", example = "1")
     private Integer currentCandidates; // 현재 예약된 지원자 수
 
     public InterviewSlotResponseDto(InterviewSlot slot){

src/main/java/dmu/dasom/api/domain/recruit/dto/RecruitScheduleDto.java

@@ -19,13 +19,4 @@ public interface RecruitService {
 
     ResultCheckResponseDto checkResult(final ResultCheckRequestDto request);
 
-    LocalDate getInterviewStartDate();
-
-    LocalDate getInterviewEndDate();
-
-    LocalTime getInterviewStartTime();
-
-    LocalTime getInterviewEndTime();
-
-
 }

src/main/java/dmu/dasom/api/domain/recruit/service/RecruitService.java

@@ -96,26 +96,6 @@ public ResultCheckResponseDto checkResult(final ResultCheckRequestDto request) {
             .build();
     }
 
-    @Override
-    public LocalDate getInterviewStartDate() {
-        return LocalDate.parse(findByKey(ConfigKey.INTERVIEW_PERIOD_START).getValue());
-    }
-
-    @Override
-    public LocalDate getInterviewEndDate() {
-        return LocalDate.parse(findByKey(ConfigKey.INTERVIEW_PERIOD_END).getValue());
-    }
-
-    @Override
-    public LocalTime getInterviewStartTime() {
-        return LocalTime.parse(findByKey(ConfigKey.INTERVIEW_TIME_START).getValue());
-    }
-
-    @Override
-    public LocalTime getInterviewEndTime() {
-        return LocalTime.parse(findByKey(ConfigKey.INTERVIEW_TIME_END).getValue());
-    }
-
     // DB에 저장된 모든 Recruit 객체를 찾아 반환
     private List<Recruit> findAll() {
         return recruitRepository.findAll();