fix(a11y): 수동 접근성 기록이 릴리스 태그로 서명되고 WCAG 2.2 칸을 갖는다
수동 접근성 기록 검사에 구멍이 둘 있다. - FE-GATE-028(`review:a11y-manual`)은 기록끼리 Release ID가 같은지만 본다 (05-01). 후보를 받는 입력이 없어, 첫 release에 세 기록을 서명한 뒤 화면을 바꾸고 기록을 그대로 둔 채 다음 release를 돌아도 통과한다. checklist의 "release 후보마다 한 번"이 지켜지지 않는다(결함 패턴 G7). - 제품은 WCAG 2.2 AA를 약속하는데 기록 양식은 M1~M7과 스크린 리더뿐이다 (05-05의 남은 것). axe에 규칙이 없는 2.4.11 포커스 가림과 일부만 보는 2.5.8 목표 크기를 볼 칸이 없다. 고른 방법: - 결정(2026-11-13, r9-fe·w2-fe-2: 후보 ID는 릴리스 태그)대로 `scripts/verify-a11y-manual.ts`가 env `RELEASE_TAG`를 읽고, 각 기록의 `Release ID`가 그 태그와 같지 않으면 실패한다. 태그가 비면 비교할 것이 없으니 모두 실패한다(fail-closed). release job은 이미 `RELEASE_TAG`를 넘기고 FE-GATE-028이 그것을 요구한다(main `000b5a35`). 규칙은 `releaseTagFailures`(`scripts/lib/manual-a11y-evidence.ts`)에 둔다. - 결정 R9-D9(2026-11-12, 총괄)대로 기록 양식에 `M8 Focus not obscured` (2.4.11)와 `M9 Target size`(2.5.8)를 더한다: 검사기의 필드 목록, checklist, 템플릿 기록 셋, `create:feature`가 만드는 기록. checklist의 `Release ID` 예는 "release tag"로 바꿨다. - 버린 대안: workflow의 `RELEASE_ID`와 대조(run마다 달라 사람이 미리 적을 수 없다), 칸 없이 태그만 더하기(2.2 AA 일부를 아무도 보지 않는다). 위험·한계: 다운스트림의 기존 route 기록에는 M8·M9가 없어 다음 동기화 뒤 FE-GATE-009 형식 검사가 그 필드 이름을 대며 실패한다. 기록마다 `M8 Focus not obscured: pending`, `M9 Target size: pending` 두 줄을 더하면 된다. 서명한 기록의 `Release ID`는 다음 release부터 태그(예 `v1.4.0`)로 적는다. 검증: `tests/unit/manual-a11y-evidence.test.ts`(M8·M9가 빠진 기록 거절, 태그 같음·다름·빔, `review:a11y-manual`을 실제로 띄워 태그로 통과·다음 태그와 빈 태그로 실패)가 고치기 전 코드에서 실패하고 고친 뒤 통과한다(desktop, PR 본문). Refs: 1112/05-01, 1112/05-05
This commit is contained in:
@@ -6,7 +6,14 @@
|
||||
registry(`src/features/installed-feature-contracts.ts`의 `ROUTE_REGISTRY`)다.
|
||||
route 하나에 기록 하나를 두고, 이름은 `<ROUTE_ID>.md`로 한다. template 필드를
|
||||
그대로 복사한다. gate는 다음을 거부한다: 비어 있는 신원·시각·서명 필드, 아직
|
||||
정하지 않은(pending) 판정, 맞지 않는 release ID, 빠진 route.
|
||||
정하지 않은(pending) 판정, 이번 release 태그와 다른 `Release ID`, 빠진 route.
|
||||
|
||||
`Release ID`는 리뷰한 release의 **태그**다(예: `v1.4.0`). release job은 만드는
|
||||
태그를 `RELEASE_TAG`로 FE-GATE-028에 넘기고(`config/ci/gates.json`의
|
||||
`requiresEnvironment`), `review:a11y-manual`은 모든 기록의 `Release ID`가 그 값과
|
||||
같은지 본다. 앞 release 태그로 서명한 기록은 다음 release에서 실패한다. 그래서
|
||||
release마다 기록을 다시 검토하고 그 태그로 서명한다. `RELEASE_TAG`가 비어 있으면
|
||||
비교할 태그가 없으므로 실패한다.
|
||||
|
||||
서명된 리뷰는 release gate FE-GATE-028(`review:a11y-manual`)이다. 그래서
|
||||
merge마다가 아니라 release 후보마다 한 번 필요하다. merge gate FE-GATE-009는
|
||||
@@ -30,7 +37,7 @@ merge마다가 아니라 release 후보마다 한 번 필요하다. merge gate F
|
||||
```text
|
||||
Status: reviewed
|
||||
Route ID: APP_HOME
|
||||
Release ID: <immutable release ID>
|
||||
Release ID: <release tag, e.g. v1.4.0>
|
||||
Reviewer: <human reviewer identity>
|
||||
Reviewed at: <RFC 3339 timestamp>
|
||||
Signature: <reviewer identity or approved signature reference>
|
||||
@@ -42,6 +49,8 @@ M4 Modal focus: pass
|
||||
M5 Error association: not-applicable (no form error on this route)
|
||||
M6 Color signal: pass
|
||||
M7 Reduced motion: pass
|
||||
M8 Focus not obscured: pass
|
||||
M9 Target size: pass
|
||||
Screen reader: pass
|
||||
Notes: <observations and linked defect IDs>
|
||||
```
|
||||
@@ -55,6 +64,10 @@ Notes: <observations and linked defect IDs>
|
||||
- M5: 오류가 있으면 해당 입력 요소와 프로그램으로 연결돼 있다
|
||||
- M6: 상태를 색으로만 나타내지 않는다
|
||||
- M7: 동작 줄이기(reduced-motion) 설정이 켜지면 꼭 필요하지 않은 움직임을 멈춘다
|
||||
- M8: focus를 받은 요소가 sticky header, sticky 폼 버튼, toast 같은 고정 요소에
|
||||
완전히 가려지지 않는다(WCAG 2.2 2.4.11). axe에는 이 규칙이 없다
|
||||
- M9: 누르는 대상이 24×24 CSS px 이상이거나 그만큼 떨어져 있다(WCAG 2.2 2.5.8).
|
||||
axe `target-size`는 일부만 본다. 템플릿 목표는 44×44 CSS px다
|
||||
- Screen reader: 제목, live region, 오류, 동작이 한 번씩 읽힌다
|
||||
|
||||
form이나 dialog가 있는 route는 M4 modal 리뷰와 M5 필드 오류 리뷰를 실제로 해야
|
||||
|
||||
@@ -14,5 +14,7 @@ M4 Modal focus: pending
|
||||
M5 Error association: not-applicable (no form error on this route)
|
||||
M6 Color signal: pending
|
||||
M7 Reduced motion: pending
|
||||
M8 Focus not obscured: pending
|
||||
M9 Target size: pending
|
||||
Screen reader: pending
|
||||
Notes: Automated axe, keyboard-focus, and reduced-motion evidence is available; human review pending.
|
||||
|
||||
@@ -14,5 +14,7 @@ M4 Modal focus: pending
|
||||
M5 Error association: not-applicable (no form error on this route)
|
||||
M6 Color signal: pending
|
||||
M7 Reduced motion: pending
|
||||
M8 Focus not obscured: pending
|
||||
M9 Target size: pending
|
||||
Screen reader: pending
|
||||
Notes: Review the horizontally scrollable registry tables for keyboard reachability of the scroll container, table caption and header association announced per row, capability status badges carrying their meaning in text rather than colour alone, and the release identity region announcing its update through aria-live without interrupting a reader mid row.
|
||||
|
||||
@@ -14,5 +14,7 @@ M4 Modal focus: pending
|
||||
M5 Error association: not-applicable (no form error on this route)
|
||||
M6 Color signal: pending
|
||||
M7 Reduced motion: pending
|
||||
M8 Focus not obscured: pending
|
||||
M9 Target size: pending
|
||||
Screen reader: pending
|
||||
Notes: Human review pending.
|
||||
|
||||
Reference in New Issue
Block a user