fix(presentation): 처리 중 버튼·화면 문구·context 기능 적재를 고친다 #51
Merged
donghyeon.kang
merged 6 commits from 2026-11-13 17:58:15 +00:00
donghyeon.kang/fix/r9-screen-copy-pending AGit into main
6
Commits
| Author | SHA1 | Message | Date | |
|---|---|---|---|---|
|
|
c106ffa858 |
Merge remote-tracking branch 'origin/main' into fix/r9-screen-copy-pending
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-025 / runbook-release-rollback (pull_request) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Skipped
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / main / self-tests and removal drills (pull_request) Skipped
frontend-quality-gates / merge / static checks (pull_request) Successful in 1m14s
frontend-quality-gates / merge / tests (pull_request) Successful in 11m30s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 5m38s
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
|
||
|
|
6084e3bf8b |
docs(ledger): round9 그룹 A 착수 예측을 남긴다
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 / 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-023 / runbook-api-degradation (pull_request) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Skipped
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / merge / static checks (pull_request) Successful in 2m6s
frontend-quality-gates / merge / tests (pull_request) Successful in 14m11s
frontend-quality-gates / merge / browser tests (pull_request) Failing after 7m47s
frontend-quality-gates / external-vulnerability-provider (pull_request) Skipped
frontend-quality-gates / external-provenance-provider (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-025 / runbook-release-rollback (pull_request) Skipped
frontend-quality-gates / main / self-tests and removal drills (pull_request) Skipped
|
||
|
|
3d34da115a |
perf(styles): Tailwind가 src 밖 파일의 낱말로 유틸리티를 만들지 않는다
`src/presentation/styles/theme.css`의 `@import "tailwindcss";`에 `source()`가
없어 Tailwind v4가 `.gitignore` 밖 파일을 모두 훑는다. 템플릿 TSX는 유틸리티
class를 쓰지 않고 `@apply`만 쓰는데, 빌드 CSS의 `@layer utilities`에 docs·
tests·scripts의 낱말에서 나온 규칙 35~40개(`.shadow\/canary`, `.sepia`,
`.cursor-not-allowed`, `.\!relative` 등)가 실린다. 모든 페이지가 기다리는 CSS가
약 0.7~0.9 KB gzip 커지고, 문서나 시험만 고친 release도 CSS 이름이 바뀌어
재방문자가 CSS를 다시 받는다.
고른 방법: `@import "tailwindcss" source("../../");`로 훑는 범위를 `src/`로
좁힌다. 제품이 `src/` 안의 className에 유틸리티를 쓰면 그대로 생긴다. 버린
대안: `source(none)`(제품이 유틸리티 class를 쓸 수 없어진다. 디자인 시스템
계약을 바꾸는 일이다).
위험·한계: 유틸리티 class를 `src/` 밖(예: `index.html`)에만 쓴 제품은 그
규칙을 잃는다. 템플릿에는 그런 곳이 없다.
검증: `tests/unit/design-system-initial-chunk.test.ts`의 새 사례가 src 밖
fixture(`tests/fixtures/tailwind-source/outside-src.txt`의
`outline-[3.21px]`)가 빌드 CSS에 없음을 본다. 고치기 전에 실패하고 고친 뒤
통과한다. 시각 골든은 FE-GATE-008이 본다(desktop, PR 본문).
Refs: 1112/06-03
|
||
|
|
4a43801859 |
perf(routes): context의 기능 실행부를 라우트 모듈과 함께 받기 시작한다
context에 처음 들어가면 라우트 모듈과 들어간 주소의 기능 실행부만 함께 받고, 그 뒤에야 같은 context의 나머지 기능 실행부를 받는다 (`src/presentation/routes/app-router.tsx` `ContextRouteGateway`). 그 전에는 라우트 로딩 표면이다. 그런데 그 기능 목록은 처음부터 정적으로 있다 (`routeModule.featureIds`). 그래서 기능 둘 이상을 한 context에 넣으면 (`create:feature --context`) 첫 진입의 요청 사슬이 "라우트 모듈 → 다른 기능 실행부 → 페이지 청크"로 한 묶음 늘어난다. 로그인 안내 화면도 그 뒤에 그려진다. 라우트를 갖지 않은 기능은 아예 받지 않아, 그 context의 페이지에서 `application.features.get`이 실패할 수 있었다. 고른 방법(리뷰의 (가)): 들어간 주소의 기능과 `routeModule.featureIds`를 라우트 모듈과 같은 `Promise.all`에서 받기 시작한다. 받은 라우트의 owner를 받는 둘째 단계는 남긴다. `features.load`가 기능마다 promise 하나를 나눠 이미 받는 중이면 왕복을 더하지 않고, context가 선언하지 않은 기능이 라우트를 가져도 그리기 전에 받는다. 버린 대안 (나): 들어간 기능만 기다려 그리고 나머지는 뒤에서 받기. "`features.get`이 그 context의 모든 페이지에서 된다"는 보장을 라우트 단위로 줄이는 계약 변경이라 이번에 하지 않는다. 위험·한계: context에 선언만 하고 라우트가 없는 기능도 이제 첫 진입에 받는다 (받는 양은 같은 context의 기능 수에 비례, 전에도 라우트를 가진 기능은 모두 받았다). 그 기능의 실행부 적재가 실패하면 그 context 전체가 실패 화면으로 간다(전에는 라우트를 가진 기능의 실패만 그랬다). context의 페이지가 그 기능을 `features.get`으로 읽을 수 있다는 약속을 지키려면 그리기 전에 받아야 하므로 고른 동작이다. lab은 아직 기능 라우트를 재지 못해(1105/15-04, 그룹 C) 시간은 재지 않았다. 검증: `tests/component/context-feature-loading.test.tsx`(기능 둘인 context에서 라우트 모듈이 오기 전에 다른 기능의 실행부를 받기 시작한다)가 고치기 전에 실패하고 고친 뒤 통과한다(desktop, PR 본문). Refs: 1112/06-01 |
||
|
|
d42ad073ee |
fix(i18n): 상태 화면 문구를 최종 사용자 말로 쓰고 숫자·단수형·문장 조립을 catalog에 맡긴다
화면 문구 셋이 어긋난다.
- 상태 화면 문구가 템플릿 개발자용이다(04-01). 생성 기능은 모두
`session-required`라 로그인 전 최종 사용자에게 "이 화면은 인증 연동 지점을
확인하기 위한 보호 라우트입니다."가 보인다. 끈 기능 화면은 "코드에는
포함되어 있으며 운영자가 다시 켤 수 있습니다.", 연동 실패 화면은 "외부 인증
소유자가 연결되면…"이다.
- 숫자를 locale formatter 없이 그린다(04-03). 생성 목록이 "총 12345개 항목"을
그리고, TextArea는 en에서 남은 1자도 "1 characters remaining"이다.
- ko·en 뜻이 다르다(04-07). en `form.conflict`에 "최신 상태를 확인해 주세요"가
없고, en 문서 제목 "Page not found"와 h1 "Page not found."가 다르다.
ErrorSummary가 번역 문장 사이에 JSX 글자 ": "를 넣는다.
고른 방법: 세 설명을 사용자 말("이 화면을 보려면 로그인해 주세요." 등)로 바꾸고
운영 설명은 뺐다. 생성 목록은 `useLocale().number(total)`을 넘긴다. TextArea는
`plural`로 `form.remaining.one`(en 단수)과 `form.remaining`을 고른다. en 충돌
문구에 행동을 더하고 not-found 제목을 h1과 같게 했다. 오류 요약 항목은
`form.errorSummary.item` "{label}: {message}"로 잇는다. 연동 실패 화면의 제목
"로그인 연동이 필요합니다."는 짝 백엔드 매뉴얼이 그 글자로 가리켜 그대로 뒀다.
검증 V4가 반박한 부분(세 화면에 행동 버튼이 없다, ProgressBar `%`)은 고치지
않았다: 셸 탐색이 늘 있고, `%`는 ko·en 결과가 같다.
위험·한계: 다운스트림이 이 키의 옛 문장을 시험으로 고정했으면 문장을 바꾼다.
이미 생성한 기능의 목록 페이지는 `count: query.data.total`을 그대로 갖는다.
`number(query.data.total)`로 바꾸면 된다(생성 명령의 새 출력과 같다).
검증: `tests/unit/i18n-contract.test.ts`(개발자 낱말, not-found 제목, 항목
문장), `tests/component/design-system-a11y.test.tsx`(en 단수·복수),
`tests/unit/create-feature.test.ts`(생성 목록의 `number(`)가 고치기 전에
실패하고 고친 뒤 통과한다. 생성 기능 시험의 total 12345 → "총 12,345개 항목"은
FE-GATE-005가 돌린다(desktop, PR 본문).
Refs: 1112/04-01, 1112/04-03, 1112/04-07
|
||
|
|
8bcecabc40 |
fix(a11y): 처리 중인 세션·상태 화면 버튼이 꺼지지 않고 포커스를 지킨다
셸 헤더의 세션 버튼과 로그인 안내(StatusPage)의 로그인·복구 버튼이 처리 중에 `disabled`가 된다. 템플릿 action API(`PageActionDefinition`)에는 `pending`이 없어 상태 화면은 끄는 길밖에 없었다. 꺼진 버튼은 키보드 포커스를 잃는다. 키보드로 "로그인 시작"을 누르고 sign-in이 실패하면 실패 알림이 뜰 때 포커스는 이미 body에 있다(결함 패턴 C11). 모든 파생 서비스의 셸이 복제한다. 같은 모양으로 Pagination의 「이전」을 2쪽에서 누르면 1쪽이 되며 그 버튼이 꺼져 포커스가 떨어진다. 고른 방법: `PageActionDefinition` 버튼에 `pending`·`pendingLabel`을 더해 `Button`으로 넘긴다(추가만). 라우터 상태 화면과 셸 세션 버튼은 `disabled` 대신 `pending`을 쓴다. 버튼은 켜진 채 `aria-busy="true"`이고, 처리 중에 그 버튼이나 다른 세션 버튼(셸과 상태 화면)을 누르면 `useSessionAction().run`이 무시한다. `SessionProvider`가 세션 버튼 모두에 잠금 하나를 준다(중복 실행을 `disabled`에 기대지 않는다). Pagination 끝 버튼은 `aria-disabled`와 누름 무시로 바꾸고, 같은 모양(`.ui-button[aria-disabled="true"]`)으로 그린다. 버린 대안: `Button`의 `pending`이 클릭을 삼키게 하기(폼은 이미 자기 `pendingRef`로 막고, 공개 primitive의 동작이 바뀐다). 위험·한계: 다운스트림이 `PageActionDefinition`에 `disabled: pending`을 넘기고 있으면 그대로 동작하지만 포커스를 잃는다. `pending`으로 옮기면 된다. jsdom은 꺼진 버튼의 포커스를 떨어뜨리지 않아 component 시험은 `disabled`가 아님과 `aria-busy`, 실패 뒤 포커스를 본다. 검증: `tests/component/route-status-surfaces.test.tsx` 세 사례와 `tests/component/pagination.test.tsx` 끝 버튼 두 사례가 고치기 전 코드에서 실패하고 고친 뒤 통과한다(desktop, PR 본문). Refs: 1112/05-03, 1112/04-05 |