[Refactor] 댓글 조회 API 분리

.github/workflows/ci-workflow.yml

@@ -19,6 +19,19 @@ env:
 jobs:
   build:
     runs-on: ubuntu-latest
+
+    # Redis를 서비스로 실행 (GitHub Runner -> Docker 컨테이너 통신)
+    services:
+      redis:
+        image: redis:7
+        ports:
+          - 6379:6379
+        options: >-
+          --health-cmd "redis-cli ping"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+
     steps:
       - uses: actions/checkout@v4
 
@@ -46,11 +59,6 @@ jobs:
       - name: 👏🏻 grant execute permission for gradlew
         run: chmod +x gradlew
 
-      - name: 🚀 Start Redis
-        uses: supercharge/[email protected]
-        with:
-          redis-version: 7
-
       - name: 🐘 build with Gradle
         run: ./gradlew build --parallel --stacktrace
 

.gitignore

@@ -122,4 +122,8 @@ $RECYCLE.BIN/
 *.msp
 
 # Windows shortcuts
-*.lnk
+*.lnk
+
+# monitoring files for local development
+/monitoring/
+

Dockerfile

@@ -1,10 +1,14 @@
 FROM amazoncorretto:17
 
-ARG PORT=8000
-ENV JAVA_TOOL_OPTIONS="-Xms512m -Xmx2g -XX:+ExitOnOutOfMemoryError"
+# 작업 디렉토리 생성
+WORKDIR /app
 
-EXPOSE ${PORT}
+# 컨테이너 환경에 맞춰 힙 메모리를 자동 조절하는 옵션 적용
+# MaxRAMPercentage=75.0 : 컨테이너 메모리의 75%를 힙으로 사용 (나머지는 메타스페이스, 스레드, OS 등을 위해 남겨둠)
+ENV JAVA_TOOL_OPTIONS="-XX:MaxRAMPercentage=75.0 -XX:+ExitOnOutOfMemoryError"
 
