refactor: 랭킹 코드 불필요한 주석 정리

Author: sylee6529

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

@@ -34,13 +34,7 @@ public class RankingFacade {
     private final ProductRepository productRepository;
     private final BrandRepository brandRepository;
 
-    /**
-     * 랭킹 페이지 조회
-     * @param date 날짜 (yyyyMMdd), null이면 오늘
-     * @param page 페이지 번호 (0-based)
-     * @param size 페이지 크기
-     * @return 랭킹 페이지 정보
-     */
+    /** @param page 0-based */
     public RankingPageInfo getRankings(String date, int page, int size) {
         // 날짜 검증 및 기본값 처리
         String targetDate = validateAndNormalizeDate(date);
@@ -101,12 +95,7 @@ public RankingPageInfo getRankings(String date, int page, int size) {
         return RankingPageInfo.of(rankings, targetDate, page, size, totalCount);
     }
 
-    /**
-     * 날짜 파라미터 검증 및 정규화
-     * @param date 날짜 문자열 (yyyyMMdd 형식) 또는 null
-     * @return 검증된 날짜 문자열 (null이면 오늘 날짜)
-     * @throws IllegalArgumentException 유효하지 않은 날짜 형식
-     */
+    /** @throws IllegalArgumentException 유효하지 않은 날짜 형식 */
     private String validateAndNormalizeDate(String date) {
         if (date == null || date.isBlank()) {
             return productRankingCache.getTodayDate();

apps/commerce-api/src/main/java/com/loopers/infrastructure/cache/ProductRankingCache.java

@@ -29,21 +29,12 @@ public class ProductRankingCache {
 
     private final RedisTemplate<String, Object> cacheRedisTemplate;
 
-    /**
-     * 상품의 오늘 날짜 기준 순위 조회
-     * @param productId 상품 ID
-     * @return 순위 (1-based), 순위권 밖이면 null
-     */
+    /** @return 순위 (1-based), 순위권 밖이면 null */
     public Integer getRank(Long productId) {
         return getRank(productId, getTodayDate());
     }
 
-    /**
-     * 상품의 특정 날짜 순위 조회
-     * @param productId 상품 ID
-     * @param date 날짜 (yyyyMMdd 형식)
-     * @return 순위 (1-based), 순위권 밖이면 null
-     */
+    /** @return 순위 (1-based), 순위권 밖이면 null */
     public Integer getRank(Long productId, String date) {
         try {
             String key = CacheKeyGenerator.dailyRankingKey(date);
@@ -65,18 +56,10 @@ public Integer getRank(Long productId, String date) {
         }
     }
 
-    /**
-     * 상품의 점수 조회
-     * @param productId 상품 ID
-     * @return 점수, 없으면 null
-     */
     public Double getScore(Long productId) {
         return getScore(productId, getTodayDate());
     }
 
-    /**
-     * 상품의 특정 날짜 점수 조회
-     */
     public Double getScore(Long productId, String date) {
         try {
             String key = CacheKeyGenerator.dailyRankingKey(date);
@@ -88,20 +71,11 @@ public Double getScore(Long productId, String date) {
         }
     }
 
-    /**
-     * 오늘 날짜 문자열 반환 (Asia/Seoul 기준)
-     */
     public String getTodayDate() {
         return LocalDate.now(ZONE_ID).format(DATE_FORMATTER);
     }
 
-    /**
-     * 랭킹 상위 목록 조회 (페이지네이션)
-     * @param date 날짜 (yyyyMMdd 형식)
-     * @param page 페이지 번호 (0-based)
-     * @param size 페이지 크기
-     * @return 상품 ID와 점수 목록 (순위 높은 순)
-     */
+    /** @param page 0-based */
     public List<RankingEntry> getTopRankings(String date, int page, int size) {
         try {
             String key = CacheKeyGenerator.dailyRankingKey(date);
@@ -134,9 +108,6 @@ public List<RankingEntry> getTopRankings(String date, int page, int size) {
         }
     }
 
-    /**
-     * 전체 랭킹 수 조회
-     */
     public long getTotalCount(String date) {
         try {
             String key = CacheKeyGenerator.dailyRankingKey(date);
@@ -148,8 +119,5 @@ public long getTotalCount(String date) {
         }
     }
 
-    /**
-     * 랭킹 엔트리 (순위, 상품ID, 점수)
-     */
     public record RankingEntry(int rank, Long productId, Double score) {}
 }

apps/commerce-streamer/src/main/java/com/loopers/infrastructure/cache/ProductRankingCache.java

@@ -45,44 +45,26 @@ public ProductRankingCache(RedisTemplate<String, Object> cacheRedisTemplate, Ran
         this.rankingConfig = rankingConfig;
     }
 
-    /**
-     * 조회 이벤트 점수 추가
-     */
     public void addViewScore(Long productId) {
         double score = rankingConfig.getWeight().getView();
         incrementScore(productId, score);
         log.debug("[Ranking] View score added - productId: {}, score: {}", productId, score);
     }
 
-    /**
-     * 좋아요 이벤트 점수 추가
-     */
     public void addLikeScore(Long productId) {
         double score = rankingConfig.getWeight().getLike();
         incrementScore(productId, score);
         log.debug("[Ranking] Like score added - productId: {}, score: {}", productId, score);
     }
 
-    /**
-     * 좋아요 취소 이벤트 점수 감소
-     * - 좋아요 추가와 동일한 가중치만큼 감소
-     * - 점수가 0 이하가 되어도 ZSET에서 자동 제거되지 않음 (일관성 유지)
-     */
+    /** 점수가 0 이하가 되어도 ZSET에서 자동 제거되지 않음 (일관성 유지) */
     public void subtractLikeScore(Long productId) {
         double score = rankingConfig.getWeight().getLike();
         decrementScore(productId, score);
         log.debug("[Ranking] Like score subtracted - productId: {}, score: -{}", productId, score);
     }
 
-    /**
-     * 주문 이벤트 점수 추가
-     * - log 정규화를 적용하여 고가 상품의 과도한 점수 편중 방지
-     * - Math.log1p(x) = ln(1 + x)로 안전하게 계산
-     *
-     * @param productId 상품 ID
-     * @param price 상품 단가
-     * @param quantity 주문 수량
-     */
+    /** log 정규화로 고가 상품의 과도한 점수 편중 방지: log1p(price * qty) */
     public void addOrderScore(Long productId, long price, int quantity) {
         double weight = rankingConfig.getWeight().getOrder();
         long orderAmount = price * quantity;
@@ -94,12 +76,7 @@ public void addOrderScore(Long productId, long price, int quantity) {
                 productId, price, quantity, orderAmount, score);
     }
 
-    /**
-     * 주문 아이템 배치 점수 추가 (Pipeline 사용)
-     * - 여러 아이템을 한 번의 Redis 요청으로 처리하여 네트워크 오버헤드 감소
-     *
-     * @param orderItems 주문 아이템 목록 (productId -> OrderItemScore)
-     */
+    /** Pipeline으로 여러 아이템을 한 번의 Redis 요청으로 처리 */
     public void addOrderScoresBatch(List<OrderItemScore> orderItems) {
         if (orderItems == null || orderItems.isEmpty()) {
             return;
@@ -136,14 +113,8 @@ public Object execute(RedisOperations operations) throws DataAccessException {
         }
     }
 
-    /**
-     * 주문 아이템 점수 정보
-     */
     public record OrderItemScore(Long productId, long price, int quantity) {}
 
-    /**
-     * ZSET 점수 증가 (ZINCRBY)
-     */
     private void incrementScore(Long productId, double score) {
         try {
             String key = getTodayKey();
@@ -155,9 +126,6 @@ private void incrementScore(Long productId, double score) {
         }
     }
 
-    /**
-     * ZSET 점수 감소 (ZINCRBY with negative value)
-     */
     private void decrementScore(Long productId, double score) {
         try {
             String key = getTodayKey();
@@ -170,10 +138,7 @@ private void decrementScore(Long productId, double score) {
         }
     }
 
-    /**
-     * TTL 설정 (원자적 처리)
-     * getAndSet으로 키 변경 시에만 TTL 설정 (날짜가 바뀌는 경우)
-     */
+    /** getAndSet으로 키 변경 시에만 TTL 설정 (날짜가 바뀌는 시점) */
     private void ensureTtl(String key) {
         String oldKey = ttlInitializedKey.getAndSet(key);
         if (!key.equals(oldKey)) {
@@ -182,18 +147,12 @@ private void ensureTtl(String key) {
         }
     }
 
-    /**
-     * 오늘 날짜 키 생성 (Asia/Seoul 기준)
-     * CacheKeyGenerator를 사용하여 commerce-api와 동일한 키 형식 보장
-     */
+    /** Asia/Seoul 기준, commerce-api와 동일한 키 형식 */
     private String getTodayKey() {
         String date = LocalDate.now(ZONE_ID).format(DATE_FORMATTER);
         return CacheKeyGenerator.dailyRankingKey(date);
     }
 
-    /**
-     * 특정 날짜 키 생성
-     */
     public static String getKeyForDate(String date) {
         return CacheKeyGenerator.dailyRankingKey(date);
     }