문제 짝 백엔드 http-contract.md §4는 web 전용 code 넷을 적는다. 그중 503 RATE_LIMIT_UNAVAILABLE(저장소 응답 없음, retryable, Retry-After 있음)과 503 RATE_LIMIT_INCOMPATIBLE(제공자 불일치)이 답 표 사본에도 프론트 판정 표에도 없다. 그래서 이 503은 기능 분류기가 정하고, create:feature가 만든 쓰기의 분류기는 늘 MAYBE_APPLIED다. 아무 일도 일어나지 않은 저장이 결과 불명이 되고, NEVER 쓰기는 사실과 다른 "변경됨으로 확인"을 눌러야 폼이 풀린다(리뷰 실험 X4: 429는 NOT_APPLIED, 503 둘은 SERVER_FAILURE/MAYBE_APPLIED). pin은 §4를 대조했다고 적었지만 사본에는 REQUEST_TIMEOUT 한 행만 있었다. 고른 방법 백엔드 45d2a478을 읽기만 해서 code마다 판정했다. 두 code는 RateLimitInterceptor.preHandle이 false를 돌려주며 쓰고(Unavailable· Indeterminate → RATE_LIMIT_UNAVAILABLE, Incompatible → RATE_LIMIT_INCOMPATIBLE), main 소스에서 두 code를 내는 곳은 그 두 줄뿐이다. preHandle이 false면 handler를 부르지 않으므로 둘 다 쓰기 전이다. 백엔드는 같은 키 재전송을 요구하지 않는다(멱등성 executor 전). 그래서 답 표 사본에 refusedBeforeWrite: true, sameKeyResend: false로 두 행을 더하고, 프론트 거절 표 REFUSED_BEFORE_WRITE에 status 503과 함께 더했다. pin 테스트의 "답 표대로 읽는다" 규칙이 그대로 NOT_APPLIED를 요구하고 양방향 대조가 두 표를 함께 지킨다. kind는 지금처럼 SERVER_FAILURE(action retry)이고, KEYED도 자동 재전송은 없다(같은 키를 요구하는 답은 503 IDEMPOTENCY_UNAVAILABLE 하나다). pin의 comparedOn을 §4를 다시 대조한 날짜로 올렸다. 계약 문서 4.1·6.1절과 매뉴얼 01·02의 5xx 행 수를 고쳤다. 버린 대안 생성기 분류기가 503을 code별로 보게 한다: 생성 기능에만 고쳐지고 손으로 쓴 Envelope operation은 그대로 남는다. 판정은 백엔드 답 표 한 곳이 정한다는 지금 규칙을 따랐다. 위험·한계 - 추론(실행 확인 안 함): Spring MVC는 비동기 처리(Callable·DeferredResult) 뒤 ASYNC 재디스패치에서도 interceptor의 preHandle을 다시 부르고, 이 interceptor는 dispatcher 종류를 보지 않는다. 비동기 쓰기 컨트롤러라면 이 503(그리고 429)이 쓰기 뒤에도 나올 수 있다. 45d2a478에는 Envelope을 돌려주는 비동기 쓰기 컨트롤러가 없다(web-advanced 스트리밍과 fileserver 전송뿐). 계약 6.1절에 적었다. 백엔드에 넘길 요청: RateLimitInterceptor가 DispatcherType.REQUEST에서만 평가하게 한다. - fileserver-upload.ts는 같은 백엔드 답을 자기 표로 따로 판정한다(01 영역). 여기서는 바꾸지 않았다. - NOT_APPLIED가 되면서 IDEMPOTENT 쓰기는 이 503에 retryBudget 안에서 자동으로 다시 보낼 수 있게 됐다(503은 재시도 status다). 쓰기 전 거절이라 중복은 없다. RATE_LIMIT_INCOMPATIBLE은 백엔드가 retryable false로 보내지만 실행기는 status로 판단하므로 같은 답을 한 번 더 받을 수 있다. KEYED·NEVER는 자동 재전송이 없다. 검증 desktop batch에서 확인: node scripts/run-vitest.ts run tests/unit/backend-envelope.test.ts tests/unit/backend-contract-pin.test.ts tests/integration/http-execution-v3-envelope.test.ts Refs: 1105/03-02
74 lines
1.6 KiB
JSON
74 lines
1.6 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
|
|
},
|
|
{
|
|
"section": "4",
|
|
"code": "RATE_LIMIT_UNAVAILABLE",
|
|
"status": 503,
|
|
"refusedBeforeWrite": true,
|
|
"sameKeyResend": false
|
|
},
|
|
{
|
|
"section": "4",
|
|
"code": "RATE_LIMIT_INCOMPATIBLE",
|
|
"status": 503,
|
|
"refusedBeforeWrite": true,
|
|
"sameKeyResend": false
|
|
}
|
|
]
|
|
}
|