fix(query): 재전송 거절의 결과 불명 해제를 짝 백엔드 표 code로만 정한다

문제: 80e7f1d의 isRefusedOnEveryAttempt는 kind가 VALIDATION_REJECTED면 code를
보지 않고 참을 돌려준다. 그 kind는 기능의 mapProblem이 정한다. 생성기는
선언한 <FEATURE>_INVALID를 VALIDATION_REJECTED로 옮기고
(scripts/create-feature-write-slice.ts mapProblem), 참조 기능 gateway는 code와
상관없이 모든 422를 그렇게 옮긴다(reference-http-gateway.ts). 그래서 기능이
선언한 code나 422 IDEMPOTENT_REQUEST_MISMATCH로 끝난 같은 키 재전송이 결과
불명을 푼다. 함수 주석, CHANGELOG, 런북 6.3-4는 이것들이 결과 불명으로
남는다고 적는다. 기존 테스트는 mapProblem 없이 실패를 만들어 이 길을 타지
않았다(최종 리뷰 FR-01).

고른 방법(메인 세션 결정 "D10 보완 2"): 재전송 거절은 짝 백엔드 표의 code일
때만 결과 불명을 푼다. 지금은 400 VALIDATION_FAILED와 400
IDEMPOTENCY_KEY_INVALID다(REFUSALS_OF_EVERY_ATTEMPT, code와 status 함께). kind
줄을 지우고 kind로 입력 검증을 말하던 주석과 런북 6.3-4를 고쳤다. 기능 code는
상태 규칙일 수 있어 mapProblem이 정한 kind를 믿지 않는다. 400
VALIDATION_FAILED는 필드 목록이 있든 없든 전처럼 푼다.
테스트: 훅의 결과 불명 유지 it.each에 mapProblem 모양(VALIDATION_REJECTED +
선언 code, VALIDATION_REJECTED + 422 IDEMPOTENT_REQUEST_MISMATCH) 두 행을 더했다.
참조 페이지에서 422 재전송이 필드 오류와 다시 저장을 보인다던 테스트를, 결과
불명이 남고 확인이 보이는 테스트로 바꿨다. 리뷰가 요청한 대로 다시 마운트한 폼이
다른 값을 보이는 채 재전송해 422 IDEMPOTENT_REQUEST_MISMATCH를 받으면 결과
불명과 확인 버튼이 남는 테스트를 더했다.
버린 대안: kind 줄을 남기고 기능 선언 code만 빼기(실행기는 code가 선언인지
폼과 훅에 알리지 않는다).

위험·한계: 참조 기능처럼 problem details를 읽는 기능의 422 입력 검증은 재전송
뒤 결과 불명으로 남는다. 출구는 결과 불명 화면의 확인이다. 리뷰 실험 03-R1
X1~X3·X5는 그대로 키가 모두 key-1이어야 한다. CHANGELOG는 다음 커밋이 적는다.

검증: desktop batch에서 확인. node scripts/run-vitest.ts run
tests/component/application-mutation-admission.test.tsx
tests/features/reference-feature/reference-page.test.tsx
tests/component/form-foundation.test.tsx tests/unit/backend-envelope.test.ts,
리뷰 실험 03-R1 패치를 이 커밋에 적용

