feat: 어드민 멘토 승격 지원서 승인/거절 기능, 상태 별 지원서 개수 조회 기능 추가

src/main/java/com/example/solidconnection/admin/controller/AdminMentorApplicationController.java

@@ -1,5 +1,7 @@
 package com.example.solidconnection.admin.controller;
 
+import com.example.solidconnection.admin.dto.MentorApplicationCountResponse;
+import com.example.solidconnection.admin.dto.MentorApplicationRejectRequest;
 import com.example.solidconnection.admin.dto.MentorApplicationSearchCondition;
 import com.example.solidconnection.admin.dto.MentorApplicationSearchResponse;
 import com.example.solidconnection.admin.service.AdminMentorApplicationService;
@@ -12,6 +14,9 @@
 import org.springframework.http.ResponseEntity;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.ModelAttribute;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
 
@@ -34,4 +39,27 @@ public ResponseEntity<PageResponse<MentorApplicationSearchResponse>> searchMento
 
         return ResponseEntity.ok(PageResponse.of(page));
     }
+
+    @PostMapping("/{mentorApplicationId}/approve")
+    public ResponseEntity<Void> approveMentorApplication(
+            @PathVariable("mentorApplicationId") Long mentorApplicationId
+    ) {
+        adminMentorApplicationService.approveMentorApplication(mentorApplicationId);
+        return ResponseEntity.ok().build();
+    }
+
+    @PostMapping("/{mentorApplicationId}/reject")
+    public ResponseEntity<Void> rejectMentorApplication(
+            @PathVariable("mentorApplicationId") Long mentorApplicationId,
+            @Valid @RequestBody MentorApplicationRejectRequest request
+    ) {
+        adminMentorApplicationService.rejectMentorApplication(mentorApplicationId, request);
+        return ResponseEntity.ok().build();
+    }
+
+    @GetMapping("/count")
+    public ResponseEntity<MentorApplicationCountResponse> getMentorApplicationCount() {
+        MentorApplicationCountResponse response = adminMentorApplicationService.getMentorApplicationCount();
+        return ResponseEntity.ok(response);
+    }
 }

src/main/java/com/example/solidconnection/admin/dto/MentorApplicationCountResponse.java

@@ -0,0 +1,9 @@
+package com.example.solidconnection.admin.dto;
+
+public record MentorApplicationCountResponse(
+        long approved,
+        long pending,
+        long rejected
+) {
+
+}

src/main/java/com/example/solidconnection/admin/dto/MentorApplicationRejectRequest.java

@@ -0,0 +1,12 @@
+package com.example.solidconnection.admin.dto;
+
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Size;
+
+public record MentorApplicationRejectRequest(
+        @NotBlank(message = "거절 사유는 필수입니다")
+        @Size(max = 200, message = "거절 사유는 200자를 초과할 수 없습니다")
+        String rejectedReason
+) {
+
+}

src/main/java/com/example/solidconnection/admin/service/AdminMentorApplicationService.java

@@ -1,7 +1,15 @@
 package com.example.solidconnection.admin.service;
 
+import static com.example.solidconnection.common.exception.ErrorCode.MENTOR_APPLICATION_NOT_FOUND;
+import static com.example.solidconnection.common.exception.ErrorCode.MENTOR_APPLICATION_UNIVERSITY_NOT_SELECTED;
+
+import com.example.solidconnection.admin.dto.MentorApplicationCountResponse;
+import com.example.solidconnection.admin.dto.MentorApplicationRejectRequest;
 import com.example.solidconnection.admin.dto.MentorApplicationSearchCondition;
 import com.example.solidconnection.admin.dto.MentorApplicationSearchResponse;
+import com.example.solidconnection.common.exception.CustomException;
+import com.example.solidconnection.mentor.domain.MentorApplication;
+import com.example.solidconnection.mentor.domain.MentorApplicationStatus;
 import com.example.solidconnection.mentor.repository.MentorApplicationRepository;
 import lombok.RequiredArgsConstructor;
 import org.springframework.data.domain.Page;
@@ -22,4 +30,37 @@ public Page<MentorApplicationSearchResponse> searchMentorApplications(
     ) {
         return mentorApplicationRepository.searchMentorApplications(mentorApplicationSearchCondition, pageable);
     }
