feat: 스터디 기본 정보와 상세 정보 작성 API

src/main/java/com/gdschongik/gdsc/domain/study/api/MentorStudyController.java

@@ -2,6 +2,7 @@
 
 import com.gdschongik.gdsc.domain.study.application.MentorStudyService;
 import com.gdschongik.gdsc.domain.study.dto.request.StudyAnnouncementCreateUpdateRequest;
+import com.gdschongik.gdsc.domain.study.dto.request.StudyUpdateRequest;
 import com.gdschongik.gdsc.domain.study.dto.response.MentorStudyResponse;
 import com.gdschongik.gdsc.domain.study.dto.response.StudyStudentResponse;
 import io.swagger.v3.oas.annotations.Operation;
@@ -10,14 +11,7 @@
 import java.util.List;
 import lombok.RequiredArgsConstructor;
 import org.springframework.http.ResponseEntity;
-import org.springframework.web.bind.annotation.DeleteMapping;
-import org.springframework.web.bind.annotation.GetMapping;
-import org.springframework.web.bind.annotation.PathVariable;
-import org.springframework.web.bind.annotation.PostMapping;
-import org.springframework.web.bind.annotation.PutMapping;
-import org.springframework.web.bind.annotation.RequestBody;
-import org.springframework.web.bind.annotation.RequestMapping;
-import org.springframework.web.bind.annotation.RestController;
+import org.springframework.web.bind.annotation.*;
 
 @Tag(name = "Mentor Study", description = "멘토 스터디 API입니다.")
 @RestController
