feat: 회원별 환급쿠폰 영수증 제출 횟수 통계 조회 기능 추가

Author: 82everywin

src/main/generated/queryDsl/com/appcenter/marketplace/domain/member_payback/dto/res/QTopMemberReceiptRes.java

@@ -0,0 +1,20 @@
+package com.appcenter.marketplace.domain.member_payback.dto.res;
+
+import com.querydsl.core.types.dsl.*;
+
+import com.querydsl.core.types.ConstructorExpression;
+import javax.annotation.processing.Generated;
+
+/**
+ * com.appcenter.marketplace.domain.member_payback.dto.res.QTopMemberReceiptRes is a Querydsl Projection type for TopMemberReceiptRes
+ */
+@Generated("com.querydsl.codegen.DefaultProjectionSerializer")
+public class QTopMemberReceiptRes extends ConstructorExpression<TopMemberReceiptRes> {
+
+    private static final long serialVersionUID = 1923847561L;
+
+    public QTopMemberReceiptRes(com.querydsl.core.types.Expression<Long> memberId, com.querydsl.core.types.Expression<Long> receiptCount) {
+        super(TopMemberReceiptRes.class, new Class<?>[]{long.class, long.class}, memberId, receiptCount);
+    }
+
+}

src/main/java/com/appcenter/marketplace/domain/member_payback/controller/MemberPaybackAdminController.java

@@ -6,6 +6,7 @@
 import com.appcenter.marketplace.domain.member_payback.dto.res.CouponPaybackStatsRes;
 import com.appcenter.marketplace.domain.member_payback.dto.res.RecentMemberPaybackStatsRes;
 import com.appcenter.marketplace.domain.member_payback.dto.res.TopMarketPaybackRes;
+import com.appcenter.marketplace.domain.member_payback.dto.res.TopMemberReceiptRes;
 import com.appcenter.marketplace.domain.member_payback.service.MemberPaybackAdminService;
 
 import java.util.List;
@@ -105,4 +106,17 @@ public ResponseEntity<CommonResponse<List<TopMarketPaybackRes>>> getTopMarketsBy
                 .ok(CommonResponse.from(STATS_FOUND.getMessage(),
                         memberPaybackAdminService.getTopMarketsByCompletedPaybackCount()));
     }
+
+    @Operation(summary = "영수증 제출 횟수 회원 Top 10 조회",
+            description = "관리자가 영수증을 가장 많이 제출한 회원 Top 10을 조회합니다. <br>" +
+                    "period 파라미터로 기간 필터 적용 가능합니다. <br>" +
+                    "DAY(하루), WEEK(일주일), MONTH(한달) / 미입력 시 전체 기간")
+    @GetMapping("/stats/top-members/receipt")
+    public ResponseEntity<CommonResponse<List<TopMemberReceiptRes>>> getTopMembersByReceiptCount(
+            @Parameter(description = "기간 필터 (DAY | WEEK | MONTH), 미입력 시 전체")
+            @RequestParam(required = false) String period) {
+        return ResponseEntity
+                .ok(CommonResponse.from(STATS_FOUND.getMessage(),
+                        memberPaybackAdminService.getTopMembersByReceiptCount(period)));
+    }
 }

src/main/java/com/appcenter/marketplace/domain/member_payback/dto/res/TopMemberReceiptRes.java

@@ -0,0 +1,16 @@
+package com.appcenter.marketplace.domain.member_payback.dto.res;
+
+import com.querydsl.core.annotations.QueryProjection;
+import lombok.Getter;
+
+@Getter
+public class TopMemberReceiptRes {
+    private final Long memberId;
+    private final Long receiptCount;
+
+    @QueryProjection
+    public TopMemberReceiptRes(Long memberId, Long receiptCount) {
+        this.memberId = memberId;
+        this.receiptCount = receiptCount;
+    }
+}

src/main/java/com/appcenter/marketplace/domain/member_payback/repository/MemberPaybackRepositoryCustom.java

@@ -6,6 +6,7 @@
 import com.appcenter.marketplace.domain.member_payback.dto.res.ReceiptRes;
 
 import com.appcenter.marketplace.domain.member_payback.dto.res.TopMarketPaybackRes;
+import com.appcenter.marketplace.domain.member_payback.dto.res.TopMemberReceiptRes;
 
 import java.time.LocalDateTime;
 import java.util.List;
@@ -24,4 +25,5 @@ public interface MemberPaybackRepositoryCustom {
     long countByMemberCreatedAtBetween(LocalDateTime startDateTime, LocalDateTime endDateTime);
     List<TopMarketPaybackRes> findTopMarketsByPaybackCount(int limit);
     List<TopMarketPaybackRes> findTopMarketsByCompletedPaybackCount(int limit);
+    List<TopMemberReceiptRes> findTopMembersByReceiptCount(int limit, LocalDateTime start, LocalDateTime end);
 }

src/main/java/com/appcenter/marketplace/domain/member_payback/repository/MemberPaybackRepositoryCustomImpl.java