-COPY ./build/libs/*.jar ./app.jar
+# 빌드된 JAR 파일 복사
+COPY ./build/libs/*.jar app.jar
 
+# 실행
 ENTRYPOINT ["java", "-jar", "app.jar"]

loadtest/comment/root_comment_show.js

@@ -0,0 +1,90 @@
+import http from 'k6/http';
+import { check } from 'k6';
+
+// --- 환경 설정 ---
+const BASE_URL = 'http://localhost:8080';
+const TARGET_POST_ID = 1;
+const POST_TYPE = 'FEED';
+
+export const options = {
+  // --- 시나리오 설정 (Constant Arrival Rate) ---
+  scenarios: {
+    // 1단계: 초당 50 요청 (Warm-up)
+    warm_up: {
+      executor: 'constant-arrival-rate',
+      rate: 50,
+      timeUnit: '1s',
+      duration: '30s',
+      preAllocatedVUs: 10,
+      maxVUs: 50,
+    },
+    // 2단계: 초당 150 요청 (Target Load)
+    load_test: {
+      executor: 'constant-arrival-rate',
+      rate: 150,
+      timeUnit: '1s',
+      duration: '1m',
+      startTime: '30s',
+      preAllocatedVUs: 30,
+      maxVUs: 100,
+    },
+    // 3단계: 초당 300 요청 (Stress Test)
+    stress_test: {
+      executor: 'constant-arrival-rate',
+      rate: 300,
+      timeUnit: '1s',
+      duration: '30s',
+      startTime: '1m30s',
+      preAllocatedVUs: 50,
+      maxVUs: 200,
+    },
+  },
+
+  // --- [핵심 수정] Thresholds 타겟팅 ---
+  // setup() 단계의 요청은 무시하고, 'root_comment_show' 태그가 있는 요청만 평가합니다.
+  thresholds: {
+    // 1. 응답 시간: 해당 태그 요청의 95%가 50ms 이내여야 함
+    'http_req_duration{name:root_comment_show}': ['p(95)<50'],
+
+    // 2. 에러율: 해당 태그 요청의 실패율이 1% 미만이어야 함
+    'http_req_failed{name:root_comment_show}': ['rate<0.01'],
+  },
+};
+
+// --- Setup: 토큰 발급 (성능 측정 제외 대상) ---
+export function setup() {
+  const MAX_SETUP_VUS = 200;
+  console.log(`🚀 토큰 ${MAX_SETUP_VUS}개 발급 시작...`);
+  const tokens = [];
+
+  for (let userId = 1; userId <= MAX_SETUP_VUS; userId++) {
+    // *주의* 여기에는 tags를 붙이지 않습니다. 따라서 thresholds 평가에서 자동 제외됩니다.
+    const res = http.get(`${BASE_URL}/api/test/token/access?userId=${userId}`);
+    if (res.status === 200 && res.body.length > 0) {
+      tokens.push(res.body);
+    }
+  }
+  console.log(`✅ 토큰 ${tokens.length}개 발급 완료`);
+  return { tokens };
+}
+
+// --- Main Logic: 루트 댓글 조회 (성능 측정 대상) ---
+export default function (data) {
+  // 토큰 랜덤 선택
+  const token = data.tokens[Math.floor(Math.random() * data.tokens.length)];
+
+  const params = {
+    headers: {
+      'Authorization': `Bearer ${token}`,
+      'Content-Type': 'application/json',
+    },
+    // [중요] 이 태그(name)를 기준으로 thresholds가 작동합니다.
+    tags: { name: 'root_comment_show' },
+  };
+
+  const res = http.get(`${BASE_URL}/comments/${TARGET_POST_ID}?postType=${POST_TYPE}`, params);
+
+  check(res, {
+    'status is 200': (r) => r.status === 200,
+  });
+}

src/main/java/konkuk/thip/comment/adapter/in/web/CommentCommandController.java

@@ -4,12 +4,14 @@
 import io.swagger.v3.oas.annotations.Parameter;
 import io.swagger.v3.oas.annotations.tags.Tag;
 import jakarta.validation.Valid;
-import konkuk.thip.comment.adapter.in.web.request.CommentCreateRequest;
+import konkuk.thip.comment.adapter.in.web.request.RootCommentCreateRequest;
+import konkuk.thip.comment.adapter.in.web.request.ChildCommentCreateRequest;
 import konkuk.thip.comment.adapter.in.web.request.CommentIsLikeRequest;
 import konkuk.thip.comment.adapter.in.web.response.CommentDeleteResponse;
 import konkuk.thip.comment.adapter.in.web.response.CommentCreateResponse;
 import konkuk.thip.comment.adapter.in.web.response.CommentIsLikeResponse;
-import konkuk.thip.comment.application.port.in.CommentCreateUseCase;
+import konkuk.thip.comment.application.port.in.RootCommentCreateUseCase;
+import konkuk.thip.comment.application.port.in.ChildCommentCreateUseCase;
 import konkuk.thip.comment.application.port.in.CommentDeleteUseCase;
 import konkuk.thip.comment.application.port.in.CommentLikeUseCase;
 import konkuk.thip.common.dto.BaseResponse;
@@ -25,28 +27,35 @@
 @RequiredArgsConstructor
 public class CommentCommandController {
 
-    private final CommentCreateUseCase commentCreateUseCase;
+    private final RootCommentCreateUseCase rootCommentCreateUseCase;
+    private final ChildCommentCreateUseCase childCommentCreateUseCase;
     private final CommentLikeUseCase commentLikeUseCase;
     private final CommentDeleteUseCase commentDeleteUseCase;
 
-    /**
-     * 댓글/답글 작성
-     * parentId:{Long},isReplyRequest:true 답글
-     * parentId:null,isReplyRequest:false 댓글
-     */
     @Operation(
-            summary = "댓글 작성",
-            description = "사용자가 댓글을 작성합니다.\n" +
-                    "답글 작성 시 parentId를 지정하고 isReplyRequest를 true로 설정합니다. " +
-                    "댓글 작성 시 parentId는 null로 설정하고 isReplyRequest를 false로 설정합니다."
+            summary = "루트 댓글 작성",
+            description = "특정 게시글에 루트 댓글을 작성합니다."
     )
     @ExceptionDescription(COMMENT_CREATE)
     @PostMapping("/comments/{postId}")
