diff --git a/backend/build.gradle b/backend/build.gradle index 3c55f665..484c7f5c 100644 --- a/backend/build.gradle +++ b/backend/build.gradle @@ -26,6 +26,7 @@ dependencies { implementation 'org.springframework.boot:spring-boot-starter-validation' implementation 'org.springframework.boot:spring-boot-starter-actuator' implementation 'org.springframework.boot:spring-boot-starter-flyway' + implementation 'com.github.ben-manes.caffeine:caffeine' implementation 'org.flywaydb:flyway-mysql' runtimeOnly 'com.mysql:mysql-connector-j' // 부하 테스트 지표. perf 프로필에서만 /actuator/prometheus를 연다 (application-perf.yml) @@ -51,6 +52,8 @@ tasks.named('test') { // 경매 시작·종료 스케줄러는 테스트에서 끈다. 다른 테스트의 데이터 정리와 겹치지 않게 하기 위해서다. // 스케줄러를 검증하는 테스트만 @SpringBootTest(properties)로 다시 켠다. systemProperty 'restless.auction.scheduler.enabled', 'false' + // 기존 테스트는 DB를 직접 바꾼다. 경매 조회 캐시는 AuctionQueryCacheTest에서만 켠다. + systemProperty 'restless.auction.query-cache.enabled', 'false' systemProperty 'restless.payment.reconcile.enabled', 'false' systemProperty 'restless.drop.expiry.enabled', 'false' // JDBC Timestamp fixtures and JPA TIMESTAMP_UTC must use the same time zone on every host. diff --git a/backend/src/main/java/com/restless/auction/api/AuctionController.java b/backend/src/main/java/com/restless/auction/api/AuctionController.java index add30ea5..695e530b 100644 --- a/backend/src/main/java/com/restless/auction/api/AuctionController.java +++ b/backend/src/main/java/com/restless/auction/api/AuctionController.java @@ -1,6 +1,7 @@ package com.restless.auction.api; import com.restless.auction.application.AuctionQueryService; +import com.restless.auction.application.AuctionQueryCache; import com.restless.auction.application.AuctionQueryService.AuctionDetail; import com.restless.auction.application.AuctionQueryService.AuctionPage; import com.restless.auction.application.AuctionQueryService.AuctionResultView; @@ -23,6 +24,7 @@ public class AuctionController { static final int MAX_PAGE_SIZE = 100; private final AuctionQueryService auctionQueryService; + private final AuctionQueryCache auctionQueryCache; /** status를 빼면 전체. page는 0부터, size는 1~100. */ @GetMapping @@ -32,12 +34,12 @@ public AuctionPage list(@RequestParam(required = false) AuctionStatus status, if (page < 0 || size < 1 || size > MAX_PAGE_SIZE) { throw new BusinessException(ErrorCode.INVALID_REQUEST, "page는 0 이상, size는 1에서 100 사이여야 합니다."); } - return auctionQueryService.list(status, page, size); + return auctionQueryCache.list(status, page, size); } @GetMapping("/{auctionId}") public AuctionDetail detail(@PathVariable Long auctionId) { - return auctionQueryService.detail(auctionId); + return auctionQueryCache.detail(auctionId); } /** 종료 전이면 404 AUCTION_RESULT_NOT_FOUND. */ diff --git a/backend/src/main/java/com/restless/auction/application/AuctionQueryCache.java b/backend/src/main/java/com/restless/auction/application/AuctionQueryCache.java new file mode 100644 index 00000000..8c1aeecd --- /dev/null +++ b/backend/src/main/java/com/restless/auction/application/AuctionQueryCache.java @@ -0,0 +1,108 @@ +package com.restless.auction.application; + +import com.github.benmanes.caffeine.cache.Cache; +import com.github.benmanes.caffeine.cache.Caffeine; +import com.github.benmanes.caffeine.cache.Ticker; +import com.restless.auction.application.AuctionQueryService.AuctionDetail; +import com.restless.auction.application.AuctionQueryService.AuctionPage; +import com.restless.auction.domain.AuctionStatus; +import io.micrometer.core.instrument.MeterRegistry; +import java.time.Clock; +import java.time.Duration; +import java.util.concurrent.TimeUnit; +import lombok.extern.slf4j.Slf4j; +import org.springframework.beans.factory.annotation.Value; +import org.springframework.stereotype.Component; +import org.springframework.transaction.event.TransactionPhase; +import org.springframework.transaction.event.TransactionalEventListener; + +/** 목록과 상세 조회 결과를 앱 메모리에 보관한다. 트랜잭션 밖에서 호출한다. */ +@Slf4j +@Component +public class AuctionQueryCache { + + private final AuctionQueryService queries; + private final Clock clock; + private final MeterRegistry meters; + private final boolean enabled; + private final Cache details; + private final Cache lists; + private final Cache generations; + + public AuctionQueryCache(AuctionQueryService queries, Clock clock, MeterRegistry meters, + @Value("${restless.auction.query-cache.enabled:true}") boolean enabled, + @Value("${restless.auction.query-cache.ttl-ms:1000}") long ttlMs) { + if (ttlMs <= 0) { + throw new IllegalArgumentException("restless.auction.query-cache.ttl-ms must be positive"); + } + this.queries = queries; + this.clock = clock; + this.meters = meters; + this.enabled = enabled; + + Ticker ticker = () -> TimeUnit.MILLISECONDS.toNanos(clock.millis()); + this.details = Caffeine.newBuilder() + .maximumSize(10_000) + .expireAfterWrite(ttlMs, TimeUnit.MILLISECONDS) + .ticker(ticker) + .build(); + this.lists = Caffeine.newBuilder() + .maximumSize(256) + .expireAfterWrite(ttlMs, TimeUnit.MILLISECONDS) + .ticker(ticker) + .build(); + this.generations = Caffeine.newBuilder() + .expireAfterWrite(generationRetentionMs(ttlMs), TimeUnit.MILLISECONDS) + .ticker(ticker) + .build(); + } + + public AuctionPage list(AuctionStatus status, int page, int size) { + if (!enabled) { + return queries.list(status, page, size); + } + ListKey key = new ListKey(status, page, size); + return lists.get(key, ignored -> queries.list(status, page, size)); + } + + public AuctionDetail detail(Long auctionId) { + if (!enabled) { + return withCurrentServerTime(queries.detail(auctionId)); + } + long generation = currentGeneration(auctionId); + DetailKey key = new DetailKey(auctionId, generation); + AuctionDetail cached = details.get(key, ignored -> queries.detail(auctionId)); + return withCurrentServerTime(cached); + } + + @TransactionalEventListener(phase = TransactionPhase.AFTER_COMMIT) + public void onChanged(AuctionChangedEvent event) { + try { + generations.asMap().compute(event.auctionId(), (ignored, generation) -> generation == null ? 1 : generation + 1); + } catch (RuntimeException exception) { + log.error("Auction query cache invalidation failed auctionId={}", event.auctionId(), exception); + meters.counter("auction.query.cache.failure", "stage", "invalidate").increment(); + throw exception; + } + } + + private AuctionDetail withCurrentServerTime(AuctionDetail detail) { + return detail.withServerTime(clock.instant()); + } + + private long currentGeneration(Long auctionId) { + Long generation = generations.getIfPresent(auctionId); + return generation == null ? 0 : generation; + } + + private static long generationRetentionMs(long ttlMs) { + long longerThanQueryTtl = ttlMs > Long.MAX_VALUE / 2 ? Long.MAX_VALUE : ttlMs * 2; + return Math.max(Duration.ofMinutes(1).toMillis(), longerThanQueryTtl); + } + + private record DetailKey(Long auctionId, long generation) { + } + + private record ListKey(AuctionStatus status, int page, int size) { + } +} diff --git a/backend/src/main/java/com/restless/auction/application/AuctionQueryService.java b/backend/src/main/java/com/restless/auction/application/AuctionQueryService.java index 6587f865..837f6dd6 100644 --- a/backend/src/main/java/com/restless/auction/application/AuctionQueryService.java +++ b/backend/src/main/java/com/restless/auction/application/AuctionQueryService.java @@ -148,6 +148,11 @@ public record AuctionDetail(Long auctionId, String title, String itemName, Strin long minimumIncrementAmount, HighestBid highestBid, long minimumBidAmount, Instant startsAt, Instant endsAt, int extensionDurationSeconds, long revision, Instant serverTime) { + public AuctionDetail withServerTime(Instant currentTime) { + return new AuctionDetail(auctionId, title, itemName, itemDescription, sellerNickname, status, + startingPriceAmount, minimumIncrementAmount, highestBid, minimumBidAmount, startsAt, endsAt, + extensionDurationSeconds, revision, currentTime); + } } /** 실시간 스트림 메시지. revision이 SSE 이벤트 id가 된다. */ diff --git a/backend/src/main/resources/application.yml b/backend/src/main/resources/application.yml index 9d704c88..398e600f 100644 --- a/backend/src/main/resources/application.yml +++ b/backend/src/main/resources/application.yml @@ -55,6 +55,10 @@ restless: flush-interval-ms: 200 # SSE 연결 최대 유지 시간(ms). 지나면 서버가 닫고, 클라이언트는 상세를 다시 받은 뒤 재연결한다. timeout-ms: 1800000 + query-cache: + # 목록·상세 조회의 앱 메모리 캐시. 변경 이벤트로 상세를 즉시 갱신한다. + enabled: true + ttl-ms: 1000 fanmeeting: worker: # 팬미팅 응모 기간 열기·마감, 추첨 Worker. 테스트에서는 build.gradle이 false로 끈다. diff --git a/backend/src/test/java/com/restless/auction/AuctionQueryCacheTest.java b/backend/src/test/java/com/restless/auction/AuctionQueryCacheTest.java new file mode 100644 index 00000000..4cd7d1a5 --- /dev/null +++ b/backend/src/test/java/com/restless/auction/AuctionQueryCacheTest.java @@ -0,0 +1,332 @@ +package com.restless.auction; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyInt; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.Mockito.doAnswer; +import static org.mockito.Mockito.times; +import static org.mockito.Mockito.verify; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.delete; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.patch; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status; + +import com.jayway.jsonpath.JsonPath; +import com.restless.TestcontainersConfiguration; +import com.restless.auction.application.AuctionChangedEvent; +import com.restless.auction.application.AuctionCloseService; +import com.restless.auction.application.AuctionQueryService; +import com.restless.auction.domain.AuctionStatus; +import com.restless.auth.infrastructure.JwtTokenProvider; +import java.time.Clock; +import java.time.Duration; +import java.time.Instant; +import java.time.ZoneId; +import java.time.ZoneOffset; +import java.util.ArrayList; +import java.util.List; +import java.util.UUID; +import java.util.concurrent.CountDownLatch; +import java.util.concurrent.ExecutorService; +import java.util.concurrent.Executors; +import java.util.concurrent.Future; +import java.util.concurrent.TimeUnit; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.boot.test.context.TestConfiguration; +import org.springframework.boot.webmvc.test.autoconfigure.AutoConfigureMockMvc; +import org.springframework.context.ApplicationEventPublisher; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Import; +import org.springframework.context.annotation.Primary; +import org.springframework.http.HttpHeaders; +import org.springframework.http.MediaType; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.test.context.bean.override.mockito.MockitoSpyBean; +import org.springframework.test.web.servlet.MockMvc; +import org.springframework.test.web.servlet.ResultActions; +import org.springframework.transaction.PlatformTransactionManager; +import org.springframework.transaction.support.TransactionTemplate; + +/** + * 경매 목록·상세 조회 캐시. DB 조회 횟수는 {@link AuctionQueryService} 호출 횟수로 센다. + * + *

상세는 경매가 바뀌면 커밋 직후 새 값을 보여 주고, 경매 이벤트가 없는 변경(닉네임)은 TTL 뒤에 반영한다. + * 목록은 TTL 동안 재사용한다. TTL은 주입된 {@link Clock} 기준이라 실제로 기다리지 않는다. + */ +@SpringBootTest(properties = { + "spring.docker.compose.enabled=false", + "restless.auction.query-cache.enabled=true", + "restless.auction.query-cache.ttl-ms=1000" +}) +@AutoConfigureMockMvc +@Import({TestcontainersConfiguration.class, AuctionQueryCacheTest.ClockConfig.class}) +class AuctionQueryCacheTest { + private static final Duration AFTER_TTL = Duration.ofMillis(1_001); + + @Autowired MockMvc mockMvc; + @Autowired JwtTokenProvider tokenProvider; + @Autowired JdbcTemplate jdbc; + @Autowired OffsetClock clock; + @Autowired AuctionCloseService closeService; + @Autowired ApplicationEventPublisher events; + @Autowired PlatformTransactionManager transactionManager; + @MockitoSpyBean AuctionQueryService queries; + + AuctionFixtures f; + Long seller; + Long bidder; + Long auctionId; + + @BeforeEach void setUp() { + clock.advance(AFTER_TTL); // 앞 테스트의 목록 캐시가 남지 않게 한다. + f = new AuctionFixtures(jdbc); + f.clean(); + seller = f.user("ORGANIZER"); + bidder = f.user("USER"); + f.credit(bidder, 100_000); + auctionId = f.openAuction(seller); + } + + String bearer(Long userId, String role) { + return "Bearer " + tokenProvider.issue(userId, role).value(); + } + + ResultActions detail(Long id) throws Exception { + return mockMvc.perform(get("/api/auctions/" + id).header(HttpHeaders.AUTHORIZATION, bearer(bidder, "USER"))); + } + + ResultActions list(String status, int page, int size) throws Exception { + var request = get("/api/auctions").param("page", String.valueOf(page)).param("size", String.valueOf(size)) + .header(HttpHeaders.AUTHORIZATION, bearer(bidder, "USER")); + return mockMvc.perform(status == null ? request : request.param("status", status)); + } + + ResultActions bid(long amount) throws Exception { + return mockMvc.perform(post("/api/auctions/" + auctionId + "/bids") + .header(HttpHeaders.AUTHORIZATION, bearer(bidder, "USER")) + .header("Idempotency-Key", UUID.randomUUID().toString()) + .contentType(MediaType.APPLICATION_JSON).content("{\"amount\":" + amount + "}")); + } + + Long scheduledAuction() { + Instant startsAt = clock.instant().plusSeconds(3_600); + Long id = f.auction(seller, startsAt, startsAt.plusSeconds(3_600)); + f.setStatus(id, "SCHEDULED"); + return id; + } + + Instant serverTime(ResultActions result) throws Exception { + return Instant.parse(JsonPath.read(result.andReturn().getResponse().getContentAsString(), "$.serverTime")); + } + + @Test void 같은_상세를_반복_조회하면_DB를_한_번만_읽는다() throws Exception { + detail(auctionId).andExpect(status().isOk()).andExpect(jsonPath("$.auctionId").value(auctionId)); + detail(auctionId).andExpect(status().isOk()).andExpect(jsonPath("$.auctionId").value(auctionId)); + detail(auctionId).andExpect(status().isOk()).andExpect(jsonPath("$.auctionId").value(auctionId)); + + verify(queries, times(1)).detail(auctionId); + } + + @Test void 같은_상세를_동시에_조회해도_DB를_한_번만_읽는다() throws Exception { + int requests = 8; + CountDownLatch loaders = new CountDownLatch(requests); + doAnswer(invocation -> { + // 캐시가 동시 조회를 묶지 못하면 모든 요청이 여기 도착해 바로 지나가고, 호출 횟수 검증에서 실패한다. + loaders.countDown(); + loaders.await(500, TimeUnit.MILLISECONDS); + return invocation.callRealMethod(); + }).when(queries).detail(auctionId); + + ExecutorService executor = Executors.newFixedThreadPool(requests); + try { + CountDownLatch start = new CountDownLatch(1); + List> responses = new ArrayList<>(); + for (int i = 0; i < requests; i++) { + responses.add(executor.submit(() -> { + start.await(); + return detail(auctionId).andReturn().getResponse().getStatus(); + })); + } + start.countDown(); + for (Future response : responses) { + assertThat(response.get(10, TimeUnit.SECONDS)).isEqualTo(200); + } + } finally { + executor.shutdownNow(); + } + + verify(queries, times(1)).detail(auctionId); + } + + @Test void 입찰이_수락되면_다음_상세는_바로_새_최고가를_보여_준다() throws Exception { + detail(auctionId).andExpect(jsonPath("$.highestBid").isEmpty()); + + bid(50_000).andExpect(status().isCreated()); + + detail(auctionId) + .andExpect(jsonPath("$.highestBid.amount").value(50_000)) + .andExpect(jsonPath("$.minimumBidAmount").value(51_000)); + verify(queries, times(2)).detail(auctionId); + f.assertInvariants(); + } + + @Test void 거절된_입찰은_상세_캐시를_버리지_않는다() throws Exception { + detail(auctionId).andExpect(status().isOk()); + + bid(49_999).andExpect(status().isConflict()).andExpect(jsonPath("$.code").value("BID_AMOUNT_TOO_LOW")); + + detail(auctionId).andExpect(status().isOk()); + verify(queries, times(1)).detail(auctionId); + } + + @Test void 롤백된_변경은_상세_캐시를_버리지_않는다() throws Exception { + detail(auctionId).andExpect(jsonPath("$.title").value("경매")); + + new TransactionTemplate(transactionManager).executeWithoutResult(tx -> { + jdbc.update("UPDATE auctions SET title = '롤백된 제목' WHERE auction_id = ?", auctionId); + events.publishEvent(new AuctionChangedEvent(auctionId, 99)); + tx.setRollbackOnly(); + }); + + detail(auctionId).andExpect(jsonPath("$.title").value("경매")); + verify(queries, times(1)).detail(auctionId); + } + + @Test void 경매가_시작되면_다음_상세는_바로_OPEN이다() throws Exception { + f.setStatus(auctionId, "SCHEDULED"); + detail(auctionId).andExpect(jsonPath("$.status").value("SCHEDULED")); + + assertThat(closeService.open(auctionId)).isTrue(); + + detail(auctionId).andExpect(jsonPath("$.status").value("OPEN")); + } + + @Test void 경매가_종료되면_다음_상세는_바로_CLOSED다() throws Exception { + detail(auctionId).andExpect(jsonPath("$.status").value("OPEN")); + f.setEndsAt(auctionId, clock.instant().minusSeconds(1)); + + assertThat(closeService.close(auctionId)).isTrue(); + + detail(auctionId).andExpect(jsonPath("$.status").value("CLOSED")); + f.assertInvariants(); + } + + @Test void 시작_전_경매를_수정하면_다음_상세는_바로_새_값이다() throws Exception { + Long id = scheduledAuction(); + detail(id).andExpect(jsonPath("$.title").value("경매")); + Instant startsAt = clock.instant().plusSeconds(7_200); + + mockMvc.perform(patch("/api/auctions/" + id).header(HttpHeaders.AUTHORIZATION, bearer(seller, "ORGANIZER")) + .contentType(MediaType.APPLICATION_JSON).content(""" + {"title":"바뀐 경매","itemName":"물품","itemDescription":"설명", + "startingPriceAmount":60000,"minimumIncrementAmount":1000, + "startsAt":"%s","endsAt":"%s","extensionDurationSeconds":60} + """.formatted(startsAt, startsAt.plusSeconds(3_600)))) + .andExpect(status().isOk()); + + detail(id).andExpect(jsonPath("$.title").value("바뀐 경매")) + .andExpect(jsonPath("$.minimumBidAmount").value(60_000)); + } + + @Test void 시작_전_경매를_삭제하면_다음_상세는_바로_404다() throws Exception { + Long id = scheduledAuction(); + detail(id).andExpect(status().isOk()); + + mockMvc.perform(delete("/api/auctions/" + id).header(HttpHeaders.AUTHORIZATION, bearer(seller, "ORGANIZER"))) + .andExpect(status().isNoContent()); + + detail(id).andExpect(status().isNotFound()).andExpect(jsonPath("$.code").value("AUCTION_NOT_FOUND")); + } + + @Test void 캐시된_상세도_serverTime은_응답_시각이다() throws Exception { + Instant first = serverTime(detail(auctionId).andExpect(status().isOk())); + + clock.advance(Duration.ofMillis(300)); + Instant second = serverTime(detail(auctionId).andExpect(status().isOk())); + + assertThat(Duration.between(first, second)).isGreaterThanOrEqualTo(Duration.ofMillis(300)); + verify(queries, times(1)).detail(auctionId); + } + + @Test void 경매_이벤트가_없는_닉네임_변경은_TTL_뒤에_상세에_반영된다() throws Exception { + String before = f.nickname(seller); + detail(auctionId).andExpect(jsonPath("$.sellerNickname").value(before)); + jdbc.update("UPDATE users SET nickname = '새닉네임' WHERE id = ?", seller); + + detail(auctionId).andExpect(jsonPath("$.sellerNickname").value(before)); + + clock.advance(AFTER_TTL); + detail(auctionId).andExpect(jsonPath("$.sellerNickname").value("새닉네임")); + verify(queries, times(2)).detail(auctionId); + } + + @Test void 없는_경매의_404는_캐시하지_않는다() throws Exception { + long missing = auctionId + 1_000; + + detail(missing).andExpect(status().isNotFound()); + detail(missing).andExpect(status().isNotFound()); + + verify(queries, times(2)).detail(missing); + } + + @Test void 같은_목록은_TTL_동안_재사용하고_TTL_뒤에_새로_읽는다() throws Exception { + list("OPEN", 0, 20).andExpect(status().isOk()).andExpect(jsonPath("$.totalElements").value(1)); + f.openAuction(seller); + + list("OPEN", 0, 20).andExpect(jsonPath("$.totalElements").value(1)); + verify(queries, times(1)).list(AuctionStatus.OPEN, 0, 20); + + clock.advance(AFTER_TTL); + list("OPEN", 0, 20).andExpect(jsonPath("$.totalElements").value(2)); + verify(queries, times(2)).list(AuctionStatus.OPEN, 0, 20); + } + + @Test void 상태_페이지_크기가_다른_목록은_섞이지_않는다() throws Exception { + f.openAuction(seller); + Long scheduled = scheduledAuction(); + + list("OPEN", 0, 1).andExpect(jsonPath("$.items.length()").value(1)) + .andExpect(jsonPath("$.totalElements").value(2)); + list("OPEN", 1, 1).andExpect(jsonPath("$.items.length()").value(1)); + list("OPEN", 0, 20).andExpect(jsonPath("$.items.length()").value(2)); + list("SCHEDULED", 0, 20).andExpect(jsonPath("$.items[0].auctionId").value(scheduled)); + list(null, 0, 20).andExpect(jsonPath("$.totalElements").value(3)); + + verify(queries, times(5)).list(any(), anyInt(), anyInt()); + verify(queries, times(1)).list(eq(AuctionStatus.OPEN), eq(0), eq(1)); + } + + @TestConfiguration + static class ClockConfig { + @Bean @Primary OffsetClock auctionQueryCacheTestClock() { + return new OffsetClock(); + } + } + + /** 실제 시각에 더한 값만 앞으로 옮긴다. 고정 시각이 아니라서 발급한 JWT가 나중에 만료되지 않는다. */ + static class OffsetClock extends Clock { + private volatile Duration offset = Duration.ZERO; + + void advance(Duration duration) { + offset = offset.plus(duration); + } + + @Override public ZoneId getZone() { + return ZoneOffset.UTC; + } + + @Override public Clock withZone(ZoneId zone) { + return this; + } + + @Override public Instant instant() { + return Instant.now().plus(offset); + } + } +} diff --git a/docs/contracts/api/auction.md b/docs/contracts/api/auction.md index d8c0d0fe..2af31cda 100644 --- a/docs/contracts/api/auction.md +++ b/docs/contracts/api/auction.md @@ -6,7 +6,7 @@ > > 관련 코드: `backend/src/main/java/com/restless/auction/api/`, `backend/src/main/java/com/restless/credit/api/`, `backend/src/main/java/com/restless/common/error/ErrorCode.java` > -> 마지막 확인: 2026-11-16 (엔드포인트와 공개 경로를 컨트롤러·`SecurityConfig`와 대조) +> 마지막 확인: 2026-11-18 (목록·상세 조회 캐시 반영) 오류 응답 형식은 [README 공통 규칙 3](README.md#공통-규칙)을 따른다. @@ -103,6 +103,8 @@ Content-Type: application/json 정렬: `OPEN`은 곧 끝나는 순, `SCHEDULED`는 곧 시작하는 순, `CLOSED`와 전체는 최근 순. +목록은 서버에서 최대 1초 캐시한다. 새 경매, 상태, 종료 시각이 최대 1초 늦게 보일 수 있다. + ## 상세 ```json @@ -127,6 +129,7 @@ Content-Type: application/json - 입찰이 없으면 `highestBid`는 `null`이고 `minimumBidAmount`는 시작가다. - `serverTime`은 클라이언트 남은 시간 표시용이다. 입찰 가능 여부는 서버가 판단한다. +- 상세는 서버에서 최대 1초 캐시한다. 입찰 수락, 시작, 종료, 수정, 삭제가 커밋되면 다음 조회부터 바로 반영한다. 경매 변경 이벤트가 없는 닉네임 변경은 최대 1초 늦게 보일 수 있다. `serverTime`은 캐시와 상관없이 응답 시각이다. ## 입찰 diff --git a/docs/domains/auction/load-test.md b/docs/domains/auction/load-test.md index c50ab6ab..1c882522 100644 --- a/docs/domains/auction/load-test.md +++ b/docs/domains/auction/load-test.md @@ -1,6 +1,6 @@ # 경매 부하 테스트 계획 -> 관련 구현: `perf/scenarios/auction-burst.js`, `auction-sse.mjs`, `auction-run.sh` +> 관련 코드: `perf/scenarios/auction-burst.js`, `perf/scenarios/auction-sse.mjs`, `perf/scenarios/auction-run.sh` > > 마지막 확인: 2026-11-17 (8,000 → 10,000 몰림 시나리오) diff --git a/docs/domains/auction/transactions.md b/docs/domains/auction/transactions.md index 7e0f3451..2de66113 100644 --- a/docs/domains/auction/transactions.md +++ b/docs/domains/auction/transactions.md @@ -2,7 +2,7 @@ > 관련 코드: `backend/src/main/java/com/restless/auction/application/`, `backend/src/main/java/com/restless/credit/application/` > -> 마지막 확인: 2026-11-15 (#142 잠금 뒤 시각 읽기와 함께 고침) +> 마지막 확인: 2026-11-18 (목록·상세 조회 캐시 추가) ## 공통 규칙 @@ -110,6 +110,30 @@ AuctionChangedEvent (AFTER_COMMIT) - **설정** (`application.yml` `restless.auction.stream`): `flush-interval-ms`(기본 200), `timeout-ms`(연결 최대 유지 시간, 기본 30분. 지나면 서버가 닫고 클라이언트가 재연결한다). - **메트릭:** `auction.stream.connections`(열린 연결 수), `auction.stream.failure`(`stage` = `send` 끊긴 연결로 전송 실패, `flush` 한 경매 조회·전송 실패, `loop` 전송 주기 자체 실패). +## 조회 캐시 (트랜잭션 밖) + +인기 경매에 같은 조회가 몰릴 때 DB 조회를 줄인다. 구현은 `auction/application/AuctionQueryCache`이고, 캐시는 이 서버 메모리에만 있다. + +| 대상 | 캐시 키 | 새로 읽는 때 | +|---|---|---| +| 상세 | 경매 ID + 세대 번호 | 경매가 바뀌어 세대 번호가 오른 뒤, 또는 TTL(기본 1초) 뒤 | +| 목록 | 상태 + 페이지 + 크기 | TTL(기본 1초) 뒤 | + +```text +AuctionChangedEvent (AFTER_COMMIT) + → 그 경매의 세대 번호를 올린다 +다음 상세 조회 + → 새 세대의 캐시가 없으므로 커밋된 최신 상태를 읽는다 +``` + +- 입찰, 시작, 종료, 수정, 삭제가 이 이벤트를 발행한다. 삭제는 `revision`이 오르지 않으므로 `revision`을 캐시 키로 쓰지 않는다. +- 세대 번호는 커밋 뒤에만 오른다. 롤백된 변경은 캐시에 영향을 주지 않는다. 이벤트 처리는 캐시 조회를 기다리지 않는다. +- 같은 키를 동시에 조회하면 한 요청만 DB를 읽고 나머지는 그 결과를 쓴다. +- 상세의 `serverTime`은 캐시하지 않고 응답할 때 넣는다. +- 경매 이벤트가 없는 닉네임 변경은 TTL 뒤에 반영된다. +- 입찰, SSE 상태 조회, 결과 조회, 내 입찰 조회, 주최자 수정 응답은 이 캐시를 쓰지 않는다. +- **설정** (`application.yml` `restless.auction.query-cache`): `enabled`(기본 true, 테스트는 `build.gradle`이 끈다), `ttl-ms`(기본 1000). + ## 장애 시나리오 | 상황 | 결과 |