+
+    @Transactional
+    public void approveMentorApplication(Long mentorApplicationId) {
+        MentorApplication mentorApplication = mentorApplicationRepository.findById(mentorApplicationId)
+                .orElseThrow(() -> new CustomException(MENTOR_APPLICATION_NOT_FOUND));
+
+        if(mentorApplication.getUniversityId() == null){
+            throw new CustomException(MENTOR_APPLICATION_UNIVERSITY_NOT_SELECTED);
+        }
+
+        mentorApplication.approve();
+    }
+
+    @Transactional
+    public void rejectMentorApplication(long mentorApplicationId, MentorApplicationRejectRequest request) {
+        MentorApplication mentorApplication = mentorApplicationRepository.findById(mentorApplicationId)
+                .orElseThrow(() -> new CustomException(MENTOR_APPLICATION_NOT_FOUND));
+
+        mentorApplication.reject(request.rejectedReason());
+    }
+
+    @Transactional(readOnly = true)
+    public MentorApplicationCountResponse getMentorApplicationCount() {
+        long approvedCount = mentorApplicationRepository.countByMentorApplicationStatus(MentorApplicationStatus.APPROVED);
+        long pendingCount = mentorApplicationRepository.countByMentorApplicationStatus(MentorApplicationStatus.PENDING);
+        long rejectedCount = mentorApplicationRepository.countByMentorApplicationStatus(MentorApplicationStatus.REJECTED);
+
+        return new MentorApplicationCountResponse(
+                approvedCount,
+                pendingCount,
+                rejectedCount
+        );
+    }
 }

src/main/java/com/example/solidconnection/common/exception/ErrorCode.java

@@ -129,6 +129,8 @@ public enum ErrorCode {
     UNIVERSITY_ID_MUST_BE_NULL_FOR_OTHER(HttpStatus.BAD_REQUEST.value(), "기타 학교를 선택한 경우 학교 정보를 입력할 수 없습니다."),
     INVALID_UNIVERSITY_SELECT_TYPE(HttpStatus.BAD_REQUEST.value(), "지원하지 않는 학교 선택 방식입니다."),
     MENTOR_ALREADY_EXISTS(HttpStatus.BAD_REQUEST.value(), "이미 존재하는 멘토입니다."),
+    MENTOR_APPLICATION_ALREADY_CONFIRM(HttpStatus.BAD_REQUEST.value(), "이미 승인 또는 거절된 멘토 승격 요청 입니다."),
+    MENTOR_APPLICATION_UNIVERSITY_NOT_SELECTED(HttpStatus.BAD_REQUEST.value(), "승인하려는 멘토 신청에 대학교가 선택되지 않았습니다."),
 
     // socket
     UNAUTHORIZED_SUBSCRIBE(HttpStatus.FORBIDDEN.value(), "구독 권한이 없습니다."),

src/main/java/com/example/solidconnection/mentor/domain/MentorApplication.java

@@ -1,5 +1,9 @@
 package com.example.solidconnection.mentor.domain;
 
+import static com.example.solidconnection.common.exception.ErrorCode.MENTOR_APPLICATION_ALREADY_CONFIRM;
+import static java.time.ZoneOffset.UTC;
+import static java.time.temporal.ChronoUnit.MICROS;
+
 import com.example.solidconnection.common.BaseEntity;
 import com.example.solidconnection.common.exception.CustomException;
 import com.example.solidconnection.common.exception.ErrorCode;
@@ -116,4 +120,20 @@ private void validateExchangeStatus(ExchangeStatus exchangeStatus) {
             throw new CustomException(ErrorCode.INVALID_EXCHANGE_STATUS_FOR_MENTOR);
         }
     }
+
+    public void approve(){
+        if(this.mentorApplicationStatus != MentorApplicationStatus.PENDING) {
+            throw new CustomException(MENTOR_APPLICATION_ALREADY_CONFIRM);
+        }
+        this.mentorApplicationStatus = MentorApplicationStatus.APPROVED;
+        this.approvedAt = ZonedDateTime.now(UTC).truncatedTo(MICROS);
+    }
+
+    public void reject(String rejectedReason){
+        if(this.mentorApplicationStatus != MentorApplicationStatus.PENDING) {
+            throw new CustomException(MENTOR_APPLICATION_ALREADY_CONFIRM);
+        }
+        this.mentorApplicationStatus = MentorApplicationStatus.REJECTED;
+        this.rejectedReason = rejectedReason;
+    }
 }

src/main/java/com/example/solidconnection/mentor/repository/MentorApplicationRepository.java

@@ -12,4 +12,6 @@ public interface MentorApplicationRepository extends JpaRepository<MentorApplica
     boolean existsBySiteUserIdAndMentorApplicationStatusIn(long siteUserId, List<MentorApplicationStatus> mentorApplicationStatuses);
 
     Optional<MentorApplication> findBySiteUserIdAndMentorApplicationStatus(long siteUserId, MentorApplicationStatus mentorApplicationStatus);
