fix(query): stale 실패를 렌더 중에 계산하고 실패 진단이 원인을 남긴다 #28

Closed
donghyeon.kang wants to merge 0 commits from donghyeon.kang/fix/r9-query-state-diagnostics AGit into main
Owner

무엇을, 왜

  • useApplicationQuery가 「데이터가 있고 마지막 조회가 실패했다」는 파생 값을 effect로 state에 복사한다. 다시 시도가 그 값을 지우고 refetch해도 조회 중에 effect가 다시 돌아 true로 되돌린다. 그래서 낡은 데이터의 다시 시도가 진행 중에도 지난 실패(stale-degraded)를 보인다(1112/01-05).
  • query·mutation 실패 진단이 원인을 버린다. cache onError가 모든 실패를 cache.operation.failed로 남기는데 ApplicationQueryError에 kind가 없어 이름(APPLICATION_QUERY_ERROR)이 남는다. 404, 필드 거절, abort가 한 가지로 남는다. 예상 밖 throw는 정의 이름 대신 고정 문자열을 쓴다(1112/01-04).

고른 방법과 버린 대안

  • staleFailure를 query.isError && hasData && !query.isFetching으로 렌더 중에 계산하고 state와 effect를 지운다. 다시 시도 중은 refreshing이다.
  • ApplicationQueryError가 failure.kind를 kind로 싣는다.
  • 예상 밖 throw는 query 정의 ID와 mutation 정의 ID를 쓴다. 정의가 없는 legacy mutation만 옛 이름(APPLICATION_MUTATION)을 둔다.
  • 버린 안: cache onError가 ApplicationQueryError를 아예 세지 않기(서버 실패를 cache 진단에서 잃는다).

위험과 영향

  • 낡은 데이터의 배경 재조회 중에도 stale 대신 refreshing을 보인다.
  • 진단 error_kind 값이 바뀐다. 그 값을 읽는 대시보드가 있으면 바꿔야 한다(템플릿 안에는 없다). round9 마지막 CHANGELOG에 적는다.

검증

desktop, CI env, scripts/verify.sh(flock).

  • RED(기준 5250ff95에 새 시험만): tests/component/application-query-bridge.test.tsx 새 시험 셋 실패(3 failed, 8 passed). 로그 /tmp/claude-gates/r9f2c-red/.
  • GREEN: application-query-bridge·application-mutation-optimistic-cache·application-query 44 passed. 로그 /tmp/claude-gates/r9f2c-green/.
  • 첫 게이트 실행에서 FE-GATE-002(lint)가 실패했다. mutation submit이 쓰기 시작한 failureOperationId가 useCallback 의존성 배열에 없었다(react-hooks/exhaustive-deps). 배열에 더해 같은 커밋에 합쳤다.
  • 게이트(트리 ade515ef = head 트리): FE-GATE-002·003·006 모두 rc=0. 로그 /tmp/claude-gates/r9f2c-gates2/. 이 파일을 읽는 시험은 component 층뿐이다(git grep).

리뷰어가 볼 곳

  • src/presentation/adapters/query/application-query.ts의 staleFailure, ApplicationQueryError.kind, failureOperationId.

