feature: 쿠폰 사용 및 할인 계산 로직 추가

- 할인 정보를 담기 위한 `CouponDiscountResult` 레코드 도입
- 주문 시 쿠폰 사용을 위해 `OrderCommand`에 `couponId` 필드 추가
- 쿠폰 검증·사용·할인 금액 계산을 처리하는 `useCouponAndCalculateDiscount` 메서드를 `CouponService`에 추가

Author: yeonjiyeon

apps/commerce-api/src/main/java/com/loopers/domain/coupon/CouponDiscountResult.java

@@ -0,0 +1,8 @@
+package com.loopers.domain.coupon;
+
+public record CouponDiscountResult(
+    long discountAmount,
+    Long usedCouponId
+) {
+
+}

apps/commerce-api/src/main/java/com/loopers/domain/coupon/CouponService.java

@@ -2,6 +2,7 @@
 
 import com.loopers.support.error.CoreException;
 import com.loopers.support.error.ErrorType;
+import jakarta.transaction.Transactional;
 import lombok.RequiredArgsConstructor;
 import org.springframework.stereotype.Component;
 
@@ -16,4 +17,23 @@ public Coupon getCoupon(Long id) {
     return couponRepository.findById(id)
         .orElseThrow(() -> new CoreException(ErrorType.NOT_FOUND, "쿠폰을 찾을 수 없습니다."));
   }
+
+  @Transactional
+  public CouponDiscountResult useCouponAndCalculateDiscount(
+      Long couponId,
+      long totalOrderAmount
+  ) {
+    Coupon coupon = couponRepository.findById(couponId)
+        .orElseThrow(() -> new CoreException(ErrorType.NOT_FOUND, "쿠폰을 찾을 수 없습니다."));
+
+    try {
+      coupon.use();
+    } catch (CoreException e) {
+      throw new CoreException(ErrorType.BAD_REQUEST, "이미 사용되었거나 사용할 수 없는 쿠폰입니다.");
+    }
+
+    long discountAmount = coupon.calculateDiscountAmount(totalOrderAmount);
+
+    return new CouponDiscountResult(discountAmount, couponId);
+  }
 }

apps/commerce-api/src/main/java/com/loopers/domain/order/OrderCommand.java

@@ -6,6 +6,7 @@ public class OrderCommand {
 
   public record PlaceOrder(
       Long userId,
+      Long couponId,
       List<Item> items
   ) {