feat: 주간·월간 랭킹 API 추가 및 RankingService 인터페이스 구현

- RankingService 인터페이스를 구현한 RankingServiceImpl 추가
- 주간·월간 랭킹 조회를 위한 getWeeklyRankings, getMonthlyRankings 메서드 구현
- 입력값에 따라 랭킹 타입을 동적으로 분기하도록 RankingFacade 개선
- DAILY, WEEKLY, MONTHLY 랭킹 타입을 지원하도록 RankingV1ApiSpec 및 RankingV1Controller 확장

Author: yeonjiyeon

apps/commerce-api/src/main/java/com/loopers/application/product/ProductFacade.java

@@ -3,8 +3,8 @@
 import com.loopers.domain.brand.BrandService;
 import com.loopers.domain.product.Product;
 import com.loopers.domain.product.ProductService;
-import com.loopers.infrastructure.rank.RankingService;
 import com.loopers.event.ProductViewEvent;
+import com.loopers.infrastructure.rank.RankingService;
 import lombok.RequiredArgsConstructor;
 import org.springframework.context.ApplicationEventPublisher;
 import org.springframework.data.domain.Page;

apps/commerce-api/src/main/java/com/loopers/application/rank/RankingFacade.java

@@ -39,4 +39,12 @@ public List<RankingInfo> getTopRankings(String date, int page, int size) {
         })
         .toList();
   }
+
+  public List<RankingInfo> getRankings(String type, String date, int page, int size) {
+    return switch (type.toUpperCase()) {
+      case "WEEKLY" -> rankingService.getWeeklyRankings(date, page, size);
+      case "MONTHLY" -> rankingService.getMonthlyRankings(date, page, size);
+      default -> getTopRankings(date, page, size);
+    };
+  }
 }

apps/commerce-api/src/main/java/com/loopers/infrastructure/rank/RankingService.java

@@ -1,44 +1,15 @@
 package com.loopers.infrastructure.rank;
 
-import java.time.LocalDateTime;
-import java.time.format.DateTimeFormatter;
+import com.loopers.application.rank.RankingInfo;
 import java.util.List;
-import java.util.Set;
-import java.util.concurrent.TimeUnit;
-import lombok.RequiredArgsConstructor;
-import org.springframework.data.redis.connection.zset.Aggregate;
-import org.springframework.data.redis.connection.zset.Weights;
-import org.springframework.data.redis.core.RedisTemplate;
-import org.springframework.stereotype.Component;
 
