Skip to content

feat(auction): 입찰 잠금 전 최소 금액 확인 - #248

Merged
vvipia merged 2 commits into
devfrom
feat/auction-bid-precheck
Nov 18, 2026
Merged

vvipia merged 2 commits into
devfrom
feat/auction-bid-precheck

Conversation

@vvipia

@vvipia vvipia commented Nov 18, 2026

Copy link
Copy Markdown
Collaborator

What changed and why

AU-4 부하 테스트에서 8,000건 중 99.9%가 BID_AMOUNT_TOO_LOW였지만, 모든 요청이 경매 행 잠금을 기다린 뒤 거절됐습니다. 확실히 금액이 부족한 입찰은 잠금 전에 거절해 잠금 대기를 줄입니다.

  • BidPrecheckService 추가
  • 조회 캐시의 세대 번호와 TTL을 쓰는 내부 입찰 상태 추가
  • 입찰 API에서 BidService.place() 전에 사전 확인

아래를 모두 만족할 때만 미리 거절합니다.

  1. 경매가 OPEN이고 startsAt <= 지금 < endsAt
  2. 판매자가 아니고 캐시의 현재 최고 입찰자도 아님
  3. 금액이 캐시의 최소 입찰 금액보다 낮음
  4. 같은 회원과 Idempotency-Key로 수락된 입찰이 없음

그 외에는 기존 잠금 경로에서 처음부터 판단합니다. OPEN 경매의 최소 금액과 종료 시각은 줄지 않으므로, 조금 오래된 캐시로도 수락 가능한 입찰을 잘못 거절하지 않습니다.

Affected domain and invariants

경매 입찰 진입 경로를 변경했습니다. BidService의 잠금, 크레딧 처리, 트랜잭션은 바꾸지 않았고 수락되는 입찰은 기존처럼 경매 행 잠금 안에서 최종 검증합니다. 동시 입찰 테스트에서 경매 불변식을 확인했습니다.

Tests

  • 구현 전 BidPrecheckTest: 15개 중 5개 실패 확인
  • bash tools/harness/harness-check.sh: PASS, 테스트 120개 통과
  • FULL=1 bash tools/harness/harness-check.sh: PASS, 테스트 906개 통과
  • 버그 주입 10종 모두 BidPrecheckTest가 검출: 요청 키 확인 누락과 순서 오류, 판매자·최고 입찰자 확인 누락, 시작·종료 조건 누락, 금액 경계 오류, 조회 실패 처리와 지표 누락, 세대 번호 무시

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

Contract / documentation updates

  • docs/contracts/api/auction.md: BID_AMOUNT_TOO_LOW의 minimumBidAmount가 최대 1초 전 값일 수 있음을 추가했습니다.
  • docs/domains/auction/transactions.md: 잠금 전 금액 확인을 추가했습니다.

Remaining risks

  • 금액 부족 후보마다 요청 키 확인용 DB 조회가 1번 남습니다.
  • 수락될 때마다 세대 번호가 바뀌어 내부 상태를 다시 읽습니다. DB 연결이 부족하면 같은 경매의 사전 확인이 함께 기다릴 수 있어 재측정에서 확인합니다.
  • 거절 응답의 최소 금액이 최대 1초 전 값이면 재입찰이 한 번 늘 수 있습니다. 최종 판단은 항상 잠금 안에서 합니다.

Closes #242

@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 ee746e0 into dev Nov 18, 2026
2 checks passed
@vvipia
vvipia deleted the feat/auction-bid-precheck branch November 18, 2026 11:50
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