+
+    long countByMentorApplicationStatus(MentorApplicationStatus mentorApplicationStatus);
 }

src/test/java/com/example/solidconnection/admin/service/AdminMentorApplicationServiceTest.java

@@ -1,13 +1,21 @@
 package com.example.solidconnection.admin.service;
 
+import static com.example.solidconnection.common.exception.ErrorCode.MENTOR_APPLICATION_ALREADY_CONFIRM;
+import static com.example.solidconnection.common.exception.ErrorCode.MENTOR_APPLICATION_NOT_FOUND;
+import static com.example.solidconnection.common.exception.ErrorCode.MENTOR_APPLICATION_UNIVERSITY_NOT_SELECTED;
 import static org.assertj.core.api.Assertions.assertThat;
+import static org.assertj.core.api.AssertionsForClassTypes.assertThatCode;
 
+import com.example.solidconnection.admin.dto.MentorApplicationCountResponse;
+import com.example.solidconnection.admin.dto.MentorApplicationRejectRequest;
 import com.example.solidconnection.admin.dto.MentorApplicationSearchCondition;
 import com.example.solidconnection.admin.dto.MentorApplicationSearchResponse;
+import com.example.solidconnection.common.exception.CustomException;
 import com.example.solidconnection.mentor.domain.MentorApplication;
 import com.example.solidconnection.mentor.domain.MentorApplicationStatus;
 import com.example.solidconnection.mentor.domain.UniversitySelectType;
 import com.example.solidconnection.mentor.fixture.MentorApplicationFixture;
+import com.example.solidconnection.mentor.repository.MentorApplicationRepository;
 import com.example.solidconnection.siteuser.domain.SiteUser;
 import com.example.solidconnection.siteuser.fixture.SiteUserFixture;
 import com.example.solidconnection.support.TestContainerSpringBootTest;
@@ -40,6 +48,9 @@ class AdminMentorApplicationServiceTest {
     @Autowired
     private UniversityFixture universityFixture;
 
+    @Autowired
+    private MentorApplicationRepository mentorApplicationRepository;
+
     private MentorApplication mentorApplication1;
     private MentorApplication mentorApplication2;
     private MentorApplication mentorApplication3;
@@ -209,4 +220,156 @@ class 멘토_승격_지원서_목록_조회 {
                     .containsOnly(regionKoreanName);
         }
     }