Refs: 1106/03-01 (final review FR-01)
This commit is contained in:
DongHyeonka
2026-11-06 08:25:28 +09:00
parent 59b2ccb5e3
commit b41990cdd5
5 changed files with 101 additions and 34 deletions
@@ -260,10 +260,12 @@ diagnostics에만 남고 `api.request.failed`에는 세지 않는다(03-07). 그
`IDEMPOTENT_REQUEST_MISMATCH`, 기능이 선언한 code) 보내지 못하면(`NOT_STARTED`) 그 `IDEMPOTENT_REQUEST_MISMATCH`, 기능이 선언한 code) 보내지 못하면(`NOT_STARTED`) 그
시도만 적용되지 않은 것이다. 결과 불명과 key는 그대로다. 폼은 "잠시 뒤 같은 요청으로 시도만 적용되지 않은 것이다. 결과 불명과 key는 그대로다. 폼은 "잠시 뒤 같은 요청으로
다시 보내 주세요"와 결과 불명 화면(확인, 다시 보내기)을 보이고 저장을 받지 않는다. 다시 보내 주세요"와 결과 불명 화면(확인, 다시 보내기)을 보이고 저장을 받지 않는다.
401은 다시 로그인 안내가 먼저다. 예외는 같은 요청이 매번 받는 거절이다. 입력 검증 401은 다시 로그인 안내가 먼저다. 예외는 같은 요청이 매번 받는 거절이다. 짝 백엔드 표의
(`VALIDATION_REJECTED`, 400 `VALIDATION_FAILED`)과 400 `IDEMPOTENCY_KEY_INVALID`는 첫 400 `VALIDATION_FAILED`(필드 목록이 있든 없든)와 400 `IDEMPOTENCY_KEY_INVALID`만 첫
요청도 거절됐다는 뜻이라 결과 불명을 풀고, 폼은 필드 오류를 보이고 저장을 다시 요청도 거절됐다는 뜻으로 읽어 결과 불명을 풀고, 폼은 필드 오류를 보이고 저장을 다시
받는다(1106/03-01, `src/contracts/errors.ts` `isRefusedOnEveryAttempt`). 받는다. 기능의 `mapProblem`이 정한 kind(`VALIDATION_REJECTED`)는 보지 않는다. 기능
code는 상태 규칙일 수 있다(1106/03-01, `src/contracts/errors.ts`
`isRefusedOnEveryAttempt`).
키가 없는 command(`NEVER`)는 서버가 두 번째 요청을 가려내지 못하므로 재전송 버튼을 키가 없는 command(`NEVER`)는 서버가 두 번째 요청을 가려내지 못하므로 재전송 버튼을
그리지 않는다(`canResendUnknownEffect`, 0929/03-03). 같은 canonical input의 재저장도 그리지 않는다(`canResendUnknownEffect`, 0929/03-03). 같은 canonical input의 재저장도
보내지 않는다. 훅의 `submit`이 `NOT_STARTED` `DUPLICATE_IN_FLIGHT`(code 보내지 않는다. 훅의 `submit`이 `NOT_STARTED` `DUPLICATE_IN_FLIGHT`(code
+9 -8
View File
@@ -260,17 +260,18 @@ export const REFUSALS_OF_EVERY_ATTEMPT: Readonly<Record<string, number>> =
}); });
/** /**
* 1106/03-01 (D10 supplement). A `NOT_APPLIED` refusal the same request gets * 1106/03-01 (D10 supplement and its second fix). A `NOT_APPLIED` refusal
* on every attempt: input validation (`VALIDATION_REJECTED`) or a row above. * the same request gets on every attempt: a row above, code and status
* A resend of an unknown request that meets one shows the first attempt was * together. A resend of an unknown request that meets one shows the first
* refused too, so the request is settled. Not one: a refusal before the * attempt was refused too, so the request is settled. Not one: a refusal
* idempotency check or one that changes over time (429, 401, 403, 503 * before the idempotency check or one that changes over time (429, 401,
* RATE_LIMIT_*), a code a feature declared refused before its write (it may * 403, 503 RATE_LIMIT_*), a code a feature declared refused before its
* be a rule on changing state), any other code, and `NOT_STARTED`. * write (it may be a rule on changing state), any other code, and
* `NOT_STARTED`. The kind is not read: a feature's `mapProblem` sets it, and
* it maps its own codes, or every 422, to `VALIDATION_REJECTED`.
*/ */
export function isRefusedOnEveryAttempt(failure: AppFailure): boolean { export function isRefusedOnEveryAttempt(failure: AppFailure): boolean {
if (failure.effect !== "NOT_APPLIED") return false; if (failure.effect !== "NOT_APPLIED") return false;
if (failure.kind === "VALIDATION_REJECTED") return true;
return ( return (
Object.hasOwn(REFUSALS_OF_EVERY_ATTEMPT, failure.code) && Object.hasOwn(REFUSALS_OF_EVERY_ATTEMPT, failure.code) &&
REFUSALS_OF_EVERY_ATTEMPT[failure.code] === failure.httpStatus REFUSALS_OF_EVERY_ATTEMPT[failure.code] === failure.httpStatus
@@ -636,10 +636,10 @@ export function useApplicationMutation<Input, Value>(
// that this attempt did not apply; the first may have. The request // that this attempt did not apply; the first may have. The request
// stays unknown with its intent, so the next save or resend carries // stays unknown with its intent, so the next save or resend carries
// the same key, never a new one (backend http-contract.md §2). A // the same key, never a new one (backend http-contract.md §2). A
// refusal every attempt of the request gets (input validation, a key // refusal every attempt of the request gets (the paired backend's 400
// the server's rule rejects) shows the first was refused too, so the // VALIDATION_FAILED and IDEMPOTENCY_KEY_INVALID) shows the first was
// request is settled and the form can take a corrected save // refused too, so the request is settled and the form can take a
// (isRefusedOnEveryAttempt, D10 supplement). // corrected save (isRefusedOnEveryAttempt, D10 supplement).
const resendLeavesUnknown = (failure: AppFailure): boolean => const resendLeavesUnknown = (failure: AppFailure): boolean =>
replayed !== undefined && replayed !== undefined &&
(!scope || scope.isCurrent()) && (!scope || scope.isCurrent()) &&
@@ -759,6 +759,26 @@ describe("application mutation intent admission", () => {
effect: "NOT_APPLIED", effect: "NOT_APPLIED",
}), }),
], ],
// Final review FR-01. The kind is the feature's mapProblem: the
// scaffold maps its declared code to a field error, and the reference
// gateway maps every 422 to one, whatever the code.
[
"refused with a declared code the feature maps to a field error",
createFailure("VALIDATION_REJECTED", "CREATE_REPLAYED", 0, {
code: "WORKLOG_INVALID",
httpStatus: 400,
effect: "NOT_APPLIED",
validationIssues: [{ path: "name", code: "INVALID" }],
}),
],
[
"refused with 422 IDEMPOTENT_REQUEST_MISMATCH read as a field error",
createFailure("VALIDATION_REJECTED", "CREATE_REPLAYED", 0, {
code: "IDEMPOTENT_REQUEST_MISMATCH",
httpStatus: 422,
effect: "NOT_APPLIED",
}),
],
])("keeps the request unknown with its key when the resend is %s", async (_label, refusal) => { ])("keeps the request unknown with its key when the resend is %s", async (_label, refusal) => {
const { hook, intents } = renderKeyedCreate([ const { hook, intents } = renderKeyedCreate([
unknown, unknown,
@@ -415,9 +415,10 @@ describe("reference feature page states", () => {
/** /**
* 1106/03-01 (D10 supplement). The form is never held for good after a * 1106/03-01 (D10 supplement). The form is never held for good after a
* same-key resend. A refusal that may change (429) keeps the result * same-key resend. A refusal that may change (429) keeps the result
* unknown and the confirm and resend actions on screen. A field error the * unknown and the confirm and resend actions on screen. So does a 422
* request gets on every attempt settles it: the field shows the error and * (final review FR-01): this feature's gateway reads every 422 as a field
* the save is on again. * error whatever its code, and only the paired backend's own table codes
* settle a resent request.
*/ */
async function resendAnUnknownCreate(resendAnswer: ReferenceResult<ReferenceResourceView>) { async function resendAnUnknownCreate(resendAnswer: ReferenceResult<ReferenceResourceView>) {
const user = userEvent.setup(); const user = userEvent.setup();
@@ -467,30 +468,26 @@ describe("reference feature page states", () => {
expect(await screen.findByText("저장했습니다.")).toBeVisible(); expect(await screen.findByText("저장했습니다.")).toBeVisible();
}); });
it("shows the field error and saves again when the resend is refused on its input", async () => { it("keeps the confirm on screen when the resend is refused with a 422", async () => {
const { user, name, createResource } = await resendAnUnknownCreate({ const { user, name } = await resendAnUnknownCreate({
ok: false, ok: false,
error: createFailure("VALIDATION_REJECTED", "CREATE_REFERENCE_RESOURCE", 0, { error: createFailure("VALIDATION_REJECTED", "CREATE_REFERENCE_RESOURCE", 0, {
code: "REFERENCE_RESOURCE_REJECTED",
effect: "NOT_APPLIED", effect: "NOT_APPLIED",
httpStatus: 422, httpStatus: 422,
validationIssues: [{ path: "name", code: "REQUIRED" }], validationIssues: [{ path: "name", code: "REQUIRED" }],
}), }),
}); });
await waitFor(() => expect(name).toHaveAttribute("aria-invalid", "true")); expect(
expect(screen.queryByText("변경 결과를 확인할 수 없습니다.")).not.toBeInTheDocument(); await screen.findByText(KO_MESSAGES["form.resendLater"]),
expect(screen.getByRole("button", { name: "저장" })).toBeEnabled(); ).toBeVisible();
await user.clear(name); expect(screen.getByText("변경 결과를 확인할 수 없습니다.")).toBeVisible();
await user.type(name, "Corrected"); expect(name).not.toHaveAttribute("aria-invalid");
await user.click(screen.getByRole("button", { name: "저장" })); expect(screen.getByRole("button", { name: "저장" })).toBeDisabled();
await user.click(screen.getByRole("button", { name: "변경됨으로 확인" }));
expect(await screen.findByText("저장했습니다.")).toBeVisible(); expect(await screen.findByText("저장했습니다.")).toBeVisible();
const keys = createResource.mock.calls.map(([, context]) => context?.intent?.idempotencyKey);
expect(keys).toEqual([
"reference-page-key-1",
"reference-page-key-1",
"reference-page-key-2",
]);
}); });
it.each([ it.each([
@@ -729,7 +726,9 @@ describe("reference feature page states", () => {
* 1106/08-01. The form the user came back to did not start the save * 1106/08-01. The form the user came back to did not start the save
* still running, and holds none of its result (review probe 08-R1). * still running, and holds none of its result (review probe 08-R1).
*/ */
async function leaveDuringSaveAndComeBack() { async function leaveDuringSaveAndComeBack(
...laterAnswers: readonly ReferenceResult<ReferenceResourceView>[]
) {
const user = userEvent.setup(); const user = userEvent.setup();
let release: let release:
| ((result: ReferenceResult<ReferenceResourceView>) => void) | ((result: ReferenceResult<ReferenceResourceView>) => void)
@@ -742,6 +741,7 @@ describe("reference feature page states", () => {
release = resolve; release = resolve;
}), }),
); );
for (const answer of laterAnswers) createResource.mockResolvedValueOnce(answer);
renderReference( renderReference(
inputWith({ createResource }), inputWith({ createResource }),
"/examples/reference-resources/new", "/examples/reference-resources/new",
@@ -761,12 +761,56 @@ describe("reference feature page states", () => {
expect(await screen.findByText("변경 사항을 저장하고 있습니다.")).toBeVisible(); expect(await screen.findByText("변경 사항을 저장하고 있습니다.")).toBeVisible();
return { return {
user, user,
createResource,
release(result: ReferenceResult<ReferenceResourceView>) { release(result: ReferenceResult<ReferenceResourceView>) {
release?.(result); release?.(result);
}, },
}; };
} }
// 1106/03-01 (final review FR-01). The remounted form shows other values
// than the save it did not start; its resend sends that save, with its
// key. A 422 IDEMPOTENT_REQUEST_MISMATCH there says the key already
// reached the server, so the first request may have applied: it stays
// unknown and the confirm stays on screen.
it("keeps a resent request unknown on a remounted form when the server answers 422 IDEMPOTENT_REQUEST_MISMATCH", async () => {
const { user, createResource, release } = await leaveDuringSaveAndComeBack({
ok: false,
error: createFailure("VALIDATION_REJECTED", "CREATE_REFERENCE_RESOURCE", 0, {
code: "IDEMPOTENT_REQUEST_MISMATCH",
effect: "NOT_APPLIED",
httpStatus: 422,
}),
});
release({
ok: false,
error: createFailure("SERVER_FAILURE", "CREATE_REFERENCE_RESOURCE", 0, {
effect: "MAYBE_APPLIED",
}),
});
await screen.findByRole("button", { name: "같은 요청으로 다시 보내기" });
await user.type(
screen.getByRole("textbox", { name: /새 항목 이름/ }),
"Second item",
);
await user.click(
screen.getByRole("button", { name: "같은 요청으로 다시 보내기" }),
);
await waitFor(() => expect(createResource).toHaveBeenCalledTimes(2));
expect(
await screen.findByText(KO_MESSAGES["form.resendLater"]),
).toBeVisible();
expect(screen.getByText("변경 결과를 확인할 수 없습니다.")).toBeVisible();
expect(screen.getByRole("button", { name: "변경됨으로 확인" })).toBeVisible();
const [first, second] = createResource.mock.calls;
expect(second?.[0]).toEqual(first?.[0]);
expect(second?.[1]?.intent?.idempotencyKey).toBe(
first?.[1]?.intent?.idempotencyKey,
);
});
// 1106/08-01 (A). Confirming that save from the remounted form used to // 1106/08-01 (A). Confirming that save from the remounted form used to
// show nothing and drop focus to the body: the form had no submitted // show nothing and drop focus to the body: the form had no submitted
// values to settle. // values to settle.