Merge pull request #57 from IT-Cotato/feature/48

[Feat] 리뷰 조회 기능 구현

Author: kangcheolung

src/main/java/com/ongil/backend/domain/order/repository/OrderItemRepository.java

@@ -1,8 +1,20 @@
 package com.ongil.backend.domain.order.repository;
 
+import java.util.List;
+
+import org.springframework.data.jpa.repository.EntityGraph;
 import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.data.jpa.repository.Query;
+import org.springframework.data.repository.query.Param;
 
 import com.ongil.backend.domain.order.entity.OrderItem;
 
 public interface OrderItemRepository extends JpaRepository<OrderItem, Long> {
-}
+
+	// 사용자의 주문 상품 목록 조회 (리뷰 작성 가능 목록용)
+	@EntityGraph(attributePaths = {"product", "product.brand", "order"})
+	@Query("SELECT oi FROM OrderItem oi " +
+		"WHERE oi.order.user.id = :userId " +
+		"ORDER BY oi.order.createdAt DESC")
+	List<OrderItem> findByOrderUserIdWithProduct(@Param("userId") Long userId);
+}

src/main/java/com/ongil/backend/domain/product/converter/ProductConverter.java

@@ -40,6 +40,8 @@ public ProductDetailResponse toDetailResponse(Product product, List<ProductOptio
 			.categoryName(product.getCategory().getName())
 			.onSale(product.getOnSale())
 			.productType(product.getProductType())
+			.reviewCount(product.getReviewCount())
+			.reviewRating(product.getReviewRating())
 			.build();
 	}
 
@@ -62,6 +64,7 @@ public ProductSimpleResponse toSimpleResponse(Product product) {
 			.viewCount(product.getViewCount())
 			.purchaseCount(product.getPurchaseCount())
 			.reviewCount(product.getReviewCount())
+			.reviewRating(product.getReviewRating())
 			.build();
 	}
 

src/main/java/com/ongil/backend/domain/product/dto/response/ProductDetailResponse.java

