Merge pull request #528 from projects200/feat/comment/post-like

[FEAT] 좋아요 댓글 API 개발

Author: dlchdaud123

src/docs/asciidoc/index.adoc

@@ -266,4 +266,8 @@ include::overview/공통-개발-참고-사항.adoc[]
 
 - 특정 피드에 댓글 작성 API #POST# `/api/v1/feeds/{feedId}/comments`
 
-- 댓글 삭제 API #DELETE# `/api/v1/comments/{commentId}`
+- 댓글 삭제 API #DELETE# `/api/v1/comments/{commentId}`
+
+=== xref:좋아요-API.html[좋아요 API]
+
+- 특정 댓글의 좋아요 작성 API #POST# `/api/v1/comments/{commentId}/like`

src/docs/asciidoc/like/특정-댓글의-좋아요-작성-API.adoc

@@ -0,0 +1,32 @@
+== 특정 댓글의 좋아요 작성 API
+
+=== 설명
+
+- #POST# `/api/v1/comments/{commentId}/like`
+- 특정 댓글에 좋아요를 하거나 취소하는 API 입니다.
+- `status` 필드가 `true`이면 좋아요, `false`이면 좋아요 취소입니다.
+
+=== 개발 이력
+
+- Sprint 24 (2026-02-04): 기능 개발이 완료되었습니다.
+
+=== 개발 참고 사항
+
+- <<공통-개발-참고-사항,공통 개발 참고 사항>>을 참고하세요.
+
+=== 코드 샘플
+
+operation::create-comment-like/create-comment-like_success[snippets="curl-request,http-request,http-response"]
+
+=== 매개 변수
+
+operation::create-comment-like/create-comment-like_success[snippets="request-headers,path-parameters,request-fields,response-fields"]
+
+==== 응답 상태 코드
+
+|===
+|상태 코드|설명
+|201|리소스가 성공적으로 생성되었습니다. (좋아요 성공/취소 모두 성공 응답)
+|401|인증되지 않은 요청입니다. Access Token이 없거나 유효하지 않습니다.
+|404|존재하지 않는 댓글입니다.
+|===

src/docs/asciidoc/좋아요-API.adoc

@@ -0,0 +1,22 @@
+= 좋아요 API
+:doctype: book
+:source-highlighter: highlightjs
+:toc: left
+:toclevels: 3
+:seclinks:
+
+:operation-request-headers-title: 요청 헤더
+:operation-path-parameters-title: 경로 매개 변수
+:operation-request-parts-title: 요청 파트(Form Data)
+:operation-request-fields-title: 요청 필드
+:operation-response-fields-title: 응답 필드
+:operation-curl-request-title: Curl 요청 예시
+:operation-http-request-title: HTTP 요청 예시
+:operation-http-response-title: HTTP 응답 예시
+
+[[공통-개발-참고-사항]]
+== 공통 개발 참고 사항
+
+include::overview/공통-개발-참고-사항.adoc[]
+
+include::like/특정-댓글의-좋아요-작성-API.adoc[]

src/main/java/com/project200/undabang/comment/entity/Comment.java

@@ -70,6 +70,16 @@ public boolean isDeleted() {
         return this.deletedAt != null;
     }
 
+    public void incrementLikesCount() {
+        this.likesCount++;
+    }
+
+    public void decrementLikesCount() {
+        if (this.likesCount > 0) {
+            this.likesCount--;
+        }
+    }
+
     public static Comment create(Member member, Feed feed, Comment parent, CreateCommentRequest request) {
         return Comment.builder()
                 .member(member)

src/main/java/com/project200/undabang/like/controller/CommentLikeCommandController.java

@@ -0,0 +1,27 @@
+package com.project200.undabang.like.controller;
+
+import com.project200.undabang.common.web.response.CommonResponse;
+import com.project200.undabang.like.dto.request.CreateCommentLikeRequest;
+import com.project200.undabang.like.dto.response.CreateCommentLikeResponse;
+import com.project200.undabang.like.service.impl.CommentCommandLikeServiceImpl;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.*;
+
+@RestController
+@RequiredArgsConstructor
+@RequestMapping("/api")
+public class CommentLikeCommandController {
+
+    private final CommentCommandLikeServiceImpl commentCommandLikeService;
+
+    @PostMapping("/v1/comments/{commentId}/like")
+    public ResponseEntity<CommonResponse<CreateCommentLikeResponse>> createCommentLike(@PathVariable Long commentId,
+                                                                                       @Valid @RequestBody CreateCommentLikeRequest request) {
+        return ResponseEntity.status(HttpStatus.CREATED)
+                .body(CommonResponse.create(commentCommandLikeService.createCommentLike(commentId, request)));
+
+    }
+}

src/main/java/com/project200/undabang/like/dto/request/CreateCommentLikeRequest.java

@@ -0,0 +1,8 @@
+package com.project200.undabang.like.dto.request;
+
+import jakarta.validation.constraints.NotNull;
+
+public record CreateCommentLikeRequest(
+        @NotNull(message = "좋아요 여부는 필수 값입니다.")
+        Boolean liked) {
+}

src/main/java/com/project200/undabang/like/dto/response/CreateCommentLikeResponse.java

@@ -0,0 +1,6 @@
+package com.project200.undabang.like.dto.response;
+
+public record CreateCommentLikeResponse(
+        Boolean liked,
+        Integer likesCount) {
+}

src/main/java/com/project200/undabang/like/entity/CommentLike.java

@@ -35,4 +35,11 @@ public class CommentLike {
     @Builder.Default
     @Column(name = "comment_like_created_at", nullable = false, updatable = false)
     private LocalDateTime createdAt = LocalDateTime.now();
+
+    public static CommentLike create(Comment comment, Member member) {
+        return CommentLike.builder()
+                .comment(comment)
+                .member(member)
+                .build();
+    }
 }

src/main/java/com/project200/undabang/like/repository/CommentLikeRepository.java

@@ -1,7 +1,13 @@
 package com.project200.undabang.like.repository;
 
+import com.project200.undabang.comment.entity.Comment;
 import com.project200.undabang.like.entity.CommentLike;
+import com.project200.undabang.member.entity.Member;
 import org.springframework.data.jpa.repository.JpaRepository;
 
+import java.util.Optional;
+
 public interface CommentLikeRepository extends JpaRepository<CommentLike, Long> {
+    Optional<CommentLike> findByCommentAndMember(Comment comment, Member member);
 }
+

src/main/java/com/project200/undabang/like/service/CommentCommandLikeService.java

@@ -0,0 +1,9 @@
+package com.project200.undabang.like.service;
+
+import com.project200.undabang.like.dto.request.CreateCommentLikeRequest;
+import com.project200.undabang.like.dto.response.CreateCommentLikeResponse;
+
+public interface CommentCommandLikeService {
+
+    CreateCommentLikeResponse createCommentLike(Long CommentId, CreateCommentLikeRequest request);
+}