Files
clean-architecture-frontend…/docs/architecture
DongHyeonka 6142cc8e08 docs(contracts): 재전송을 푸는 VALIDATION_FAILED는 요청 내용 검사여야 한다고 적는다
문제: b41990c 뒤 같은 키 재전송이 400 VALIDATION_FAILED로 거절되면 훅과 폼이
첫 요청도 거절된 것으로 보고 결과 불명을 푼다. 백엔드가 시각이나 데이터베이스를
읽는 규칙을 VALIDATION_FAILED로 내면, 첫 요청이 적용된 뒤의 재전송도 이 답을
받을 수 있다. 계약 문서 6.1절은 이 전제를 적지 않는다(최종 리뷰 FR-02).

고른 방법: 6.1절의 재전송 규칙 옆에 한 문장을 더한다. VALIDATION_FAILED는
요청 내용만 보는 검사여야 하고, 시각이나 데이터베이스를 읽는 규칙은 기능이
선언한 code로 내며 그 code는 결과 불명을 풀지 않는다.
버린 대안: 프론트에서 VALIDATION_FAILED도 결과 불명으로 남기기(메인 세션
결정 "D10 보완 2"가 이 code를 푸는 쪽으로 정했다).

위험·한계: 문서 규칙이다. 백엔드에서 이것을 막는 검사는 없다(6.1절 끝의 남은
위험과 같다).

검증: desktop batch에서 확인. corepack pnpm verify:documentation, node
scripts/run-vitest.ts run tests/unit/backend-contract-pin-document.test.ts

Refs: 1106/03-01 (final review FR-02)
2026-11-06 08:25:56 +09:00
..