@@ -67,6 +67,13 @@ public class ProductDetailResponse {
 	@Schema(description = "상품 타입 (NORMAL: 일반 상품, SPECIAL_SALE: 특가 상품)")
 	private ProductType productType;
 
+	// 리뷰 정보
+	@Schema(description = "리뷰 개수")
+	private Integer reviewCount;
+
+	@Schema(description = "리뷰 평균 평점")
+	private Double reviewRating;
+
 	// 소재 설명 내부 클래스
 	@Getter
 	@Builder

src/main/java/com/ongil/backend/domain/product/dto/response/ProductSimpleResponse.java

@@ -43,4 +43,7 @@ public class ProductSimpleResponse {
 
 	@Schema(description = "리뷰 개수")
 	private Integer reviewCount;
+
+	@Schema(description = "리뷰 평균 평점")
+	private Double reviewRating;
 }

src/main/java/com/ongil/backend/domain/product/entity/Product.java

@@ -70,6 +70,9 @@ public class Product extends BaseEntity {
 	@Column(name = "review_count")
 	private Integer reviewCount = 0;
 
+	@Column(name = "review_rating", nullable = false)
+	private Double reviewRating = 0.0;
+
 	@Formula("coalesce(view_count, 0) + coalesce(purchase_count, 0)")
 	private Integer popularity;
 

src/main/java/com/ongil/backend/domain/review/controller/ReviewController.java

@@ -0,0 +1,88 @@
+package com.ongil.backend.domain.review.controller;
+
+import java.util.List;
+
+import org.springframework.data.domain.Page;
+import org.springframework.security.core.annotation.AuthenticationPrincipal;
+import org.springframework.web.bind.annotation.*;
+
+import com.ongil.backend.domain.review.dto.request.ReviewListRequest;
+import com.ongil.backend.domain.review.dto.response.*;
+import com.ongil.backend.domain.review.enums.ReviewType;
+import com.ongil.backend.domain.review.service.ReviewService;
+import com.ongil.backend.global.common.dto.DataResponse;
+
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import lombok.RequiredArgsConstructor;
+
+@Tag(name = "Review", description = "리뷰 API")
+@RestController
+@RequiredArgsConstructor
+public class ReviewController {
+
+	private final ReviewService reviewService;
+
+	@Operation(summary = "상품별 리뷰 목록 조회", description = "상품의 리뷰 목록을 조회합니다. 유사 체형 필터, 사이즈/색상 필터, 정렬을 지원합니다.")
+	@GetMapping("/api/products/{productId}/reviews")
+	public DataResponse<Page<ReviewListResponse>> getProductReviews(
+		@PathVariable Long productId,
+		@AuthenticationPrincipal Long userId,
+		@ModelAttribute ReviewListRequest request
+	) {
+		Page<ReviewListResponse> reviews = reviewService.getProductReviews(productId, userId, request);
+		return DataResponse.from(reviews);
+	}
+
+	@Operation(summary = "리뷰 통계 요약 조회", description = "상품의 리뷰 통계 요약을 조회합니다. 사이즈는 유사 체형 기준, 색감/소재는 전체 유저 기준입니다.")
+	@GetMapping("/api/products/{productId}/reviews/summary")
+	public DataResponse<ReviewSummaryResponse> getReviewSummary(
+		@PathVariable Long productId,
+		@AuthenticationPrincipal Long userId
+	) {
+		ReviewSummaryResponse summary = reviewService.getReviewSummary(productId, userId);
+		return DataResponse.from(summary);
+	}
+
+	@Operation(summary = "리뷰 상세 조회", description = "리뷰의 상세 정보를 조회합니다. 모든 선택지 답변을 부문별로 반환합니다.")
+	@GetMapping("/api/reviews/{reviewId}/details")
+	public DataResponse<ReviewDetailResponse> getReviewDetail(
+		@PathVariable Long reviewId,
+		@AuthenticationPrincipal Long userId
+	) {
+		ReviewDetailResponse detail = reviewService.getReviewDetail(reviewId, userId);
+		return DataResponse.from(detail);
+	}
+
+	@Operation(summary = "내가 작성한 리뷰 조회", description = "로그인한 사용자가 작성한 리뷰 목록을 조회합니다.")
+	@GetMapping("/api/users/me/reviews")
+	public DataResponse<Page<MyReviewResponse>> getMyReviews(
+		@AuthenticationPrincipal Long userId,
+		@Parameter(description = "리뷰 타입 필터") @RequestParam(required = false) ReviewType reviewType,
+		@Parameter(description = "페이지 번호") @RequestParam(defaultValue = "0") int page,
+		@Parameter(description = "페이지 크기") @RequestParam(defaultValue = "10") int pageSize
+	) {
+		Page<MyReviewResponse> reviews = reviewService.getMyReviews(userId, reviewType, page, pageSize);
+		return DataResponse.from(reviews);
+	}
+
+	@Operation(summary = "작성 가능한 리뷰 목록 조회", description = "로그인한 사용자가 작성 가능한 리뷰 목록을 조회합니다.")
+	@GetMapping("/api/users/me/reviews/pending")
+	public DataResponse<List<PendingReviewResponse>> getPendingReviews(
+		@AuthenticationPrincipal Long userId
+	) {
+		List<PendingReviewResponse> pendingReviews = reviewService.getPendingReviews(userId);
+		return DataResponse.from(pendingReviews);
+	}
+
+	@Operation(summary = "리뷰 도움돼요 토글", description = "리뷰의 도움돼요를 토글합니다. 이미 눌렀으면 취소, 안 눌렀으면 추가됩니다.")
+	@PostMapping("/api/reviews/{reviewId}/helpful")
+	public DataResponse<ReviewHelpfulResponse> toggleHelpful(
+		@PathVariable Long reviewId,
+		@AuthenticationPrincipal Long userId
+	) {
+		ReviewHelpfulResponse response = reviewService.toggleHelpful(reviewId, userId);
+		return DataResponse.from(response);
+	}
+}