Skip to content

feat(order): 판매자 반품 조회 대기열을 제공한다 - #452

Merged
Neo1228 merged 1 commit into
mainfrom
fix/450-seller-return-inbox
Nov 20, 2026
Merged

Neo1228 merged 1 commit into
mainfrom
fix/450-seller-return-inbox

Conversation

@Neo1228

@Neo1228 Neo1228 commented Nov 20, 2026

Copy link
Copy Markdown
Owner

변경 요청 (Pull Request)

목적

  • 해결할 문제: 판매자는 receipt·inspection API를 갖고 있지만 returnId를 발견할 seller-side 목록 API가 없다. Buyer-only /api/buyers/{buyerRef}/orders/{orderId}/returns는 seller가 사용할 수 없어 반품 수령·검수·환불 흐름이 HTTP로 시작 불가능했다.
  • 변경이 필요한 이유: 이미 요청된 반품이 seller에게 도달하지 않으면 구매자는 반품 진행과 환불을 받을 수 없다.

변경 범위

  • 포함: GET /api/sellers/{sellerId}/returns seller return queue, 선택적 status filter, keyset cursor, seller 전용 응답 DTO(buyerRef 제외), V60 seller-history index, multi-seller/pagination 통합 테스트.
  • 제외: buyer return 생성, seller receipt/inspection state transition, return 환불 처리(기존 계약 유지).

근거와 설계

  • 확인된 사실·가정: order_return에는 sellerId·requestedAt·returnId가 저장되지만 읽기 API는 buyerRef와 orderId를 요구했다. receipt·inspection POST는 sellerId·orderId·returnId를 요구한다.
  • 결정과 이유: seller_id + requested_at DESC + return_id DESC keyset 순서로 limit+1개를 읽고, 동일 seller/status 필터로 다음 페이지를 조회한다. status 필터는 선택적이다. 요청의 buyerRef는 seller 화면에 필요하지 않으므로 Seller response에서 제외한다.
  • 대안·trade-off: 기존 OrderReturnResponse는 buyerRef를 포함해 재사용하지 않는다. collection graph fetch와 페이지네이션의 곱집합/메모리 페이징을 피하기 위해 먼저 부모 ID 페이지를 조회하고 현재 페이지의 items만 한 번에 가져와 원래 순서를 복원한다. seller-history index 하나를 추가한다.
  • 데이터·API·상태 영향: V60은 additive index. 새 read-only GET route 추가, limit/cursor/status query parameters. 잘못된 limit/cursor는 INVALID_REQUEST; seller ownership은 기존 AccountOwnershipInterceptor, 데이터 필터는 service query에서 다시 적용.
  • 영향 범위 (dependency·plugin·runtime·test·build): 새 의존성 없음. order service/repository/response DTO, application controller, migration, PostgreSQL integration test 변경.
  • 검증 근거와 한계: 24개 OrderRefundLifecycleIntegrationTest 통과, git diff --check, Checkstyle 통과. 테스트는 두 반품을 한 seller에서 keyset 페이지화하고 다른 seller의 반품과 격리하며, buyerRef를 JSON에 포함하지 않는지 확인한다.

시각화

  • Diagram 또는 N/A 사유: N/A. 기존 seller ownership 경계 아래의 read-only list endpoint이며 새로운 상태 전이는 없다.

추적

변경 요약

  • 변경: 판매자가 자신의 반품을 상태·항목별로 조회하고 receipt/inspection을 시작할 returnId를 찾을 수 있다.

검증

  • 실행한 명령과 결과: :application-module:test --tests '*OrderRefundLifecycleIntegrationTest': 24 tests 통과. ./gradlew clean check: ./gradlew clean check: BUILD SUCCESSFUL, 600 tests, 0 failures/errors..
  • 관련 문서·기록 갱신: Issue #450의 누락된 seller discovery contract 기록.

위험·후속 작업

  • 알려진 위험·한계: buyerRef는 공개하지 않는다. 판매자 주문 상세는 #449에서 제공한다. 검색/요청 순서는 requestedAt/returnId 기준이며 status filter를 cursor와 함께 사용한다.
  • 후속 작업: seller 화면에서 queue를 소비하고 receipt/inspection을 연결한다.

검토 체크리스트

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

- seller 소유 반품을 status filter와 keyset cursor로 조회하는 GET API를 추가한다.
- seller 전용 response에서 buyerRef를 제외하고, V60 seller-history index 및 multi-seller/pagination 통합 테스트를 추가한다.
- 검증: OrderRefundLifecycleIntegrationTest 24 tests 및 Checkstyle 통과.
@Neo1228
Neo1228 merged commit f2727ae into main Nov 20, 2026
3 checks passed
@Neo1228
Neo1228 deleted the fix/450-seller-return-inbox branch November 20, 2026 19:52
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