feat : 파티 신청/초대 관리 로직 개선 및 api 응답 통일 (#152)

* feat : 상태 enum 확장 및 dto 추가

* feat : 여러 상태를 한번에 조회하는 메서드 추가

* feat : 파티 에러 코드 추가

* feat: 파티 신청/초대 관리 로직 개선 및 API 응답 통일

Author: HeegangBae

backend/src/main/java/com/back/domain/party/party/controller/ApiV1PartyController.java

@@ -153,44 +153,63 @@ public ResponseEntity<ApiResponse<PartyDto>> getPartyDetails(@PathVariable Integ
     }
 
     @PostMapping("/{partyId}/invite")
-    @Operation(summary = "파티 초대 (코드)", description = "파티장이 다른 멤버를 코드를 사용하여 파티에 초대하는 API")
-    public ResponseEntity<ApiResponse<Void>> inviteMember(
+    @Operation(summary = "파티에 멤버 초대", description = "파티장이 멤버 코드로 다른 사용자를 파티에 초대합니다. 상태는 INVITED로 설정됩니다.")
+    public ResponseEntity<ApiResponse<PartyMemberStatusResponse>> inviteMember(
             @PathVariable Integer partyId,
-            @RequestBody @Valid InvitationDto invitationDto,
+            @Valid @RequestBody InvitationDto invitationDto,
             Authentication authentication
     ) {
         Integer leaderId = getMemberIdFromAuthentication(authentication);
-        partyService.inviteMember(partyId, leaderId, invitationDto.getInvitedMemberCode());
+
+        PartyMemberStatusResponse responseContent = partyService.inviteMember(
+                partyId,
+                leaderId,
+                invitationDto.getInvitedMemberCode()
+        );
 
         return ResponseEntity
                 .status(HttpStatus.OK)
-                .body(ApiResponse.success("200", "파티 초대 성공"));
+                .body(ApiResponse.success("200", "초대 성공", responseContent));
     }
 
     @PostMapping("/{partyId}/accept")
-    @Operation(summary = "초대/신청 수락", description = "초대/신청 대기 중인 멤버를 파티원이 되도록 수락하는 API")
-    public ResponseEntity<ApiResponse<Void>> acceptInvitation(
+    @Operation(summary = "파티 가입 신청/초대 수락", description = "파티장이 대기 중인 멤버의 가입 신청 또는 초대를 수락합니다. (PENDING | INVITED) -> ACCEPTED")
+    public ResponseEntity<ApiResponse<PartyMemberStatusResponse>> acceptInvitation(
             @PathVariable Integer partyId,
+            @Valid @RequestBody MemberIdRequest memberIdRequest,
             Authentication authentication
     ) {
-        Integer memberId = getMemberIdFromAuthentication(authentication);
-        partyService.acceptInvitation(partyId, memberId);
+        Integer leaderId = getMemberIdFromAuthentication(authentication);
+
+        PartyMemberStatusResponse responseContent = partyService.acceptInvitation(
+                partyId,
+                memberIdRequest.getMemberId(),
+                leaderId
+        );
+
         return ResponseEntity
                 .status(HttpStatus.OK)
-                .body(ApiResponse.success("200", "초대/신청 수락 성공"));
+                .body(ApiResponse.success("200", "초대/신청 수락 성공", responseContent));
     }
 
     @PostMapping("/{partyId}/reject")
-    @Operation(summary = "초대/신청 거절", description = "초대/신청 대기 중인 멤버를 거절하는 API")
-    public ResponseEntity<ApiResponse<Void>> rejectInvitation(
+    @Operation(summary = "파티 가입 신청/초대 거절 (소프트 삭제)", description = "파티장이 대기 중인 멤버의 신청 또는 초대를 거절하고 상태를 REJECTED로 변경합니다. (PENDING | INVITED) -> REJECTED")
+    public ResponseEntity<ApiResponse<PartyMemberStatusResponse>> rejectInvitation(
             @PathVariable Integer partyId,
+            @Valid @RequestBody MemberIdRequest memberIdRequest,
             Authentication authentication
     ) {
-        Integer memberId = getMemberIdFromAuthentication(authentication);
-        partyService.rejectInvitation(partyId, memberId);
+        Integer leaderId = getMemberIdFromAuthentication(authentication);
+
+        PartyMemberStatusResponse responseContent = partyService.rejectInvitation(
+                partyId,
+                memberIdRequest.getMemberId(),
+                leaderId
+        );
+
         return ResponseEntity
                 .status(HttpStatus.OK)
-                .body(ApiResponse.success("200", "초대/신청 거절 성공"));
+                .body(ApiResponse.success("200", "초대/신청 거절 성공", responseContent));
     }
 
     @DeleteMapping("/{partyId}/members/{kickedMemberId}")
@@ -209,15 +228,15 @@ public ResponseEntity<ApiResponse<Void>> kickMember(
     }
 
     @GetMapping("/{partyId}/requests")
-    @Operation(summary = "파티 가입 신청/초대 목록 조회", description = "파티장이 가입 신청 또는 초대 대기 중인 멤버 목록을 조회하는 API")
+    @Operation(summary = "파티 가입 신청/초대 목록 조회", description = "파티장이 PENDING(신청) 또는 INVITED(초대) 대기 중인 멤버 목록을 조회합니다. 응답에 status 필드가 포함됩니다.")
     public ResponseEntity<ApiResponse<List<PartyMemberDto>>> getPendingJoinRequests(
             @PathVariable Integer partyId,
             Authentication authentication
     ) {
         Integer leaderId = getMemberIdFromAuthentication(authentication);
         List<PartyMember> pendingRequests = partyService.getPendingJoinRequests(partyId, leaderId);
         List<PartyMemberDto> requestDtos = pendingRequests.stream()
-                .map(pm -> new PartyMemberDto(pm.getMember()))
+                .map(pm -> new PartyMemberDto(pm.getMember(), pm.getStatus().name()))
                 .collect(Collectors.toList());
 
         return ResponseEntity

backend/src/main/java/com/back/domain/party/party/dto/MemberIdRequest.java

@@ -0,0 +1,12 @@
+package com.back.domain.party.party.dto;
+
+import jakarta.validation.constraints.NotNull;
+import lombok.Getter;
+import lombok.Setter;
+
+@Getter
+@Setter
+public class MemberIdRequest {
+    @NotNull(message = "멤버 ID는 필수 입력 항목입니다.")
+    private Integer memberId;
+}

backend/src/main/java/com/back/domain/party/party/dto/PartyMemberStatusResponse.java

@@ -0,0 +1,13 @@
+package com.back.domain.party.party.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Getter
+@AllArgsConstructor
+@NoArgsConstructor
+public class PartyMemberStatusResponse {
+    private Integer memberId;
+    private String status;
+}

backend/src/main/java/com/back/domain/party/party/entity/PartyMemberStatus.java

@@ -1,8 +1,10 @@
 package com.back.domain.party.party.entity;
 
 public enum PartyMemberStatus {
-    PENDING,    // 초대 대기
-    ACCEPTED,   // 파티원
+    PENDING,    // 파티 가입 신청 대기 (멤버 -> 리더)
+    INVITED,    // 파티 초대 대기 (리더 -> 멤버)
+    ACCEPTED,   // 신청/초대 수락
+    REJECTED,   // 신청/초대 거절
     COMPLETED,  // 미션 완료
     LEFT        // 도중에 나감 또는 중도 포기
 }

backend/src/main/java/com/back/domain/party/party/repository/PartyMemberRepository.java

@@ -6,6 +6,7 @@
 import org.springframework.data.jpa.repository.JpaRepository;
 import org.springframework.stereotype.Repository;
 
+import java.util.Collection;
 import java.util.List;
 import java.util.Optional;
 
@@ -24,4 +25,7 @@ public interface PartyMemberRepository extends JpaRepository<PartyMember, PartyM
     // 파티원 수 조회용 메서드 추가
     long countByParty_IdAndStatus(Integer partyId, PartyMemberStatus status);
 
+    // 특정 파티의 여러 상태에 해당하는 파티원들을 찾는 메서드
+    List<PartyMember> findByParty_IdAndStatusIn(Integer partyId, Collection<PartyMemberStatus> statuses);
+
 }