feat: group response swagger 설명 추가 (#47) (KAN-102)

src/main/java/org/ioteatime/meonghanyangserver/group/controller/GroupApi.java

@@ -22,5 +22,5 @@ public interface GroupApi {
     Api<CctvInviteResponse> generateCctvInvite(@LoginMember Long userId);
 
     @Operation(summary = "그룹 통합 정보를 조회합니다.")
-    Api<GroupTotalResponse> getGroupTotalData(Authentication authentication);
+    Api<GroupTotalResponse> getGroupTotalData(@LoginMember Long userId);
 }

src/main/java/org/ioteatime/meonghanyangserver/group/controller/GroupController.java

@@ -42,8 +42,8 @@ public Api<CctvInviteResponse> generateCctvInvite(@LoginMember Long userId) {
     }
 
     @GetMapping("/info-list")
-    public Api<GroupTotalResponse> getGroupTotalData(Authentication authentication) {
-        GroupTotalResponse groupTotalResponse = groupService.getGroupTotalData(authentication);
+    public Api<GroupTotalResponse> getGroupTotalData(@LoginMember Long userId) {
+        GroupTotalResponse groupTotalResponse = groupService.getGroupTotalData(userId);
         return Api.success(GroupSuccessType.GET_GROUP_TOTAL_INFO, groupTotalResponse);
     }
 }

src/main/java/org/ioteatime/meonghanyangserver/group/domain/GroupEntity.java

@@ -26,9 +26,9 @@ public class GroupEntity {
     @Column(nullable = false)
     private LocalDateTime createdAt;
 
-    @OneToMany(mappedBy = "group", cascade = CascadeType.ALL)
+    @OneToMany(mappedBy = "group")
     private List<CctvEntity> cctvs;
 
-    @OneToMany(mappedBy = "group", cascade = CascadeType.ALL)
+    @OneToMany(mappedBy = "group")
     private List<GroupUserEntity> groupUserEntities;
 }

src/main/java/org/ioteatime/meonghanyangserver/group/dto/response/CreateGroupResponse.java

@@ -1,5 +1,10 @@
 package org.ioteatime.meonghanyangserver.group.dto.response;
 
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
 import java.time.LocalDateTime;
 
-public record CreateGroupResponse(Long groupId, String groupName, LocalDateTime createdAt) {}
+@Schema(description = "그룹 생성 정보 응답")
+public record CreateGroupResponse(
+        @NotNull Long groupId, @NotBlank String groupName, @NotNull LocalDateTime createdAt) {}

src/main/java/org/ioteatime/meonghanyangserver/group/dto/response/GroupTotalResponse.java

@@ -1,12 +1,16 @@
 package org.ioteatime.meonghanyangserver.group.dto.response;
 
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
 import java.time.LocalDateTime;
 import java.util.List;
 import org.ioteatime.meonghanyangserver.cctv.dto.response.CctvInfoResponse;
 
+@Schema(description = "그룹 통합 정보 응답")
 public record GroupTotalResponse(
-        Long groupId,
-        String groupName,
-        LocalDateTime createdAt,
+        @NotNull Long groupId,
+        @NotBlank String groupName,
+        @NotNull LocalDateTime createdAt,
         List<GroupUserInfoResponse> groupUser,
         List<CctvInfoResponse> cctv) {}

src/main/java/org/ioteatime/meonghanyangserver/group/dto/response/GroupUserInfoResponse.java

@@ -1,3 +1,8 @@
 package org.ioteatime.meonghanyangserver.group.dto.response;
 
-public record GroupUserInfoResponse(Long userId, String nickname) {}
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+
+@Schema(description = "그룹 유저 정보 응답")
+public record GroupUserInfoResponse(@NotNull Long userId, @NotBlank String nickname) {}

src/main/java/org/ioteatime/meonghanyangserver/group/repository/groupuser/GroupUserRepository.java

@@ -11,5 +11,5 @@ public interface GroupUserRepository {
 
     Optional<GroupUserEntity> findByUserId(Long userId);
 
-    Optional<GroupUserEntity> findGroupUser(UserEntity userEntity);
+    Optional<GroupUserEntity> findGroupUser(Long userId);
 }

src/main/java/org/ioteatime/meonghanyangserver/group/repository/groupuser/GroupUserRepositoryImpl.java

@@ -28,9 +28,8 @@ public Optional<GroupUserEntity> findByUserId(Long userId) {
     }
 
     @Override
-    public Optional<GroupUserEntity> findGroupUser(UserEntity userEntity) {
-        Optional<GroupUserEntity> groupUserEntity =
-                jpaGroupUserRepository.findByUserId(userEntity.getId());
+    public Optional<GroupUserEntity> findGroupUser(Long userId) {
+        Optional<GroupUserEntity> groupUserEntity = jpaGroupUserRepository.findByUserId(userId);
 
         return groupUserEntity;
     }

src/main/java/org/ioteatime/meonghanyangserver/group/service/GroupService.java

@@ -45,12 +45,9 @@ public CreateGroupResponse createGroup(Authentication authentication) {
         return GroupResponseMapper.from(newGroupEntity);
     }
 
-    public GroupTotalResponse getGroupTotalData(Authentication authentication) {
-        CustomUserDetail userDetails = (CustomUserDetail) authentication.getPrincipal();
-
-        UserEntity userEntity = userDetails.getUserEntity();
+    public GroupTotalResponse getGroupTotalData(Long userId) {
 
-        GroupUserEntity groupUserEntity = groupUserService.getGroupUser(userEntity);
+        GroupUserEntity groupUserEntity = groupUserService.getGroupUser(userId);
 
         GroupEntity groupEntity = groupUserEntity.getGroup();
 

src/main/java/org/ioteatime/meonghanyangserver/group/service/GroupUserService.java

@@ -53,10 +53,10 @@ public CctvInviteResponse generateCctvInvite(Long userId) {
         return new CctvInviteResponse(groupUserEntity.getGroup().getId(), kvsChannelName);
     }
 
-    public GroupUserEntity getGroupUser(UserEntity userEntity) {
+    public GroupUserEntity getGroupUser(Long userId) {
         GroupUserEntity groupUserEntity =
                 groupUserRepository
-                        .findGroupUser(userEntity)
+                        .findGroupUser(userId)
                         .orElseThrow(
                                 () -> new NotFoundException(GroupErrorType.GROUP_USER_NOT_FOUND));
         return groupUserEntity;