[Feat] 가입한 그룹 목록 조회 API 개발 (#60)

* feat: 가입한 그룹 목록 조회 API 응답 DTO 구현 (#55)

* feat: 가입한 그룹 목록 조회용 QueryDSL 리포지토리 구현 (#55)

* feat: 가입한 그룹 목록 조회 서비스 구현 (#55)

* feat: 가입한 그룹 목록 조회 API 컨트롤러 구현 (#55)

Author: soonge2

src/main/java/com/moa/moa_server/domain/group/repository/GroupMemberRepositoryCustom.java

@@ -2,11 +2,13 @@
 
 import com.moa.moa_server.domain.global.cursor.GroupNameGroupIdCursor;
 import com.moa.moa_server.domain.group.entity.Group;
+import com.moa.moa_server.domain.group.entity.GroupMember;
 import com.moa.moa_server.domain.user.entity.User;
 import jakarta.annotation.Nullable;
 
 import java.util.List;
 
 public interface GroupMemberRepositoryCustom {
     List<Group> findJoinedGroupLabels(User user, @Nullable GroupNameGroupIdCursor cursor, int size);
+    List<GroupMember> findJoinedGroups(User user, @Nullable GroupNameGroupIdCursor cursor, int size);
 }

src/main/java/com/moa/moa_server/domain/group/repository/impl/GroupMemberRepositoryImpl.java

@@ -2,6 +2,7 @@
 
 import com.moa.moa_server.domain.global.cursor.GroupNameGroupIdCursor;
 import com.moa.moa_server.domain.group.entity.Group;
+import com.moa.moa_server.domain.group.entity.GroupMember;
 import com.moa.moa_server.domain.group.entity.QGroup;
 import com.moa.moa_server.domain.group.entity.QGroupMember;
 import com.moa.moa_server.domain.user.entity.User;
@@ -45,4 +46,31 @@ public List<Group> findJoinedGroupLabels(User user, @Nullable GroupNameGroupIdCu
                 .limit(size)
                 .fetch();
     }
-}
+
+    @Override
+    public List<GroupMember> findJoinedGroups(User user, @Nullable GroupNameGroupIdCursor cursor, int size) {
+        QGroupMember member = QGroupMember.groupMember;
+        QGroup group = QGroup.group;
+
+        BooleanBuilder builder = new BooleanBuilder()
+                .and(member.user.eq(user))
+                .and(member.deletedAt.isNull())
+                .and(group.id.ne(1L)); // 공개 그룹 제외
+
+        if (cursor != null) {
+            builder.and(
+                    group.name.gt(cursor.groupName())
+                            .or(group.name.eq(cursor.groupName())
+                                    .and(group.id.gt(cursor.groupId())))
+            );
+        }
+
+        return queryFactory
+                .selectFrom(member)
+                .join(member.group, group).fetchJoin()
+                .where(builder)
+                .orderBy(group.name.asc(), group.id.asc())
+                .limit(size)
+                .fetch();
+    }
+}

src/main/java/com/moa/moa_server/domain/user/controller/UserController.java

@@ -2,6 +2,7 @@
 
 import com.moa.moa_server.domain.global.dto.ApiResponse;
 import com.moa.moa_server.domain.user.dto.response.GroupLabelResponse;
+import com.moa.moa_server.domain.user.dto.response.JoinedGroupResponse;
 import com.moa.moa_server.domain.user.service.UserService;
 import lombok.RequiredArgsConstructor;
 import org.springframework.http.ResponseEntity;
@@ -27,4 +28,14 @@ public ResponseEntity<ApiResponse> getJoinedGroupLabels(
         GroupLabelResponse response = userService.getJoinedGroupLabels(userId, cursor, size);
         return ResponseEntity.ok(new ApiResponse("SUCCESS", response));
     }
+
+    @GetMapping("/groups")
+    public ResponseEntity<ApiResponse> getJoinedGroups(
+            @AuthenticationPrincipal Long userId,
+            @RequestParam(required = false) String cursor,
+            @RequestParam(required = false) Integer size
+    ) {
+        JoinedGroupResponse response = userService.getJoinedGroups(userId, cursor, size);
+        return ResponseEntity.ok(new ApiResponse("SUCCESS", response));
+    }
 }

src/main/java/com/moa/moa_server/domain/user/dto/response/GroupDetail.java

@@ -0,0 +1,28 @@
+package com.moa.moa_server.domain.user.dto.response;
+
+import com.moa.moa_server.domain.group.entity.Group;
+import com.moa.moa_server.domain.group.entity.GroupMember;
+
+public record GroupDetail(
+        Long groupId,
+        String name,
+        String description,
+        String imageUrl,
+        String inviteCode,
+        String role
+) {
+    public static GroupDetail from(Group group, GroupMember.Role role) {
+        return new GroupDetail(
+                group.getId(),
+                group.getName(),
+                group.getDescription(),
+                group.getImageUrl(),
+                group.getInviteCode(),
+                role.name()
+        );
+    }
+
+    public static GroupDetail from(GroupMember member) {
+        return from(member.getGroup(), member.getRole());
+    }
+}

src/main/java/com/moa/moa_server/domain/user/dto/response/JoinedGroupResponse.java

@@ -0,0 +1,10 @@
+package com.moa.moa_server.domain.user.dto.response;
+
+import java.util.List;
+
+public record JoinedGroupResponse(
+    List<GroupDetail> groups,
+    String nextCursor,
+    boolean hasNext,
+    int size
+) {}

src/main/java/com/moa/moa_server/domain/user/service/UserService.java

@@ -2,10 +2,13 @@
 
 import com.moa.moa_server.domain.global.cursor.GroupNameGroupIdCursor;
 import com.moa.moa_server.domain.group.entity.Group;
+import com.moa.moa_server.domain.group.entity.GroupMember;
 import com.moa.moa_server.domain.group.repository.GroupMemberRepository;
 import com.moa.moa_server.domain.group.service.GroupService;
+import com.moa.moa_server.domain.user.dto.response.GroupDetail;
 import com.moa.moa_server.domain.user.dto.response.GroupLabel;
 import com.moa.moa_server.domain.user.dto.response.GroupLabelResponse;
+import com.moa.moa_server.domain.user.dto.response.JoinedGroupResponse;
 import com.moa.moa_server.domain.user.entity.User;
 import com.moa.moa_server.domain.user.handler.UserErrorCode;
 import com.moa.moa_server.domain.user.handler.UserException;
@@ -62,4 +65,34 @@ public GroupLabelResponse getJoinedGroupLabels(Long userId, @Nullable String cur
 
         return new GroupLabelResponse(labels, nextCursor, hasNext, labels.size());
     }
-}
+
+    @Transactional(readOnly = true)
+    public JoinedGroupResponse getJoinedGroups(Long userId, @Nullable String cursor, @Nullable Integer size) {
+        int pageSize = (size == null || size <= 0) ? DEFAULT_PAGE_SIZE : size;
+        GroupNameGroupIdCursor parsedCursor = cursor != null ? GroupNameGroupIdCursor.parse(cursor) : null;
+
+        // 유저 조회 및 검증
+        User user = userRepository.findById(userId)
+                .orElseThrow(() -> new UserException(UserErrorCode.USER_NOT_FOUND));
+        AuthUserValidator.validateActive(user);
+
+        // 그룹 멤버 목록 조회
+        List<GroupMember> members = groupMemberRepository.findJoinedGroups(user, parsedCursor, pageSize + 1);
+
+        // 응답 구성
+        boolean hasNext = members.size() > pageSize;
+        if (hasNext) members = members.subList(0, pageSize);
+
+        String nextCursor = members.isEmpty() ? null :
+                new GroupNameGroupIdCursor(
+                        members.getLast().getGroup().getName(),
+                        members.getLast().getGroup().getId()
+                ).encode();
+
+        List<GroupDetail> groups = members.stream()
+                .map(GroupDetail::from)
+                .toList();
+
+        return new JoinedGroupResponse(groups, nextCursor, hasNext, groups.size());
+    }
+}