Feat: 반복 슬롯 생성

sso0om · sso0om · commit 3edcb58d2132 · 2025-09-25T18:55:19.000+09:00
diff --git a/back/src/main/java/com/back/domain/mentoring/mentoring/controller/MentoringController.java b/back/src/main/java/com/back/domain/mentoring/mentoring/controller/MentoringController.java
@@ -17,7 +17,7 @@
 import org.springframework.web.bind.annotation.*;
 
 @RestController
-@RequestMapping("/mentoring")
+@RequestMapping("/mentorings")
 @RequiredArgsConstructor
 @Tag(name = "MentoringController", description = "멘토링 API")
 public class MentoringController {
diff --git a/back/src/main/java/com/back/domain/mentoring/slot/controller/MentorSlotController.java b/back/src/main/java/com/back/domain/mentoring/slot/controller/MentorSlotController.java
@@ -1,8 +1,9 @@
 package com.back.domain.mentoring.slot.controller;
 
 import com.back.domain.member.member.entity.Member;
-import com.back.domain.mentoring.slot.dto.MentorSlotDto;
+import com.back.domain.mentoring.slot.dto.request.MentorSlotRepetitionRequest;
 import com.back.domain.mentoring.slot.dto.request.MentorSlotRequest;
+import com.back.domain.mentoring.slot.dto.response.MentorSlotDto;
 import com.back.domain.mentoring.slot.dto.response.MentorSlotResponse;
 import com.back.domain.mentoring.slot.service.MentorSlotService;
 import com.back.global.rq.Rq;
@@ -20,7 +21,7 @@
 import java.util.List;
 
 @RestController
-@RequestMapping("/mentor-slot")
+@RequestMapping("/mentor-slots")
 @RequiredArgsConstructor
 @Tag(name = "MentorSlotController", description = "멘토 슬롯(멘토의 예약 가능 일정) API")
 public class MentorSlotController {
@@ -49,7 +50,6 @@ public RsData<List<MentorSlotDto>> getMyMentorSlots(
         );
     }
 
-
     @GetMapping("/available/{mentorId}")
     @Operation(summary = "멘토의 예약 가능한 슬롯 목록 조회", description = "멘티가 특정 멘토의 예약 가능한 슬롯 목록을 조회합니다.")
     public RsData<List<MentorSlotDto>> getAvailableMentorSlots(
@@ -99,6 +99,21 @@ public RsData<MentorSlotResponse> createMentorSlot(
         );
     }
 
+    @PostMapping("/repetition")
+    @PreAuthorize("hasRole('MENTOR')")
+    @Operation(summary = "반복 슬롯 생성", description = "멘토 슬롯을 반복 생성합니다. 로그인한 멘토만 생성할 수 있습니다.")
+    public RsData<Void> createMentorSlotRepetition(
+        @RequestBody @Valid MentorSlotRepetitionRequest reqDto
+    ) {
+        Member member = rq.getActor();
+        mentorSlotService.createMentorSlotRepetition(reqDto, member);
+
+        return new RsData<>(
+            "201",
+            "반복 일정을 등록했습니다."
+        );
+    }
+
     @PutMapping("/{slotId}")
     @Operation(summary = "멘토 슬롯 수정", description = "멘토 슬롯을 수정합니다. 멘토 슬롯 작성자만 접근할 수 있습니다.")
     public RsData<MentorSlotResponse> updateMentorSlot(
diff --git a/back/src/main/java/com/back/domain/mentoring/slot/dto/request/MentorSlotRepetitionRequest.java b/back/src/main/java/com/back/domain/mentoring/slot/dto/request/MentorSlotRepetitionRequest.java
@@ -0,0 +1,36 @@
+package com.back.domain.mentoring.slot.dto.request;
+
+import com.fasterxml.jackson.annotation.JsonFormat;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+
+import java.time.DayOfWeek;
+import java.time.LocalDate;
+import java.time.LocalTime;
+import java.util.List;
+
+public record MentorSlotRepetitionRequest(
+    @Schema(description = "반복 시작일")
+    @NotNull
+    LocalDate repeatStartDate,
+
+    @Schema(description = "반복 종료일")
+    @NotNull
+    LocalDate repeatEndDate,
+
+    @Schema(description = "반복 요일")
+    @NotEmpty
+    List<DayOfWeek> daysOfWeek,
+
+    @Schema(description = "시작 시간")
+    @NotNull
+    @JsonFormat(pattern = "HH:mm:ss")
+    LocalTime startTime,
+
+    @Schema(description = "종료 시간")
+    @NotNull
+    @JsonFormat(pattern = "HH:mm:ss")
+    LocalTime endTime
+){
+}
diff --git a/back/src/main/java/com/back/domain/mentoring/slot/dto/response/MentorSlotDto.java b/back/src/main/java/com/back/domain/mentoring/slot/dto/response/MentorSlotDto.java
@@ -1,4 +1,4 @@
-package com.back.domain.mentoring.slot.dto;
+package com.back.domain.mentoring.slot.dto.response;
 
 import com.back.domain.mentoring.slot.constant.MentorSlotStatus;
 import com.back.domain.mentoring.slot.entity.MentorSlot;
diff --git a/back/src/main/java/com/back/domain/mentoring/slot/service/MentorSlotService.java b/back/src/main/java/com/back/domain/mentoring/slot/service/MentorSlotService.java
@@ -7,8 +7,9 @@
 import com.back.domain.mentoring.mentoring.error.MentoringErrorCode;
 import com.back.domain.mentoring.mentoring.repository.MentoringRepository;
 import com.back.domain.mentoring.reservation.repository.ReservationRepository;
-import com.back.domain.mentoring.slot.dto.MentorSlotDto;
+import com.back.domain.mentoring.slot.dto.request.MentorSlotRepetitionRequest;
 import com.back.domain.mentoring.slot.dto.request.MentorSlotRequest;
+import com.back.domain.mentoring.slot.dto.response.MentorSlotDto;
 import com.back.domain.mentoring.slot.dto.response.MentorSlotResponse;
 import com.back.domain.mentoring.slot.entity.MentorSlot;
 import com.back.domain.mentoring.slot.error.MentorSlotErrorCode;
@@ -18,7 +19,11 @@
 import org.springframework.stereotype.Service;
 import org.springframework.transaction.annotation.Transactional;
 
+import java.time.DayOfWeek;
+import java.time.LocalDate;
 import java.time.LocalDateTime;
+import java.time.temporal.TemporalAdjusters;
+import java.util.ArrayList;
 import java.util.List;
 
 @Service
@@ -81,6 +86,19 @@ public MentorSlotResponse createMentorSlot(MentorSlotRequest reqDto, Member memb
         return MentorSlotResponse.from(mentorSlot, mentoring);
     }
 
+    @Transactional
+    public void createMentorSlotRepetition(MentorSlotRepetitionRequest reqDto, Member member) {
+        Mentor mentor = findMentorByMember(member);
+
+        List<MentorSlot> mentorSlots = new ArrayList<>();
+
+        // 지정한 요일별로 슬롯 목록 생성
+        for(DayOfWeek targetDayOfWeek : reqDto.daysOfWeek()) {
+            mentorSlots.addAll(generateSlotsForDayOfWeek(reqDto, targetDayOfWeek, mentor));
+        }
+        mentorSlotRepository.saveAll(mentorSlots);
+    }
+
     @Transactional
     public MentorSlotResponse updateMentorSlot(Long slotId, MentorSlotRequest reqDto, Member member) {
         Mentor mentor = findMentorByMember(member);
@@ -112,6 +130,42 @@ public void deleteMentorSlot(Long slotId, Member member) {
     }
 
 
+    // ===== 반복 슬롯 생성 로직 =====
+
+    /**
+     * 특정 요일에 해당하는 모든 슬롯들을 생성
+     */
+    private List<MentorSlot> generateSlotsForDayOfWeek(MentorSlotRepetitionRequest reqDto, DayOfWeek targetDayOfWeek, Mentor mentor) {
+        List<MentorSlot> mentorSlots = new ArrayList<>();
+        LocalDate currentDate = findNextOrSameDayOfWeek(reqDto.repeatStartDate(), targetDayOfWeek);
+
+        // 해당 요일에 대해 주 단위로 반복하여 슬롯 생성
+        while (!currentDate.isAfter(reqDto.repeatEndDate())) {
+            LocalDateTime startDateTime = LocalDateTime.of(currentDate, reqDto.startTime());
+            LocalDateTime endDateTime = LocalDateTime.of(currentDate, reqDto.endTime());
+
+            validateOverlappingSlots(mentor, startDateTime, endDateTime);
+
+            MentorSlot mentorSlot = MentorSlot.builder()
+                .mentor(mentor)
+                .startDateTime(startDateTime)
+                .endDateTime(endDateTime)
+                .build();
+            mentorSlots.add(mentorSlot);
+
+            currentDate = currentDate.plusWeeks(1);
+        }
+        return mentorSlots;
+    }
+
+    /**
+     * 시작일부터 해당 요일의 첫 번째 날짜를 찾기
+     */
+    private LocalDate findNextOrSameDayOfWeek(LocalDate startDate, DayOfWeek targetDay) {
+        return startDate.with(TemporalAdjusters.nextOrSame(targetDay));
+    }
+
+
     // ===== 헬퍼 메서드 =====
 
     private Mentor findMentorByMember(Member member) {
diff --git a/back/src/test/java/com/back/domain/mentoring/mentoring/controller/MentoringControllerTest.java b/back/src/test/java/com/back/domain/mentoring/mentoring/controller/MentoringControllerTest.java
@@ -50,7 +50,7 @@ class MentoringControllerTest {
     @Autowired private AuthTokenService authTokenService;
 
     private static final String TOKEN = "accessToken";
-    private static final String MENTORING_URL = "/mentoring";
+    private static final String MENTORING_URL = "/mentorings";
 
     private Mentor mentor;
     private Mentee mentee;
diff --git a/back/src/test/java/com/back/domain/mentoring/slot/controller/MentorSlotControllerTest.java b/back/src/test/java/com/back/domain/mentoring/slot/controller/MentorSlotControllerTest.java
@@ -25,10 +25,13 @@
 import org.springframework.test.web.servlet.ResultActions;
 import org.springframework.transaction.annotation.Transactional;
 
+import java.time.DayOfWeek;
 import java.time.LocalDateTime;
 import java.time.format.DateTimeFormatter;
 import java.util.ArrayList;
 import java.util.List;
+import java.util.Set;
+import java.util.stream.Collectors;
 
 import static org.assertj.core.api.Assertions.assertThat;
 import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.*;
@@ -49,7 +52,7 @@ class MentorSlotControllerTest {
     @Autowired private AuthTokenService authTokenService;
 
     private static final String TOKEN = "accessToken";
-    private static final String MENTOR_SLOT_URL = "/mentor-slot";
+    private static final String MENTOR_SLOT_URL = "/mentor-slots";
 
     private Mentor mentor;
     private String mentorToken;
@@ -226,6 +229,60 @@ void createMentorSlotFailOverlappingSlots() throws Exception {
     }
 
 
+    // ===== 슬롯 반복 생성 =====
+    @Test
+    @DisplayName("멘토 슬롯 반복 생성 성공")
+    void createMentorSlotRepetitionSuccess() throws Exception {
+        String req = """
+        {
+            "repeatStartDate": "2025-11-01",
+            "repeatEndDate": "2025-11-30",
+            "daysOfWeek": ["MONDAY", "WEDNESDAY", "FRIDAY"],
+            "startTime": "10:00:00",
+            "endTime": "11:00:00"
+        }
+        """;
+
+        long beforeCount = mentorSlotRepository.countByMentorId(mentor.getId());
+
+        mvc.perform(
+                post(MENTOR_SLOT_URL + "/repetition")
+                    .cookie(new Cookie(TOKEN, mentorToken))
+                    .contentType(MediaType.APPLICATION_JSON)
+                    .content(req)
+            )
+            .andDo(print())
+            .andExpect(status().isCreated())
+            .andExpect(jsonPath("$.resultCode").value("201"))
+            .andExpect(jsonPath("$.msg").value("반복 일정을 등록했습니다."));
+
+        // 11월 월/수/금 = 13개
+        long afterCount = mentorSlotRepository.countByMentorId(mentor.getId());
+        assertThat(afterCount - beforeCount).isEqualTo(12);
+
+        List<MentorSlot> createdSlots = mentorSlotRepository.findMySlots(
+            mentor.getId(),
+            LocalDateTime.of(2025, 11, 1, 0, 0),
+            LocalDateTime.of(2025, 12, 1, 0, 0)
+        );
+        assertThat(createdSlots).hasSize(12);
+
+        // 모든 슬롯이 월/수/금인지 검증
+        Set<DayOfWeek> actualDaysOfWeek = createdSlots.stream()
+            .map(slot -> slot.getStartDateTime().getDayOfWeek())
+            .collect(Collectors.toSet());
+
+        assertThat(actualDaysOfWeek).containsExactlyInAnyOrder(
+            DayOfWeek.MONDAY, DayOfWeek.WEDNESDAY, DayOfWeek.FRIDAY
+        );
+
+        // 시간 검증
+        MentorSlot firstSlot = createdSlots.getFirst();
+        assertThat(firstSlot.getStartDateTime().getHour()).isEqualTo(10);
+        assertThat(firstSlot.getEndDateTime().getHour()).isEqualTo(11);
+    }
+
+
     // ===== 슬롯 수정 =====
 
     @Test

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-package com.back.domain.mentoring.slot.dto;`
	`1`	`+package com.back.domain.mentoring.slot.dto.response;`
`2`	`2`
`3`	`3`	`import com.back.domain.mentoring.slot.constant.MentorSlotStatus;`
`4`	`4`	`import com.back.domain.mentoring.slot.entity.MentorSlot;`