feat: 지원자 상태 변경 로직 구현

- 요청 DTO 구현
- 상태 변경 후 지원자 정보 리턴

Author: ysw789

src/main/java/dmu/dasom/api/domain/applicant/dto/ApplicantStatusUpdateRequestDto.java

@@ -0,0 +1,14 @@
+package dmu.dasom.api.domain.applicant.dto;
+
+import dmu.dasom.api.domain.applicant.enums.ApplicantStatus;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Getter;
+
+@Getter
+@Schema(name = "ApplicantStatusUpdateRequestDto", description = "지원자 상태 변경 요청 DTO")
+public class ApplicantStatusUpdateRequestDto {
+
+    @Schema(description = "상태", example = "DOCUMENT_PASSED")
+    private ApplicantStatus status;
+
+}

src/main/java/dmu/dasom/api/domain/applicant/service/ApplicantService.java

@@ -3,6 +3,7 @@
 import dmu.dasom.api.domain.applicant.dto.ApplicantCreateRequestDto;
 import dmu.dasom.api.domain.applicant.dto.ApplicantDetailsResponseDto;
 import dmu.dasom.api.domain.applicant.dto.ApplicantResponseDto;
+import dmu.dasom.api.domain.applicant.dto.ApplicantStatusUpdateRequestDto;
 import dmu.dasom.api.global.dto.PageResponse;
 
 public interface ApplicantService {
@@ -13,4 +14,6 @@ public interface ApplicantService {
 
     ApplicantDetailsResponseDto getApplicant(final Long id);
 
+    ApplicantDetailsResponseDto updateApplicantStatus(final Long id, final ApplicantStatusUpdateRequestDto request);
+
 }

src/main/java/dmu/dasom/api/domain/applicant/service/ApplicantServiceImpl.java

@@ -3,6 +3,7 @@
 import dmu.dasom.api.domain.applicant.dto.ApplicantCreateRequestDto;
 import dmu.dasom.api.domain.applicant.dto.ApplicantDetailsResponseDto;
 import dmu.dasom.api.domain.applicant.dto.ApplicantResponseDto;
+import dmu.dasom.api.domain.applicant.dto.ApplicantStatusUpdateRequestDto;
 import dmu.dasom.api.domain.applicant.entity.Applicant;
 import dmu.dasom.api.domain.applicant.repository.ApplicantRepository;
 import dmu.dasom.api.domain.common.exception.CustomException;
@@ -42,8 +43,21 @@ public PageResponse<ApplicantResponseDto> getApplicants(final int page) {
     // 지원자 상세 조회
     @Override
     public ApplicantDetailsResponseDto getApplicant(final Long id) {
+        return findById(id).toApplicantDetailsResponse();
+    }
+
+    // 지원자 상태 변경
+    @Override
+    public ApplicantDetailsResponseDto updateApplicantStatus(final Long id, final ApplicantStatusUpdateRequestDto request) {
+        final Applicant applicant = findById(id);
+        applicant.updateStatus(request.getStatus());
+
+        return applicant.toApplicantDetailsResponse();
+    }
+
+    // Repository에서 ID로 지원자 조회
+    private Applicant findById(final Long id) {
         return applicantRepository.findById(id)
-                .map(Applicant::toApplicantDetailsResponse)
                 .orElseThrow(() -> new CustomException(ErrorCode.EMPTY_RESULT));
     }
 

src/main/java/dmu/dasom/api/global/admin/controller/AdminController.java

@@ -2,6 +2,7 @@
 
 import dmu.dasom.api.domain.applicant.dto.ApplicantDetailsResponseDto;
 import dmu.dasom.api.domain.applicant.dto.ApplicantResponseDto;
+import dmu.dasom.api.domain.applicant.dto.ApplicantStatusUpdateRequestDto;
 import dmu.dasom.api.domain.applicant.service.ApplicantService;
 import dmu.dasom.api.global.dto.PageResponse;
 import io.swagger.v3.oas.annotations.Operation;
@@ -10,6 +11,7 @@
 import io.swagger.v3.oas.annotations.media.Schema;
 import io.swagger.v3.oas.annotations.responses.ApiResponse;
 import io.swagger.v3.oas.annotations.responses.ApiResponses;
+import jakarta.validation.Valid;
 import jakarta.validation.constraints.Min;
 import lombok.RequiredArgsConstructor;
 import org.springframework.http.ResponseEntity;
@@ -69,4 +71,12 @@ public ResponseEntity<ApplicantDetailsResponseDto> getApplicant(@PathVariable("i
         return ResponseEntity.ok(applicantService.getApplicant(id));
     }
 
+    // 지원자 상태 변경
+    @Operation(summary = "지원자 상태 변경")
+    @PatchMapping("/applicants/{id}/status")
+    public ResponseEntity<ApplicantDetailsResponseDto> updateApplicantStatus(@PathVariable("id") @Min(0) final Long id,
+                                                                             @Valid @RequestBody final ApplicantStatusUpdateRequestDto request) {
+        return ResponseEntity.ok(applicantService.updateApplicantStatus(id, request));
+    }
+
 }