test(a11y): 접근성 자동 검사가 지키는 규칙에 실제로 닿게 한다 #27

Closed
donghyeon.kang wants to merge 0 commits from donghyeon.kang/fix/r9-a11y-test-reach AGit into main
Owner

무엇을, 왜

접근성 자동 검사 셋이 지키는 것에 닿지 않는다.

  • reduced-motion e2e가 body의 animationDuration으로 브라우저 기본값 0s도 받아들인다. responsive.css의 reduced-motion 규칙을 지워도 통과한다(05-08).
  • 예제 화면을 Storybook 갤러리로 옮기면서 화면 전체 axe 검사가 빠졌다. 기능이 없는 템플릿에서 빈·오류·로그인·권한 표면이 axe를 받지 않는다(05-04).
  • 제품이 WCAG 2.2 AA를 약속하는데 스캔 태그는 2.1까지다. 같은 태그 목록이 네 곳에 손으로 적혀 있다(05-05 일부).
  • 셸 compact drawer는 modal이고 모든 셸 route에 있는데, 라우트 수동 기록 셋과 checklist 예시가 M4를 「modal 없음」으로 채운다(05-07).

고른 방법과 버린 대안

  • reduced-motion 시험은 규칙이 없을 때의 값(0s)과 규칙의 값(1e-05s)을 함께 본다.
  • 갤러리 두 story를 light·dark에서 화면 전체 axe로 본다.
  • 태그는 tests/support/browser/axe-tags.ts 하나에 두고 wcag22aa를 더한다.
  • 라우트 기록의 M4를 pending으로 바꾸고 checklist에 셸 drawer를 적는다.
  • 버린 안: 이 PR에서 수동 기록 양식에 2.4.11·2.5.8 칸을 더하기. 양식과 생성 출력이 바뀌는 일이라 R9-D9(권하는 안으로 정함(2026-11-12, 총괄))에 따라 따로 한다.

위험과 영향

  • wcag22aa는 axe의 target-size 규칙만 더한다. 포커스 가림(2.4.11) 같은 기준은 여전히 수동이다.
  • 제품 화면이 target-size 규칙에 걸리면 FE-GATE-009가 새로 실패할 수 있다. 템플릿 화면은 통과한다.

검증

desktop, CI env, scripts/verify.sh(flock). 시험 스크립트 /tmp/claude-gates/r9fe-scripts/f5.sh.

  • 변이: responsive.css의 reduced-motion 규칙을 지운 사본에서 새 reduced-motion 시험이 세 엔진 모두 실패(3 failed), 원래 코드에서 3 passed. 로그 /tmp/claude-gates/r9f5-green/.
  • 갤러리 axe(두 story × light·dark): storybook 5 passed. accessibility.spec.ts·theme.spec.ts 세 엔진 24 passed.
  • 게이트(트리 e9b9e8b0 = head 트리): FE-GATE-002·003·009 rc=0. 로그 /tmp/claude-gates/r9f5-gates/.
  • FE-GATE-008(generated-feature.spec.ts의 axe 포함, 같은 트리): rc=0. e2e 183 passed·4 skipped(일부러 실패를 확인하는 preload 검사 자기 시험 셋은 게이트가 실패를 기대한다), browser capability 69 passed, storybook·visual 통과. 로그 /tmp/claude-gates/r9f5-008/.

리뷰어가 볼 곳

  • tests/e2e/theme.spec.ts의 reduced-motion 단언, tests/storybook/galleries.spec.ts의 axe.

