docs: 배치 모듈 JavaDoc 한글화

Author: rkdalsdn94

apps/commerce-batch/src/main/java/com/loopers/batch/config/BatchConfig.java

@@ -3,10 +3,10 @@
 import org.springframework.context.annotation.Configuration;
 
 /**
- * Base configuration class for Spring Batch.
+ * Spring Batch 기본 설정 클래스.
  *
- * <p>Spring Boot 3.x auto-configures Spring Batch, so @EnableBatchProcessing is not needed.
- * <p>This class can be used for common batch configuration beans if needed.
+ * <p>Spring Boot 3.x는 Spring Batch를 자동 설정하므로 @EnableBatchProcessing은 필요하지 않습니다.
+ * <p>이 클래스는 필요한 경우 공통 배치 설정 빈을 정의하는 용도로 사용할 수 있습니다.
  */
 @Configuration
 public class BatchConfig {

apps/commerce-batch/src/main/java/com/loopers/batch/config/MonthlyRankingJobConfig.java

@@ -25,23 +25,23 @@
 import org.springframework.transaction.PlatformTransactionManager;
 
 /**
- * Configuration class for monthly ranking aggregation batch job.
+ * 월간 랭킹 집계 배치 작업 설정 클래스.
  *
- * <p>This job aggregates product metrics data on a monthly basis and
- * stores the top N rankings in the materialized view table.
+ * <p>이 작업은 상품 지표 데이터를 월간 단위로 집계하여
+ * 상위 N개 랭킹을 Materialized View 테이블에 저장합니다.
  *
- * <p>Job execution example:
+ * <p>작업 실행 예시:
  * <pre>
  * java -jar commerce-batch.jar \
  *   --job.name=monthlyRankingJob \
  *   yearMonth=2025-01
  * </pre>
  *
- * <p>Chunk-oriented processing flow:
+ * <p>Chunk 지향 처리 흐름:
  * <ol>
- *   <li>Reader: Aggregate product_metrics by month</li>
- *   <li>Processor: Calculate ranking scores</li>
- *   <li>Writer: Save to mv_product_rank_monthly</li>
+ *   <li>Reader: product_metrics를 월간 단위로 집계</li>
+ *   <li>Processor: 랭킹 점수 계산</li>
+ *   <li>Writer: mv_product_rank_monthly에 저장</li>
  * </ol>
  */
 @Slf4j
@@ -56,11 +56,11 @@ public class MonthlyRankingJobConfig {
     private final MonthlyRankRepository monthlyRankRepository;
 
     /**
-     * Defines the monthly ranking job.
+     * 월간 랭킹 작업을 정의합니다.
      *
-     * @param jobRepository the Spring Batch job repository
-     * @param monthlyRankingStep the step to execute
-     * @return configured Job instance
+     * @param jobRepository Spring Batch 작업 저장소
+     * @param monthlyRankingStep 실행할 Step
+     * @return 설정된 Job 인스턴스
      */
     @Bean
     public Job monthlyRankingJob(
@@ -73,12 +73,12 @@ public Job monthlyRankingJob(
     }
 
     /**
-     * Defines the monthly ranking step with chunk-oriented processing.
+     * Chunk 지향 처리를 사용하는 월간 랭킹 Step을 정의합니다.
      *
-     * @param jobRepository the Spring Batch job repository
-     * @param transactionManager the transaction manager
-     * @param yearMonth the target month (injected from job parameters)
-     * @return configured Step instance
+     * @param jobRepository Spring Batch 작업 저장소
+     * @param transactionManager 트랜잭션 관리자
+     * @param yearMonth 대상 월 (작업 파라미터에서 주입)
+     * @return 설정된 Step 인스턴스
      */
     @Bean
     @JobScope
@@ -98,10 +98,10 @@ public Step monthlyRankingStep(
     }
 
     /**
-     * Creates an ItemReader for monthly metrics aggregation.
+     * 월간 지표 집계를 위한 ItemReader를 생성합니다.
      *
-     * @param yearMonth the target month
-     * @return configured ItemReader
+     * @param yearMonth 대상 월
+     * @return 설정된 ItemReader
      */
     @Bean
     @StepScope
@@ -112,10 +112,10 @@ public ItemReader<ProductRankingAggregation> monthlyMetricsReader(
     }
 
     /**
-     * Creates an ItemProcessor for ranking score calculation.
+     * 랭킹 점수 계산을 위한 ItemProcessor를 생성합니다.
      *
-     * @param yearMonth the target month
-     * @return configured ItemProcessor
+     * @param yearMonth 대상 월
+     * @return 설정된 ItemProcessor
      */
     @Bean
     @StepScope
@@ -127,9 +127,9 @@ public ItemProcessor<ProductRankingAggregation, MonthlyProductRank> monthlyRanki
     }
 
     /**
-     * Creates an ItemWriter for persisting monthly rankings.
+     * 월간 랭킹 저장을 위한 ItemWriter를 생성합니다.
      *
-     * @return configured ItemWriter
+     * @return 설정된 ItemWriter
      */
     @Bean
     @StepScope

apps/commerce-batch/src/main/java/com/loopers/batch/config/WeeklyRankingJobConfig.java

@@ -25,23 +25,23 @@
 import org.springframework.transaction.PlatformTransactionManager;
 
 /**
- * Configuration class for weekly ranking aggregation batch job.
+ * 주간 랭킹 집계 배치 작업 설정 클래스.
  *
- * <p>This job aggregates product metrics data on a weekly basis and
- * stores the top N rankings in the materialized view table.
+ * <p>이 작업은 상품 지표 데이터를 주간 단위로 집계하여
+ * 상위 N개 랭킹을 Materialized View 테이블에 저장합니다.
  *
- * <p>Job execution example:
+ * <p>작업 실행 예시:
  * <pre>
  * java -jar commerce-batch.jar \
  *   --job.name=weeklyRankingJob \
  *   yearWeek=2025-W01
  * </pre>
  *
- * <p>Chunk-oriented processing flow:
+ * <p>Chunk 지향 처리 흐름:
  * <ol>
- *   <li>Reader: Aggregate product_metrics by week</li>
- *   <li>Processor: Calculate ranking scores</li>
- *   <li>Writer: Save to mv_product_rank_weekly</li>
+ *   <li>Reader: product_metrics를 주간 단위로 집계</li>
+ *   <li>Processor: 랭킹 점수 계산</li>
+ *   <li>Writer: mv_product_rank_weekly에 저장</li>
  * </ol>
  */
 @Slf4j
@@ -56,11 +56,11 @@ public class WeeklyRankingJobConfig {
     private final WeeklyRankRepository weeklyRankRepository;
 
     /**
-     * Defines the weekly ranking job.
+     * 주간 랭킹 작업을 정의합니다.
      *
-     * @param jobRepository the Spring Batch job repository
-     * @param weeklyRankingStep the step to execute
-     * @return configured Job instance
+     * @param jobRepository Spring Batch 작업 저장소
+     * @param weeklyRankingStep 실행할 Step
+     * @return 설정된 Job 인스턴스
      */
     @Bean
     public Job weeklyRankingJob(
@@ -73,12 +73,12 @@ public Job weeklyRankingJob(
     }
 
     /**
-     * Defines the weekly ranking step with chunk-oriented processing.
+     * Chunk 지향 처리를 사용하는 주간 랭킹 Step을 정의합니다.
      *
-     * @param jobRepository the Spring Batch job repository
-     * @param transactionManager the transaction manager
-     * @param yearWeek the target week in ISO format (injected from job parameters)
-     * @return configured Step instance
+     * @param jobRepository Spring Batch 작업 저장소
+     * @param transactionManager 트랜잭션 관리자
+     * @param yearWeek ISO 형식의 대상 주차 (작업 파라미터에서 주입)
+     * @return 설정된 Step 인스턴스
      */
     @Bean
     @JobScope
@@ -98,10 +98,10 @@ public Step weeklyRankingStep(
     }
 
     /**
-     * Creates an ItemReader for weekly metrics aggregation.
+     * 주간 지표 집계를 위한 ItemReader를 생성합니다.
      *
-     * @param yearWeek the target week
-     * @return configured ItemReader
+     * @param yearWeek 대상 주차
+     * @return 설정된 ItemReader
      */
     @Bean
     @StepScope
@@ -112,10 +112,10 @@ public ItemReader<ProductRankingAggregation> weeklyMetricsReader(
     }
 
     /**
-     * Creates an ItemProcessor for ranking score calculation.
+     * 랭킹 점수 계산을 위한 ItemProcessor를 생성합니다.
      *
-     * @param yearWeek the target week
-     * @return configured ItemProcessor
+     * @param yearWeek 대상 주차
+     * @return 설정된 ItemProcessor
      */
     @Bean
     @StepScope
@@ -127,9 +127,9 @@ public ItemProcessor<ProductRankingAggregation, WeeklyProductRank> weeklyRanking
     }
 
     /**
-     * Creates an ItemWriter for persisting weekly rankings.
+     * 주간 랭킹 저장을 위한 ItemWriter를 생성합니다.
      *
-     * @return configured ItemWriter
+     * @return 설정된 ItemWriter
      */
     @Bean
     @StepScope

apps/commerce-batch/src/main/java/com/loopers/batch/processor/RankingScoreProcessor.java

@@ -7,24 +7,24 @@
 import org.springframework.batch.item.ItemProcessor;
 
 /**
- * ItemProcessor for converting aggregated metrics into ranking entities.
+ * 집계된 지표를 랭킹 엔티티로 변환하는 ItemProcessor.
  *
- * <p>This processor transforms ProductRankingAggregation DTOs into either
- * WeeklyProductRank or MonthlyProductRank entities based on the period type.
- * The ranking score is calculated using weighted metrics.
+ * <p>이 Processor는 ProductRankingAggregation DTO를 기간 타입에 따라
+ * WeeklyProductRank 또는 MonthlyProductRank 엔티티로 변환합니다.
+ * 랭킹 점수는 가중치가 적용된 지표를 사용하여 계산됩니다.
  *
- * <p>Score calculation formula:
+ * <p>점수 계산 공식:
  * <pre>
- * score = (viewCount * WEIGHT_VIEW) +
- *         (likeCount * WEIGHT_LIKE) +
- *         (orderCount * WEIGHT_ORDER * log10(salesAmount + 1))
+ * 점수 = (조회수 * 조회_가중치) +
+ *       (좋아요수 * 좋아요_가중치) +
+ *       (주문수 * 주문_가중치 * log10(판매금액 + 1))
  * </pre>
  *
- * where:
+ * 가중치:
  * <ul>
- *   <li>WEIGHT_VIEW = 0.1</li>
- *   <li>WEIGHT_LIKE = 0.2</li>
- *   <li>WEIGHT_ORDER = 0.6</li>
+ *   <li>조회_가중치 = 0.1</li>
+ *   <li>좋아요_가중치 = 0.2</li>
+ *   <li>주문_가중치 = 0.6</li>
  * </ul>
  */
 @Slf4j
@@ -38,10 +38,10 @@ public class RankingScoreProcessor implements ItemProcessor<ProductRankingAggreg
     private final String period;
 
     /**
-     * Constructs a new RankingScoreProcessor.
+     * RankingScoreProcessor 생성자.
      *
-     * @param periodType the type of period ("WEEKLY" or "MONTHLY")
-     * @param period the period string (e.g., "2025-W01" or "2025-01")
+     * @param periodType 기간 타입 ("WEEKLY" 또는 "MONTHLY")
+     * @param period 기간 문자열 (예: "2025-W01" 또는 "2025-01")
      */
     public RankingScoreProcessor(String periodType, String period) {
         this.periodType = periodType;
@@ -81,13 +81,13 @@ public Object process(ProductRankingAggregation item) {
     }
 
     /**
-     * Calculates the ranking score based on weighted metrics.
+     * 가중치가 적용된 지표를 기반으로 랭킹 점수를 계산합니다.
      *
-     * <p>Uses logarithmic normalization for sales amount to prevent
-     * extreme values from dominating the score.
+     * <p>판매 금액에 대해 로그 정규화를 사용하여
+     * 극단적인 값이 점수를 지배하는 것을 방지합니다.
      *
-     * @param agg the aggregated metrics
-     * @return the calculated score
+     * @param agg 집계된 지표
+     * @return 계산된 점수
      */
     private double calculateScore(ProductRankingAggregation agg) {
         double salesAmountValue = agg.getSalesAmount() != null ? agg.getSalesAmount().doubleValue() : 0.0;