✨ [STMT-266] 관리자 위임 API 구현 (#150)

* ✨ [STMT-266] 관리자 위임 API 구현

* ✅ [STMT-266] 관리자 위임 API 테스트 케이스 작성

* 📝 [STMT-266] 관리자 위임 API 명세서 작성

src/docs/asciidoc/index.adoc

@@ -413,6 +413,34 @@ include::{snippets}/study-member-join/fail/not-exist-study/response-fields.adoc[
 include::{snippets}/study-member-join/fail/not-exist-member/response-body.adoc[]
 include::{snippets}/study-member-join/fail/not-exist-member/response-fields.adoc[]
 
+=== 관리자 위임
+
+다른 멤버에게 관리자를 위임하는 API입니다.
+
+==== PATCH /v1/api/studies/{studyId}/members/{memberId}/admin/delegate
+
+===== 요청
+include::{snippets}/delegate-admin/success/http-request.adoc[]
+
+====== 헤더
+include::{snippets}/delegate-admin/success/request-headers.adoc[]
+
+====== 경로 변수
+include::{snippets}/delegate-admin/success/path-parameters.adoc[]
+
+===== 응답 성공 (200)
+include::{snippets}/delegate-admin/success/response-body.adoc[]
+include::{snippets}/delegate-admin/success/response-fields.adoc[]
+
+===== 응답 실패 (403)
+.요청자가 해당 스터디 관리자가 아닌 경우
+include::{snippets}/delegate-admin/fail/not-admin/response-body.adoc[]
+include::{snippets}/delegate-admin/fail/not-admin/response-fields.adoc[]
+
+.위임 대상자가 스터디 멤버가 아닌 경우
+include::{snippets}/delegate-admin/fail/member-not-joined/response-body.adoc[]
+include::{snippets}/delegate-admin/fail/member-not-joined/response-fields.adoc[]
+
 == 파일 관리
 
 === Presigned URL 발급

src/main/java/com/stumeet/server/studymember/adapter/in/web/AdminDelegationApi.java

@@ -0,0 +1,34 @@
+package com.stumeet.server.studymember.adapter.in.web;
+
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.core.annotation.AuthenticationPrincipal;
+import org.springframework.web.bind.annotation.PatchMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.RequestMapping;
+
+import com.stumeet.server.common.annotation.WebAdapter;
+import com.stumeet.server.common.auth.model.LoginMember;
+import com.stumeet.server.common.model.ApiResponse;
+import com.stumeet.server.common.response.SuccessCode;
+import com.stumeet.server.studymember.application.port.in.AdminDelegationUseCase;
+
+import lombok.RequiredArgsConstructor;
+
+@WebAdapter
+@RequestMapping("/api/v1")
+@RequiredArgsConstructor
+public class AdminDelegationApi {
+
+    private final AdminDelegationUseCase adminDelegationUseCase;
+
+    @PatchMapping("/studies/{studyId}/members/{memberId}/admin/delegate")
+    public ResponseEntity<ApiResponse<Void>> delegateAdmin(
+            @AuthenticationPrincipal LoginMember member,
+            @PathVariable Long studyId,
+            @PathVariable Long memberId
+    ) {
+        adminDelegationUseCase.delegateAdmin(studyId, member.getId(), memberId);
+
+        return ResponseEntity.ok(ApiResponse.success(SuccessCode.UPDATE_SUCCESS));
+    }
+}

src/main/java/com/stumeet/server/studymember/adapter/out/persistence/AdminManagementAdapter.java

@@ -0,0 +1,19 @@
+package com.stumeet.server.studymember.adapter.out.persistence;
+
+import com.stumeet.server.common.annotation.PersistenceAdapter;
+import com.stumeet.server.studymember.application.port.out.AdminManagementPort;
+
+import lombok.RequiredArgsConstructor;
+
+@PersistenceAdapter
+@RequiredArgsConstructor
+public class AdminManagementAdapter implements AdminManagementPort {
+
+    private final JpaStudyMemberRepository jpaStudyMemberRepository;
+
+    @Override
+    public void delegateAdmin(Long studyId, Long adminId, Long memberId) {
+        jpaStudyMemberRepository.removeAdmin(studyId, adminId);
+        jpaStudyMemberRepository.appointAdmin(studyId, memberId);
+    }
+}

src/main/java/com/stumeet/server/studymember/adapter/out/persistence/JpaStudyMemberRepository.java

@@ -1,11 +1,27 @@
 package com.stumeet.server.studymember.adapter.out.persistence;
 
 import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.data.jpa.repository.Modifying;
+import org.springframework.data.jpa.repository.Query;
 
 public interface JpaStudyMemberRepository extends JpaRepository<StudyMemberJpaEntity, Long>, JpaStudyMemberRepositoryCustom {
     long countByStudyId(Long studyId);
 
     void deleteByStudyIdAndMemberId(Long studyId, Long memberId);
 
     void deleteAllByStudyId(Long studyId);
+
+    @Modifying
+    @Query("UPDATE StudyMemberJpaEntity sm "
+            + "SET sm.isAdmin = false "
+            + "WHERE sm.study.id = :studyId "
+            + "AND sm.member.id = :adminId")
+    void removeAdmin(Long studyId, Long adminId);
+
+    @Modifying
+    @Query("UPDATE StudyMemberJpaEntity sm "
+            + "SET sm.isAdmin = true "
+            + "WHERE sm.study.id = :studyId "
+            + "AND sm.member.id = :memberId")
+    void appointAdmin(Long studyId, Long memberId);
 }

src/main/java/com/stumeet/server/studymember/application/port/in/AdminDelegationUseCase.java

@@ -0,0 +1,6 @@
+package com.stumeet.server.studymember.application.port.in;
+
+public interface AdminDelegationUseCase {
+
+    void delegateAdmin(Long studyId, Long adminId, Long memberId);
+}

src/main/java/com/stumeet/server/studymember/application/port/out/AdminManagementPort.java

@@ -0,0 +1,6 @@
+package com.stumeet.server.studymember.application.port.out;
+
+public interface AdminManagementPort {
+
+    void delegateAdmin(Long studyId, Long adminId, Long memberId);
+}

src/main/java/com/stumeet/server/studymember/application/service/AdminDelegationService.java

@@ -0,0 +1,27 @@
+package com.stumeet.server.studymember.application.service;
+
+import org.springframework.transaction.annotation.Transactional;
+
+import com.stumeet.server.common.annotation.UseCase;
+import com.stumeet.server.studymember.application.port.in.AdminDelegationUseCase;
+import com.stumeet.server.studymember.application.port.in.StudyMemberValidationUseCase;
+import com.stumeet.server.studymember.application.port.out.AdminManagementPort;
+
+import lombok.RequiredArgsConstructor;
+
+@Transactional
+@UseCase
+@RequiredArgsConstructor
+public class AdminDelegationService implements AdminDelegationUseCase {
+
+    private final StudyMemberValidationUseCase studyMemberValidationUseCase;
+    private final AdminManagementPort adminManagementPort;
+
+    @Override
+    public void delegateAdmin(Long studyId, Long adminId, Long memberId) {
+        studyMemberValidationUseCase.checkAdmin(studyId, adminId);
+        studyMemberValidationUseCase.checkStudyJoinMember(studyId, memberId);
+
+        adminManagementPort.delegateAdmin(studyId, adminId, memberId);
+    }
+}

src/test/java/com/stumeet/server/studymember/adapter/in/web/AdminDelegationApiTest.java

@@ -0,0 +1,101 @@
+package com.stumeet.server.studymember.adapter.in.web;
+
+import static org.springframework.restdocs.headers.HeaderDocumentation.*;
+import static org.springframework.restdocs.mockmvc.MockMvcRestDocumentation.*;
+import static org.springframework.restdocs.mockmvc.RestDocumentationRequestBuilders.patch;
+import static org.springframework.restdocs.operation.preprocess.Preprocessors.*;
+import static org.springframework.restdocs.payload.PayloadDocumentation.*;
+import static org.springframework.restdocs.request.RequestDocumentation.*;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
+
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Nested;
+import org.junit.jupiter.api.Test;
+
+import com.stumeet.server.common.auth.model.AuthenticationHeader;
+import com.stumeet.server.helper.WithMockMember;
+import com.stumeet.server.stub.MemberStub;
+import com.stumeet.server.stub.StudyStub;
+import com.stumeet.server.stub.TokenStub;
+import com.stumeet.server.template.ApiTest;
+
+class AdminDelegationApiTest extends ApiTest {
+
+    @Nested
+    @DisplayName("관리자 위임")
+    class DelegateAdmin {
+        private static final String PATH = "/api/v1/studies/{studyId}/members/{memberId}/admin/delegate";
+
+        @DisplayName("[성공] 관리자 위임에 성공한다.")
+        @Test
+        @WithMockMember
+        void success() throws Exception {
+            Long studyId = StudyStub.getStudyId();
+            Long memberId = 2L;
+
+            mockMvc.perform(patch(PATH, studyId, memberId)
+                    .header(AuthenticationHeader.ACCESS_TOKEN.getName(), TokenStub.getMockAccessToken()))
+                    .andExpect(status().isOk())
+                    .andDo(document("delegate-admin/success",
+                            preprocessRequest(prettyPrint()),
+                            preprocessResponse(prettyPrint()),
+                            requestHeaders(
+                                    headerWithName(AuthenticationHeader.ACCESS_TOKEN.getName()).description("서버로부터 전달받은 액세스 토큰")
+                            ),
+                            pathParameters(
+                                    parameterWithName("studyId").description("스터디 ID"),
+                                    parameterWithName("memberId").description("관리자 위임할 멤버 ID")
+                            ),
+                            responseFields(
+                                    fieldWithPath("code").description("응답 코드"),
+                                    fieldWithPath("message").description("응답 메시지")
+                            )));
+        }
+
+        @DisplayName("[실패] 요청자가 해당 스터디의 관리자가 아닌 경우 관리자 위임에 실패한다.")
+        @Test
+        @WithMockMember(id = 2L)
+        void fail_when_not_admin() throws Exception {
+            Long studyId = StudyStub.getStudyId();
+            Long memberId = MemberStub.getMemberId();
+
+            mockMvc.perform(patch(PATH, studyId, memberId)
+                            .header(AuthenticationHeader.ACCESS_TOKEN.getName(), TokenStub.getMockAccessToken()))
+                    .andExpect(status().isForbidden())
+                    .andDo(document("delegate-admin/fail/not-admin",
+                            preprocessRequest(prettyPrint()),
+                            preprocessResponse(prettyPrint()),
+                            pathParameters(
+                                    parameterWithName("studyId").description("스터디 ID"),
+                                    parameterWithName("memberId").description("관리자 위임할 멤버 ID")
+                            ),
+                            responseFields(
+                                    fieldWithPath("code").description("응답 코드"),
+                                    fieldWithPath("message").description("응답 메시지")
+                            )));
+        }
+
+        @DisplayName("[실패] 위임 대상자가 스터디 멤버가 아닌 경우 관리자 위임에 실패한다.")
+        @Test
+        @WithMockMember
+        void fail_when_not_study_member() throws Exception {
+            Long studyId = StudyStub.getStudyId();
+            Long memberId = 3L;
+
+            mockMvc.perform(patch(PATH, studyId, memberId)
+                            .header(AuthenticationHeader.ACCESS_TOKEN.getName(), TokenStub.getMockAccessToken()))
+                    .andExpect(status().isForbidden())
+                    .andDo(document("delegate-admin/fail/member-not-joined",
+                            preprocessRequest(prettyPrint()),
+                            preprocessResponse(prettyPrint()),
+                            pathParameters(
+                                    parameterWithName("studyId").description("스터디 ID"),
+                                    parameterWithName("memberId").description("관리자 위임할 멤버 ID")
+                            ),
+                            responseFields(
+                                    fieldWithPath("code").description("응답 코드"),
+                                    fieldWithPath("message").description("응답 메시지")
+                            )));
+        }
+    }
+}