From df66cc9e53010b9b95a5521d42d1d4faaedfd59c Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Sun, 1 Nov 2026 18:34:28 +0900 Subject: [PATCH] =?UTF-8?q?docs(review):=20UI=20=EA=B0=90=EC=82=AC=20?= =?UTF-8?q?=EB=B0=9C=EA=B2=AC=EB=B3=84=20=EC=A1=B0=EC=B9=98=20=EA=B2=B0?= =?UTF-8?q?=EA=B3=BC=EB=A5=BC=20=EA=B8=B0=EB=A1=9D=ED=95=9C=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 감사 문서에 발견마다 어떻게 닫았는지가 없었다. 조치 결과 표를 추가했다. 넣은 검사, 커밋, UI-03 범위 확대(읽히지 않던 컴포넌트 토큰 4개), UI-05의 남은 절반(시각 테스트 글꼴 고정), UI-07 재판정(정상 구성과 데모 틀이라 조치 안 함)을 적었다. 위험: 문서만 바뀐다. 검증: 표의 커밋 ID와 검사 이름을 브랜치 기록과 대조했다. --- docs/reviews/2026-11-01-ui-design-audit.md | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) diff --git a/docs/reviews/2026-11-01-ui-design-audit.md b/docs/reviews/2026-11-01-ui-design-audit.md index 6f8628c0..ced7c9c2 100644 --- a/docs/reviews/2026-11-01-ui-design-audit.md +++ b/docs/reviews/2026-11-01-ui-design-audit.md @@ -182,7 +182,22 @@ | 23 | 일관성 | 적용 — 토큰·색 일관성 | 목표 M3 / 확인 M2 | E3 | 부분 충족 — UI-02, 03, 05 | | 그 외 19개 | — | 미평가 — 이번 감사 범위(화면 디자인) 밖 | 미평가 | 미확인 | 미검증 | -## 권장 순서 +## 조치 결과 (브랜치 `fix/ui-design-audit-2026-11-01`) + +각 항목은 고치기 전에 실패하는 검사를 먼저 넣고(RED), 고친 뒤 통과를 확인했다(GREEN). + +| ID | 상태 | 커밋 | 넣은 검사 | 비고 | +| --- | --- | --- | --- | --- | +| UI-01 | 충족 | `735e280` | `check:design-system`: 두 테마의 포커스 색과 표면 8종 대비 3:1 미만이면 실패. `tests/unit/oklch-contrast.test.ts` | 라이트 포커스 `oklch(0.52 0.15 230)`, 최저 4.24:1. 계산식은 브라우저 실측(2.33:1)과 일치 | +| UI-02 | 충족 | `84dbb3a` | `check:design-system`: `color-mix`를 oklch·lch·hsl·hwb로 섞으면 실패 | 15곳을 `in oklab`으로 | +| UI-03 | 충족 | `4bb15e6` | `check:design-system`: 계약의 컴포넌트 토큰을 읽는 스타일이 없으면 실패 | 범위 확대: `--navigation-active-background`와 기본 버튼 토큰 3개까지 모두 4개가 읽히지 않고 있었다 | +| UI-04 | 충족 | `5d2ed17` | `tests/e2e/i18n.spec.ts`: 선택 상자 폭이 브라우저가 옵션에 필요한 폭보다 좁으면 실패(ko·en·en-XA) | chromium·firefox·webkit 통과 | +| UI-05 | 부분 충족 | `c6730ea` | `check:design-system`: `--font-sans`의 첫 글꼴이 기본 키워드도 아니고 `@font-face`로 싣지도 않으면 실패 | 결정: 대안 (b) 시스템 글꼴 스택. 남은 것: 시각 테스트 실행 환경의 글꼴 고정 | +| UI-06 | 충족 | `2560580` | 없음 — 지울 수 있는 예제 화면의 문구라 검사 비용이 더 크다 | 예제 화면 4곳의 eyebrow 제거. 예제는 의도적으로 i18n 검사 밖(`scripts/check-i18n.ts` 대상 폴더) | +| UI-07 | 적용 제외(재판정) | — | — | 다시 보니 탐지기 5건 중 2건(`ui-alert` in Card, `fieldset.ui-radio-group`)은 제품에서도 쓰는 정상 구성이다. 3건은 갤러리가 상태 화면을 이름 붙은 데모 틀에 넣은 것이다. 제품 화면에는 이 중첩이 생기지 않는다 | +| UI-08 | 충족 | `267300a` | 컴포넌트 테스트: 이름 있는 `region` 요구 | caption id로 `aria-labelledby` | + +## 권장 순서 (감사 시점 기준) 1. **P1 UI-01**: 포커스 색 수정 + 토큰 대비 테스트 추가 2. **P2 UI-02 + UI-03**: 함께 처리(`in oklab` 전환과 토큰 사용 일원화)