fix(forms): 짝 백엔드 필드 검증 code마다 문구를 보인다 (1101/14.4)
문제
짝 백엔드는 필드 검증 실패의 details[].code에 NOT_BLANK, SIZE 같은 자기
code를 싣는다(백엔드 5786126c ClientSafeValidationDetails.java RULES 18-42와
INVALID). 폼 문구 표(form-contracts.ts VALIDATION_COPY)에는 zod code와
REQUIRED만 있어서, 백엔드 code는 모두 form.validation.unknown("입력값을
확인해 주세요.")이 된다. 필드 위치는 맞지만 무엇이 틀렸는지 알 수 없다.
고른 방법
- VALIDATION_COPY에 백엔드 code 20개를 모두 넣었다. 뜻이 같은 것은 기존
키를 쓴다: NOT_NULL·NOT_BLANK·NOT_EMPTY → required, PATTERN →
invalidFormat, TYPE_MISMATCH → invalidType, ASSERT_TRUE·ASSERT_FALSE →
invalidValue.
- 나머지 13개는 새 키로 ko-KR·en-US 문구를 넣었다(size, min, max, positive,
positiveOrZero, negative, negativeOrZero, email, past, pastOrPresent,
future, futureOrPresent, invalid). ar-EG는 en-US 표를 그대로 쓴다.
- 모르는 code는 그대로 form.validation.unknown이다.
- 백엔드 code를 쓰는 곳은 V2 client가 이미 details[].code를 issue code로
넘기는 경로(errors.ts safeValidationIssues)라 표 한 곳만 바꿨다.
버린 대안
- SIZE를 tooSmall·tooBig에 맞추기: SIZE는 짧은지 긴지 말하지 않는다. 한쪽
문구를 고르면 틀린 말을 할 수 있다.
- 백엔드가 보낸 message를 보여 주기: 백엔드 문구를 화면에 그리지 않는 규칙
(check-i18n rawFailureRender, errors.ts)을 깬다. 한국어만 있다.
- 백엔드 소스에서 code 목록을 읽는 검사: 두 repo가 나란히 있어야 돈다.
목록은 테스트에 SHA와 함께 적었다.
위험·한계
- 백엔드가 code를 더하면 프론트는 알지 못하고 기본 문구가 나온다. 알아챌
방법은 백엔드가 code 목록을 문서나 레지스트리로 내주는 것이다(최종 보고에
제안).
- 페이지·정렬 파라미터 code(PAGE_NEGATIVE, SIZE_EXCEEDS_MAX 등)는 details가
배열이 아니라 폼 issue가 되지 않으므로 넣지 않았다.
- 초기 JS gzip 202,770 → 203,165 B(+395, 예산 204,800). i18n catalog가 초기
청크에 있다.
검증
- RED: tests/component/form-foundation.test.tsx 3행 실패. ko-KR·en-US 모두
백엔드 code 20개가 기본 문구였고, 400 VALIDATION_FAILED NOT_BLANK 행은
"Name: 입력값을 확인해 주세요."를 보였다.
- GREEN: 위 3행과 "keeps the default copy for a code it does not know" 통과.
tests/component·unit·features 237 files 2951 tests 통과.
- node scripts/generate-product-feature-index.ts && node scripts/check-i18n.ts:
237 keys across 4 locales PASS. node scripts/check-registries.ts: PASS,
compatibility=none.
- tsc app·test 통과, 바꾼 파일 eslint 통과.
- 초기 JS는 기준 트리와 이 트리를 각각 build-frontend.ts로 빌드하고
check-bundle.ts와 같은 방식(classifyViteJavascript initialFiles, gzipSync)으로
쟀다. check-bundle.ts는 pnpm이 만드는 bundle.json이 필요해 돌리지 않았다.
Refs: docs/reviews/2026-11-01-maturity-review/README.md 14.4
This commit is contained in:
@@ -37,6 +37,30 @@ const VALIDATION_COPY = Object.freeze({
|
||||
invalid_type: "form.validation.invalidType",
|
||||
invalid_format: "form.validation.invalidFormat",
|
||||
invalid_value: "form.validation.invalidValue",
|
||||
// 1101/14.4. The paired backend's field codes, every one it can send
|
||||
// (clean-architecture-backend-template 5786126c,
|
||||
// ClientSafeValidationDetails.java RULES and INVALID). A code it adds later
|
||||
// shows form.validation.unknown until it gets a row here.
|
||||
NOT_NULL: "form.validation.required",
|
||||
NOT_BLANK: "form.validation.required",
|
||||
NOT_EMPTY: "form.validation.required",
|
||||
SIZE: "form.validation.size",
|
||||
MIN: "form.validation.min",
|
||||
MAX: "form.validation.max",
|
||||
POSITIVE: "form.validation.positive",
|
||||
POSITIVE_OR_ZERO: "form.validation.positiveOrZero",
|
||||
NEGATIVE: "form.validation.negative",
|
||||
NEGATIVE_OR_ZERO: "form.validation.negativeOrZero",
|
||||
PATTERN: "form.validation.invalidFormat",
|
||||
EMAIL: "form.validation.email",
|
||||
PAST: "form.validation.past",
|
||||
PAST_OR_PRESENT: "form.validation.pastOrPresent",
|
||||
FUTURE: "form.validation.future",
|
||||
FUTURE_OR_PRESENT: "form.validation.futureOrPresent",
|
||||
ASSERT_TRUE: "form.validation.invalidValue",
|
||||
ASSERT_FALSE: "form.validation.invalidValue",
|
||||
TYPE_MISMATCH: "form.validation.invalidType",
|
||||
INVALID: "form.validation.invalid",
|
||||
});
|
||||
|
||||
type MessageResolver = (key: ParameterlessMessageKey) => string;
|
||||
|
||||
Reference in New Issue
Block a user