Ref: post 도메인 리팩토링

Author: joyewon0705

src/main/java/com/back/domain/board/post/controller/PostController.java

@@ -65,9 +65,8 @@ public ResponseEntity<RsData<PostDetailResponse>> getPost(
             @PathVariable Long postId,
             @AuthenticationPrincipal CustomUserDetails user
     ) {
-        PostDetailResponse response = (user != null)
-                ? postService.getPostWithUser(postId, user.getUserId())
-                : postService.getPost(postId);
+        Long userId = (user != null) ? user.getUserId() : null;
+        PostDetailResponse response = postService.getPost(postId, userId);
         return ResponseEntity
                 .status(HttpStatus.OK)
                 .body(RsData.success(

src/main/java/com/back/domain/board/post/controller/docs/PostCategoryControllerDocs.java

@@ -32,7 +32,7 @@ public interface PostCategoryControllerDocs {
                             examples = @ExampleObject(value = """
                                     {
                                       "success": true,
-                                      "code": "SUCCESS_201",
+                                      "code": "SUCCESS_200",
                                       "message": "카테고리가 생성되었습니다.",
                                       "data": {
                                         "id": 80,

src/main/java/com/back/domain/board/post/controller/docs/PostControllerDocs.java

@@ -409,10 +409,18 @@ ResponseEntity<RsData<PostDetailResponse>> getPost(
             ),
             @ApiResponse(
                     responseCode = "404",
-                    description = "존재하지 않는 게시글 또는 카테고리",
+                    description = "존재하지 않는 사용자/게시글/카테고리",
                     content = @Content(
                             mediaType = "application/json",
                             examples = {
+                                    @ExampleObject(name = "존재하지 않는 사용자", value = """
+                                            {
+                                              "success": false,
+                                              "code": "USER_001",
+                                              "message": "존재하지 않는 사용자입니다.",
+                                              "data": null
+                                            }
+                                            """),
                                     @ExampleObject(name = "존재하지 않는 게시글", value = """
                                             {
                                               "success": false,
@@ -539,17 +547,27 @@ ResponseEntity<RsData<PostResponse>> updatePost(
             ),
             @ApiResponse(
                     responseCode = "404",
-                    description = "존재하지 않는 게시글",
+                    description = "존재하지 않는 사용자 또는 게시글",
                     content = @Content(
                             mediaType = "application/json",
-                            examples = @ExampleObject(value = """
-                                    {
-                                      "success": false,
-                                      "code": "POST_001",
-                                      "message": "존재하지 않는 게시글입니다.",
-                                      "data": null
-                                    }
-                                    """)
+                            examples = {
+                                    @ExampleObject(name = "존재하지 않는 사용자", value = """
+                                            {
+                                              "success": false,
+                                              "code": "USER_001",
+                                              "message": "존재하지 않는 사용자입니다.",
+                                              "data": null
+                                            }
+                                            """),
+                                    @ExampleObject(name = "존재하지 않는 게시글", value = """
+                                            {
+                                              "success": false,
+                                              "code": "POST_001",
+                                              "message": "존재하지 않는 게시글입니다.",
+                                              "data": null
+                                            }
+                                            """)
+                            }
                     )
             ),
             @ApiResponse(

src/main/java/com/back/domain/board/post/entity/Post.java

@@ -159,4 +159,9 @@ public List<PostCategory> getCategories() {
                 .map(PostCategoryMapping::getCategory)
                 .toList();
     }
+
+    /** 게시글 삭제 시 연관관계 정리 */
+    public void remove() {
+        this.user.removePost(this);
+    }
 }

src/main/java/com/back/domain/board/post/entity/PostBookmark.java

@@ -29,4 +29,11 @@ public PostBookmark(Post post, User user) {
         post.addBookmark(this);
         user.addPostBookmark(this);
     }
+
+    // -------------------- 헬퍼 메서드 --------------------
+    /** 게시글 북마크 삭제 시 연관관계 정리 */
+    public void remove() {
+        this.post.removeBookmark(this);
+        this.user.removePostBookmark(this);
+    }
 }

src/main/java/com/back/domain/board/post/entity/PostLike.java

@@ -29,4 +29,11 @@ public PostLike(Post post, User user) {
         post.addLike(this);
         user.addPostLike(this);
     }
+
+    // -------------------- 헬퍼 메서드 --------------------
+    /** 게시글 좋아요 삭제 시 연관관계 정리 */
+    public void remove() {
+        this.post.removeLike(this);
+        this.user.removePostLike(this);
+    }
 }

src/main/java/com/back/domain/board/post/service/PostBookmarkService.java

@@ -23,11 +23,10 @@ public class PostBookmarkService {
 
     /**
      * 게시글 북마크 서비스
-     * 1. User 조회
-     * 2. Post 조회
-     * 3. 이미 존재하는 경우 예외 처리
-     * 4. PostBookmark 저장 및 bookmarkCount 증가
-     * 5. PostBookmarkResponse 반환
+     *
+     * @param postId 게시글 ID
+     * @param userId 사용자 ID
+     * @return 게시글 북마크 응답 DTO
      */
     public PostBookmarkResponse bookmarkPost(Long postId, Long userId) {
         // User 조회
@@ -43,21 +42,19 @@ public PostBookmarkResponse bookmarkPost(Long postId, Long userId) {
             throw new CustomException(ErrorCode.BOOKMARK_ALREADY_EXISTS);
         }
 
-        // 북마크 수 증가
+        // PostBookmark 저장 및 북마크 수 증가 처리
         post.increaseBookmarkCount();
-
-        // PostBookmark 저장 및 응답 반환
         postBookmarkRepository.save(new PostBookmark(post, user));
+
         return PostBookmarkResponse.from(post);
     }
 
     /**
      * 게시글 북마크 취소 서비스
-     * 1. User 조회
-     * 2. Post 조회
-     * 3. PostBookmark 조회
-     * 4. PostBookmark 삭제 및 bookmarkCount 감소
-     * 5. PostBookmarkResponse 반환
+     *
+     * @param postId 게시글 ID
+     * @param userId 사용자 ID
+     * @return 게시글 북마크 응답 DTO
      */
     public PostBookmarkResponse cancelBookmarkPost(Long postId, Long userId) {
         // User 조회
@@ -72,17 +69,11 @@ public PostBookmarkResponse cancelBookmarkPost(Long postId, Long userId) {
         PostBookmark postBookmark = postBookmarkRepository.findByUserIdAndPostId(userId, postId)
                 .orElseThrow(() -> new CustomException(ErrorCode.BOOKMARK_NOT_FOUND));
 
-        // 연관관계 제거
-        post.removeBookmark(postBookmark);
-        user.removePostBookmark(postBookmark);
-
-        // PostBookmark 삭제
+        // PostBookmark 삭제 및 북마크 수 감소 처리
+        postBookmark.remove();
         postBookmarkRepository.delete(postBookmark);
-
-        // 북마크 수 감소
         post.decreaseBookmarkCount();
 
-        // 응답 반환
         return PostBookmarkResponse.from(post);
     }
 }

src/main/java/com/back/domain/board/post/service/PostCategoryService.java

@@ -23,13 +23,12 @@ public class PostCategoryService {
 
     /**
      * 카테고리 생성 서비스
-     * 1. User 조회
-     * 2. 이미 존재하는 경우 예외
-     * 3. PostCategory 생성
-     * 4. PostCategory 저장 및 CategoryResponse 반환
+     *
+     * @param request 카테고리 생성 요청 본문
+     * @param userId  사용자 ID
+     * @return 생성된 카테고리 응답 DTO
      */
     public CategoryResponse createCategory(CategoryRequest request, Long userId) {
-
         // User 조회
         User user = userRepository.findById(userId)
                 .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND));
@@ -41,16 +40,15 @@ public CategoryResponse createCategory(CategoryRequest request, Long userId) {
 
         // PostCategory 생성
         PostCategory category = new PostCategory(request.name(), request.type());
-
-        // PostCategory 저장 및 응답 반환
         PostCategory saved = postCategoryRepository.save(category);
+
         return CategoryResponse.from(saved);
     }
 
     /**
      * 카테고리 전체 조회 서비스
-     * 1. PostCategory 전체 조회
-     * 2. List<CategoryResponse> 반환
+     *
+     * @return 카테고리 응답 DTO 리스트
      */
     @Transactional(readOnly = true)
     public List<CategoryResponse> getAllCategories() {

src/main/java/com/back/domain/board/post/service/PostLikeService.java

@@ -25,13 +25,11 @@ public class PostLikeService {
     private final ApplicationEventPublisher eventPublisher;
 
     /**
-     * 게시글 좋아요 서비스
-     * 1. User 조회
-     * 2. Post 조회
-     * 3. 이미 존재하는 경우 예외 처리
-     * 4. PostLike 저장 및 likeCount 증가
-     * 5. 알림 이벤트 발행 (자기 글이 아닐 경우)
-     * 6. PostLikeResponse 반환
+     * 게시글 좋아요 생성 서비스
+     *
+     * @param postId 게시글 ID
+     * @param userId 사용자 ID
+     * @return 게시글 좋아요 응답 DTO
      */
     public PostLikeResponse likePost(Long postId, Long userId) {
         // User 조회
@@ -42,22 +40,20 @@ public PostLikeResponse likePost(Long postId, Long userId) {
         Post post = postRepository.findById(postId)
                 .orElseThrow(() -> new CustomException(ErrorCode.POST_NOT_FOUND));
 
-        // 이미 좋아요를 누른 경우 예외
+        // 이미 좋아요한 경우 예외
         if (postLikeRepository.existsByUserIdAndPostId(userId, postId)) {
             throw new CustomException(ErrorCode.POST_ALREADY_LIKED);
         }
 
-        // 좋아요 수 증가
+        // PostLike 저장 및 좋아요 수 증가 처리
         post.increaseLikeCount();
-
-        // PostLike 저장 및 응답 반환
         postLikeRepository.save(new PostLike(post, user));
 
-        // 알림 이벤트 발행 (자기 자신의 글이 아닐 때만)
+        // 게시글 좋아요 이벤트 발행 (자기 자신의 글이 아닐 때만)
         if (!post.getUser().getId().equals(userId)) {
             eventPublisher.publishEvent(
                     new PostLikedEvent(
-                            userId,                    // 좋아요 누른 사람
+                            userId,                    // 좋아요한 사용자
                             post.getUser().getId(),    // 게시글 작성자
                             post.getId(),
                             post.getTitle()
@@ -69,12 +65,11 @@ public PostLikeResponse likePost(Long postId, Long userId) {
     }
 
     /**
-     * 게시글 좋아요 취소 서비스
-     * 1. User 조회
-     * 2. Post 조회
-     * 3. PostLike 조회
-     * 4. PostLike 삭제 및 likeCount 감소
-     * 5. PostLikeResponse 반환
+     * 게시글 좋아요 삭제 서비스
+     *
+     * @param postId 게시글 ID
+     * @param userId 사용자 ID
+     * @return 게시글 좋아요 응답 DTO
      */
     public PostLikeResponse cancelLikePost(Long postId, Long userId) {
         // User 조회
@@ -89,17 +84,11 @@ public PostLikeResponse cancelLikePost(Long postId, Long userId) {
         PostLike postLike = postLikeRepository.findByUserIdAndPostId(userId, postId)
                 .orElseThrow(() -> new CustomException(ErrorCode.POST_LIKE_NOT_FOUND));
 
-        // 연관관계 제거
-        post.removeLike(postLike);
-        user.removePostLike(postLike);
-
-        // PostLike 삭제
+        // PostLike 삭제 및 좋아요 수 감소 처리
+        postLike.remove();
         postLikeRepository.delete(postLike);
-
-        // 좋아요 수 감소
         post.decreaseLikeCount();
 
-        // 응답 반환
         return PostLikeResponse.from(post);
     }
 }