[Test] Cart API Test

src/docs/asciidoc/_cart.adoc

@@ -0,0 +1,46 @@
+== 장바구니 (Cart) API
+
+=== 1. 장바구니 추가
+`POST /carts`
+
+요청 본문:
+include::{snippets}/cart-create/request-fields.adoc[]
+
+응답:
+include::{snippets}/cart-create/http-response.adoc[]
+
+---
+
+=== 2. 장바구니 목록 조회
+`GET /carts`
+
+응답 본문:
+include::{snippets}/cart-get-list/response-fields.adoc[]
+
+응답:
+include::{snippets}/cart-get-list/http-response.adoc[]
+
+---
+
+=== 3. 장바구니 수량 수정
+`PATCH /carts/{cartId}`
+
+경로 파라미터 (Path Parameters):
+include::{snippets}/cart-update/path-parameters.adoc[]
+
+요청 본문:
+include::{snippets}/cart-update/request-fields.adoc[]
+
+응답:
+include::{snippets}/cart-update/http-response.adoc[]
+
+---
+
+=== 4. 장바구니 삭제
+`DELETE /carts/{cartId}`
+
+경로 파라미터 (Path Parameters):
+include::{snippets}/cart-delete/path-parameters.adoc[]
+
+응답:
+include::{snippets}/cart-delete/http-response.adoc[]

src/docs/asciidoc/index.adoc

@@ -16,3 +16,5 @@ include::_discount.adoc[]
 include::_deliverypolicy.adoc[]
 // include::_product.adoc[]
 
+include::_cart.adoc[]
+

src/main/java/com/irum/come2us/domain/cart/application/service/CartService.java

@@ -15,86 +15,59 @@
 import java.util.UUID;
 import java.util.stream.Collectors;
 import lombok.RequiredArgsConstructor;
-import lombok.extern.slf4j.Slf4j;
 import org.springframework.stereotype.Service;
 import org.springframework.transaction.annotation.Transactional;
 
 @Service
 @RequiredArgsConstructor
 @Transactional
