Files
clean-architecture-frontend…/docs/architecture
DongHyeonka 5379c805ba docs(contracts): 짝 백엔드 계약 기준점을 c508b1ba로 올린다
문제
fix/r1103-http는 짝 백엔드 계약 pin을 bbe944bd에 두었다. 그 뒤 백엔드에
70fb80bf(늦게 끝난 멱등 실행 기록)와 c508b1ba(회복 필요 응답 안내)가
들어왔다. 새 `check:backend-contract-drift`가 §2의 500
IDEMPOTENCY_RECOVERY_REQUIRED 행 변경을 알린다. 전에는 "재전송도
재실행도 안전하지 않다"였고, 지금은 "자동 재시도하지 않는다. 같은 키
재전송은 안전하다"다.

고른 방법
- pin과 답 표 JSON의 기준을 c508b1ba 전체 SHA로 옮기고,
  IDEMPOTENCY_RECOVERY_REQUIRED의 sameKeyResend를 true로 바꾼다.
- 프론트 판정은 바꾸지 않는다. 이 code는 이미 MAYBE_APPLIED이고 키를
  붙들며 자동 재전송하지 않는다. 결과 불명 화면의 같은 키 재전송은 새
  문장과 맞는다.
- 6.1절이 인용하는 IdempotencyExecutor를 c508b1ba에서 다시 읽었다.
  처리 중·불일치 판정은 그대로 action 전이고 줄 번호만 옮겼다
  (127-130, 166-169, 267).

위험·한계
- c508b1ba에서는 §1·§2·§4와 IdempotencyExecutor만 다시 대조했다.
  나머지 6.1절 파일은 bbe944bd 판독 그대로다(두 커밋 사이에 바뀌지
  않았다).

검증
- check:backend-contract-drift --backend <백엔드 checkout>: pin과 HEAD가
  같다.
- tests/unit/backend-contract-pin.test.ts 10건, verify:documentation
  PASS_SCOPED.

Refs: docs/reviews/2026-11-03-maturity-review/12-guardrails-ci.md 12-06, README.md 10.6
2026-11-04 22:36:24 +09:00
..