Merge pull request #302 from DevKor-github/docs/comments

docs(): 스웨거에서 동일한 이름의 아이템을 못 찾는 문제 수정

Author: pizzazoa

src/main/java/org/devkor/apu/saerok_server/domain/collection/api/dto/response/GetCollectionCommentsResponse.java

@@ -6,10 +6,11 @@
 import java.util.List;
 
 public record GetCollectionCommentsResponse(
+    @Schema(description = "댓글 목록 (원댓글만 포함, 대댓글은 각 원댓글의 replies에 포함)")
     List<Item> items,
     @Schema(description = "내 컬렉션인지 여부", example = "true")
     Boolean isMyCollection,
-    @Schema(description = "다음 페이지 존재 여부 (페이징 요청 시에만 유효)", example = "true")
+    @Schema(description = "다음 페이지 존재 여부 (페이징 요청 시에만 유효, 미사용 시 null)", example = "true", nullable = true)
     Boolean hasNext
 ) {
 
@@ -28,19 +29,19 @@ public record Item(
             String content,
             @Schema(description = "댓글 상태 (ACTIVE, DELETED, BANNED)", example = "ACTIVE", requiredMode = Schema.RequiredMode.REQUIRED)
             String status,
-            @Schema(description = "부모 댓글 ID (대댓글인 경우)", example = "5", requiredMode = Schema.RequiredMode.NOT_REQUIRED)
+            @Schema(description = "부모 댓글 ID (원댓글이면 null, 대댓글이면 부모 댓글 ID)", example = "null", nullable = true, requiredMode = Schema.RequiredMode.NOT_REQUIRED)
             Long parentId,
             @Schema(description = "좋아요 수", example = "5", requiredMode = Schema.RequiredMode.REQUIRED)
             int likeCount,
-            @Schema(description = "좋아요 눌렀는지 여부", example = "true")
+            @Schema(description = "좋아요 눌렀는지 여부 (비로그인 시 false)", example = "true", requiredMode = Schema.RequiredMode.REQUIRED)
             Boolean isLiked,
-            @Schema(description = "내 댓글인지 여부", example = "false")
+            @Schema(description = "내 댓글인지 여부 (비로그인 시 false)", example = "false", requiredMode = Schema.RequiredMode.REQUIRED)
             Boolean isMine,
             @Schema(description = "작성 시각", example = "2025-07-05T03:10:00", requiredMode = Schema.RequiredMode.REQUIRED)
             LocalDateTime createdAt,
             @Schema(description = "수정 시각", example = "2025-07-05T04:21:00", requiredMode = Schema.RequiredMode.REQUIRED)
             LocalDateTime updatedAt,
-            @Schema(description = "대댓글 목록", requiredMode = Schema.RequiredMode.REQUIRED)
+            @Schema(description = "대댓글 목록 (대댓글의 replies는 항상 빈 배열)", example = "[]", requiredMode = Schema.RequiredMode.REQUIRED)
             List<Item> replies
     ) {
 

src/main/resources/application.yml

@@ -46,4 +46,7 @@ notification-batch:
   initial-window-seconds: 30
   max-window-seconds: 60
   ttl-seconds: 90
-  max-batches-per-tick: 300
+  max-batches-per-tick: 300
+
+springdoc:
+  use-fqn: true