feat(presentation): 폼 저장 실패와 결과 불명 화면에 지원 참조를 보인다 (0929/08-04)

문제: 조회 실패는 failure.requestId를 "지원 참조"로 보이는데, 폼의
FormFailureStatus는 넘기지 않았다. 결과 불명 저장은 AsyncSurface의
indicator 분기라 실패 객체가 없고, 폼도 MAYBE_APPLIED 실패를 버렸다.
사용자가 가장 문의하고 싶은 경우에 줄 식별자가 없었다. 샘플의
contact-support 이동은 식별자를 버리고, 상태 페이지는 식별자처럼 보이는
고정 문자열 "REFERENCE-STATUS-DEMO"를 보였다.

고른 방법: 리뷰의 최소 개선 방향(기대 계약 고정)대로 했다.
- FormFailureStatus가 supportReference={failure.requestId}를 넘긴다.
- useAppForm이 MAYBE_APPLIED 실패도 보관하고 supportReference(현재
  보이는 상태 실패 또는 결과 불명 저장의 requestId)를 돌려준다. failure는
  여전히 상태 결과에만 값이 있어 FormFailureStatus가 결과 불명을 두 번
  그리지 않는다.
- AsyncSurface가 supportReference prop을 받아 결과 불명 indicator에서만
  보인다. 샘플 폼 페이지가 form.supportReference를 넘긴다.
- 샘플 contact-support 이동은 식별자를 history state로 넘기고(URL에
  넣지 않음), 상태 페이지는 받은 문자열만 보이고 없으면 줄을 숨긴다.
공개 API는 추가만 했다(useAppForm 반환 필드, AsyncSurface prop).
버린 대안: 결과 불명 식별자를 mutation 채널(application-query.ts)에
두기 — 재마운트 뒤에도 남지만 925줄 파일의 채널 구조를 바꾸고 08-03
(raw 경로 정리)과 겹친다.

위험·한계: 폼이 재마운트되면 결과 불명 배너는 mutation 채널에서
남지만 식별자는 사라진다(제출 값과 같은 수명). 서버가
x-correlation-id를 노출하지 않으면 식별자가 없다(0929 FOLLOW-UP 03-03).
결과 불명 화면에 줄 하나가 생긴다. 초기 JS는 이번 브랜치 전체 기준
202,520 → 202,631 B(예산 204,800 B).

검증:
- RED: 새 테스트 6건이 수정 전 실패(form-foundation 2, async-surface 1,
  reference-page 3. 예: "Unable to find an element with the text: 지원
  참조: corr-save-500"). 새 e2e가 이전 빌드에서 실패(getByText('지원 참조:
  corr-save-500') not found).
- GREEN: 관련 3파일 70/70, tests/component·features·architecture
  59 files 336 tests 통과. e2e reference-save·reference-form·
  reference-route chromium·firefox·webkit 42/42. tsc app·test, eslint,
  check-i18n, check-design-system 통과.

Refs: docs/reviews/2026-09-29-maturity-review/08-presentation.md 08-04
This commit is contained in:
DongHyeonka
2026-11-01 23:20:32 +09:00
parent b9a8a1a6c2
commit e54fbf2014
10 changed files with 203 additions and 3 deletions
@@ -147,6 +147,7 @@ export default function ReferenceResourceFormPage() {
<>
<AsyncSurface
state={mutation.state}
supportReference={form.supportReference}
onReconcileUnknownEffect={(resolution) => {
void mutation
.reconcileUnknownEffect(resolution)
@@ -1,11 +1,24 @@
import { useNavigate } from "react-router-dom";
import { useLocation, useNavigate } from "react-router-dom";
import { StatusPage } from "../../../presentation/design-system/index.ts";
import { useLocale } from "../../../presentation/i18n/index.ts";
import type { ReferenceSupportState } from "./use-reference-failure-action.ts";
/** History state is untrusted input: only a string reference is shown. */
function receivedSupportReference(state: unknown): string | undefined {
const reference =
state && typeof state === "object"
? (state as ReferenceSupportState).supportReference
: undefined;
return typeof reference === "string" && reference !== "" ? reference : undefined;
}
export default function ReferenceResourceStatusPage() {
const navigate = useNavigate();
const location = useLocation();
const { message } = useLocale();
// 0929/08-04. Only the id the failed request carried; none when opened directly.
const supportReference = receivedSupportReference(location.state);
return (
<StatusPage
@@ -20,7 +33,7 @@ export default function ReferenceResourceStatusPage() {
label: message("reference.status.back"),
onAction: () => navigate("/examples/reference-resources"),
}}
supportReference="REFERENCE-STATUS-DEMO"
supportReference={supportReference}
/>
);
}
@@ -6,6 +6,9 @@ import { useSession } from "../../../presentation/providers/session-provider.tsx
const REFERENCE_SUPPORT_ROUTE = "/examples/reference-resources/status";
/** 0929/08-04. What the support status page receives as navigation state. */
export type ReferenceSupportState = Readonly<{ supportReference?: string }>;
/**
* Reference queries own concrete destinations for generic application failure
* actions. Retry remains query-owned; guarded release reloads remain in the
@@ -18,6 +21,7 @@ export function useReferenceFailureAction(
const navigate = useNavigate();
const { beginSignIn } = useSession();
const action = failure?.action;
const requestId = failure?.requestId;
const handleAction = useCallback(() => {
if (action === "reauth") {
const returnTo = `${location.pathname}${location.search}${location.hash}`;
@@ -31,10 +35,14 @@ export function useReferenceFailureAction(
return;
}
if (action === "contact-support") {
void navigate(REFERENCE_SUPPORT_ROUTE);
// The id stays in history state, never in the URL.
const state: ReferenceSupportState =
requestId === undefined ? {} : { supportReference: requestId };
void navigate(REFERENCE_SUPPORT_ROUTE, { state });
}
}, [
action,
requestId,
beginSignIn,
location.hash,
location.pathname,