feat: 7일간 회원 평균 다운 횟수 통계 API 추가

Author: 82everywin

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

@@ -4,6 +4,7 @@
 import com.appcenter.marketplace.domain.member_coupon.dto.res.CouponHandleRes;
 import com.appcenter.marketplace.domain.member_payback.dto.res.AdminReceiptRes;
 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.service.MemberPaybackAdminService;
 import com.appcenter.marketplace.global.common.CommonResponse;
 import io.swagger.v3.oas.annotations.Operation;
@@ -71,4 +72,14 @@ public ResponseEntity<CommonResponse<CouponPaybackStatsRes>> getCouponPaybackSta
                 .ok(CommonResponse.from(STATS_FOUND.getMessage(),
                         memberPaybackAdminService.getCouponPaybackStats()));
     }
+
+    @Operation(summary = "최근 7일 가입 회원 환급 쿠폰 통계 조회",
+            description = "관리자가 최근 7일간 가입한 회원들의 환급 쿠폰 통계를 조회합니다. <br>" +
+                    "최근 7일 가입 회원 수와 회원당 평균 환급 쿠폰 다운로드 수를 제공합니다.")
+    @GetMapping("/stats/recent")
+    public ResponseEntity<CommonResponse<RecentMemberPaybackStatsRes>> getRecentMemberPaybackStats() {
+        return ResponseEntity
+                .ok(CommonResponse.from(STATS_FOUND.getMessage(),
+                        memberPaybackAdminService.getRecentMemberPaybackStats()));
+    }
 }

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

@@ -0,0 +1,23 @@
+package com.appcenter.marketplace.domain.member_payback.dto.res;
+
+import lombok.Builder;
+import lombok.Getter;
+
+@Getter
+public class RecentMemberPaybackStatsRes {
+    private final Long recentSevenDaysMemberCount;
+    private final Double avgPaybackCouponDownloadPerMember;
+
+    @Builder
+    public RecentMemberPaybackStatsRes(Long recentSevenDaysMemberCount, Double avgPaybackCouponDownloadPerMember) {
+        this.recentSevenDaysMemberCount = recentSevenDaysMemberCount;
+        this.avgPaybackCouponDownloadPerMember = avgPaybackCouponDownloadPerMember;
+    }
+
+    public static RecentMemberPaybackStatsRes of(Long recentSevenDaysMemberCount, Double avgPaybackCouponDownloadPerMember) {
+        return RecentMemberPaybackStatsRes.builder()
+                .recentSevenDaysMemberCount(recentSevenDaysMemberCount)
+                .avgPaybackCouponDownloadPerMember(avgPaybackCouponDownloadPerMember)
+                .build();
+    }
+}

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

@@ -5,6 +5,7 @@
 import com.appcenter.marketplace.domain.member_payback.dto.res.AdminReceiptRes;
 import com.appcenter.marketplace.domain.member_payback.dto.res.ReceiptRes;
 
+import java.time.LocalDateTime;
 import java.util.List;
 import java.util.Optional;
 
@@ -18,4 +19,5 @@ public interface MemberPaybackRepositoryCustom {
     List<MemberPayback> findMemberPaybacksByMarketId(Long marketId);
     List<AdminReceiptRes> findReceiptsForAdmin(Long memberPaybackId, Long marketId, Integer size);
     AdminReceiptRes findReceiptDetailForAdmin(Long memberPaybackId);
+    long countByMemberCreatedAtBetween(LocalDateTime startDateTime, LocalDateTime endDateTime);
 }

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

@@ -199,4 +199,16 @@ public AdminReceiptRes findReceiptDetailForAdmin(Long memberPaybackId) {
                 .fetchOne();
     }
 
+    // 특정 기간에 가입한 회원들의 MemberPayback 개수 조회
+    @Override
+    public long countByMemberCreatedAtBetween(LocalDateTime startDateTime, LocalDateTime endDateTime) {
+        Long count = jpaQueryFactory
+                .select(memberPayback.count())
+                .from(memberPayback)
+                .innerJoin(memberPayback.member, member)
+                .where(member.createdAt.between(startDateTime, endDateTime))
+                .fetchOne();
+        return count != null ? count : 0L;
+    }
+
 }

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

@@ -4,6 +4,7 @@
 import com.appcenter.marketplace.domain.member_coupon.dto.res.CouponHandleRes;
 import com.appcenter.marketplace.domain.member_payback.dto.res.AdminReceiptRes;
 import com.appcenter.marketplace.domain.member_payback.dto.res.CouponPaybackStatsRes;
+import com.appcenter.marketplace.domain.member_payback.dto.res.RecentMemberPaybackStatsRes;
 
 public interface MemberPaybackAdminService {
 
@@ -15,4 +16,6 @@ public interface MemberPaybackAdminService {
 
     CouponPaybackStatsRes getCouponPaybackStats();
 
+    RecentMemberPaybackStatsRes getRecentMemberPaybackStats();
+
 }

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

@@ -7,13 +7,17 @@
 import com.appcenter.marketplace.domain.member_payback.MemberPayback;
 import com.appcenter.marketplace.domain.member_payback.dto.res.AdminReceiptRes;
 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.repository.MemberPaybackRepository;
 import com.appcenter.marketplace.domain.member_payback.service.MemberPaybackAdminService;
 import com.appcenter.marketplace.global.exception.CustomException;
 import lombok.RequiredArgsConstructor;
 import org.springframework.stereotype.Service;
 import org.springframework.transaction.annotation.Transactional;
 
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.time.LocalTime;
 import java.util.List;
 
 import static com.appcenter.marketplace.global.common.StatusCode.COUPON_NOT_EXIST;
@@ -81,6 +85,26 @@ public CouponPaybackStatsRes getCouponPaybackStats() {
         return CouponPaybackStatsRes.of(avgCouponDownloadPerMember, paybackRate);
     }
 
+    @Override
+    public RecentMemberPaybackStatsRes getRecentMemberPaybackStats() {
+        LocalDate today = LocalDate.now();
+        LocalDateTime sevenDaysAgoStart = LocalDateTime.of(today.minusDays(7), LocalTime.MIN);
+        LocalDateTime todayEnd = LocalDateTime.of(today, LocalTime.MAX);
+
+        // 최근 7일간 가입한 회원 수
+        long recentMemberCount = memberRepository.countByCreatedAtBetween(sevenDaysAgoStart, todayEnd);
+
+        // 최근 7일간 가입한 회원들의 환급 쿠폰 다운로드 수
+        long recentMemberPaybackCount = memberPaybackRepository.countByMemberCreatedAtBetween(sevenDaysAgoStart, todayEnd);
+
+        // 회원당 평균 환급 쿠폰 다운로드 수
+        double avgPaybackCouponDownloadPerMember = recentMemberCount > 0
+                ? (double) recentMemberPaybackCount / recentMemberCount
+                : 0.0;
+
+        return RecentMemberPaybackStatsRes.of(recentMemberCount, avgPaybackCouponDownloadPerMember);
+    }
+
     private MemberPayback findMemberPaybackById(Long couponId) {
         return memberPaybackRepository.findById(couponId)
                 .orElseThrow(() -> new CustomException(COUPON_NOT_EXIST));