-@Slf4j
 public class CartService {
 
     private final CartRepository cartRepository;
     private final ProductOptionValueRepository productOptionValueRepository;
     private final MemberUtil memberUtil;
 
+    @Transactional
     public CartResponse createCart(CartCreateRequest request) {
         Member currentMember = memberUtil.getCurrentMember();
 
-        // 옵션값 검증
         ProductOptionValue optionValue =
                 productOptionValueRepository
                         .findById(request.optionValueId())
                         .orElseThrow(
                                 () -> new CommonException(CartErrorCode.OPTION_VALUE_NOT_FOUND));
 
-        // 기존 동일 옵션 Cart 존재 시 수량 합산
         Cart existing =
                 cartRepository.findByMemberIdAndOptionValueId(
                         currentMember.getMemberId(), request.optionValueId());
 
-        Cart saved;
+        Cart target;
         if (existing != null) {
-            int oldQuantity = existing.getQuantity();
-            int updatedQuantity = oldQuantity + request.quantity();
+            int updatedQuantity = existing.getQuantity() + request.quantity();
             existing.updateQuantity(updatedQuantity);
-            saved = existing;
-
-            log.info(
-                    "장바구니 수량 합산: memberId={}, optionValueId={}, oldQuantity={}, newQuantity={}",
-                    currentMember.getMemberId(),
-                    request.optionValueId(),
-                    oldQuantity,
-                    updatedQuantity);
+            target = existing;
         } else {
-            Cart newCart = Cart.createCart(currentMember, optionValue, request.quantity());
-            saved = cartRepository.save(newCart);
-
-            log.info(
-                    "장바구니 신규 추가: memberId={}, optionValueId={}, quantity={}",
-                    currentMember.getMemberId(),
-                    request.optionValueId(),
-                    request.quantity());
+            target = Cart.createCart(currentMember, optionValue, request.quantity());
+            cartRepository.save(target);
         }
 
-        return CartResponse.from(saved);
+        return CartResponse.from(target);
     }
 
-    public CartResponse updateCart(UUID cartId, CartUpdateRequest request) {
+    public void updateCart(UUID cartId, CartUpdateRequest request) {
         Cart cart =
                 cartRepository
                         .findById(cartId)
                         .orElseThrow(() -> new CommonException(CartErrorCode.CART_NOT_FOUND));
 
         memberUtil.assertMemberResourceAccess(cart.getMember());
-
-        if (cart.getQuantity().equals(request.quantity())) {
-            throw new CommonException(CartErrorCode.CART_NOT_MODIFIED);
-        }
-
         cart.updateQuantity(request.quantity());
-        log.info("장바구니 수정 완료: cartId={}, updatedQuantity={}", cartId, request.quantity());
-        return CartResponse.from(cart);
     }
 
     @Transactional(readOnly = true)
     public List<CartResponse> getCartListByMember() {
         Member currentMember = memberUtil.getCurrentMember();
-
         List<Cart> carts = cartRepository.findAllWithProductByMemberId(currentMember.getMemberId());
-        log.info("장바구니 조회 완료: memberId={}, count={}", currentMember.getMemberId(), carts.size());
-
         return carts.stream().map(CartResponse::from).collect(Collectors.toList());
     }
 
@@ -103,10 +76,7 @@ public void deleteCart(UUID cartId) {
                 cartRepository
                         .findById(cartId)
                         .orElseThrow(() -> new CommonException(CartErrorCode.CART_NOT_FOUND));
-
         memberUtil.assertMemberResourceAccess(cart.getMember());
         cartRepository.delete(cart);
-
-        log.info("장바구니 삭제 완료: cartId={}", cartId);
     }
 }

src/main/java/com/irum/come2us/domain/cart/domain/repository/CartRepository.java

@@ -23,15 +23,18 @@ public interface CartRepository extends JpaRepository<Cart, UUID> {
     Cart findByMemberIdAndOptionValueId(
             @Param("memberId") @NotNull Long memberId, @Param("optionValueId") UUID optionValueId);
 
-    // 특정 회원의 장바구니 + 상품/옵션 통합 조회
-    // TODO: 이미지 조인 추후 추가 예정
+    /**
+     * 특정 회원의 장바구니 + 상품/옵션/이미지 통합 조회 - Cart → OptionValue → OptionGroup → Product → ProductImage -
+     * LEFT JOIN FETCH 로 대표 이미지까지 미리 로딩
+     */
     @Query(
             """
         SELECT DISTINCT c
         FROM Cart c
         JOIN FETCH c.optionValue ov
         JOIN FETCH ov.optionGroup og
         JOIN FETCH og.product p
+        LEFT JOIN FETCH p.productImages pi
         WHERE c.member.memberId = :memberId
     """)
     List<Cart> findAllWithProductByMemberId(@Param("memberId") Long memberId);

src/main/java/com/irum/come2us/domain/cart/presentation/controller/CartController.java

@@ -9,6 +9,8 @@
 import java.util.UUID;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
 import org.springframework.web.bind.annotation.*;
 
 @RestController
@@ -20,30 +22,35 @@ public class CartController {
     private final CartService cartService;
 
     @PostMapping
-    public CartResponse createCart(@Valid @RequestBody CartCreateRequest request) {
+    public ResponseEntity<CartResponse> createCart(@Valid @RequestBody CartCreateRequest request) {
         log.info(
                 "장바구니 추가 요청: optionValueId={}, quantity={}",
                 request.optionValueId(),
                 request.quantity());
-        return cartService.createCart(request);
+        CartResponse response = cartService.createCart(request);
+        return ResponseEntity.status(HttpStatus.CREATED).body(response);
     }
 
     @PatchMapping("/{cartId}")
-    public CartResponse updateCart(
+    public ResponseEntity<Void> updateCart(
             @PathVariable UUID cartId, @Valid @RequestBody CartUpdateRequest request) {
         log.info("장바구니 수정 요청: cartId={}, quantity={}", cartId, request.quantity());
-        return cartService.updateCart(cartId, request);
+        cartService.updateCart(cartId, request);
+        return ResponseEntity.noContent().build();
     }
 
     @GetMapping
-    public List<CartResponse> getMyCartList() {
-        log.info("본인 장바구니 조회 요청");
-        return cartService.getCartListByMember();
+    public ResponseEntity<List<CartResponse>> getMyCartList() {
+        log.info("장바구니 목록 조회 요청");
+        List<CartResponse> responses = cartService.getCartListByMember();
+        log.info("장바구니 조회 결과: {}개 항목", responses.size());
+        return ResponseEntity.ok(responses);
     }
 
     @DeleteMapping("/{cartId}")
-    public void deleteCart(@PathVariable UUID cartId) {
+    public ResponseEntity<Void> deleteCart(@PathVariable UUID cartId) {
         log.info("장바구니 삭제 요청: cartId={}", cartId);
         cartService.deleteCart(cartId);
+        return ResponseEntity.noContent().build();
     }
 }

src/main/java/com/irum/come2us/domain/cart/presentation/dto/request/CartCreateRequest.java

@@ -5,6 +5,5 @@
 import java.util.UUID;
 
 public record CartCreateRequest(
-        @NotNull(message = "회원 ID는 필수 입력값입니다.") Long memberId,
         @NotNull(message = "옵션 값 ID는 필수 입력값입니다.") UUID optionValueId,
         @Min(value = 1, message = "수량은 1개 이상이어야 합니다.") int quantity) {}

src/main/java/com/irum/come2us/domain/cart/presentation/dto/response/CartResponse.java

@@ -10,7 +10,7 @@ public record CartResponse(
         UUID optionValueId,
         String productName,
         String optionValueName,
-        // String imageUrl,   // 상품 이미지 구현 후 주석 해제
+        String imageUrl,
         int quantity,
         int basePrice, // 상품 기본가
         int extraPrice, // 옵션 추가금
@@ -26,17 +26,17 @@ public static CartResponse from(Cart cart) {
         int unit = base + extra;
         int total = unit * cart.getQuantity();
 
-        // String imageUrl = (product.getProductImages() != null &&
-        //         !product.getProductImages().isEmpty())
-        //         ? product.getProductImages().get(0).getImageUrl()
-        //         : null;
+        String imageUrl =
+                (product.getProductImages() != null && !product.getProductImages().isEmpty())
+                        ? product.getProductImages().get(0).getImageUrl()
+                        : null;
 
         return CartResponse.builder()
                 .cartId(cart.getId())
                 .optionValueId(optionValue.getId())
                 .productName(product.getName())
                 .optionValueName(optionValue.getName())
-                // .imageUrl(imageUrl)
+                .imageUrl(imageUrl)
                 .quantity(cart.getQuantity())
                 .basePrice(base)
                 .extraPrice(extra)

src/main/java/com/irum/come2us/domain/product/domain/entity/Product.java

@@ -132,5 +132,8 @@ public void updateCategory(Category category) {
         this.category = category;
     }
 
-    // TODO: 이미지 매핑, 리뷰 매핑
+    @OneToMany(mappedBy = "product", cascade = CascadeType.ALL, orphanRemoval = true)
+    private List<ProductImage> productImages = new ArrayList<>();
+
+    // TODO: 리뷰 매핑
 }