feat: 랭킹 API 기간 파라미터 지원

Author: adminhelper

apps/commerce-api/src/main/java/com/loopers/interfaces/api/ranking/RankingV1ApiSpec.java

@@ -17,6 +17,9 @@ ApiResponse<RankingV1Dto.RankingResponse> getRankings(
             @Schema(description = "조회할 날짜(yyyyMMdd). 미입력 시 오늘 기준", example = "20251226")
             @RequestParam(required = false) String date,
 
+            @Schema(description = "조회 주기(daily, weekly, monthly)", example = "weekly")
+            @RequestParam(defaultValue = "daily") String period,
+
             @Schema(description = "페이지 번호", example = "0")
             @RequestParam(defaultValue = "0") int page,
 

apps/commerce-api/src/main/java/com/loopers/interfaces/api/ranking/RankingV1Controller.java

@@ -1,6 +1,7 @@
 package com.loopers.interfaces.api.ranking;
 
 import com.loopers.application.ranking.RankingFacade;
+import com.loopers.application.ranking.RankingPeriod;
 import com.loopers.interfaces.api.ApiResponse;
 import lombok.RequiredArgsConstructor;
 import org.springframework.web.bind.annotation.GetMapping;
@@ -16,12 +17,13 @@ public class RankingV1Controller implements RankingV1ApiSpec {
 
     @Override
     @GetMapping
-    public ApiResponse<RankingV1Dto.RankingResponse> getRankings(String date, int page, int size) {
+    public ApiResponse<RankingV1Dto.RankingResponse> getRankings(String date, String period, int page, int size) {
         int safePage = Math.max(page, 0);
         int safeSize = Math.max(size, 1);
-        long total = rankingFacade.count(date);
+        RankingPeriod rankingPeriod = RankingPeriod.from(period);
+        long total = rankingFacade.count(date, rankingPeriod);
         return ApiResponse.success(RankingV1Dto.RankingResponse.from(
-                rankingFacade.getRankingItems(date, safePage, safeSize),
+                rankingFacade.getRankingItems(date, rankingPeriod, safePage, safeSize),
                 safePage,
                 safeSize,
                 total