문제 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
60 lines
1.3 KiB
JSON
60 lines
1.3 KiB
JSON
{
|
|
"schemaVersion": 1,
|
|
"source": {
|
|
"repository": "clean-architecture-backend-template",
|
|
"commit": "45d2a478b800586f1d84151723629a560265d58e",
|
|
"document": "docs/web/http-contract.md"
|
|
},
|
|
"answers": [
|
|
{
|
|
"section": "2",
|
|
"code": "IDEMPOTENT_IN_FLIGHT",
|
|
"status": 409,
|
|
"refusedBeforeWrite": false,
|
|
"sameKeyResend": true
|
|
},
|
|
{
|
|
"section": "2",
|
|
"code": "IDEMPOTENT_REQUEST_MISMATCH",
|
|
"status": 422,
|
|
"refusedBeforeWrite": true,
|
|
"sameKeyResend": false
|
|
},
|
|
{
|
|
"section": "2",
|
|
"code": "IDEMPOTENCY_KEY_INVALID",
|
|
"status": 400,
|
|
"refusedBeforeWrite": true,
|
|
"sameKeyResend": false
|
|
},
|
|
{
|
|
"section": "2",
|
|
"code": "IDEMPOTENCY_UNAVAILABLE",
|
|
"status": 503,
|
|
"refusedBeforeWrite": true,
|
|
"sameKeyResend": true
|
|
},
|
|
{
|
|
"section": "2",
|
|
"code": "IDEMPOTENCY_COMPLETION_UNKNOWN",
|
|
"status": 503,
|
|
"refusedBeforeWrite": false,
|
|
"sameKeyResend": true
|
|
},
|
|
{
|
|
"section": "2",
|
|
"code": "IDEMPOTENCY_RECOVERY_REQUIRED",
|
|
"status": 500,
|
|
"refusedBeforeWrite": false,
|
|
"sameKeyResend": true
|
|
},
|
|
{
|
|
"section": "4",
|
|
"code": "REQUEST_TIMEOUT",
|
|
"status": 503,
|
|
"refusedBeforeWrite": false,
|
|
"sameKeyResend": false
|
|
}
|
|
]
|
|
}
|