feat(#197/recruit): 특정 멤버 입금 상태 변경 api 구현

Author: kaswhy

src/main/java/inha/gdgoc/domain/recruit/controller/RecruitMemberController.java

@@ -2,30 +2,36 @@
 
 import static inha.gdgoc.domain.recruit.controller.message.RecruitMemberMessage.MEMBER_RETRIEVED_SUCCESS;
 import static inha.gdgoc.domain.recruit.controller.message.RecruitMemberMessage.MEMBER_SAVE_SUCCESS;
+import static inha.gdgoc.domain.recruit.controller.message.RecruitMemberMessage.PAYMENT_MARKED_COMPLETE_SUCCESS;
+import static inha.gdgoc.domain.recruit.controller.message.RecruitMemberMessage.PAYMENT_MARKED_INCOMPLETE_SUCCESS;
 import static inha.gdgoc.domain.recruit.controller.message.RecruitMemberMessage.PHONE_NUMBER_DUPLICATION_CHECK_SUCCESS;
 import static inha.gdgoc.domain.recruit.controller.message.RecruitMemberMessage.STUDENT_ID_DUPLICATION_CHECK_SUCCESS;
 
 import inha.gdgoc.domain.recruit.dto.request.ApplicationRequest;
+import inha.gdgoc.domain.recruit.dto.request.PaymentUpdateRequest;
 import inha.gdgoc.domain.recruit.dto.response.CheckPhoneNumberResponse;
 import inha.gdgoc.domain.recruit.dto.response.CheckStudentIdResponse;
 import inha.gdgoc.domain.recruit.dto.response.SpecifiedMemberResponse;
 import inha.gdgoc.domain.recruit.service.RecruitMemberService;
 import inha.gdgoc.global.dto.response.ApiResponse;
 import io.swagger.v3.oas.annotations.Operation;
 import io.swagger.v3.oas.annotations.security.SecurityRequirement;
+import io.swagger.v3.oas.annotations.tags.Tag;
 import jakarta.validation.constraints.NotBlank;
 import jakarta.validation.constraints.Pattern;
 import lombok.RequiredArgsConstructor;
 import org.springframework.http.ResponseEntity;
 import org.springframework.security.access.prepost.PreAuthorize;
 import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PatchMapping;
 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.RequestParam;
 import org.springframework.web.bind.annotation.RestController;
 
+@Tag(name = "Recruit - Members", description = "리크루팅 지원자 관리 API")
 @RequestMapping("/api/v1")
 @RequiredArgsConstructor
 @RestController
@@ -67,7 +73,7 @@ public ResponseEntity<ApiResponse<CheckPhoneNumberResponse, Void>> duplicatedPho
         return ResponseEntity.ok(ApiResponse.ok(PHONE_NUMBER_DUPLICATION_CHECK_SUCCESS, response));
     }
 
-    @Operation(summary = "특정 멤버 가입 신청서 조회", security = { @SecurityRequirement(name = "BearerAuth") })
+    @Operation(summary = "특정 멤버 가입 신청서 조회", security = {@SecurityRequirement(name = "BearerAuth")})
     @PreAuthorize("hasRole('ADMIN')")
     @GetMapping("/recruit/members/{memberId}")
     public ResponseEntity<ApiResponse<SpecifiedMemberResponse, Void>> getSpecifiedMember(
@@ -80,7 +86,27 @@ public ResponseEntity<ApiResponse<SpecifiedMemberResponse, Void>> getSpecifiedMe
 
     // TODO 전체 응답 조회 및 검색
 
-    // TODO 입금 완료
 
-    // TODO 입금 미완료
+    @Operation(
+            summary = "입금 상태 변경",
+            description = "설정하려는 상태(NOT 현재 상태)를 body에 보내주세요. true=입금 완료, false=입금 미완료",
+            security = { @SecurityRequirement(name = "BearerAuth") }
+    )
+    @PreAuthorize("hasRole('ADMIN')")
+    @PatchMapping("/recruit/members/{memberId}/payment")
+    public ResponseEntity<ApiResponse<Void, Void>> updatePayment(
+            @PathVariable Long memberId,
+            @RequestBody PaymentUpdateRequest paymentUpdateRequest
+    ) {
+        recruitMemberService.updatePayment(memberId, paymentUpdateRequest.isPayed());
+
+        return ResponseEntity.ok(
+                ApiResponse.ok(
+                        paymentUpdateRequest.isPayed()
+                        ? PAYMENT_MARKED_COMPLETE_SUCCESS
+                        : PAYMENT_MARKED_INCOMPLETE_SUCCESS
+                )
+        );
+    }
+
 }

src/main/java/inha/gdgoc/domain/recruit/controller/message/RecruitMemberMessage.java

@@ -5,4 +5,6 @@ public class RecruitMemberMessage {
     public static final String STUDENT_ID_DUPLICATION_CHECK_SUCCESS = "성공적으로 학번 중복 조회를 완료했습니다.";
     public static final String PHONE_NUMBER_DUPLICATION_CHECK_SUCCESS = "성공적으로 전화번호 중복 조회를 완료했습니다.";
     public static final String MEMBER_RETRIEVED_SUCCESS = "성공적으로 특정 멤버의 지원서를 조회했습니다.";
+    public static final String PAYMENT_MARKED_COMPLETE_SUCCESS   = "성공적으로 입금 완료로 변경했습니다.";
+    public static final String PAYMENT_MARKED_INCOMPLETE_SUCCESS = "성공적으로 입금 미완료로 변경했습니다.";
 }

src/main/java/inha/gdgoc/domain/recruit/dto/request/PaymentUpdateRequest.java

@@ -0,0 +1,7 @@
+package inha.gdgoc.domain.recruit.dto.request;
+
+public record PaymentUpdateRequest(
+        boolean isPayed
+) {
+
+}

src/main/java/inha/gdgoc/domain/recruit/entity/RecruitMember.java

@@ -81,4 +81,12 @@ public class RecruitMember extends BaseEntity {
     @Builder.Default
     @OneToMany(mappedBy = "recruitMember", cascade = CascadeType.ALL, orphanRemoval = true)
     private List<Answer> answers = new ArrayList<>();
+
+    public void markPaid() {
+        this.isPayed = Boolean.TRUE;
+    }
+
+    public void markUnpaid() {
+        this.isPayed = Boolean.FALSE;
+    }
 }

src/main/java/inha/gdgoc/domain/recruit/service/RecruitMemberService.java

@@ -67,4 +67,17 @@ public SpecifiedMemberResponse findSpecifiedMember(Long id) {
 
         return SpecifiedMemberResponse.from(member, answers, objectMapper);
     }
+
+    @Transactional
+    public void updatePayment(Long memberId, boolean isPayed) {
+        RecruitMember m = recruitMemberRepository.findById(memberId)
+                .orElseThrow(() -> new IllegalArgumentException("RecruitMember not found: " + memberId));
+
+        // 멱등 처리: 이미 동일 상태면 스킵
+        if (Boolean.TRUE.equals(m.getIsPayed()) == isPayed) return;
+
+        if (isPayed) m.markPaid();
+        else m.markUnpaid();
+    }
+
 }