feat: cache key 생성 일관성을 위한 cache 빌더 구현

docker-compose-prod.yml

@@ -42,6 +42,11 @@ services:
       JWT_ACCESS_TOKEN_VALIDITY: ${JWT_ACCESS_TOKEN_VALIDITY}
       JWT_REFRESH_TOKEN_VALIDITY: ${JWT_REFRESH_TOKEN_VALIDITY}
 
+      # === Redis Configuration ===
+      REDIS_HOST: ${REDIS_HOST}
+      REDIS_PORT: ${REDIS_PORT}
+      REDIS_PASSWORD: ${REDIS_PASSWORD}
+
       # === External API Configuration ===
       NEXON_OPEN_API_KEY: ${NEXON_OPEN_API_KEY}
       AUCTION_HISTORY_DELAY_MS: ${AUCTION_HISTORY_DELAY_MS}

src/main/java/until/the/eternity/auctionhistory/application/scheduler/AuctionHistoryScheduler.java

@@ -1,7 +1,5 @@
 package until.the.eternity.auctionhistory.application.scheduler;
 
-import java.util.*;
-import java.util.stream.Collectors;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.beans.factory.annotation.Value;
@@ -19,6 +17,9 @@
 import until.the.eternity.common.annotation.BatchLog;
 import until.the.eternity.common.enums.ItemCategory;
 
+import java.util.*;
+import java.util.stream.Collectors;
+
 @Slf4j
 @Component
 @RequiredArgsConstructor

src/main/java/until/the/eternity/auctionhistory/application/service/AuctionHistoryCacheWarmupService.java

@@ -43,6 +43,17 @@ public void evictAndWarm() {
         warmup();
     }
 
