Skip to content

feat(auction): 경매 목록·상세 조회 캐시 적용 - #245

Merged
vvipia merged 3 commits into
devfrom
feat/auction-query-cache
Nov 18, 2026
Merged

vvipia merged 3 commits into
devfrom
feat/auction-query-cache

Conversation

@vvipia

@vvipia vvipia commented Nov 18, 2026

Copy link
Copy Markdown
Collaborator

What changed and why

1초 몰림 부하 테스트에서 경매 상세 조회는 앱 CPU가 100%까지 올랐고(8,000건, 초당 약 318건), 목록 조회는 DB 연결 대기로 응답 중앙값이 5초였습니다. 같은 데이터를 요청마다 다시 읽지 않도록 목록·상세에 앱 메모리 캐시를 적용했습니다.

  • AuctionQueryCache 추가 (Caffeine)
  • 상세: 경매 ID + 세대 번호를 키로 사용하고, AuctionChangedEvent 커밋 후 세대 번호를 올려 다음 조회부터 새 값을 읽습니다. 경매 삭제는 revision이 오르지 않아 세대 번호를 사용합니다.
  • 목록: 상태 + 페이지 + 크기를 키로 1초 보관합니다.
  • 같은 키의 동시 조회는 DB 조회 한 번으로 합칩니다.
  • 상세의 serverTime은 캐시와 상관없이 응답 시각을 넣습니다.

입찰, SSE snapshot(), 결과 조회, 내 입찰 조회, 주최자 수정 응답은 캐시를 쓰지 않습니다.

Affected domain and invariants

경매 조회만 변경했습니다. 입찰, 크레딧, 종료 트랜잭션과 잠금 순서는 바꾸지 않았고, 경매 불변식에 영향을 주는 쓰기 경로도 변경하지 않았습니다.

Tests

  • 구현 전 AuctionQueryCacheTest: 14개 중 7개 실패 확인
  • bash tools/harness/harness-check.sh: PASS, 테스트 105개 통과
  • FULL=1 bash tools/harness/harness-check.sh: PASS, 테스트 891개 통과
  • 버그 주입 7종 모두 AuctionQueryCacheTest가 검출: 커밋 전 무효화, 세대 번호 미증가, serverTime 미갱신, 동시 조회 미병합, 목록 키 페이지 누락, 목록·상세 만료 누락

부하 테스트 재측정(AU-2, AU-3)은 머지 뒤 진행합니다.

Contract / documentation updates

  • docs/contracts/api/auction.md: 목록은 최대 1초 지연될 수 있고, 상세는 경매 변경 커밋 후 바로 반영되며 닉네임 변경은 최대 1초 지연될 수 있음을 추가했습니다.
  • docs/domains/auction/transactions.md: 조회 캐시 동작을 추가했습니다.
  • docs/domains/auction/load-test.md: 관련 코드 경로를 고쳤습니다.
  • build.gradle: Caffeine 의존성과 테스트용 캐시 비활성화 설정을 추가했습니다.
  • application.yml: restless.auction.query-cache 설정을 추가했습니다.

Remaining risks

  • 캐시는 서버 메모리에 있습니다. 서버가 여러 대가 되면 다른 서버의 상세는 최대 1초 늦을 수 있습니다.
  • DB 연결이 부족해 캐시 적재가 오래 걸리면 같은 키를 기다리는 요청도 함께 기다립니다. 재측정에서 응답 시간을 확인합니다.
  • 보안 필터와 JSON 변환은 요청마다 남으므로 CPU 절감 폭은 재측정으로 확인해야 합니다.

Closes #241

@vvipia vvipia added this to the Phase 2 - FANQ milestone Nov 18, 2026
@vvipia vvipia self-assigned this Nov 18, 2026
@vvipia vvipia added the Feat label Nov 18, 2026
@vvipia
vvipia merged commit e1d7754 into dev Nov 18, 2026
2 checks passed
@vvipia
vvipia deleted the feat/auction-query-cache branch November 18, 2026 08:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Feat] 경매 목록·상세 조회 캐시 적용

1 participant