Skip to content

fix(order): 캠페인 주문 취소에도 capture 펜스를 적용한다 - #447

Merged
Neo1228 merged 3 commits into
mainfrom
fix/445-campaign-capture-fence
Nov 20, 2026
Merged

Neo1228 merged 3 commits into
mainfrom
fix/445-campaign-capture-fence

Conversation

@Neo1228

@Neo1228 Neo1228 commented Nov 20, 2026 •

Copy link
Copy Markdown
Owner

변경 요청 (Pull Request)

목적

  • 해결할 문제: [버그]: 취소 요청 후에도 승인된 결제가 새로 capture될 수 있다 #442 의 capture 펜스는 checkout 경로에만 적용됐다. 결제를 주문이 직접 소유하는 캠페인 주문은 취소 요청 후에도 AUTHORIZED 결제의 새 capture가 시작될 수 있었다. 또 경쟁 통합 테스트가 간헐적으로 실패했고, 실제 결제 경로 장애 주입은 실행된 적이 없었다.
  • 변경이 필요한 이유: 취소를 요청한 구매자에게 청구될 수 있는 금전 결함이 남아 있었고, 검증 근거(테스트·실측)가 주장과 맞지 않았다.

변경 범위

근거와 설계

  • 확인된 사실·가정: OrderServiceImpl.cancelLocked는 주문 행을 잠그고 CANCEL_PENDING을 기록하지만 결제 시도에 펜스를 남기지 않았다. V58 소급도 buyer_checkout만 대상으로 했다.
  • 결정과 이유: checkout 경로와 같은 방식으로, 주문 행 잠금 트랜잭션 안에서 Propagation.MANDATORY로 펜스를 기록한다(잠금 순서 주문 → 결제 시도). 취소가 롤백되면 펜스도 롤백된다. 이미 시작된 CAPTURE_PENDING/UNKNOWN capture는 기존대로 복구한다.
  • 대안·trade-off: 결제 모듈이 주문 상태를 직접 읽는 방식은 모듈 경계(ArchUnit)를 위반한다. 펜스 API를 주문용으로 하나 더 두는 쪽이 경계를 지킨다.
  • 데이터·API·상태 영향: V59는 데이터만 갱신한다(스키마 변경 없음). checkout_id IS NULL인 결제 시도 중 주문이 CANCEL_PENDING/CANCELLED인 행만 대상이다. HTTP API 변경 없음.
  • 영향 범위 (dependency·plugin·runtime·test·build): application runtime 의존성 변경 없음. 실험 도구 load-tests/paypal-real-fault/에만 Playwright 1.64.0(devDependency, 로컬 전용)을 둔다. node_modules는 git에서 제외한다. 실행하지 않는 이전 하네스(run.sh, workload.js)는 제거했다.
  • 검증 근거와 한계: 경쟁 테스트는 트랜잭션 안에서 재사용되는 pg_stat_activity 스냅샷 때문에 대기를 놓쳤다. 매 조회 전 pg_stat_clear_snapshot()을 호출하고, 경쟁 스레드가 막히지 않고 끝나면 즉시 실패하게 했다(연속 3회 통과). 실측은 조건당 3건이고 FX 스냅샷만 SYNTHETIC_FIXTURE다. 승인 return 장애는 PayPal 주문 GET에 주입되며, capture POST 자체의 장애 복구로 주장하지 않는다. 이 분리 측정은 #448 후속 작업으로 남긴다.

시각화

  • Diagram 또는 N/A 사유:
sequenceDiagram
    participant B as Buyer cancel (campaign order)
    participant O as purchase_order row
    participant A as payment_attempt row
    participant R as recovery / approval callback
    B->>O: lock, CANCEL_PENDING
    B->>A: lock, capture_prohibited=true (same tx)
    R->>A: reservePhase(CAPTURE) under lock
    A-->>R: AUTHORIZED + fence → no provider call
Loading

추적

변경 요약

  • 변경: 캠페인 주문 취소 capture 펜스와 V59 소급, 경쟁 테스트 결정화, 실제 Sandbox 주문 생성 및 승인 return/order-lookup 장애 주입 하네스와 실측 기록.

검증

  • 실행한 명령과 결과: CheckoutCaptureFencePostgresIntegrationTest 4건 연속 3회 통과, CheckoutBehaviorTest(주문 취소가 provider 작업보다 먼저 펜스를 기록하는지 순서 검증 포함) 통과. 실제 Sandbox 하네스: 수정 후 기준선·주문 생성·승인 return order-lookup 장애 18/18 PAID, PayPal capture 각 1건. 수정 전 order-lookup 지연 3건은 500으로 180초 미수렴. ./gradlew clean check: ./gradlew clean check: BUILD SUCCESSFUL, 599 tests, 0 failures/errors..
  • 관련 문서·기록 갱신: EXP-050 결과 표, decision log D-121.

위험·후속 작업

  • 알려진 위험·한계: 실측 표본이 조건당 3건이다. FX 스냅샷은 합성값(BOK ECOS 키 없음)이다. TLS tunnel toxic은 승인 return의 첫 PayPal GET에 걸렸고 capture POST 자체는 무장애로 복구 worker가 수행했다. 캠페인 주문 경로는 실제 Sandbox로 측정하지 않았다(checkout 경로만 측정).
  • 후속 작업: 표본 확대, capture POST 응답 유실·단절 분리 측정([제안]: PayPal capture POST 단계 장애 주입을 별도로 검증한다 #448), 환불 경로 실측, ECOS 키 확보 후 실제 FX로 재측정.

검토 체크리스트

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

- 캠페인 주문 취소와 capture 펜스를 같은 트랜잭션에 기록하고 V59 로 기존 취소 주문을 소급한다.
- pg_stat_activity 스냅샷을 비우며 PostgreSQL 경쟁 테스트의 실제 행 잠금 대기를 결정적으로 확인한다.
- Playwright로 실제 PayPal Sandbox 승인까지 진행하는 로컬 Toxiproxy 하네스와 실측 결과(EXP-050)를 추가한다.
- 검증: clean check 599 tests / 0 failures; Toxiproxy 실제 Sandbox 9/9 capture fault 복구, 각 PayPal capture 1건.

Closes #445
- 승인 return 단계에서 Toxiproxy 가 실제로 방해하는 첫 PayPal GET 요청을 조건명과 주석에 명시한다.
- capture POST 자체에 장애를 주입한 것처럼 보이는 EXP-050 및 PR 설명을 정정한다.
- 검증: Node 구문 검사와 EXP-050 Markdown lint 통과.
- Toxiproxy 가 승인 return 의 첫 PayPal 주문 GET 에 영향을 주며 capture POST 자체는 미주입임을 명시한다.
- PayPal 자격 증명·FX 합성 전제를 정확히 기록하고 capture 전용 fault 검증을 #448 후속으로 남긴다.
- 검증: EXP-050 Markdown lint 통과.
@Neo1228
Neo1228 merged commit 726903f into main Nov 20, 2026
5 checks passed
@Neo1228
Neo1228 deleted the fix/445-campaign-capture-fence branch November 20, 2026 18:28
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.

[버그]: 캠페인 주문 취소에는 capture 펜스가 적용되지 않는다

1 participant