🛵 배달 서비스 리뷰 도메인 구현기 — DDD 구조로 처음부터 끝까지

들어가며

오늘은 배달 서비스 프로젝트에서 리뷰 도메인을 DDD(Domain-Driven Design) 구조로 구현했다.
도메인 설계부터 프레젠테이션 레이어까지, 팀원 코드와 연동하면서 겪은 문제들과 해결 과정을 정리한다.

---

1. DDD 레이어 구현 순서

DDD 구조에서는 다음 순서로 구현하는 것이 좋다.

Domain → Application → Infrastructure → Presentation

• Domain: 비즈니스 핵심 로직 (Entity, Value Object, Domain Service 인터페이스)
• Application: 유즈케이스 처리 (Service, DTO)
• Infrastructure: 외부 기술 구현체 (Repository 구현체, Domain Service 구현체)
• Presentation: 요청/응답 처리 (Controller, Request/Response DTO)

---

2. Domain 레이어 설계

Review 엔티티

@Entity
@NoArgsConstructor(access = AccessLevel.PROTECTED)
public class Review extends BaseUserEntity {

    @EmbeddedId
    private ReviewId id;

    @Embedded
    private Reviewer reviewer;      // 작성자 정보

    @Embedded
    private ReviewOrderInfo info;   // 주문 정보

    @Embedded
    private ReviewContent content;  // 리뷰 내용
}

@EmbeddedId로 복합키 대신 ReviewId를 식별자로 사용했고,
관련 정보들을 @Embedded Value Object로 분리했다.

권한 체크 로직

리뷰 작성/수정/삭제 시 권한을 체크하는 로직을 도메인 안에 캡슐화했다.

private void checkAuthority(UUID orderId, ReviewerCheck reviewerCheck, RoleCheck roleCheck) {
    // 관리자는 항상 허용
    if (roleCheck.hasRole(List.of("MASTER", "MANAGER"))) {
        return;
    }
    // 주문자/작성자 확인
    if (!reviewerCheck.check(id, orderId)) {
        if (id == null) {
            throw new CustomException(ErrorCode.INVALID_REVIEW_UNAUTHORIZED);
        } else {
            throw new CustomException(ErrorCode.INVALID_REVIEW_DETAIL_UNAUTHORIZED);
        }
    }
}

Domain Service 인터페이스

인프라에 의존하지 않도록 도메인 서비스를 인터페이스로 정의했다.

public interface ReviewerCheck {
    boolean check(ReviewId reviewId, UUID orderId);
}

public interface OrderInfoProvider {
    ReviewOrderInfo getOrderInfo(UUID orderId);
}

public interface StoreRatingCalculator {
    double getAverageRating(UUID storeId);
    Long getReviewCount(UUID storeId);
}

---

3. Infrastructure 레이어 — 팀원 코드 연동

핵심 포인트: 타입 불일치 문제

팀원의 Orderer 클래스에서 userId가 Long 타입이었다.

public class Orderer {
    private Long userId;  // UUID가 아닌 Long!
}

따라서 Reviewer의 id도 Long으로 맞춰야 했다.

public class Reviewer {
    @Column(name = "reviewer_id")
    private Long id;  // UUID → Long으로 변경
}

ReviewerCheckImpl

@Component
@RequiredArgsConstructor
public class ReviewerCheckImpl implements ReviewerCheck {

    @Override
    public boolean check(ReviewId reviewId, UUID orderId) {
        Long currentUserId = userDetails.getId();
        return reviewId == null
                ? isOrderer(orderId, currentUserId)   // 새 리뷰: 주문자 확인
                : isReviewer(reviewId, currentUserId); // 수정: 작성자 확인
    }
}

QueryDSL 사용 — QReview 자동 생성

QueryDSL을 사용하면 @Entity 클래스를 기반으로 Q클래스가 자동 생성된다.

./gradlew compileJava

빌드 후 build/generated/sources/annotationProcessor/java/main/ 경로에 QReview.java가 생긴다.

---

4. jsonb 타입 매핑 문제

List<ReviewOrderItem>을 PostgreSQL의 jsonb 타입으로 저장하려면 JPA가 직렬화 방법을 알아야 한다.

AttributeConverter 사용

@Converter
public class ReviewOrderItemsConverter 
        implements AttributeConverter<List<ReviewOrderItem>, String> {

    private final ObjectMapper objectMapper = new ObjectMapper();

    @Override
    public String convertToDatabaseColumn(List<ReviewOrderItem> items) {
        try {
            return objectMapper.writeValueAsString(items);
        } catch (Exception e) {
            throw new RuntimeException("JSON 변환 실패", e);
        }
    }

    @Override
    public List<ReviewOrderItem> convertToEntityAttribute(String json) {
        try {
            return objectMapper.readValue(json, new TypeReference<>() {});
        } catch (Exception e) {
            throw new RuntimeException("JSON 파싱 실패", e);
        }
    }
}

---

5. 이벤트 발행 — 평점 업데이트

리뷰 작성/수정/삭제 시 상점 평점을 업데이트하기 위해 도메인 이벤트를 발행했다.

private void triggerEvent(UUID storeId) {
    reviewRepository.flush(); // 평점 평균 계산 전 리뷰 먼저 반영

    Events.trigger(new ReviewScoreChangedEvent(
            storeId,
            calculator.getReviewCount(storeId),
            calculator.getAverageRating(storeId)
    ));
}

---

6. Git 브랜치 전략

기능별로 브랜치를 분리해서 작업했다.

dev
├── feature/review-domain       # 도메인 레이어
├── feature/review-application  # 애플리케이션 레이어
├── feature/review-infrastructure  # 인프라 레이어
└── feature/review-pressentation   # 프레젠테이션 레이어

브랜치 간 코드 가져오기

PR이 merge 되기 전에 다른 브랜치 코드가 필요한 경우:

# 다른 브랜치 코드 가져오기
git merge 브랜치명

# 또는 특정 커밋만 가져오기
git cherry-pick 커밋해시

실수로 잘못된 브랜치에 커밋했을 때

# 커밋 취소 (변경사항은 유지)
git reset HEAD~1

# 변경사항 임시 저장
git stash

# 올바른 브랜치로 이동
git switch 올바른브랜치

# 변경사항 가져오기
git stash pop

---

7. 오늘 겪은 주요 트러블슈팅

문제	원인	해결
Could not autowire	인터페이스만 있고 구현체 없음	@Component 붙인 Impl 클래스 생성
QReview 없음	빌드 안 함	./gradlew compileJava 실행
타입 불일치	팀원 코드와 타입 다름	Long으로 통일
switch 미완성	case 누락	모든 enum case 추가
new 키워드 누락	오타	() -> new CustomException(...)

---

마치며

드디어 처음으로 DDD 구조를 적용해서 리뷰 도메인을 구현해봤다.
인터페이스와 구현체를 분리하는 것, 도메인 안에 비즈니스 로직을 캡슐화하는 것이 핵심이었다.
팀원 코드와 연동하면서 타입 불일치 같은 예상치 못한 문제도 겪었지만, 덕분에 코드를 더 깊이 이해할 수 있었다.
아직도 완벽히 정리되진 않은 것 같아서 다시 한번 코드보면서 복습 할 예정이다.