Skip to content

feat(ticketing): 회차별 구매 한도와 활성 예약 조회 API 추가 - #235

Merged
songfox00 merged 12 commits into
devfrom
feat/ticketing-booking-availability
Nov 18, 2026
Merged

songfox00 merged 12 commits into
devfrom
feat/ticketing-booking-availability

Conversation

@songfox00

Copy link
Copy Markdown
Collaborator

변경 내용과 이유

좌석 선택 화면에서 회원의 남은 구매 한도와 진행 중인 예약을
미리 확인할 수 있도록 회차별 구매 현황 조회 API를 추가했습니다.

  • GET /api/performances/{performanceId}/booking-availability
  • 로그인 회원의 회차당 최대·구매 확정·선점·남은 수량을 반환합니다.
  • 해당 회차에 진행 중인 예약이 있으면 예약 상세를 함께 반환합니다.
  • 기존 구매 이력이 없으면 확정·선점 수량을 0으로 반환합니다.

영향 도메인과 불변식

  • 티켓팅의 읽기 전용 조회 기능입니다. 예약·좌석·주문 상태를 변경하지 않습니다.
  • 남은 수량은 최대 수량 - 확정 수량 - 선점 수량이며, 0 미만이면 0으로 표시합니다.
  • 활성 예약은 HELD, PAYMENT_PENDING, RECONCILING 상태를 포함합니다.
  • 조회 결과는 조회 시점의 안내입니다. 실제 좌석 선점 시 기존 서버 로직이
    구매 관리 행을 잠그고 한도와 활성 예약을 다시 검증합니다.
  • 다른 회원의 구매 수량과 예약은 반환하지 않습니다.

테스트

TicketReservationServiceTest에 다음 조회 시나리오를 추가했습니다.

  • 최초 사용자와 구매 확정·선점 수량이 있는 사용자의 남은 한도
  • 같은 회차의 활성 예약 표시와 회원 간 조회 범위 분리
  • 비로그인 요청 및 존재하지 않는 회차

계약 및 문서 변경

  • 티켓팅 API 문서에 요청 경로, 응답 필드와 인증·오류 규칙을 추가했습니다.
  • DB 스키마와 기존 좌석 선점 API 계약은 변경하지 않았습니다.

남은 위험 및 후속 작업

  • 조회 이후 다른 탭이나 요청에서 구매 상태가 바뀔 수 있으므로
    실제 선점 결과가 화면에 표시된 한도와 다를 수 있습니다.
  • 화면의 좌석 선택 제한과 활성 예약 안내는 별도 frontend-test
    저장소의 변경사항입니다.

…-final-RESTLESS into dev

# Conflicts:
#	backend/src/main/java/com/restless/common/error/ErrorCode.java
#	backend/src/main/java/com/restless/concert/application/ConcertQueryService.java
#	backend/src/main/java/com/restless/concert/infrastructure/PerformanceRepository.java
#	backend/src/main/java/com/restless/ticketing/api/TicketReservationController.java
#	backend/src/main/java/com/restless/ticketing/api/TicketSeatController.java
#	backend/src/main/java/com/restless/ticketing/application/SeatHoldExpirationScheduler.java
#	backend/src/main/java/com/restless/ticketing/application/TicketReservationService.java
#	backend/src/main/java/com/restless/ticketing/application/TicketSeatQueryService.java
#	backend/src/main/java/com/restless/ticketing/domain/SeatHold.java
#	backend/src/main/java/com/restless/ticketing/domain/TicketPurchaseLimit.java
#	backend/src/main/java/com/restless/ticketing/domain/TicketReservation.java
#	backend/src/main/java/com/restless/ticketing/domain/TicketSeat.java
#	backend/src/main/java/com/restless/ticketing/infrastructure/SeatHoldRepository.java
#	backend/src/main/java/com/restless/ticketing/infrastructure/TicketReservationRepository.java
#	backend/src/test/java/com/restless/concert/entity/ConcertPerformanceMappingTest.java
#	backend/src/test/java/com/restless/ticketing/application/TicketReservationServiceTest.java
#	docs/contracts/api/ticketing.md
#	docs/domains/ticketing/design.md
#	docs/domains/ticketing/expiration.md
#	docs/domains/ticketing/idempotency.md
#	docs/domains/ticketing/seat-ownership.md
#	docs/domains/ticketing/venue-consistency.md
@songfox00 songfox00 added this to the Phase 2 - FANQ milestone Nov 18, 2026
@songfox00 songfox00 self-assigned this Nov 18, 2026
@songfox00 songfox00 added the Feat label Nov 18, 2026
@songfox00 songfox00 linked an issue Nov 18, 2026 that may be closed by this pull request
@songfox00
songfox00 merged commit 12a3f0d into dev Nov 18, 2026
2 checks passed
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