백엔드 스터디 Day 5: Service와 트랜잭션으로 비즈니스 흐름 읽기

Controller: HTTP 요청을 받는다
Service: 기능의 실제 규칙을 실행한다
Repository: DB와 대화한다
Entity: DB에 저장되는 객체다
DTO: API 입출력 모양이다

게시글 작성 요청
→ 로그인 사용자인지 확인
→ 제목/내용이 유효한지 확인
→ 카테고리가 존재하는지 확인
→ 작성 권한이 있는지 확인
→ Post Entity 생성
→ DB에 저장
→ 응답 DTO 반환

@PostMapping("/posts")
public ResponseEntity<PostResponse> createPost(
        @Valid @RequestBody CreatePostRequest request,
        @AuthenticationPrincipal UserPrincipal user
) {

@Service
@RequiredArgsConstructor
public class PostService {

    private final PostRepository postRepository;
    private final CategoryRepository categoryRepository;
    private final UserRepository userRepository;

    @Transactional
    public PostResponse createPost(CreatePostRequest request, Long userId) {
        User author = userRepository.findById(userId)
                .orElseThrow(() -> new NotFoundException("사용자를 찾을 수 없습니다."));

        Category category = categoryRepository.findByIdrequest

작성자 사용자를 찾는다.
카테고리를 찾는다.
게시글 Entity를 만든다.
DB에 저장한다.
응답 DTO로 바꿔 돌려준다.

1. 메서드 이름을 본다.
2. 입력값을 본다.
3. 조회하는 Repository를 본다.
4. 검증/권한/상태 변경 규칙을 본다.
5. 저장하거나 삭제하는 Repository 호출을 본다.
6. 어떤 DTO로 응답하는지 본다.
7. 트랜잭션이 필요한지 본다.

@Transactional
public PostResponse updatePost(Long postId, UpdatePostRequest request, Long userId) {
    Post post = postRepository.findById(postId)
            .orElseThrow(() -> new NotFoundException("게시글을 찾을 수 없습니다."));

    if (!post.isWrittenBy(userId)) {
        throw new ForbiddenException("게시글 수정 권한이 없습니다.");
    }

    post.updateTitle(request.title());

수정할 게시글을 찾는다.
없으면 404를 낸다.
작성자가 아니면 403을 낸다.
제목과 내용을 바꾼다.
바뀐 게시글을 응답 DTO로 돌려준다.

@Transactional 안에서 조회한 Entity를 바꾸면 저장될 수 있다.
그래서 Service의 @Transactional 여부와 Entity 변경 코드를 같이 봐야 한다.

@Service
@RequiredArgsConstructor
public class CommentService {
    private final CommentRepository commentRepository;
    private final PostRepository postRepository;
}

src/main/java/com/example/app/post/PostService.java
src/main/java/com/example/app/comment/CommentService.java
src/main/java/com/example/app/user/UserService.java

@PostMapping("/posts")
public PostResponse createPost(@RequestBody CreatePostRequest request) {
    User user = userRepository.findById(request.userId()).get();
    Category category = categoryRepository.findById(request.categoryId()).get();

    if (request.title().length() > 100) {
        throw new IllegalArgumentException("제목이 너무 깁니다."

Controller: 요청을 Service에 전달
Service: 사용자/카테고리 조회, 검증, Entity 생성, 저장
Repository: DB 접근

public interface PostRepository extends JpaRepository<Post, Long> {
    List<Post> findByAuthorId(Long authorId);
    List<Post> findByCategoryId(Long categoryId);
    boolean existsByTitleAndAuthorId(String title, Long authorId);
}

@Query("""
    select p from Post p
    where p.category.id = :categoryId
      and p.deleted = false
      and p.author.status = 'ACTIVE'
      and p.createdAt > :limitDate
      and (p.visibility = 'PUBLIC' or p.author.id = :viewerId)
""")
List<Post> findVisibleRecentPosts(Long categoryId, Long viewerId, LocalDateTime limitDate);

상품 재고 확인
→ 주문 생성
→ 주문 항목 생성
→ 재고 차감
→ 결제 대기 상태 저장

@Transactional
public OrderResponse createOrder(CreateOrderRequest request, Long userId) {
    User user = userRepository.findById(userId)
            .orElseThrow(() -> new NotFoundException("사용자를 찾을 수 없습니다."));

    Product product = productRepository.findById(request.productId())
            .orElseThrow(() -> new NotFoundException("상품을 찾을 수 없습니다."));

    product.decreaseStock(request.quantity(

사용자 조회
상품 조회
재고 차감
주문 생성
주문 저장

@Transactional(readOnly = true)
public PostDetailResponse getPost(Long postId, Long viewerId) {
    Post post = postRepository.findById(postId)
            .orElseThrow(() -> new NotFoundException("게시글을 찾을 수 없습니다."));

    if (!post.canBeViewedBy(viewerId)) {
        throw new ForbiddenException("게시글을 볼 수 없습니다.");
    }

    return PostDetailResponse.from(post);

@Transactional(readOnly = true)
public PostDetailResponse getPost(Long postId) {
    Post post = postRepository.findById(postId)
            .orElseThrow(() -> new NotFoundException("게시글을 찾을 수 없습니다."));

    post.increaseViewCount(); // 위험 신호

    return PostDetailResponse.from(post);
}

createPost

createComment

togglePostLike

@Transactional
public PostResponse createPostAndNotifyAndUploadAndRecommend(...) {
    // 게시글 생성
    // 파일 업로드
    // 알림 발송
    // 추천 피드 갱신
    // 검색 인덱스 갱신
    // 통계 업데이트
}

Post post = postRepository.findById(postId).get();

Post post = postRepository.findById(postId)
        .orElseThrow(() -> new NotFoundException("게시글을 찾을 수 없습니다."));

public PostResponse createPost(CreatePostRequest request) {
    User author = userRepository.findById(request.userId()).get();
    // ...
}

public PostResponse createPost(CreatePostRequest request, Long currentUserId) {
    User author = userRepository.findById(currentUserId)
            .orElseThrow(...);
}

@Transactional
public void deletePost(Long postId) {
    postRepository.deleteById(postId);
}

@Transactional
public void deletePost(Long postId, Long userId) {
    Post post = postRepository.findById(postId)
            .orElseThrow(() -> new NotFoundException("게시글을 찾을 수 없습니다."));

    if (!post.isWrittenBy(userId)) {
        throw new ForbiddenException("게시글 삭제 권한이 없습니다.");
    }

    postRepository.delete(post);
}

public Post getPost(Long postId) {
    return postRepository.findById(postId).orElseThrow(...);
}

public PostResponse getPost(Long postId) {
    Post post = postRepository.findById(postId).orElseThrow(...);
    return PostResponse.from(post);
}

public PostResponse updatePost(Long postId, UpdatePostRequest request) {
    Post post = postRepository.findById(postId).orElseThrow(...);
    post.update(request.title(), request.content());
    return PostResponse.from(post);
}

@Transactional
public void payOrder(Long orderId) {
    Order order = orderRepository.findById(orderId).orElseThrow(...);
    paymentClient.pay(order.getPrice());
    order.markPaid();
}

[게시글 수정]

await updatePost({ postId, title, content });

postId로 게시글을 찾는가?
없으면 404인가?
현재 사용자가 작성자인지 확인하는가?
title/content 검증은 어디서 하는가?
수정 시간이 갱신되는가?
응답 DTO에 프론트엔드가 필요한 필드가 들어가는가?

화면 행동
→ API 요청 payload
→ Controller 파라미터
→ Service 규칙
→ Repository 조회/저장
→ Entity 변경
→ 응답 DTO
→ 프론트엔드 상태 갱신

@Test
void 작성자가_아니면_게시글을_수정할_수_없다() {
    Post post = postRepository.save(PostFixture.post(author));

    assertThatThrownBy(() -> postService.updatePost(
            post.getId(),
            new UpdatePostRequest("새 제목", "새 내용"),
            otherUser.getId()
    )).isInstanceOf(ForbiddenException.class);
}

무엇을 찾고,
무엇을 검증하고,
무엇을 바꾸고,
무엇을 저장하고,
무엇을 응답하는가?