-@Component
-@RequiredArgsConstructor
-public class RankingService {
+public interface RankingService {
 
-  private final RedisTemplate<String, String> redisTemplate;
+  List<Long> getTopRankingIds(String date, int page, int size);
 
-  public List<Long> getTopRankingIds(String date, int page, int size) {
-    String key = "ranking:all:" + date;
-    int start = (page - 1) * size;
-    int end = start + size - 1;
+  List<RankingInfo> getWeeklyRankings(String date, int page, int size);
 
-    Set<String> rankedIds = redisTemplate.opsForZSet().reverseRange(key, start, end);
+  List<RankingInfo> getMonthlyRankings(String date, int page, int size);
 
-    if (rankedIds == null || rankedIds.isEmpty()) {
-      return List.of();
-    }
-
-    return rankedIds.stream()
-        .map(Long::valueOf)
-        .toList();
-  }
-
-  public Integer getProductRank(Long productId) {
-    String today = LocalDateTime.now().format(DateTimeFormatter.ofPattern("yyyyMMdd"));
-    String key = "ranking:all:" + today;
-
-    Long rank = redisTemplate.opsForZSet().reverseRank(key, String.valueOf(productId));
-
-    return (rank != null) ? rank.intValue() + 1 : null;
-  }
+  Integer getProductRank(Long productId);
 }

apps/commerce-api/src/main/java/com/loopers/infrastructure/rank/RankingServiceImpl.java

@@ -0,0 +1,65 @@
+package com.loopers.infrastructure.rank;
+
+import com.loopers.application.rank.RankingInfo;
+import com.loopers.domain.rank.monthly.MonthlyRankingMVRepository;
+import com.loopers.domain.rank.weekly.WeeklyRankingMVRepository;
+import java.time.LocalDateTime;
+import java.time.format.DateTimeFormatter;
+import java.util.List;
+import java.util.Set;
+import lombok.RequiredArgsConstructor;
+import org.springframework.data.domain.PageRequest;
+import org.springframework.data.redis.core.RedisTemplate;
+import org.springframework.stereotype.Component;
+
+@RequiredArgsConstructor
+@Component
+public class RankingServiceImpl implements RankingService {
+
+  private final RedisTemplate<String, String> redisTemplate;
+  private final WeeklyRankingMVRepository weeklyRepository;
+  private final MonthlyRankingMVRepository monthlyRepository;
+
+  @Override
+  public List<Long> getTopRankingIds(String date, int page, int size) {
+    String key = "ranking:all:" + date;
+    int start = (page - 1) * size;
+    int end = start + size - 1;
+
+    Set<String> rankedIds = redisTemplate.opsForZSet().reverseRange(key, start, end);
+
+    if (rankedIds == null || rankedIds.isEmpty()) {
+      return List.of();
+    }
+
+    return rankedIds.stream()
+        .map(Long::valueOf)
+        .toList();
+  }
+
+  @Override
+  public List<RankingInfo> getWeeklyRankings(String date, int page, int size) {
+    return weeklyRepository.findByBaseDateOrderByCurrentRankAsc(date, PageRequest.of(page - 1, size))
+        .stream()
+        .map(RankingInfo::from)
+        .toList();
+  }
+
+  @Override
+  public List<RankingInfo> getMonthlyRankings(String date, int page, int size) {
+    return monthlyRepository.findByBaseDateOrderByCurrentRankAsc(date, PageRequest.of(page - 1, size))
+        .stream()
+        .map(RankingInfo::from)
+        .toList();
+  }
+
+  @Override
+  public Integer getProductRank(Long productId) {
+    String today = LocalDateTime.now().format(DateTimeFormatter.ofPattern("yyyyMMdd"));
+    String key = "ranking:all:" + today;
+
+    Long rank = redisTemplate.opsForZSet().reverseRank(key, String.valueOf(productId));
+
+    return (rank != null) ? rank.intValue() + 1 : null;
+  }
+}

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

@@ -12,6 +12,7 @@ public interface RankingV1ApiSpec {
 
   @Operation(summary = "실시간 랭킹 조회", description = "특정 날짜의 인기 상품 랭킹을 조회합니다.")
   ApiResponse<List<RankingResponse>> getRankings(
+      @Parameter(description = "랭킹 타입 (DAILY, WEEKLY, MONTHLY)", example = "WEEKLY") String type,
       @Parameter(description = "조회 날짜 (yyyyMMdd)", example = "20251225") String date,
       @Parameter(description = "페이지 번호") int page,
       @Parameter(description = "페이지 크기") int size

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

@@ -21,11 +21,12 @@ public class RankingV1Controller implements RankingV1ApiSpec {
   @GetMapping
   @Override
   public ApiResponse<List<RankingResponse>> getRankings(
+      @RequestParam(value = "type", defaultValue = "DAILY") String type,
       @RequestParam(value = "date") String date,
       @RequestParam(value = "page", defaultValue = "1") int page,
       @RequestParam(value = "size", defaultValue = "20") int size
   ) {
-    List<RankingInfo> infos = rankingFacade.getTopRankings(date, page, size);
+    List<RankingInfo> infos = rankingFacade.getRankings(type, date, page, size);
     List<RankingV1Dto.RankingResponse> response = infos.stream()
         .map(RankingV1Dto.RankingResponse::from)
         .toList();