@@ -8,8 +8,10 @@
 import com.appcenter.marketplace.domain.member_payback.dto.res.QAdminReceiptRes;
 import com.appcenter.marketplace.domain.member_payback.dto.res.QReceiptRes;
 import com.appcenter.marketplace.domain.member_payback.dto.res.QTopMarketPaybackRes;
+import com.appcenter.marketplace.domain.member_payback.dto.res.QTopMemberReceiptRes;
 import com.appcenter.marketplace.domain.member_payback.dto.res.ReceiptRes;
 import com.appcenter.marketplace.domain.member_payback.dto.res.TopMarketPaybackRes;
+import com.appcenter.marketplace.domain.member_payback.dto.res.TopMemberReceiptRes;
 import com.querydsl.core.BooleanBuilder;
 import com.querydsl.core.types.dsl.Expressions;
 import com.querydsl.jpa.impl.JPAQueryFactory;
@@ -230,6 +232,28 @@ public List<TopMarketPaybackRes> findTopMarketsByPaybackCount(int limit) {
                 .fetch();
     }
 
+    // 영수증 제출 수 기준 회원 Top N 조회 (기간 필터)
+    @Override
+    public List<TopMemberReceiptRes> findTopMembersByReceiptCount(int limit, LocalDateTime start, LocalDateTime end) {
+        BooleanBuilder where = new BooleanBuilder();
+        where.and(memberPayback.receipt.isNotNull());
+        if (start != null && end != null) {
+            where.and(memberPayback.modifiedAt.between(start, end));
+        }
+
+        return jpaQueryFactory
+                .select(new QTopMemberReceiptRes(
+                        member.id,
+                        memberPayback.count()))
+                .from(memberPayback)
+                .innerJoin(memberPayback.member, member)
+                .where(where)
+                .groupBy(member.id)
+                .orderBy(memberPayback.count().desc())
+                .limit(limit)
+                .fetch();
+    }
+
     // 환급 완료 수 기준 매장 Top N 조회
     @Override
     public List<TopMarketPaybackRes> findTopMarketsByCompletedPaybackCount(int limit) {

src/main/java/com/appcenter/marketplace/domain/member_payback/service/MemberPaybackAdminService.java

@@ -6,6 +6,7 @@
 import com.appcenter.marketplace.domain.member_payback.dto.res.CouponPaybackStatsRes;
 import com.appcenter.marketplace.domain.member_payback.dto.res.RecentMemberPaybackStatsRes;
 import com.appcenter.marketplace.domain.member_payback.dto.res.TopMarketPaybackRes;
+import com.appcenter.marketplace.domain.member_payback.dto.res.TopMemberReceiptRes;
 
 import java.util.List;
 
@@ -25,4 +26,6 @@ public interface MemberPaybackAdminService {
 
     List<TopMarketPaybackRes> getTopMarketsByCompletedPaybackCount();
 
+    List<TopMemberReceiptRes> getTopMembersByReceiptCount(String period);
+
 }

src/main/java/com/appcenter/marketplace/domain/member_payback/service/impl/MemberPaybackAdminServiceImpl.java

@@ -9,6 +9,7 @@
 import com.appcenter.marketplace.domain.member_payback.dto.res.CouponPaybackStatsRes;
 import com.appcenter.marketplace.domain.member_payback.dto.res.RecentMemberPaybackStatsRes;
 import com.appcenter.marketplace.domain.member_payback.dto.res.TopMarketPaybackRes;
+import com.appcenter.marketplace.domain.member_payback.dto.res.TopMemberReceiptRes;
 import com.appcenter.marketplace.domain.member_payback.repository.MemberPaybackRepository;
 import com.appcenter.marketplace.domain.member_payback.service.MemberPaybackAdminService;
 import com.appcenter.marketplace.global.config.MetricsConfig;
@@ -119,6 +120,26 @@ public List<TopMarketPaybackRes> getTopMarketsByCompletedPaybackCount() {
         return memberPaybackRepository.findTopMarketsByCompletedPaybackCount(10);
     }
 
+    @Override
+    public List<TopMemberReceiptRes> getTopMembersByReceiptCount(String period) {
+        LocalDateTime start = null;
+        LocalDateTime end = null;
+
+        if (period != null) {
+            LocalDateTime now = LocalDateTime.now();
+            end = now;
+            start = switch (period.toUpperCase()) {
+                case "DAY"   -> now.minusDays(1);
+                case "WEEK"  -> now.minusWeeks(1);
+                case "MONTH" -> now.minusMonths(1);
+                default      -> null;
+            };
+            if (start == null) end = null; // 잘못된 값이면 전체 조회
+        }
+
+        return memberPaybackRepository.findTopMembersByReceiptCount(10, start, end);
+    }
+
     private MemberPayback findMemberPaybackById(Long couponId) {
         return memberPaybackRepository.findById(couponId)
                 .orElseThrow(() -> new CustomException(COUPON_NOT_EXIST));