-    public BaseResponse<CommentCreateResponse> createComment(
-            @RequestBody @Valid final CommentCreateRequest request,
+    public BaseResponse<CommentCreateResponse> createRootComment(
+            @RequestBody @Valid final RootCommentCreateRequest request,
             @Parameter(description = "댓글을 작성하려는 게시물 ID", example = "1") @PathVariable("postId") final Long postId,
             @Parameter(hidden = true) @UserId final Long userId) {
-        return BaseResponse.ok(commentCreateUseCase.createComment(request.toCommand(userId,postId)));
+        return BaseResponse.ok(rootCommentCreateUseCase.createRootComment(request.toCommand(userId, postId)));
+    }
+
+    @Operation(
+            summary = "답글 작성",
+            description = "특정 댓글에 답글(자식 댓글)을 작성합니다."
+    )
+    @ExceptionDescription(COMMENT_CREATE)
+    @PostMapping("/comments/replies/{parentCommentId}")
+    public BaseResponse<CommentCreateResponse> createChildComment(
+            @RequestBody @Valid final ChildCommentCreateRequest request,
+            @Parameter(description = "부모 댓글 ID", example = "1") @PathVariable("parentCommentId") final Long parentCommentId,
+            @Parameter(hidden = true) @UserId final Long userId) {
+        return BaseResponse.ok(childCommentCreateUseCase.createChildComment(request.toCommand(userId, parentCommentId)));
     }
 
     @Operation(

src/main/java/konkuk/thip/comment/adapter/in/web/CommentQueryController.java

@@ -3,8 +3,11 @@
 import io.swagger.v3.oas.annotations.Operation;
 import io.swagger.v3.oas.annotations.Parameter;
 import io.swagger.v3.oas.annotations.tags.Tag;
-import konkuk.thip.comment.adapter.in.web.response.CommentForSinglePostResponse;
-import konkuk.thip.comment.application.port.in.CommentShowAllUseCase;
+import konkuk.thip.comment.adapter.in.web.response.ChildCommentsResponse;
+import konkuk.thip.comment.adapter.in.web.response.RootCommentsResponse;
+import konkuk.thip.comment.application.port.in.ChildCommentShowUseCase;
+import konkuk.thip.comment.application.port.in.RootCommentShowUseCase;
+import konkuk.thip.comment.application.port.in.dto.ChildCommentsShowQuery;
 import konkuk.thip.comment.application.port.in.dto.CommentShowAllQuery;
 import konkuk.thip.common.dto.BaseResponse;
 import konkuk.thip.common.security.annotation.UserId;
@@ -19,23 +22,40 @@
 @RequiredArgsConstructor
 public class CommentQueryController {
 
-    public final CommentShowAllUseCase commentShowAllUseCase;
+    public final RootCommentShowUseCase rootCommentShowUseCase;
+    public final ChildCommentShowUseCase childCommentShowUseCase;
 
     @Operation(
-            summary = "댓글 전체 조회",
-            description = "특정 게시글(= 피드, 기록, 투표) 의 댓글과 대댓글들을 전체 조회합니다."
+            summary = "루트 댓글 조회",
+            description = "특정 게시글(= 피드, 기록, 투표) 에 직접 달린 루트 댓글을 조회합니다."
     )
     @GetMapping("/comments/{postId}")
-    public BaseResponse<CommentForSinglePostResponse> showAllCommentsOfPost(
+    public BaseResponse<RootCommentsResponse> showRootCommentsOfPost(
             @Parameter(hidden = true) @UserId final Long userId,
             @Parameter(description = "댓글을 조회할 게시글(= FEED, RECORD, VOTE)의 id값")
             @PathVariable("postId") final Long postId,
             @Parameter(description = "게시물 타입 (RECORD, VOTE, FEED)", example = "RECORD")
             @RequestParam(value = "postType") final String postType,
             @Parameter(description = "커서 (첫번째 요청시 : null, 다음 요청시 : 이전 요청에서 반환받은 nextCursor 값)")
             @RequestParam(value = "cursor", required = false) final String cursor) {
-        return BaseResponse.ok(commentShowAllUseCase.showAllCommentsOfPost(
+        return BaseResponse.ok(rootCommentShowUseCase.showRootCommentsOfPost(
                 CommentShowAllQuery.of(postId, userId, postType, cursor)
         ));
     }
+
+    @Operation(
+            summary = "특정 댓글의 대댓글 조회",
+            description = "특정 루트 댓글의 모든 대댓글(자식 댓글)을 작성 시각순으로 조회합니다."
+    )
+    @GetMapping("/comments/replies/{rootCommentId}")
+    public BaseResponse<ChildCommentsResponse> showChildComments(
+            @Parameter(hidden = true) @UserId final Long userId,
+            @Parameter(description = "부모 댓글(루트 댓글)의 id값")
+            @PathVariable("rootCommentId") final Long rootCommentId,
+            @Parameter(description = "커서 (첫번째 요청시 : null, 다음 요청시 : 이전 요청에서 반환받은 nextCursor 값)")
+            @RequestParam(value = "cursor", required = false) final String cursor) {
+        return BaseResponse.ok(childCommentShowUseCase.showChildComments(
+                ChildCommentsShowQuery.of(rootCommentId, userId, cursor)
+        ));
+    }
 }

src/main/java/konkuk/thip/comment/adapter/in/web/request/ChildCommentCreateRequest.java

@@ -0,0 +1,26 @@
+package konkuk.thip.comment.adapter.in.web.request;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import konkuk.thip.comment.application.port.in.dto.ChildCommentCreateCommand;
+
+@Schema(description = "자식 댓글(답글) 작성 요청 DTO")
+public record ChildCommentCreateRequest(
+
+        @Schema(description = "댓글 내용", example = "좋은 의견이네요!")
+        @NotBlank(message = "댓글 내용은 필수입니다.")
+        String content,
+
+        @Schema(description = "게시물 타입 (RECORD, VOTE, FEED)", example = "RECORD")
+        @NotBlank(message = "게시물 타입은 필수입니다.")
+        String postType,
+
+        @Schema(description = "게시물 ID", example = "1")
+        @NotNull(message = "게시물 ID는 필수입니다.")
+        Long postId
+) {
+        public ChildCommentCreateCommand toCommand(Long userId, Long parentCommentId) {
+                return new ChildCommentCreateCommand(content, postType, postId, userId, parentCommentId);
+        }
+}

src/main/java/konkuk/thip/comment/adapter/in/web/request/RootCommentCreateRequest.java

@@ -0,0 +1,21 @@
+package konkuk.thip.comment.adapter.in.web.request;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import konkuk.thip.comment.application.port.in.dto.RootCommentCreateCommand;
+
+@Schema(description = "루트 댓글 작성 요청 DTO")
+public record RootCommentCreateRequest(
+
+        @Schema(description = "댓글 내용", example = "이 게시물 정말 좋아요!")
+        @NotBlank(message = "댓글 내용은 필수입니다.")
+        String content,
+
+        @Schema(description = "게시물 타입 (RECORD, VOTE, FEED)", example = "RECORD")
+        @NotBlank(message = "게시물 타입은 필수입니다.")
+        String postType
+) {
+        public RootCommentCreateCommand toCommand(Long userId, Long postId) {
+                return new RootCommentCreateCommand(content, postType, postId, userId);
+        }
+}

src/main/java/konkuk/thip/comment/adapter/in/web/response/ChildCommentsResponse.java

@@ -0,0 +1,25 @@
+package konkuk.thip.comment.adapter.in.web.response;
+
+import java.util.List;
+
+public record ChildCommentsResponse(
+        List<ChildCommentDto> childComments,
+        String nextCursor,
+        boolean isLast
+) {
+    public record ChildCommentDto(
+            Long commentId,
+            String parentCommentCreatorNickname,
+            Long creatorId,
+            String creatorProfileImageUrl,
+            String creatorNickname,
+            String aliasName,
+            String aliasColor,
+            String postDate,        // 댓글 작성 시각 (~ 전 형식)
+            String content,
+            int likeCount,
+            boolean isLike,
+            boolean isWriter
+    ) {}
+}
+