문제 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
20 lines
613 B
JSON
20 lines
613 B
JSON
{
|
|
"schemaVersion": 1,
|
|
"backend": {
|
|
"repository": "clean-architecture-backend-template",
|
|
"commit": "45d2a478b800586f1d84151723629a560265d58e",
|
|
"document": "docs/web/http-contract.md",
|
|
"sectionsCompared": ["1", "2", "4"]
|
|
},
|
|
"frontend": {
|
|
"contractDocument": "docs/architecture/backend-api-and-server-state-contract.md",
|
|
"contractSections": ["4.1", "6", "6.1"],
|
|
"readers": ["src/adapters/http/backend-envelope.ts"]
|
|
},
|
|
"tables": {
|
|
"idempotencyAnswers": "config/contracts/backend-idempotency-answers.json"
|
|
},
|
|
"owner": "frontend-platform",
|
|
"comparedOn": "2026-11-04"
|
|
}
|