Files
clean-architecture-frontend…/docs/architecture
DongHyeonka 580be5839d docs(contracts): 짝 백엔드 계약 기준점을 45d2a478로 올린다
문제
check:backend-contract-drift가 백엔드 HEAD 45d2a478에서 http-contract.md §2
두 행의 설명 변경을 알린다. IDEMPOTENT_IN_FLIGHT(PostgreSQL 저장소는 409
대신 첫 요청이 끝날 때까지 기다림)와 IDEMPOTENCY_UNAVAILABLE(processing
lease가 시작 전에 끝나 저장소가 시작을 거절함)이다. 같은 커밋이 6.1절이
인용하는 GlobalExceptionHandler와 IdempotencyExecutor도 고쳤다.

고른 방법
- 두 행의 code·status·retryable·재전송 규칙은 같다. 프론트 판정(처리 중
  MAYBE_APPLIED·같은 키, UNAVAILABLE 실행 안 됨·같은 키 자동 재전송)은
  바꾸지 않는다.
- 6.1절이 인용하는 블록 13개를 두 판에서 대조했다. 내용은 모두 같고
  GlobalExceptionHandler 4개, IdempotencyExecutor 1개의 줄 번호만 옮겼다.
  인용한 다른 백엔드 파일 15개는 바뀌지 않았다.
- pin, 답 표 JSON, 계약 문서 4.1·6·6.1절, CHANGELOG의 pin 행과 알려진
  제한을 같이 고친다.

위험·한계
- PostgreSQL 저장소의 기다림이 프론트 totalDeadline보다 길면 응답 없는
  끝(결과 불명, 키 유지)이 된다. 판정은 안전 쪽이다.
- Fileserver 계약(docs/fileserver/http-contract.md)은 bbe944bd 이후 바뀌지
  않았다.

검증
- check:backend-contract-drift --backend <백엔드 checkout>: pinned
  45d2a478.
- backend-contract-pin·changelog-review-ids 테스트 11건,
  verify:documentation PASS_SCOPED.

Refs: docs/reviews/2026-11-03-maturity-review/12-guardrails-ci.md 12-06
2026-11-05 00:24:59 +09:00
..