feat: 사용자가 사용한 쿠폰 리스트 조회

Author: TaetaetaE01

src/main/java/com/trashheroesbe/feature/coupon/api/CouponPartnerController.java

@@ -8,6 +8,7 @@
 import com.trashheroesbe.feature.coupon.dto.response.CouponCreateResponse;
 import com.trashheroesbe.feature.coupon.dto.response.CouponUsageStatisticsResponse;
 import com.trashheroesbe.feature.coupon.dto.response.PartnerCouponResponse;
+import com.trashheroesbe.feature.coupon.dto.response.UsedCouponListResponse;
 import com.trashheroesbe.global.response.ApiResponse;
 import com.trashheroesbe.global.auth.security.CustomerDetails;
 import jakarta.validation.Valid;
@@ -83,8 +84,17 @@ public ApiResponse<Void> useCoupon(
         @AuthenticationPrincipal CustomerDetails customerDetails,
         @PathVariable Long userCouponId
     ) {
-        couponService.userCoupon(customerDetails, userCouponId);
+        couponService.useCoupon(customerDetails, userCouponId);
         return ApiResponse.success(OK);
     }
 
+    @Override
+    @GetMapping("/coupons/used")
+    public ApiResponse<List<UsedCouponListResponse>> getUsedCoupons(
+        @AuthenticationPrincipal CustomerDetails customerDetails
+    ) {
+        List<UsedCouponListResponse> responses = couponService.getUsedCoupons(customerDetails);
+        return ApiResponse.success(OK, responses);
+    }
+
 }

src/main/java/com/trashheroesbe/feature/coupon/api/CouponPartnerControllerApi.java

@@ -5,6 +5,7 @@
 import com.trashheroesbe.feature.coupon.dto.response.CouponCreateResponse;
 import com.trashheroesbe.feature.coupon.dto.response.CouponUsageStatisticsResponse;
 import com.trashheroesbe.feature.coupon.dto.response.PartnerCouponResponse;
+import com.trashheroesbe.feature.coupon.dto.response.UsedCouponListResponse;
 import com.trashheroesbe.global.response.ApiResponse;
 import io.swagger.v3.oas.annotations.Operation;
 import io.swagger.v3.oas.annotations.Parameter;
@@ -54,6 +55,10 @@ ApiResponse<Void> useCoupon(
         @Parameter(description = "유저쿠폰 ID", required = true) @PathVariable Long userCouponId
     );
 
+    @Operation(summary = "사용한 파트너 쿠폰 전체 조회", description = "파트너가 발급한 쿠폰 중 사용된 쿠폰 목록을 조회합니다.")
+    ApiResponse<List<UsedCouponListResponse>> getUsedCoupons(
+        @AuthenticationPrincipal CustomerDetails customerDetails
+    );
 
 
 

src/main/java/com/trashheroesbe/feature/coupon/application/CouponService.java

@@ -10,6 +10,8 @@
 import com.trashheroesbe.feature.coupon.dto.response.CouponUsageStatisticsResponse.UsageSummary;
 import com.trashheroesbe.feature.coupon.dto.response.CouponUsageStatisticsResponse.UsageSummary.PeriodRange;
 import com.trashheroesbe.feature.coupon.dto.response.PartnerCouponResponse;
+import com.trashheroesbe.feature.coupon.dto.response.UsedCouponListResponse;
+import com.trashheroesbe.feature.coupon.dto.response.UserCouponResponse;
 import com.trashheroesbe.feature.coupon.infrastructure.CouponRepository;
 import com.trashheroesbe.feature.coupon.infrastructure.UserCouponRepository;
 import com.trashheroesbe.feature.partner.domain.entity.Partner;
@@ -33,6 +35,7 @@ public class CouponService {
     private final CouponRepository couponRepository;
     private final UserCouponRepository userCouponRepository;
 
+
     @Transactional(readOnly = true)
     public List<PartnerCouponResponse> getPartnerCoupons(CustomerDetails customerDetails) {
         Partner partner = extractPartner(customerDetails);
@@ -115,14 +118,23 @@ public CouponUsageStatisticsResponse getCouponUsage(CustomerDetails customerDeta
         );
     }
 
-    public void userCoupon(CustomerDetails customerDetails, Long userCouponId) {
+    public void useCoupon(CustomerDetails customerDetails, Long userCouponId) {
         Partner partner = extractPartner(customerDetails);
 
         UserCoupon userCoupon = userCouponRepository.findById(userCouponId)
             .orElseThrow(() -> new BusinessException(ErrorCode.ENTITY_NOT_FOUND));
         userCoupon.useCoupon();
     }
 
+    @Transactional(readOnly = true)
+    public List<UsedCouponListResponse> getUsedCoupons(CustomerDetails customerDetails) {
+        Partner partner = extractPartner(customerDetails);
+
+        return userCouponRepository.findUsedByPartnerId(partner.getId()).stream()
+            .map(UsedCouponListResponse::from)
+            .toList();
+    }
+
     private Partner extractPartner(CustomerDetails customerDetails) {
         if (customerDetails == null || customerDetails.getUser() == null) {
             throw new BusinessException(ErrorCode.ACCESS_DENIED_EXCEPTION);

src/main/java/com/trashheroesbe/feature/coupon/dto/response/UsedCouponListResponse.java

@@ -0,0 +1,31 @@
+package com.trashheroesbe.feature.coupon.dto.response;
+
+import com.trashheroesbe.feature.coupon.domain.entity.UserCoupon;
+import java.time.LocalDateTime;
+
+public record UsedCouponListResponse(
+    Long UserCouponId,
+    String CouponStatusDescription,
+    LocalDateTime usedAt,
+
+    Long userId,
+    String userNickName,
+
+    Long couponId,
+    String couponTitle,
+    String couponTypeDescription
+) {
+
+    public static UsedCouponListResponse from(UserCoupon userCoupon) {
+        return new UsedCouponListResponse(
+            userCoupon.getId(),
+            userCoupon.getStatus().getDescription(),
+            userCoupon.getUsedAt(),
+            userCoupon.getUser().getId(),
+            userCoupon.getUser().getNickname(),
+            userCoupon.getCoupon().getId(),
+            userCoupon.getCoupon().getTitle(),
+            userCoupon.getCoupon().getType().getDescription()
+        );
+    }
+}

src/main/java/com/trashheroesbe/feature/coupon/infrastructure/UserCouponRepository.java

@@ -41,4 +41,12 @@ long countByCouponPartnerIdAndStatus(
         @Param("partnerId") Long partnerId,
         @Param("status") CouponStatus status
     );
+
+    @Query("SELECT uc FROM UserCoupon uc " +
+        "JOIN FETCH uc.coupon c " +
+        "JOIN FETCH uc.user u " +
+        "WHERE c.partner.id = :partnerId " +
+        "AND uc.status = 'USED' " +
+        "ORDER BY uc.usedAt DESC")
+    List<UserCoupon> findUsedByPartnerId(@Param("partnerId") Long partnerId);
 }