+    /** 앱 시작 시 기본 화면 1개 키만 경량 워밍업한다. */
+    public void warmupForStartup() {
+        AuctionHistorySearchRequest emptyRequest =
+                new AuctionHistorySearchRequest(
+                        null, null, null, null, null, null, null, null, null);
+        PageRequestDto pageRequest =
+                new PageRequestDto(1, WARMUP_SIZE, SortField.DATE_AUCTION_BUY, SortDirection.DESC);
+        auctionHistoryService.search(emptyRequest, pageRequest);
+        log.info("[Cache Warmup] Startup warmup completed: auction-history default key");
+    }
+
     private void evictCaches() {
         clearCache(CacheNames.AUCTION_HISTORY_SEARCH);
         // auction_history 전체를 직접 쿼리하는 역대 랭킹도 함께 무효화

src/main/java/until/the/eternity/auctionhistory/application/service/AuctionHistoryService.java

@@ -1,7 +1,6 @@
 package until.the.eternity.auctionhistory.application.service;
 
 import jakarta.persistence.EntityManager;
-import java.util.List;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.cache.annotation.Cacheable;
@@ -18,6 +17,8 @@
 import until.the.eternity.common.response.PageResponseDto;
 import until.the.eternity.config.CacheNames;
 
+import java.util.List;
+
 @Service
 @RequiredArgsConstructor
 @Slf4j
@@ -35,16 +36,8 @@ public class AuctionHistoryService {
     @Cacheable(
             cacheNames = CacheNames.AUCTION_HISTORY_SEARCH,
             key =
-                    "#pageRequestDto.page() + ':'"
-                            + " + #pageRequestDto.size() + ':'"
-                            + " + (#pageRequestDto.sortBy() != null ? #pageRequestDto.sortBy().fieldName : 'dateAuctionBuy') + ':'"
-                            + " + (#pageRequestDto.direction() != null ? #pageRequestDto.direction().code : 'DESC') + ':'"
-                            + " + (#requestDto.itemName() ?: '') + ':'"
-                            + " + (#requestDto.isExactItemName() ?: false) + ':'"
-                            + " + (#requestDto.itemTopCategory() ?: '') + ':'"
-                            + " + (#requestDto.itemSubCategory() ?: '') + ':'"
-                            + " + (#requestDto.dateAuctionBuyRequest()?.dateAuctionBuyFrom() ?: '') + ':'"
-                            + " + (#requestDto.dateAuctionBuyRequest()?.dateAuctionBuyTo() ?: '')",
+                    "T(until.the.eternity.common.util.CacheKeyBuilder)"
+                            + ".buildAuctionHistorySearchKey(#requestDto, #pageRequestDto)",
             condition =
                     "#requestDto.itemOptionSearchRequest() == null"
                             + " and #requestDto.enchantSearchRequest() == null"

src/main/java/until/the/eternity/auctionhistory/application/service/fetcher/AuctionHistoryFetcher.java

@@ -1,8 +1,5 @@
 package until.the.eternity.auctionhistory.application.service.fetcher;
 
-import java.util.ArrayList;
-import java.util.List;
-import java.util.OptionalInt;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.stereotype.Component;
@@ -12,6 +9,10 @@
 import until.the.eternity.auctionhistory.interfaces.external.dto.OpenApiAuctionHistoryResponse;
 import until.the.eternity.common.enums.ItemCategory;
 
+import java.util.ArrayList;
+import java.util.List;
+import java.util.OptionalInt;
+
 @Slf4j
 @Component
 @RequiredArgsConstructor

src/main/java/until/the/eternity/auctionhistory/application/service/persister/AuctionHistoryPersister.java

@@ -1,6 +1,5 @@
 package until.the.eternity.auctionhistory.application.service.persister;
 
-import java.util.List;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.stereotype.Component;
@@ -11,6 +10,8 @@
 import until.the.eternity.auctionhistory.interfaces.external.dto.OpenApiAuctionHistoryResponse;
 import until.the.eternity.common.enums.ItemCategory;
 
+import java.util.List;
+
 @Slf4j
 @RequiredArgsConstructor
 @Component

src/main/java/until/the/eternity/auctionhistory/domain/entity/AuctionHistory.java

@@ -1,11 +1,12 @@
 package until.the.eternity.auctionhistory.domain.entity;
 
 import jakarta.persistence.*;
-import java.time.Instant;
-import java.util.List;
 import lombok.*;
 import until.the.eternity.auctionitemoption.domain.entity.AuctionHistoryItemOption;
 
+import java.time.Instant;
+import java.util.List;
+
 @Entity
 @Table(name = "auction_history")
 @Getter

src/main/java/until/the/eternity/auctionhistory/domain/event/AuctionHistorySavedEvent.java

@@ -1,8 +1,9 @@
 package until.the.eternity.auctionhistory.domain.event;
 
-import java.time.LocalDateTime;
 import lombok.Getter;
 
+import java.time.LocalDateTime;
+
 /** 경매장 거래 내역 저장 완료 이벤트 AuctionHistoryScheduler가 거래 내역을 성공적으로 저장한 후 발행됩니다. */
 @Getter
 public class AuctionHistorySavedEvent {

src/main/java/until/the/eternity/auctionhistory/domain/mapper/AuctionHistoryMapper.java

@@ -1,13 +1,14 @@
 package until.the.eternity.auctionhistory.domain.mapper;
 
-import java.util.List;
 import org.mapstruct.Mapper;
 import org.mapstruct.Mapping;
 import until.the.eternity.auctionhistory.domain.entity.AuctionHistory;
 import until.the.eternity.auctionhistory.interfaces.rest.dto.response.AuctionHistoryDetailResponse;
 import until.the.eternity.auctionhistory.interfaces.rest.dto.response.ItemOptionResponse;
 import until.the.eternity.auctionitemoption.domain.entity.AuctionHistoryItemOption;
 
+import java.util.List;
+
 /**
  * AuctionHistory Entity to internal.responseDto transfer mapper class 데이터 흐름은 external.responseDto
  * -> entity -> internal.responseDto 단방향으로 흐름

src/main/java/until/the/eternity/auctionhistory/domain/mapper/OpenApiAuctionHistoryMapper.java

@@ -1,12 +1,13 @@
 package until.the.eternity.auctionhistory.domain.mapper;
 
-import java.time.Instant;
-import java.util.List;
 import org.mapstruct.*;
 import until.the.eternity.auctionhistory.domain.entity.AuctionHistory;
 import until.the.eternity.auctionhistory.interfaces.external.dto.OpenApiAuctionHistoryResponse;
 import until.the.eternity.common.enums.ItemCategory;
 
+import java.time.Instant;
+import java.util.List;
+
 @Mapper(componentModel = "spring", uses = OpenApiItemOptionMapper.class)
 public interface OpenApiAuctionHistoryMapper {
 

src/main/java/until/the/eternity/auctionhistory/domain/repository/AuctionHistoryRepositoryPort.java

@@ -1,15 +1,16 @@
 package until.the.eternity.auctionhistory.domain.repository;
 
-import java.time.Instant;
-import java.util.List;
-import java.util.Optional;
-import java.util.Set;
 import org.springframework.data.domain.Page;
 import org.springframework.data.domain.Pageable;
 import until.the.eternity.auctionhistory.domain.entity.AuctionHistory;
 import until.the.eternity.auctionhistory.interfaces.rest.dto.request.AuctionHistorySearchRequest;
 import until.the.eternity.common.enums.ItemCategory;
 
+import java.time.Instant;
+import java.util.List;
+import java.util.Optional;
+import java.util.Set;
+
 /** 경매장 거래 내역 POJO Repository - Mock 또는 Stub 으로 대체해 단위 테스트 용이성 확보 */
 public interface AuctionHistoryRepositoryPort {
 

src/main/java/until/the/eternity/auctionhistory/domain/service/AuctionHistoryDuplicateChecker.java

@@ -1,9 +1,5 @@
 package until.the.eternity.auctionhistory.domain.service;
 
-import java.time.Instant;
-import java.util.List;
-import java.util.OptionalInt;
-import java.util.Set;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.stereotype.Component;
@@ -12,6 +8,11 @@
 import until.the.eternity.auctionhistory.interfaces.external.dto.OpenApiAuctionHistoryResponse;
 import until.the.eternity.common.enums.ItemCategory;
 
+import java.time.Instant;
+import java.util.List;
+import java.util.OptionalInt;
+import java.util.Set;
+
 @Slf4j
 @Component
 @RequiredArgsConstructor

src/main/java/until/the/eternity/auctionhistory/domain/service/fetcher/AuctionHistoryFetcherPort.java

@@ -1,9 +1,10 @@
 package until.the.eternity.auctionhistory.domain.service.fetcher;
 
-import java.util.List;
 import until.the.eternity.auctionhistory.interfaces.external.dto.OpenApiAuctionHistoryResponse;
 import until.the.eternity.common.enums.ItemCategory;
 
+import java.util.List;
+
 public interface AuctionHistoryFetcherPort {
     List<OpenApiAuctionHistoryResponse> fetch(ItemCategory category);
 }

src/main/java/until/the/eternity/auctionhistory/domain/service/persister/AuctionHistoryPersisterPort.java

@@ -1,10 +1,11 @@
 package until.the.eternity.auctionhistory.domain.service.persister;
 
-import java.util.List;
 import until.the.eternity.auctionhistory.domain.entity.AuctionHistory;
 import until.the.eternity.auctionhistory.interfaces.external.dto.OpenApiAuctionHistoryResponse;
 import until.the.eternity.common.enums.ItemCategory;
 
+import java.util.List;
+
 public interface AuctionHistoryPersisterPort {
 
     List<AuctionHistory> filterOutExisting(

src/main/java/until/the/eternity/auctionhistory/infrastructure/persistence/AuctionHistoryJpaRepository.java

@@ -1,15 +1,16 @@
 package until.the.eternity.auctionhistory.infrastructure.persistence;
 
-import java.time.Instant;
-import java.util.List;
-import java.util.Optional;
 import org.springframework.data.jpa.repository.EntityGraph;
 import org.springframework.data.jpa.repository.JpaRepository;
 import org.springframework.data.jpa.repository.JpaSpecificationExecutor;
 import org.springframework.data.jpa.repository.Query;
 import org.springframework.stereotype.Repository;
 import until.the.eternity.auctionhistory.domain.entity.AuctionHistory;
 
+import java.time.Instant;
+import java.util.List;
+import java.util.Optional;
+
 @Repository
 public interface AuctionHistoryJpaRepository
         extends JpaRepository<AuctionHistory, String>, JpaSpecificationExecutor<AuctionHistory> {