[feat/#496] 멤버 역할(부모임장) 설정 API 구현 (#497)

* feat: 멤버 역할(부모임장) 설정 API 구현

* feat: 멤버 역할(부모임장) 설정 API 서비스 구현체

* feat: 멤버 역할(부모임장) 설정 API 알림 발송 구현

* feat: 멤버 역할(부모임장) 설정 API 검증 및 권한 로직 추가

* fix: 같은 역할일 경우, 에러 처리가 아닌 return 해주도록 수정

Author: dbalsk

src/main/java/umc/cockple/demo/domain/exercise/service/ExerciseValidator.java

@@ -32,7 +32,7 @@ public class ExerciseValidator {
 
     public void validateCreateExercise(Long memberId, ExerciseCreateDTO.Request request, Party party) {
         validatePartyIsActive(party);
-        validateMemberPermission(memberId, party);
+        validateSubManagerPermission(memberId, party);
         validateExerciseTime(request);
     }
 
@@ -62,19 +62,19 @@ public void validateCancelGuestInvitation(Exercise exercise, Guest guest, Member
 
     public void validateCancelCommonParticipationByManager(Exercise exercise, Member manager) {
         validateAlreadyStarted(exercise, ExerciseErrorCode.EXERCISE_ALREADY_STARTED_CANCEL);
-        validateMemberPermission(manager.getId(), exercise.getParty());
+        validateSubManagerPermission(manager.getId(), exercise.getParty());
     }
 
     public void validateCancelGuestParticipationByManager(Guest guest, Exercise exercise){
         validateGuestBelongsToExercise(guest, exercise);
     }
 
     public void validateDeleteExercise(Exercise exercise, Long memberId) {
-        validateMemberPermission(memberId, exercise.getParty());
+        validateManagerPermission(memberId, exercise.getParty());
     }
 
     public void validateUpdateExercise(Exercise exercise, Member member, ExerciseUpdateDTO.Request request) {
-        validateMemberPermission(member.getId(), exercise.getParty());
+        validateManagerPermission(member.getId(), exercise.getParty());
         validateAlreadyStarted(exercise, ExerciseErrorCode.EXERCISE_ALREADY_STARTED_UPDATE);
         validateUpdateTime(request, exercise);
     }
@@ -87,7 +87,7 @@ private void validatePartyIsActive(Party party) {
         }
     }
 
-    private void validateMemberPermission(Long memberId, Party party) {
+    private void validateManagerPermission(Long memberId, Party party) {
         boolean isOwner = party.getOwnerId().equals(memberId);
         boolean isManager = memberPartyRepository.existsByPartyIdAndMemberIdAndRole(
                 party.getId(), memberId, Role.party_MANAGER);
@@ -96,6 +96,17 @@ private void validateMemberPermission(Long memberId, Party party) {
             throw new ExerciseException(ExerciseErrorCode.INSUFFICIENT_PERMISSION);
     }
 
+    private void validateSubManagerPermission(Long memberId, Party party) {
+        boolean isOwner = party.getOwnerId().equals(memberId);
+        boolean isManager = memberPartyRepository.existsByPartyIdAndMemberIdAndRole(
+                party.getId(), memberId, Role.party_MANAGER);
+        boolean isSubManager = memberPartyRepository.existsByPartyIdAndMemberIdAndRole(
+                party.getId(), memberId, Role.party_SUBMANAGER);
+
+        if (!isOwner && !isManager && !isSubManager)
+            throw new ExerciseException(ExerciseErrorCode.INSUFFICIENT_PERMISSION);
+    }
+
     private void validateExerciseTime(ExerciseCreateDTO.Request request) {
         LocalDate date = request.toParsedDate();
         LocalTime startTime = request.toParsedStartTime();

src/main/java/umc/cockple/demo/domain/member/domain/MemberParty.java

@@ -67,4 +67,8 @@ public boolean isLeader() {
         if (this.role == Role.party_MANAGER) return true;
         return false;
     }
+
+    public void changeRole(Role newRole) {
+        this.role = newRole;
+    }
 }

src/main/java/umc/cockple/demo/domain/member/exception/MemberErrorCode.java

@@ -23,6 +23,7 @@ public enum MemberErrorCode implements BaseErrorCode {
     ALREADY_WITHDRAW(HttpStatus.UNAUTHORIZED, "MEMBER301", "이미 탈퇴한 회원입니다."),
 
     MANAGER_CANNOT_LEAVE(HttpStatus.BAD_REQUEST, "MEMBER401", "모임장은 탈퇴할 수 없습니다. 모임 삭제를 먼저 해주세요."),
+    SUBMANAGER_CANNOT_LEAVE(HttpStatus.BAD_REQUEST, "MEMBER402", "부모임장은 탈퇴할 수 없습니다. 모임 탈퇴를 먼저 해주세요."),
 
     // 회원 주소 관련
     ADDRESS_NOT_FOUND(HttpStatus.NOT_FOUND, "MEM_ADDR201", "해당 주소를 찾을 수 없습니다."),

src/main/java/umc/cockple/demo/domain/member/repository/MemberPartyRepository.java

@@ -54,4 +54,6 @@ List<Long> findAllPartyIdsByMemberAndPartyIds(@Param("memberId") Long memberId,
        WHERE mp.party.id = :partyId
        """)
     List<MemberParty> findAllByPartyIdWithMember(@Param("partyId") Long partyId);
+
+    Optional<MemberParty> findByPartyIdAndRole(Long partyId, Role role);
 }

src/main/java/umc/cockple/demo/domain/member/service/MemberCommandService.java

@@ -16,6 +16,7 @@
 import umc.cockple.demo.domain.member.repository.*;
 import umc.cockple.demo.domain.member.enums.MemberStatus;
 import umc.cockple.demo.domain.image.service.ImageService;
+import umc.cockple.demo.global.enums.Role;
 
 import java.util.List;
 import umc.cockple.demo.global.oauth2.service.KakaoOauthService;
@@ -283,5 +284,16 @@ private void validateCanWithdraw(Member member) {
         if (isLeader) {
             throw new MemberException(MemberErrorCode.MANAGER_CANNOT_LEAVE);
         }
+
+        // 활성화 된 모임의 부모임장인 경우 -> 탈퇴 불가
+        boolean isSubOwner = member.getMemberParties().stream()
+                .anyMatch(memberParty ->
+                        memberParty.getRole() == Role.party_SUBMANAGER
+                                && memberParty.getStatus() == MemberPartyStatus.ACTIVE
+                );
+
+        if (isSubOwner) {
+            throw new MemberException(MemberErrorCode.SUBMANAGER_CANNOT_LEAVE);
+        }
     }
 }

src/main/java/umc/cockple/demo/domain/notification/enums/NotificationTarget.java

@@ -8,7 +8,9 @@ public enum NotificationTarget {
     PARTY_MODIFY(NotificationType.CHANGE),
     PARTY_INVITE(NotificationType.INVITE),
     PARTY_INVITE_APPROVED(NotificationType.SIMPLE),
-    PARTY_JOINREQUEST_APPROVED(NotificationType.CHANGE);
+    PARTY_JOINREQUEST_APPROVED(NotificationType.CHANGE),
+    PARTY_SUBOWNER_ASSIGNED(NotificationType.SIMPLE),
+    PARTY_SUBOWNER_RELEASED(NotificationType.SIMPLE);
 
     private final NotificationType defaultType;
 

src/main/java/umc/cockple/demo/domain/notification/service/NotificationCommandService.java

@@ -42,7 +42,6 @@ public class NotificationCommandService {
     private final NotificationMessageGenerator notificationMessageGenerator;
     private final ObjectMapper objectMapper;
 
-
     // 알림 타입 변경 (초대 수락, 거절에 사용)
     public Response markAsReadNotification(Long memberId, Long notificationId, NotificationType type) {
         Notification notification = findByNotificationId(notificationId);
@@ -96,7 +95,11 @@ public void createNotification(CreateNotificationRequestDTO dto) {
                 title = "새로운 모임";
             } else if (dto.target() == NotificationTarget.PARTY_INVITE_APPROVED) {
                 content = notificationMessageGenerator.generateInviteApprovedMessage(dto.subjectName());
-            }else {
+            } else if (dto.target() == NotificationTarget.PARTY_SUBOWNER_ASSIGNED) {
+                content = notificationMessageGenerator.generateSubOwnerAssignedMessage(dto.subjectName());
+            } else if (dto.target() == NotificationTarget.PARTY_SUBOWNER_RELEASED) {
+                content = notificationMessageGenerator.generateSubOwnerReleasedMessage(dto.subjectName());
+            } else {
                 content = notificationMessageGenerator.generateJoinRequestApprovedMessage();
             }
 

src/main/java/umc/cockple/demo/domain/notification/service/NotificationMessageGenerator.java

@@ -36,4 +36,12 @@ public String generateExerciseChangedMessage(String dateStr) {
     public String generateExerciseAttendChangedMessage() {
         return "운동 참석으로 변경되었어요!";
     }
+
+    public String generateSubOwnerAssignedMessage(String nickname) {
+        return String.format("'%s'님이 부모임장으로 지정되었습니다.", nickname);
+    }
+
+    public String generateSubOwnerReleasedMessage(String nickname) {
+        return String.format("'%s'님의 부모임장 권한이 해제되었습니다.", nickname);
+    }
 }

src/main/java/umc/cockple/demo/domain/party/controller/PartyController.java

@@ -213,6 +213,22 @@ public BaseResponse<Void> removeMember(
         return BaseResponse.success(CommonSuccessCode.OK);
     }
 
+    @PatchMapping("/parties/{partyId}/members/{memberId}/role")
+    @Operation(summary = "멤버 역할(부모임장) 설정", description = "모임장이 특정 멤버를 부모임장으로 지정하거나 해제합니다.")
+    @ApiResponse(responseCode = "200", description = "역할 변경 성공")
+    @ApiResponse(responseCode = "400", description = "유효하지 않은 역할 값")
+    @ApiResponse(responseCode = "403", description = "모임장 권한 없음 또는 모임장 역할 변경 시도")
+    @ApiResponse(responseCode = "404", description = "존재하지 않는 모임 또는 멤버")
+    public BaseResponse<Void> updateMemberRole(
+            @PathVariable Long partyId,
+            @PathVariable Long memberId,
+            @RequestBody @Valid PartyMemberRoleDTO.Request request) {
+        Long currentMemberId = SecurityUtil.getCurrentMemberId();
+
+        partyCommandService.updateMemberRole(partyId, memberId, currentMemberId, request);
+        return BaseResponse.success(CommonSuccessCode.OK);
+    }
+
     @PostMapping("/parties/{partyId}/join-requests")
     @Operation(summary = "모임 가입 신청",
             description = "사용자가 특정 모임에 가입을 신청합니다")

src/main/java/umc/cockple/demo/domain/party/dto/PartyMemberRoleDTO.java

@@ -0,0 +1,13 @@
+package umc.cockple.demo.domain.party.dto;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import umc.cockple.demo.global.enums.Role;
+
+public class PartyMemberRoleDTO {
+
+    @Schema(name = "PartyMemberRoleRequest")
+    public record Request(
+            @NotNull(message = "역할 값은 필수입니다.") Role role) {
+    }
+}