[FEAT]: 상품 상세 리뷰 탭 실데이터 연동 및 요약 통계 개선

src/app/actions/review.ts

@@ -2,7 +2,15 @@
 
 import { redirect } from 'next/navigation';
 
-import { api } from '@/lib/api-client';
+import { ApiError, api } from '@/lib/api-client';
+import { rethrowNextError } from '@/lib/server-action-utils';
+import type {
+  PageResponse,
+  ProductReviewListItem,
+  ReviewDetail,
+  ReviewHelpfulData,
+  ReviewStatsData,
+} from '@/types/domain/review';
 
 interface InitReviewResponseData {
   reviewId: number;
@@ -44,12 +52,80 @@ interface ActionResult<T = undefined> {
   data?: T;
 }
 
+export interface ProductReviewsQuery {
+  reviewType?: 'INITIAL' | 'ONE_MONTH';
+  size?: string | string[];
+  color?: string | string[];
+  sort?: 'BEST' | 'RECENT' | 'RATING_HIGH' | 'RATING_LOW';
+  mySizeOnly?: boolean;
+  page?: number;
+  pageSize?: number;
+}
+
+const REVIEW_LIST_DEFAULT_PAGE_SIZE = 10;
+
+function createEmptyReviewSummary(): ReviewStatsData {
+  return {
+    averageRating: 0,
+    initialReviewCount: 0,
+    oneMonthReviewCount: 0,
+    sizeSummary: {
+      category: '사이즈',
+      totalCount: 0,
+      topAnswer: null,
+      topAnswerCount: 0,
+      answerStats: [],
+    },
+    colorSummary: {
+      category: '색감',
+      totalCount: 0,
+      topAnswer: null,
+      topAnswerCount: 0,
+      answerStats: [],
+    },
+    materialSummary: {
+      category: '소재',
+      totalCount: 0,
+      topAnswer: null,
+      topAnswerCount: 0,
+      answerStats: [],
+    },
+  };
+}
+
+function createEmptyReviewPage(
+  page = 0,
+  pageSize = 10,
+): PageResponse<ProductReviewListItem> {
+  return {
+    totalPages: 0,
+    totalElements: 0,
+    pageable: {
+      paged: true,
+      pageNumber: page,
+      pageSize,
+      offset: page * pageSize,
+      sort: [],
+      unpaged: false,
+    },
+    first: true,
+    last: true,
+    size: pageSize,
+    content: [],
+    number: page,
+    sort: [],
+    numberOfElements: 0,
+    empty: true,
+  };
+}
+
 export async function initPendingReviewAction(formData: FormData) {
   const rawOrderItemId = formData.get('orderItemId');
   const rawProductId = formData.get('productId');
   const orderItemId =
     typeof rawOrderItemId === 'string' ? Number(rawOrderItemId) : NaN;
-  const productId = typeof rawProductId === 'string' ? Number(rawProductId) : NaN;
+  const productId =
+    typeof rawProductId === 'string' ? Number(rawProductId) : NaN;
 
   if (!Number.isFinite(orderItemId)) {
     return;
@@ -123,21 +199,98 @@ export async function submitReviewAction(
   payload: ReviewSubmitRequest,
 ): Promise<ActionResult> {
   try {
-    console.log('[review-submit] request', {
-      endpoint: `/reviews/${reviewId}/submit`,
-      reviewId,
-      payload,
-    });
-
     await api.post<Record<string, never>, ReviewSubmitRequest>(
       `/reviews/${reviewId}/submit`,
       payload,
     );
 
-    console.log('[review-submit] success', { reviewId });
     return { success: true };
   } catch (error) {
     console.error('리뷰 제출 실패:', error);
     return { success: false, message: '리뷰 제출에 실패했습니다.' };
   }
 }
+
+/** 리뷰 도움돼요 토글 */
+export async function toggleReviewHelpfulAction(
+  reviewId: number,
+): Promise<ActionResult<ReviewHelpfulData>> {
+  try {
+    const data = await api.post<ReviewHelpfulData, Record<string, never>>(
+      `/reviews/${reviewId}/helpful`,
+      {},
+    );
+    return { success: true, data };
+  } catch (error) {
+    if (error instanceof ApiError && error.status === 404) {
+      return { success: false, message: '리뷰를 찾을 수 없습니다.' };
+    }
+    rethrowNextError(error);
+    console.error('리뷰 도움돼요 토글 실패:', { error, reviewId });
+    return { success: false, message: '도움돼요 처리에 실패했습니다.' };
+  }
+}
+
+/** 리뷰 상세 조회 */
+export async function getReviewDetailAction(
+  reviewId: number,
+): Promise<ReviewDetail | null> {
+  try {
+    const detail = await api.get<ReviewDetail>(`/reviews/${reviewId}/details`);
+    return detail;
+  } catch (error) {
+    if (error instanceof ApiError && error.status === 404) {
+      console.warn('리뷰 상세 조회: 리뷰를 찾을 수 없습니다.', { reviewId });
+      return null;
+    }
+    rethrowNextError(error);
+    console.error('리뷰 상세 조회 실패:', error);
+    throw new Error(
+      error instanceof Error ? error.message : '리뷰 상세 조회에 실패했습니다.',
+    );
+  }
+}
+
+/** 상품별 리뷰 목록 조회 */
+export async function getProductReviewsAction(
+  productId: number,
+  query: ProductReviewsQuery = {},
+): Promise<PageResponse<ProductReviewListItem>> {
+  const page = query.page ?? 0;
+  const pageSize = query.pageSize ?? REVIEW_LIST_DEFAULT_PAGE_SIZE;
+  const params: Record<
+    string,
+    string | number | boolean | string[] | undefined
+  > = { ...query };
+  params.page = page;
+  params.pageSize = pageSize;
+  params.sort = query.sort ?? 'BEST';
+
+  try {
+    return await api.get<PageResponse<ProductReviewListItem>>(
+      `/products/${productId}/reviews`,
+      {
+        params,
+      },
+    );
+  } catch (error) {
+    rethrowNextError(error);
+    console.error('상품 리뷰 목록 조회 실패:', { error, productId, params });
+    return createEmptyReviewPage(page, pageSize);
+  }
+}
+
+/** 리뷰 통계 요약 조회 */
+export async function getProductReviewsSummaryAction(
+  productId: number,
+): Promise<ReviewStatsData> {
+  try {
+    return await api.get<ReviewStatsData>(
+      `/products/${productId}/reviews/summary`,
+    );
+  } catch (error) {
+    rethrowNextError(error);
+    console.error('리뷰 통계 요약 조회 실패:', { error, productId });
+    return createEmptyReviewSummary();
+  }
+}

src/app/product/[id]/page.tsx

@@ -1,6 +1,7 @@
 import { notFound } from 'next/navigation';
 import { getProductDetail, getSimilarProducts } from '@/app/actions/product';
 import { getMyBodyInfoAction } from '@/app/actions/body-info';
+import { getProductReviewsSummaryAction } from '@/app/actions/review';
 import { fetchSizeAnalysis } from '@/mocks/size';
 import ProductDetailView from '@/components/product/product-detail-view';
 import { getMyWishlist } from '@/app/actions/wishlist';
@@ -26,36 +27,54 @@ export default async function ProductPage({ params, searchParams }: PageProps) {
     notFound();
   }
 
-  const [bodyInfoResult, wishlist, similarProducts] = await Promise.all([
-    getMyBodyInfoAction(),
-    getMyWishlist(),
-    getSimilarProducts(productId),
-  ]);
+  const [bodyInfoResult, wishlist, similarProducts, reviewSummaryResult] =
+    await Promise.allSettled([
+      getMyBodyInfoAction(),
+      getMyWishlist(),
+      getSimilarProducts(productId),
+      getProductReviewsSummaryAction(productId),
+    ]);
+
+  const resolvedBodyInfo =
+    bodyInfoResult.status === 'fulfilled'
+      ? bodyInfoResult.value
+      : { success: false as const, data: null };
+  const resolvedWishlist =
+    wishlist.status === 'fulfilled' ? wishlist.value : [];
+  const resolvedSimilarProducts =
+    similarProducts.status === 'fulfilled' ? similarProducts.value : [];
+  const reviewSummary =
+    reviewSummaryResult.status === 'fulfilled'
+      ? reviewSummaryResult.value
+      : undefined;
 
   const userInfo =
-    bodyInfoResult.success && bodyInfoResult.data?.hasBodyInfo
-      ? bodyInfoResult.data
+    resolvedBodyInfo.success && resolvedBodyInfo.data?.hasBodyInfo
+      ? resolvedBodyInfo.data
       : null;
 
   const analysisData = userInfo
     ? await fetchSizeAnalysis(id, userInfo.height, userInfo.weight)
     : null;
 
   // 2. 찜 목록에서 현재 상품이 있는지 확인
-  const wishlistItem = wishlist.find((item) => item.productId === productId);
+  const wishlistItem = resolvedWishlist.find(
+    (item) => item.productId === productId,
+  );
   const isLiked = !!wishlistItem;
   const wishlistId = wishlistItem?.wishlistId;
 
   // 3. 클라이언트 뷰에 데이터 전달하며 렌더링
   return (
     <ProductDetailView
       product={product}
-      similarProducts={similarProducts}
+      similarProducts={resolvedSimilarProducts}
       userInfo={userInfo}
       analysisData={analysisData}
       backHref={backHref}
       isLiked={isLiked}
       wishlistId={wishlistId}
+      productReviewSummary={reviewSummary}
     />
   );
 }

src/components/product/index.tsx

@@ -35,15 +35,6 @@ export {
   useProductInteraction,
 } from './product-interaction-context';
 
-// ----------------------------------------------------------------------
-// 6. 데이터 비즈니스 로직
-// ----------------------------------------------------------------------
-export {
-  getProductsByCategoryId,
-  getProductById,
-  getCategoryTitle,
-} from './product-service';
-
 // ----------------------------------------------------------------------
 // 7. 사이즈 관련 컴포넌트
 // ----------------------------------------------------------------------