@@ -27,6 +21,13 @@ public class MentorStudyController {
 
     private final MentorStudyService mentorStudyService;
 
+    @Operation(summary = "스터디 정보 작성", description = "스터디 기본 정보와 상세 정보를 작성합니다.")
+    @PatchMapping("/{studyId}")
+    public ResponseEntity<Void> updateStudy(@PathVariable Long studyId, @RequestBody StudyUpdateRequest request) {
+        mentorStudyService.updateStudy(studyId, request);
+        return ResponseEntity.ok().build();
+    }
+
     @Operation(summary = "내 스터디 조회", description = "내가 멘토로 있는 스터디를 조회합니다.")
     @GetMapping("/me")
     public ResponseEntity<List<MentorStudyResponse>> getStudiesInCharge() {

src/main/java/com/gdschongik/gdsc/domain/study/application/MentorStudyService.java

@@ -1,20 +1,30 @@
 package com.gdschongik.gdsc.domain.study.application;
 
+import static com.gdschongik.gdsc.global.exception.ErrorCode.STUDY_NOT_FOUND;
+
 import com.gdschongik.gdsc.domain.member.domain.Member;
 import com.gdschongik.gdsc.domain.study.dao.StudyAnnouncementRepository;
+import com.gdschongik.gdsc.domain.study.dao.StudyDetailRepository;
 import com.gdschongik.gdsc.domain.study.dao.StudyHistoryRepository;
 import com.gdschongik.gdsc.domain.study.dao.StudyRepository;
+import com.gdschongik.gdsc.domain.study.domain.*;
 import com.gdschongik.gdsc.domain.study.domain.Study;
 import com.gdschongik.gdsc.domain.study.domain.StudyAnnouncement;
 import com.gdschongik.gdsc.domain.study.domain.StudyHistory;
 import com.gdschongik.gdsc.domain.study.domain.StudyValidator;
 import com.gdschongik.gdsc.domain.study.dto.request.StudyAnnouncementCreateUpdateRequest;
+import com.gdschongik.gdsc.domain.study.dto.request.StudySessionCreateRequest;
+import com.gdschongik.gdsc.domain.study.dto.request.StudyUpdateRequest;
 import com.gdschongik.gdsc.domain.study.dto.response.MentorStudyResponse;
 import com.gdschongik.gdsc.domain.study.dto.response.StudyStudentResponse;
 import com.gdschongik.gdsc.global.exception.CustomException;
 import com.gdschongik.gdsc.global.exception.ErrorCode;
 import com.gdschongik.gdsc.global.util.MemberUtil;
+import java.util.ArrayList;
 import java.util.List;
+import java.util.Map;
+import java.util.function.Function;
+import java.util.stream.Collectors;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.stereotype.Service;
@@ -30,6 +40,8 @@ public class MentorStudyService {
     private final StudyAnnouncementRepository studyAnnouncementRepository;
     private final StudyHistoryRepository studyHistoryRepository;
     private final StudyValidator studyValidator;
+    private final StudyDetailRepository studyDetailRepository;
+    private final StudyDetailValidator studyDetailValidator;
 
     @Transactional(readOnly = true)
     public List<MentorStudyResponse> getStudiesInCharge() {
@@ -90,4 +102,39 @@ public void deleteStudyAnnouncement(Long studyAnnouncementId) {
 
         log.info("[MentorStudyService] 스터디 공지 삭제 완료: studyAnnouncementId={}", studyAnnouncement.getId());
     }
+
+    // TODO session -> curriculum 변경
+    @Transactional
+    public void updateStudy(Long studyId, StudyUpdateRequest request) {
+        Member currentMember = memberUtil.getCurrentMember();
+        Study study = studyRepository.findById(studyId).orElseThrow(() -> new CustomException(STUDY_NOT_FOUND));
+        studyValidator.validateStudyMentor(currentMember, study);
+
+        List<StudyDetail> studyDetails = studyDetailRepository.findAllByStudyId(studyId);
+        studyDetailValidator.validateUpdateStudyDetail(studyDetails, request.studySessions());
+
+        study.update(request.notionLink(), request.introduction());
+        studyRepository.save(study);
+        log.info("[MentorStudyService] 스터디 기본 정보 수정 완료: studyId={}", studyId);
+
+        Map<Long, StudySessionCreateRequest> requestMap = request.studySessions().stream()
+                .collect(Collectors.toMap(StudySessionCreateRequest::studyDetailId, Function.identity()));
+
+        List<StudyDetail> updatedStudyDetails = new ArrayList<>();
+        for (StudyDetail studyDetail : studyDetails) {
+            Long id = studyDetail.getId();
+            StudySessionCreateRequest matchingSession = requestMap.get(id);
+
+            studyDetail.updateSession(
+                    studyDetail.getStudy().getPeriod().getStartDate(),
+                    matchingSession.title(),
+                    matchingSession.description(),
+                    matchingSession.difficulty(),
+                    matchingSession.status());
+
+            updatedStudyDetails.add(studyDetail);
+        }
+        studyDetailRepository.saveAll(updatedStudyDetails);
+        log.info("[MentorStudyService] 스터디 상세정보 커리큘럼 작성 완료: studyDetailId={}", studyDetails);
+    }
 }

src/main/java/com/gdschongik/gdsc/domain/study/domain/Study.java

@@ -182,4 +182,9 @@ public boolean isStudyOngoing() {
     public LocalDate getStartDate() {
         return period.getStartDate().toLocalDate();
     }
+
+    public void update(String link, String intro) {
+        notionLink = link;
+        introduction = intro;
+    }
 }

src/main/java/com/gdschongik/gdsc/domain/study/domain/StudyDetail.java

@@ -101,6 +101,11 @@ public LocalDate getAttendanceDay() {
                         - study.getStartDate().getDayOfWeek().getValue());
     }
 
+    public void updateSession(
+            LocalDateTime startAt, String title, String description, Difficulty difficulty, StudyStatus status) {
+        session = Session.generateSession(startAt, title, description, difficulty, status);
+    }
+
     public void validateAssignmentSubmittable(LocalDateTime now) {
         if (now.isBefore(period.getStartDate())) {
             throw new CustomException(ASSIGNMENT_SUBMIT_NOT_STARTED);

src/main/java/com/gdschongik/gdsc/domain/study/domain/StudyDetailValidator.java

@@ -4,9 +4,13 @@
 
 import com.gdschongik.gdsc.domain.member.domain.Member;
 import com.gdschongik.gdsc.domain.study.dto.request.AssignmentCreateUpdateRequest;
+import com.gdschongik.gdsc.domain.study.dto.request.StudySessionCreateRequest;
 import com.gdschongik.gdsc.global.annotation.DomainService;
 import com.gdschongik.gdsc.global.exception.CustomException;
 import java.time.LocalDateTime;
+import java.util.List;
+import java.util.Set;
+import java.util.stream.Collectors;
 
 @DomainService
 public class StudyDetailValidator {
@@ -54,4 +58,23 @@ private void validateUpdateDeadline(
             throw new CustomException(STUDY_DETAIL_ASSIGNMENT_INVALID_UPDATE_DEADLINE);
         }
     }
+
+    public void validateUpdateStudyDetail(List<StudyDetail> studyDetails, List<StudySessionCreateRequest> requests) {
+        // StudyDetail 목록과 요청된 StudySessionCreateRequest 목록의 크기를 먼저 비교
+        if (studyDetails.size() != requests.size()) {
+            throw new CustomException(STUDY_DETAIL_SESSION_SIZE_MISMATCH);
+        }
+
+        // StudyDetail ID를 추출하여 Set으로 저장
+        Set<Long> studyDetailIds = studyDetails.stream().map(StudyDetail::getId).collect(Collectors.toSet());
+
+        // 요청된 StudySessionCreateRequest의 StudyDetail ID를 추출하여 Set으로 저장
+        Set<Long> requestIds =
+                requests.stream().map(StudySessionCreateRequest::studyDetailId).collect(Collectors.toSet());
+
+        // 두 ID 집합이 동일한지 비교하여 ID 불일치 시 예외를 던짐
+        if (!studyDetailIds.equals(requestIds)) {
+            throw new CustomException(STUDY_DETAIL_ID_INVALID);
+        }
+    }
 }

src/main/java/com/gdschongik/gdsc/domain/study/domain/vo/Session.java

@@ -45,4 +45,15 @@ private Session(
     public static Session createEmptySession() {
         return Session.builder().status(StudyStatus.NONE).build();
     }
+
+    public static Session generateSession(
+            LocalDateTime startAt, String title, String description, Difficulty difficulty, StudyStatus status) {
+        return Session.builder()
+                .startAt(startAt)
+                .title(title)
+                .description(description)
+                .difficulty(difficulty)
+                .status(status)
+                .build();
+    }
 }

src/main/java/com/gdschongik/gdsc/domain/study/dto/request/StudySessionCreateRequest.java

@@ -0,0 +1,13 @@
+package com.gdschongik.gdsc.domain.study.dto.request;
+
+import com.gdschongik.gdsc.domain.study.domain.Difficulty;
+import com.gdschongik.gdsc.domain.study.domain.StudyStatus;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+
+public record StudySessionCreateRequest(
+        @NotNull Long studyDetailId,
+        @Schema(description = "제목") String title,
+        @Schema(description = "설명") String description,
+        @Schema(description = "난이도") Difficulty difficulty,
+        @Schema(description = "휴강 여부") StudyStatus status) {}

src/main/java/com/gdschongik/gdsc/domain/study/dto/request/StudyUpdateRequest.java

@@ -0,0 +1,9 @@
+package com.gdschongik.gdsc.domain.study.dto.request;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import java.util.List;
+
+public record StudyUpdateRequest(
+        @Schema(description = "스터디 소개 페이지 링크") String notionLink,
+        @Schema(description = "스터디 한 줄 소개") String introduction,
+        List<StudySessionCreateRequest> studySessions) {}

src/main/java/com/gdschongik/gdsc/global/exception/ErrorCode.java

@@ -114,7 +114,8 @@ public enum ErrorCode {
     STUDY_DETAIL_UPDATE_RESTRICTED_TO_MENTOR(HttpStatus.CONFLICT, "해당 스터디의 멘토만 수정할 수 있습니다."),
     STUDY_DETAIL_ASSIGNMENT_INVALID_DEADLINE(HttpStatus.CONFLICT, "마감기한이 지난 과제의 마감기한을 수정할 수 없습니다"),
     STUDY_DETAIL_ASSIGNMENT_INVALID_UPDATE_DEADLINE(HttpStatus.CONFLICT, "수정하려고 하는 과제의 마감기한은 기존의 마감기한보다 빠르면 안됩니다."),
-
+    STUDY_DETAIL_ID_INVALID(HttpStatus.CONFLICT, "수정하려는 스터디 상세정보가 서버에 존재하지 않거나 유효하지 않습니다."),
+    STUDY_DETAIL_SESSION_SIZE_MISMATCH(HttpStatus.BAD_REQUEST, "스터디 커리큘럼의 총 개수가 일치하지 않습니다."),
     // StudyHistory
     STUDY_HISTORY_NOT_FOUND(HttpStatus.NOT_FOUND, "존재하지 않는 스터디 수강 기록입니다."),
     STUDY_HISTORY_DUPLICATE(HttpStatus.CONFLICT, "이미 해당 스터디를 신청했습니다."),
@@ -168,7 +169,6 @@ public enum ErrorCode {
     GITHUB_COMMIT_DATE_FETCH_FAILED(HttpStatus.INTERNAL_SERVER_ERROR, "깃허브 커밋 날짜 조회에 실패했습니다."),
     GITHUB_ASSIGNMENT_NOT_FOUND(HttpStatus.NOT_FOUND, "존재하지 않는 과제 파일입니다."),
     ;
-
     private final HttpStatus status;
     private final String message;
 }

src/test/java/com/gdschongik/gdsc/domain/study/application/MentorStudyServiceTest.java

@@ -0,0 +1,79 @@
+package com.gdschongik.gdsc.domain.study.application;
+
+import static com.gdschongik.gdsc.global.common.constant.StudyConstant.*;
+import static com.gdschongik.gdsc.global.common.constant.StudyConstant.SESSION_DESCRIPTION;
+import static org.assertj.core.api.Assertions.assertThat;
+
+import com.gdschongik.gdsc.domain.member.domain.Member;
+import com.gdschongik.gdsc.domain.member.domain.MemberRole;
+import com.gdschongik.gdsc.domain.recruitment.domain.vo.Period;
+import com.gdschongik.gdsc.domain.study.domain.Difficulty;
+import com.gdschongik.gdsc.domain.study.domain.Study;
+import com.gdschongik.gdsc.domain.study.domain.StudyDetail;
+import com.gdschongik.gdsc.domain.study.domain.StudyStatus;
+import com.gdschongik.gdsc.domain.study.dto.request.StudySessionCreateRequest;
+import com.gdschongik.gdsc.domain.study.dto.request.StudyUpdateRequest;
+import com.gdschongik.gdsc.helper.IntegrationTest;
+import java.time.LocalDateTime;
+import java.util.*;
+import org.junit.jupiter.api.*;
+import org.springframework.beans.factory.annotation.Autowired;
+
+public class MentorStudyServiceTest extends IntegrationTest {
+
+    @Autowired
+    private MentorStudyService mentorStudyService;
+
+    @Nested
+    class 스터디_정보_작성시 {
+
+        @Test
+        void 성공한다() {
+            // given
+            LocalDateTime now = LocalDateTime.now();
+            Member mentor = createMentor();
+            Study study = createNewStudy(
+                    mentor,
+                    4L,
+                    Period.createPeriod(now.plusDays(5), now.plusDays(10)),
+                    Period.createPeriod(now.minusDays(5), now));
+            for (int i = 1; i <= 4; i++) {
+                Long week = (long) i;
+                createNewStudyDetail(week, study, now, now.plusDays(7));
+                now = now.plusDays(8);
+            }
+            logoutAndReloginAs(study.getMentor().getId(), MemberRole.ASSOCIATE);
+
+            List<StudySessionCreateRequest> sessionCreateRequests = new ArrayList<>();
+            for (int i = 1; i <= study.getTotalWeek(); i++) {
+                Long id = (long) i;
+                StudySessionCreateRequest sessionCreateRequest = new StudySessionCreateRequest(
+                        id, SESSION_TITLE + i, SESSION_DESCRIPTION + i, Difficulty.HIGH, StudyStatus.OPEN);
+                sessionCreateRequests.add(sessionCreateRequest);
+            }
+
+            StudyUpdateRequest request =
+                    new StudyUpdateRequest(STUDY_NOTION_LINK, STUDY_INTRODUCTION, sessionCreateRequests);
+
+            // when
+            mentorStudyService.updateStudy(1L, request);
+
+            // then
+            Study savedStudy = studyRepository.findById(study.getId()).get();
+            assertThat(savedStudy.getNotionLink()).isEqualTo(request.notionLink());
+            assertThat(savedStudy.getIntroduction()).isEqualTo(request.introduction());
+
+            List<StudyDetail> studyDetails = studyDetailRepository.findAllByStudyId(1L);
+            for (int i = 0; i < studyDetails.size(); i++) {
+                StudyDetail studyDetail = studyDetails.get(i);
+                Long expectedId = studyDetail.getId();
+
+                assertThat(studyDetail.getId()).isEqualTo(expectedId);
+                assertThat(studyDetail.getSession().getTitle()).isEqualTo(SESSION_TITLE + expectedId);
+                assertThat(studyDetail.getSession().getDescription()).isEqualTo(SESSION_DESCRIPTION + expectedId);
+                assertThat(studyDetail.getSession().getDifficulty()).isEqualTo(Difficulty.HIGH);
+                assertThat(studyDetail.getSession().getStatus()).isEqualTo(StudyStatus.OPEN);
+            }
+        }
+    }
+}