docs(review): UI 감사 발견별 조치 결과를 기록한다

감사 문서에 발견마다 어떻게 닫았는지가 없었다.

조치 결과 표를 추가했다. 넣은 검사, 커밋, UI-03 범위 확대(읽히지 않던
컴포넌트 토큰 4개), UI-05의 남은 절반(시각 테스트 글꼴 고정),
UI-07 재판정(정상 구성과 데모 틀이라 조치 안 함)을 적었다.

위험: 문서만 바뀐다.
검증: 표의 커밋 ID와 검사 이름을 브랜치 기록과 대조했다.
This commit is contained in:
DongHyeonka
2026-11-01 18:34:28 +09:00
parent 5008013db2
commit df66cc9e53
+16 -1
View File
@@ -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` 전환과 토큰 사용 일원화)