Skip to content

feat(order): 판매자 주문 상세 API를 제공한다 - #451

Merged
Neo1228 merged 1 commit into
mainfrom
fix/449-seller-order-detail-discovery
Nov 20, 2026
Merged

Neo1228 merged 1 commit into
mainfrom
fix/449-seller-order-detail-discovery

Conversation

@Neo1228

@Neo1228 Neo1228 commented Nov 20, 2026

Copy link
Copy Markdown
Owner

변경 요청 (Pull Request)

목적

  • 해결할 문제: 판매자 주문 목록은 orderId를 제공하지만 주문 항목(orderItemId)은 제공하지 않는다. 배송·환불 API는 orderItemId를 필수 입력으로 요구하고, generic GET /api/orders/{orderId}는 buyer ownership으로 보호되어 seller가 사용할 수 없다. 기존 발견 테스트도 OrderService를 직접 호출해 HTTP 계약의 차이를 놓쳤다.
  • 변경이 필요한 이유: 판매자는 API에서 주문을 찾아도 배송·환불에 필요한 항목을 식별할 수 없어 후속 이행 요청을 구성할 수 없다.

변경 범위

  • 포함: GET /api/sellers/{sellerId}/orders/{orderId} seller 전용 주문 상세 응답과 HTTP/PostgreSQL 통합 테스트.
  • 제외: seller 반품 대기열(별도 #450), 배송지 주소 도메인(현재 요구사항 BR-011 범위 밖), 실제 shipment/refund provider 실행.

근거와 설계

  • 확인된 사실·가정: 목록 DTO(OrderHistoryPageResponse.Entry)는 주문 식별자와 상태만 담고, 배송·환불 요청은 orderItemId를 요구한다. interceptor는 /api/sellers/**에서 seller 소유권을 확인하며, orderId가 있는 seller 경로는 주문 항목도 seller 소유인지 확인한다. seller detail도 같은 경계를 따른다.
  • 결정과 이유: orderId를 seller 경로에 명시하고 OrderService.findSellerOrder(sellerId,orderId)에서 주문의 seller와 모든 항목 seller가 요청자와 일치하는지 재검증한다. 응답은 배송·환불에 필요한 항목 ID·SKU·상품·수량·금액·주문 상태만 포함한다.
  • 대안·trade-off: 기존 OrderResponse를 그대로 재사용하면 paymentAttemptId·paymentApprovalUrl 등 판매자가 알 필요 없는 결제 데이터도 노출된다. seller 전용 SellerOrderDetailResponse를 추가해 응답 필드를 최소화한다.
  • 데이터·API·상태 영향: schema·migration 변경 없음. 새 read-only GET endpoint 추가. cross-seller 또는 buyer-only generic route는 403이며 GET side effect 없음.
  • 영향 범위 (dependency·plugin·runtime·test·build): 새 의존성 없음. order service contract, controller, DTO 및 Testcontainers integration test만 변경.
  • 검증 근거와 한계: 통합 테스트는 seller가 주문 목록→seller detail로 orderItemId를 얻는 경로, paymentAttemptId/paymentApprovalUrl/buyerRef 비노출, 다른 seller와 generic buyer route의 거부를 검증한다. 실제 shipment/refund 호출 자체는 별도 lifecycle test 범위이며 여기서는 수행하지 않는다.

시각화

  • Diagram 또는 N/A 사유: N/A. seller-scoped read-only endpoint 하나와 기존 ownership interceptor만 사용한다.

추적

변경 요약

  • 변경: seller-scoped 주문 상세를 추가해 배송·환불에 필요한 orderItemId와 안전한 seller order fields를 반환.

검증

  • 실행한 명령과 결과: :application-module:test --tests '*SellerOrderDiscoveryIntegrationTest' 통과(2 tests); 전체 clean check: ./gradlew clean check: BUILD SUCCESSFUL, 599 tests, 0 failures/errors..
  • 관련 문서·기록 갱신: Issue #449의 기존 direct-service 테스트 한계와 HTTP 계약 acceptance를 기록.

위험·후속 작업

검토 체크리스트

  • 변경 범위가 하나의 목적과 검토 가능한 경계에 맞음.
  • 실행하지 않은 검증·성과를 주장하지 않음.
  • 데이터·보안·금전 상태·복구 영향을 검토함; schema 변경 없음, seller-only reads의 정보 공개를 검증함.
  • Issue 번호·링크가 일치하며 Closes #N 또는 Refs #N 형식이 plain text임.
  • 복잡한 변경의 사실·가정·근거·영향을 본문에서 설명함; 링크만으로 대체하지 않음.
  • API 변경 시 오류/status contract와 GET의 side effect를 확인함; GET은 read-only, 타 seller 접근은 403.
  • 필요한 경우 Mermaid diagram으로 계층·상태 흐름을 설명함. (단일 read endpoint라 N/A)
  • Java 주석은 한국어; API 식별자와 오류 코드는 임의로 바꾸지 않음.
  • 체크리스트 전체 완료; N/A 항목은 구체적인 사유를 포함함.

- seller ownership 을 검증하는 주문 상세 GET 을 추가해 이행에 필요한 orderItemId 를 반환한다.
- paymentAttemptId, paymentApprovalUrl, buyerRef 는 seller 응답에서 제외하고 cross-seller 및 buyer-only 경로 거부를 HTTP 통합 테스트로 검증한다.
- 검증: SellerOrderDiscoveryIntegrationTest 2 tests, 전체 clean check 599 tests / 0 failures.

Closes #449
@Neo1228
Neo1228 merged commit a832ba1 into main Nov 20, 2026
3 checks passed
@Neo1228
Neo1228 deleted the fix/449-seller-order-detail-discovery branch November 20, 2026 19:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[버그]: 판매자 주문 상세에서 배송·환불에 필요한 주문 항목을 조회할 수 없다

1 participant