Merge pull request 'fix(a11y): 수동 접근성 기록을 릴리스 태그로 대조하고 WCAG 2.2 칸을 더한다' (#48) from donghyeon.kang/fix/r9-a11y-evidence into main
frontend-quality-gates / merge / tests (push) Successful in 20m10s
frontend-quality-gates / FE-GATE-014 / config-compatibility (push) Canceled after 0s
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (push) Canceled after 0s
frontend-quality-gates / FE-GATE-026 / lab-performance (push) Canceled after 0s
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (push) Canceled after 0s
frontend-quality-gates / external-vulnerability-provider (push) Canceled after 0s
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (push) Canceled after 0s
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (push) Canceled after 0s
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (push) Canceled after 0s
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (push) Canceled after 0s
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (push) Canceled after 0s
frontend-quality-gates / FE-GATE-018 / field-web-vitals (push) Canceled after 0s
frontend-quality-gates / FE-GATE-017 / diagram-review (push) Canceled after 0s
frontend-quality-gates / main / self-tests and removal drills (push) Canceled after 0s
frontend-quality-gates / external-provenance-provider (push) Canceled after 0s
frontend-quality-gates / promote-verified-immutable-candidate (push) Canceled after 0s
frontend-quality-gates / deploy-promoted-release (push) Canceled after 0s
frontend-quality-gates / FE-GATE-019 / hosting-header (push) Canceled after 0s
frontend-quality-gates / merge / browser tests (push) Canceled after 3m31s
frontend-quality-gates / merge / static checks (push) Successful in 2m30s
frontend-quality-gates / merge / tests (push) Successful in 20m10s
frontend-quality-gates / FE-GATE-014 / config-compatibility (push) Canceled after 0s
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (push) Canceled after 0s
frontend-quality-gates / FE-GATE-026 / lab-performance (push) Canceled after 0s
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (push) Canceled after 0s
frontend-quality-gates / external-vulnerability-provider (push) Canceled after 0s
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (push) Canceled after 0s
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (push) Canceled after 0s
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (push) Canceled after 0s
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (push) Canceled after 0s
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (push) Canceled after 0s
frontend-quality-gates / FE-GATE-018 / field-web-vitals (push) Canceled after 0s
frontend-quality-gates / FE-GATE-017 / diagram-review (push) Canceled after 0s
frontend-quality-gates / main / self-tests and removal drills (push) Canceled after 0s
frontend-quality-gates / external-provenance-provider (push) Canceled after 0s
frontend-quality-gates / promote-verified-immutable-candidate (push) Canceled after 0s
frontend-quality-gates / deploy-promoted-release (push) Canceled after 0s
frontend-quality-gates / FE-GATE-019 / hosting-header (push) Canceled after 0s
frontend-quality-gates / merge / browser tests (push) Canceled after 3m31s
frontend-quality-gates / merge / static checks (push) Successful in 2m30s
This commit was merged in pull request #48.
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 필드 오류 리뷰를 실제로 해야
|
||||
@@ -66,8 +79,9 @@ not-applicable이 아니다. 자동 증거가
|
||||
|
||||
자동 실행이 검사하는 것:
|
||||
|
||||
- 등록된 모든 route. route 자신의 `h1`이 화면에 나온 뒤 검사한다. 그래서 앱 셸의
|
||||
로딩 화면을 검사하는 일이 없다(`tests/e2e/accessibility.spec.ts`). 공개
|
||||
- 등록된 모든 route. route 자신의 `h1`이 화면에 나오고 `aria-busy` 표면이 모두
|
||||
풀린 뒤 검사한다. 그래서 앱 셸의 로딩 화면이나 아직 받는 중인 표를 검사하는 일이
|
||||
없다(`tests/e2e/accessibility.spec.ts`). 공개
|
||||
route의 `h1`은 catalog 제목과 같아야 한다.
|
||||
- 보호된 route는 데모 로그인 뒤에 검사하고, 로그인 안내 화면은 검사하지 않는다.
|
||||
목록 읽기에는 빈 목록이 응답으로 온다. 그 응답은 descriptor가 선언한 frame에
|
||||
|
||||
@@ -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.
|
||||
|
||||
@@ -436,7 +436,7 @@ projectRequest: (input) => Object.freeze({
|
||||
① **정할 것**
|
||||
|
||||
- `access`: `public`(로그인 없이) 또는 `session-required`(로그인 필요).
|
||||
- `loadingSurface`: 로딩 화면 이름. 케밥 표기.
|
||||
- `loadingSurface`: 라우트 청크를 받는 동안 보이는 로딩 표면의 이름. 케밥 표기. 화면에는 `data-surface` 속성으로만 붙는다. 진단과 시험이 어느 라우트의 로딩인지 찾는 이름표이고, 로딩 모양은 고르지 않는다. 모든 라우트가 같은 `LoadingSurface`를 그린다(`src/presentation/routes/app-router.tsx`).
|
||||
- `errorSurface`: `route-boundary`, `feature-boundary`, `not-found` 중 하나. 생성된 판은 `feature-boundary`다.
|
||||
- `chunkId`: 지연 로드 청크 이름. 전역에서 유일해야 한다.
|
||||
- `navigationOrder`: 메뉴 순서. `null`이면 메뉴에 나오지 않는다.
|
||||
|
||||
@@ -60,12 +60,12 @@ create:feature가 pending 기록을 만든다
|
||||
|
||||
할 일:
|
||||
|
||||
1. 릴리스 후보 하나를 띄운다.
|
||||
2. `docs/accessibility/manual-checklist.md`의 M1~M7과 스크린 리더 항목을 그 라우트에서 확인한다.
|
||||
1. 릴리스 후보 하나를 띄운다. 그 릴리스의 태그(예 `v1.4.0`)를 정한다.
|
||||
2. `docs/accessibility/manual-checklist.md`의 M1~M9와 스크린 리더 항목을 그 라우트에서 확인한다.
|
||||
3. `docs/accessibility/route-reviews/<ROUTE_ID>.md`를 채운다.
|
||||
- `Status: reviewed`, `Release ID`, `Reviewer`, `Reviewed at`, `Signature`, `Attestation: accepted`
|
||||
- `Status: reviewed`, `Release ID`(그 릴리스 태그), `Reviewer`, `Reviewed at`, `Signature`, `Attestation: accepted`
|
||||
- 항목마다 `pass` 또는 `not-applicable (<구체적 이유>)`
|
||||
4. 모든 라우트 기록의 `Release ID`가 같아야 한다.
|
||||
4. 모든 라우트 기록의 `Release ID`가 이번 릴리스 태그와 같아야 한다. release job이 그 태그를 `RELEASE_TAG`로 FE-GATE-028에 넘기고, 앞 릴리스 태그로 서명한 기록은 실패한다. 그래서 릴리스마다 다시 검토하고 그 태그로 서명한다.
|
||||
|
||||
안 하면: FE-GATE-028이 `Manual accessibility evidence is incomplete:`로 릴리스를 막는다.
|
||||
|
||||
|
||||
@@ -180,6 +180,8 @@ lint / check:architecture / check:i18n → FE-GATE-002, FE-GATE-010
|
||||
| `a11y.json not written:` 다음 `a11y: <ROUTE_ID> reads one resource (<operationId>) but has no failure-state record in artifacts/tests/a11y-data-state` (`test:a11y`, FE-GATE-009) | 라우트의 `paramsSchema`가 한 자원을 읽는 GET의 입력인데, 접근성 spec이 그 라우트를 실패 화면으로만 봤다는 기록이 없다(1106/11-01). spec이 기록 호출을 놓쳤거나, 그 라우트의 페이지가 그 GET을 부르지 않아 spec이 실패 화면을 보지 않았다. 앞의 경우 그대로면 `a11y.json`이 그 라우트를 통과로 센다 | 페이지가 그 GET을 부르면 `tests/e2e/accessibility.spec.ts`의 기록 호출(`recordA11yDataState`)을 본다. 이때 기능 파일은 고치지 않는다. 페이지가 그 GET을 부르지 않으면(예: `/things/:thingId/parts/new` 같은 하위 항목 작성 폼이 상세 GET과 같은 `ThingParams`를 쓴다) 그 라우트에 자기 `paramsSchema`를 따로 둔다. 기능의 라우트 계약과 `contracts/<base>-schema-metadata.ts`를 고친다 |
|
||||
| `Manual accessibility evidence is incomplete:` 다음 `<ROUTE_ID>: <failures>` (FE-GATE-028) | 서명하지 않은 기록 | [03 문서](../03-outside-feature-folder.md#수동-접근성-검토-서명) |
|
||||
| `release IDs do not match` (FE-GATE-028) | 라우트마다 다른 릴리스로 검토했다 | 같은 릴리스 후보로 다시 검토한다 |
|
||||
| `<ROUTE_ID>: Release ID "<id>" is not the release tag "<tag>"` (FE-GATE-028) | 그 기록이 이번 릴리스 태그가 아닌 릴리스(보통 앞 릴리스)로 서명됐다 | 이번 릴리스에서 다시 검토하고 `Release ID`를 그 태그로 적어 서명한다([03 문서](../03-outside-feature-folder.md#수동-접근성-검토-서명)) |
|
||||
| `no release tag to compare the Release ID with (RELEASE_TAG is empty)` (FE-GATE-028) | 태그 run이 아닌 곳에서 서명 검사를 돌렸다. release job은 태그 run에서만 `RELEASE_TAG`를 채운다 | 릴리스 태그(`v*`)를 push한 run에서 돌린다. 손으로 돌리면 `RELEASE_TAG=<tag>`를 준다 |
|
||||
| `<doc> names paths that do not exist: <paths>` (`verify:documentation`) | 문서가 없는 경로를 적었다 | 그 문서 |
|
||||
|
||||
---
|
||||
|
||||
Reference in New Issue
Block a user