+
+    @Nested
+    class 멘토_승격_지원서_승인{
+
+        @Test
+        void 대기중인_멘토_지원서를_승인한다() {
+            // given
+            long pendingMentorApplicationId = mentorApplication2.getId();
+
+            // when
+            adminMentorApplicationService.approveMentorApplication(pendingMentorApplicationId);
+
+            // then
+            MentorApplication result = mentorApplicationRepository.findById(mentorApplication2.getId()).get();
+            assertThat(result.getMentorApplicationStatus()).isEqualTo(MentorApplicationStatus.APPROVED);
+            assertThat(result.getApprovedAt()).isNotNull();
+        }
+
+        @Test
+        void 대학이_선택되지_않은_멘토_지원서를_승인하면_예외가_발생한다(){
+            // given
+            SiteUser user = siteUserFixture.사용자();
+            MentorApplication noUniversityIdMentorApplication = mentorApplicationFixture.대기중_멘토신청(user.getId(), UniversitySelectType.OTHER, null);
+
+            // when & then
+            assertThatCode(() -> adminMentorApplicationService.approveMentorApplication(noUniversityIdMentorApplication.getId()))
+                    .isInstanceOf(CustomException.class)
+                    .hasMessage(MENTOR_APPLICATION_UNIVERSITY_NOT_SELECTED.getMessage());
+        }
+
+        @Test
+        void 이미_승인된_멘토_지원서를_승인하면_예외가_발생한다() {
+            // given
+            long approvedMentorApplicationId = mentorApplication1.getId();
+
+            // when & then
+            assertThatCode(() -> adminMentorApplicationService.approveMentorApplication(approvedMentorApplicationId))
+                    .isInstanceOf(CustomException.class)
+                    .hasMessage(MENTOR_APPLICATION_ALREADY_CONFIRM.getMessage());
+        }
+
+        @Test
+        void 이미_거절된_멘토_지원서를_승인하면_예외가_발생한다() {
+            // given
+            long rejectedMentorApplicationId = mentorApplication3.getId();
+
+            // when & then
+            assertThatCode(() -> adminMentorApplicationService.approveMentorApplication(rejectedMentorApplicationId))
+                    .isInstanceOf(CustomException.class)
+                    .hasMessage(MENTOR_APPLICATION_ALREADY_CONFIRM.getMessage());
+        }
+
+        @Test
+        void 존재하지_않는_멘토_지원서를_승인하면_예외가_발생한다() {
+            // given
+            long nonExistentId = 99999L;
+
+            // when & then
+            assertThatCode(() -> adminMentorApplicationService.approveMentorApplication(nonExistentId))
+                    .isInstanceOf(CustomException.class)
+                    .hasMessage(MENTOR_APPLICATION_NOT_FOUND.getMessage());
+        }
+    }
+
+    @Nested
+    class 멘토_승격_지원서_거절{
+
+        @Test
+        void 대기중인_멘토_지원서를_거절한다() {
+            // given
+            long pendingMentorApplicationId = mentorApplication2.getId();
+            MentorApplicationRejectRequest request = new MentorApplicationRejectRequest("파견학교 인증 자료 누락");
+
+            // when
+            adminMentorApplicationService.rejectMentorApplication(pendingMentorApplicationId, request);
+
+            // then
+            MentorApplication result = mentorApplicationRepository.findById(mentorApplication2.getId()).get();
+            assertThat(result.getMentorApplicationStatus()).isEqualTo(MentorApplicationStatus.REJECTED);
+            assertThat(result.getRejectedReason()).isEqualTo(request.rejectedReason());
+        }
+
+        @Test
+        void 이미_승인된_멘토_지원서를_거절하면_예외가_발생한다() {
+            // given
+            long approvedMentorApplicationId = mentorApplication1.getId();
+            MentorApplicationRejectRequest request = new MentorApplicationRejectRequest("파견학교 인증 자료 누락");
+
+            // when & then
+            assertThatCode(() -> adminMentorApplicationService.rejectMentorApplication(approvedMentorApplicationId, request))
+                    .isInstanceOf(CustomException.class)
+                    .hasMessage(MENTOR_APPLICATION_ALREADY_CONFIRM.getMessage());
+        }
+
+        @Test
+        void 이미_거절된_멘토_지원서를_거절하면_예외가_발생한다() {
+            // given
+            long rejectedMentorApplicationId = mentorApplication3.getId();
+            MentorApplicationRejectRequest request = new MentorApplicationRejectRequest("파견학교 인증 자료 누락");
+
+            // when & then
+            assertThatCode(() -> adminMentorApplicationService.rejectMentorApplication(rejectedMentorApplicationId, request))
+                    .isInstanceOf(CustomException.class)
+                    .hasMessage(MENTOR_APPLICATION_ALREADY_CONFIRM.getMessage());
+        }
+
+        @Test
+        void 존재하지_않는_멘토_지원서를_거절하면_예외가_발생한다() {
+            // given
+            long nonExistentId = 99999L;
+            MentorApplicationRejectRequest request = new MentorApplicationRejectRequest("파견학교 인증 자료 누락");
+
+            // when & then
+            assertThatCode(() -> adminMentorApplicationService.rejectMentorApplication(nonExistentId, request))
+                    .isInstanceOf(CustomException.class)
+                    .hasMessage(MENTOR_APPLICATION_NOT_FOUND.getMessage());
+        }
+    }
+
+    @Nested
+    class 멘토_지원서_상태별_개수_조회 {
+
+        @Test
+        void 상태별_멘토_지원서_개수를_조회한다() {
+            // given
+            List<MentorApplication> expectedApprovedCount = List.of(mentorApplication1, mentorApplication4);
+            List<MentorApplication> expectedPendingCount = List.of(mentorApplication2, mentorApplication5);
+            List<MentorApplication> expectedRejectedCount = List.of(mentorApplication3, mentorApplication6);
+
+            // when
+            MentorApplicationCountResponse response = adminMentorApplicationService.getMentorApplicationCount();
+
+            // then
+            assertThat(response.approved()).isEqualTo(expectedApprovedCount.size());
+            assertThat(response.pending()).isEqualTo(expectedPendingCount.size());
+            assertThat(response.rejected()).isEqualTo(expectedRejectedCount.size());
+        }
+
+        @Test
+        void 멘토_지원서가_없으면_모든_개수가_0이다() {
+            // given
+            mentorApplicationRepository.deleteAll();
+
+            // when
+            MentorApplicationCountResponse response = adminMentorApplicationService.getMentorApplicationCount();
+
+            // then
+            assertThat(response.approved()).isEqualTo(0L);
+            assertThat(response.pending()).isEqualTo(0L);
+            assertThat(response.rejected()).isEqualTo(0L);
+        }
+    }
 }