관련

  • 발견: docs/reviews/2026-11-round9-05-a11y.md 05-04·05·07·08(PR #23)
  • Refs: 1112/05-04, 1112/05-05, 1112/05-07, 1112/05-08
## 무엇을, 왜 접근성 자동 검사 셋이 지키는 것에 닿지 않는다. - reduced-motion e2e가 body의 `animationDuration`으로 브라우저 기본값 `0s`도 받아들인다. `responsive.css`의 reduced-motion 규칙을 지워도 통과한다(05-08). - 예제 화면을 Storybook 갤러리로 옮기면서 화면 전체 axe 검사가 빠졌다. 기능이 없는 템플릿에서 빈·오류·로그인·권한 표면이 axe를 받지 않는다(05-04). - 제품이 WCAG 2.2 AA를 약속하는데 스캔 태그는 2.1까지다. 같은 태그 목록이 네 곳에 손으로 적혀 있다(05-05 일부). - 셸 compact drawer는 modal이고 모든 셸 route에 있는데, 라우트 수동 기록 셋과 checklist 예시가 M4를 「modal 없음」으로 채운다(05-07). ## 고른 방법과 버린 대안 - reduced-motion 시험은 규칙이 없을 때의 값(`0s`)과 규칙의 값(`1e-05s`)을 함께 본다. - 갤러리 두 story를 light·dark에서 화면 전체 axe로 본다. - 태그는 `tests/support/browser/axe-tags.ts` 하나에 두고 `wcag22aa`를 더한다. - 라우트 기록의 M4를 pending으로 바꾸고 checklist에 셸 drawer를 적는다. - 버린 안: 이 PR에서 수동 기록 양식에 2.4.11·2.5.8 칸을 더하기. 양식과 생성 출력이 바뀌는 일이라 R9-D9(권하는 안으로 정함(2026-11-12, 총괄))에 따라 따로 한다. ## 위험과 영향 - `wcag22aa`는 axe의 target-size 규칙만 더한다. 포커스 가림(2.4.11) 같은 기준은 여전히 수동이다. - 제품 화면이 target-size 규칙에 걸리면 FE-GATE-009가 새로 실패할 수 있다. 템플릿 화면은 통과한다. ## 검증 desktop, CI env, `scripts/verify.sh`(flock). 시험 스크립트 `/tmp/claude-gates/r9fe-scripts/f5.sh`. - 변이: `responsive.css`의 reduced-motion 규칙을 지운 사본에서 새 reduced-motion 시험이 세 엔진 모두 실패(3 failed), 원래 코드에서 3 passed. 로그 `/tmp/claude-gates/r9f5-green/`. - 갤러리 axe(두 story × light·dark): storybook 5 passed. `accessibility.spec.ts`·`theme.spec.ts` 세 엔진 24 passed. - 게이트(트리 `e9b9e8b0` = head 트리): FE-GATE-002·003·009 rc=0. 로그 `/tmp/claude-gates/r9f5-gates/`. - FE-GATE-008(`generated-feature.spec.ts`의 axe 포함, 같은 트리): rc=0. e2e 183 passed·4 skipped(일부러 실패를 확인하는 preload 검사 자기 시험 셋은 게이트가 실패를 기대한다), browser capability 69 passed, storybook·visual 통과. 로그 `/tmp/claude-gates/r9f5-008/`. ## 리뷰어가 볼 곳 - `tests/e2e/theme.spec.ts`의 reduced-motion 단언, `tests/storybook/galleries.spec.ts`의 axe. ## 관련 - 발견: `docs/reviews/2026-11-round9-05-a11y.md` 05-04·05·07·08(PR #23) - Refs: 1112/05-04, 1112/05-05, 1112/05-07, 1112/05-08
donghyeon.kang added 1 commit 2026-11-12 17:45:36 +00:00
test(a11y): 접근성 자동 검사가 지키는 규칙에 실제로 닿게 한다
frontend-quality-gates / merge / static checks (pull_request) Successful in 3m52s
frontend-quality-gates / merge / tests (pull_request) Failing after 15m28s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 10m56s
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
978170cb03
접근성 자동 검사 셋이 지키는 것에 닿지 않는다.

- reduced-motion e2e가 body의 animationDuration으로 브라우저 기본값
  0s도 받아들인다. responsive.css의 reduced-motion 규칙을 지워도
  통과한다(1112/05-08).
- 예제 화면을 Storybook 갤러리로 옮기면서 화면 전체 axe 검사가 빠졌다.
  기능이 없는 템플릿에서 빈·오류·로그인·권한 표면이 axe를 받지
  않는다(05-04).
- 제품이 WCAG 2.2 AA를 약속하는데 스캔 태그는 2.1까지다. 같은 태그 목록이
  네 곳에 손으로 적혀 있다(05-05 일부).
- 셸 compact drawer는 modal이고 모든 셸 route에 있는데, 라우트 수동 기록
  셋과 checklist 예시가 M4를 "modal 없음"으로 채운다(05-07).

고른 방법: reduced-motion 시험은 규칙이 없을 때의 값(0s)과 규칙의 값
(0.01ms)을 함께 본다. 갤러리 두 story를 light·dark에서 화면 전체 axe로
본다. 태그는 tests/support/browser/axe-tags.ts 하나에 두고 wcag22aa를
더한다. 라우트 기록의 M4를 pending으로 바꾸고 checklist에 셸 drawer를
적는다. 수동 기록 양식에 2.4.11·2.5.8 칸을 더하는 일(05-05의 나머지)은 양식과 생성
출력이 바뀌는 일이라 이 커밋에 넣지 않았다. R9-D9(권하는 안으로 정함
(2026-11-12, 총괄))에 따라 따로 한다.

위험·한계: wcag22aa는 axe의 target-size 규칙만 더한다. 포커스 가림(2.4.11)
같은 기준은 여전히 수동이다.

검증: reduced-motion 시험이 규칙을 지운 변이에서 실패하고 원래 코드에서
통과한다. 갤러리 axe 넷과 FE-GATE-009는 desktop에서 돈다(PR 본문).

Refs: 1112/05-04, 1112/05-05, 1112/05-07, 1112/05-08
donghyeon.kang added 1 commit 2026-11-12 19:29:32 +00:00
Merge remote-tracking branch 'origin/main' into fix/r9-a11y-test-reach
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
70b1be2998
Author
Owner

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

#40으로 병합됐다(main `ee47480c`). 이 PR의 head `70b1be29`가 #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#27