관련

  • 발견: docs/reviews/2026-11-round9-01-react.md 01-04·01-05(PR #23)
  • Refs: 1112/01-04, 1112/01-05
## 무엇을, 왜 - `useApplicationQuery`가 「데이터가 있고 마지막 조회가 실패했다」는 파생 값을 effect로 state에 복사한다. 다시 시도가 그 값을 지우고 refetch해도 조회 중에 effect가 다시 돌아 true로 되돌린다. 그래서 낡은 데이터의 다시 시도가 진행 중에도 지난 실패(stale-degraded)를 보인다(1112/01-05). - query·mutation 실패 진단이 원인을 버린다. cache `onError`가 모든 실패를 `cache.operation.failed`로 남기는데 `ApplicationQueryError`에 `kind`가 없어 이름(`APPLICATION_QUERY_ERROR`)이 남는다. 404, 필드 거절, abort가 한 가지로 남는다. 예상 밖 throw는 정의 이름 대신 고정 문자열을 쓴다(1112/01-04). ## 고른 방법과 버린 대안 - `staleFailure`를 `query.isError && hasData && !query.isFetching`으로 렌더 중에 계산하고 state와 effect를 지운다. 다시 시도 중은 refreshing이다. - `ApplicationQueryError`가 `failure.kind`를 `kind`로 싣는다. - 예상 밖 throw는 query 정의 ID와 mutation 정의 ID를 쓴다. 정의가 없는 legacy mutation만 옛 이름(`APPLICATION_MUTATION`)을 둔다. - 버린 안: cache `onError`가 `ApplicationQueryError`를 아예 세지 않기(서버 실패를 cache 진단에서 잃는다). ## 위험과 영향 - 낡은 데이터의 배경 재조회 중에도 stale 대신 refreshing을 보인다. - 진단 `error_kind` 값이 바뀐다. 그 값을 읽는 대시보드가 있으면 바꿔야 한다(템플릿 안에는 없다). round9 마지막 CHANGELOG에 적는다. ## 검증 desktop, CI env, `scripts/verify.sh`(flock). - RED(기준 `5250ff95`에 새 시험만): `tests/component/application-query-bridge.test.tsx` 새 시험 셋 실패(3 failed, 8 passed). 로그 `/tmp/claude-gates/r9f2c-red/`. - GREEN: `application-query-bridge`·`application-mutation-optimistic-cache`·`application-query` 44 passed. 로그 `/tmp/claude-gates/r9f2c-green/`. - 첫 게이트 실행에서 FE-GATE-002(lint)가 실패했다. mutation `submit`이 쓰기 시작한 `failureOperationId`가 useCallback 의존성 배열에 없었다(`react-hooks/exhaustive-deps`). 배열에 더해 같은 커밋에 합쳤다. - 게이트(트리 `ade515ef` = head 트리): FE-GATE-002·003·006 모두 rc=0. 로그 `/tmp/claude-gates/r9f2c-gates2/`. 이 파일을 읽는 시험은 component 층뿐이다(`git grep`). ## 리뷰어가 볼 곳 - `src/presentation/adapters/query/application-query.ts`의 `staleFailure`, `ApplicationQueryError.kind`, `failureOperationId`. ## 관련 - 발견: `docs/reviews/2026-11-round9-01-react.md` 01-04·01-05(PR #23) - Refs: 1112/01-04, 1112/01-05
donghyeon.kang added 1 commit 2026-11-12 17:47:07 +00:00
fix(query): stale 실패를 렌더 중에 계산하고 실패 진단이 원인을 남긴다
frontend-quality-gates / merge / static checks (pull_request) Successful in 2m26s
frontend-quality-gates / merge / tests (pull_request) Failing after 15m50s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 11m10s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / main / checker self-tests (pull_request) Skipped
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Skipped
frontend-quality-gates / external-vulnerability-provider (pull_request) Skipped
frontend-quality-gates / external-provenance-provider (pull_request) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Skipped
frontend-quality-gates / deploy-promoted-release (pull_request) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Skipped
d4aa365bd9
useApplicationQuery가 "데이터가 있고 마지막 조회가 실패했다"는 파생 값을
effect로 state에 복사한다. 다시 시도가 그 값을 지운 뒤 refetch해도, 조회
중에 effect가 다시 돌아 true로 되돌린다. 그래서 낡은 데이터의 다시 시도가
진행 중에도 지난 실패(stale-degraded)를 보인다(1112/01-05).

query·mutation 실패 진단은 원인을 버린다. cache의 onError가 모든 실패를
cache.operation.failed로 남기는데, ApplicationQueryError에 kind가 없어
safeErrorKind가 이름(APPLICATION_QUERY_ERROR)을 쓴다. 404, 필드 거절,
abort가 한 가지로 남는다. 예상 밖 throw는 정의 이름 대신 고정 문자열
(APPLICATION_QUERY, APPLICATION_MUTATION)을 쓴다(1112/01-04).

고른 방법: staleFailure를 query.isError && hasData && !isFetching으로 렌더
중에 계산하고 state와 effect를 지운다. 다시 시도 중은 refreshing이다.
ApplicationQueryError가 failure.kind를 kind로 싣는다. 예상 밖 throw는 query
정의 ID와 mutation 정의 ID를 쓰고, 정의가 없는 legacy mutation만 옛 이름을
둔다. 버린 대안: cache onError가 ApplicationQueryError를 아예 세지 않기
(서버 실패를 cache 진단에서 잃는다).

위험·한계: 낡은 데이터의 배경 재조회 중에도 stale 대신 refreshing을
보인다. 진단 error_kind 값이 바뀌어 그 값을 읽는 대시보드가 있으면
바꿔야 한다(템플릿 안에는 없다).

검증: tests/component/application-query-bridge.test.tsx의 새 시험 셋이
고치기 전 코드에서 실패하고 고친 뒤 통과한다(desktop, PR 본문).

Refs: 1112/01-04, 1112/01-05
donghyeon.kang added 1 commit 2026-11-12 19:29:33 +00:00
Merge remote-tracking branch 'origin/main' into fix/r9-query-state-diagnostics
frontend-quality-gates / merge / static checks (pull_request) Canceled after 0s
frontend-quality-gates / merge / tests (pull_request) Canceled after 0s
frontend-quality-gates / merge / browser tests (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Canceled after 0s
frontend-quality-gates / external-vulnerability-provider (pull_request) Canceled after 0s
frontend-quality-gates / external-provenance-provider (pull_request) Canceled after 0s
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Canceled after 0s
frontend-quality-gates / deploy-promoted-release (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Canceled after 0s
frontend-quality-gates / main / self-tests and removal drills (pull_request) Canceled after 0s
78938e8f91
Author
Owner

#40으로 병합됐다(main ee47480c). 이 PR의 head 78938e8f가 #40 브랜치에 merge 커밋으로 들어 있고, #40의 runner merge job 셋이 그 합친 트리로 초록이었다. runner 대기를 줄이려고 이번만 쓴 방식이다(소유자 승인, 2026-11-13).

#40으로 병합됐다(main `ee47480c`). 이 PR의 head `78938e8f`가 #40 브랜치에 merge 커밋으로 들어 있고, #40의 runner merge job 셋이 그 합친 트리로 초록이었다. runner 대기를 줄이려고 이번만 쓴 방식이다(소유자 승인, 2026-11-13).
donghyeon.kang closed this pull request 2026-11-12 23:43:39 +00:00

Pull request closed

Please reopen this pull request to perform a merge.
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: donghyeon.kang/clean-architecture-frontend-template#28