Bằng chứng khả năng tiếp cận

Policy 5.0.0 bổ sung miền accessibility vào đánh giá dự án. Mặc định cần ít nhất một lần quét axe-core Playwright có kiểm tra thực tế ở cả chromium-desktop và android-chrome. Mỗi lần quét phải dùng wcag2a, wcag2aa, wcag21a, wcag21aa, ghi phiên bản axe, đường dẫn trang, số rule kiểm tra, vi phạm và mục chưa kết luận. Vi phạm đo được là fail; thiếu scan, không có rule nào, dữ liệu sai định dạng hoặc có mục chưa kết luận là incomplete.

Cài @axe-core/playwright vào từng app được kiểm thử hoặc workspace, rồi commit lockfile. Thêm phép quét vào Playwright test của trang đã render. Các app mẫu có ví dụ đầy đủ; mẫu cốt lõi:

import AxeBuilder from "@axe-core/playwright";
import { expect, test } from "@playwright/test";

test("home page accessibility", async ({ page }) => {
  await page.goto("/");
  const tags = ["wcag2a", "wcag2aa", "wcag21a", "wcag21aa"];
  const result = await new AxeBuilder({ page }).withTags(tags).analyze();
  test.info().annotations.push({ type: "lattice-axe", description: JSON.stringify({
    route: new URL(page.url()).pathname,
    axeVersion: result.testEngine.version,
    tags,
    checks: result.passes.length + result.violations.length + result.incomplete.length,
    needsReview: result.incomplete.length,
    violations: result.violations.flatMap(rule => rule.nodes.map(node => ({
      id: rule.id, impact: rule.impact ?? "critical",
      selector: node.target[0] ?? "unknown", help: rule.help,
    }))),
  }) });
  expect(result.violations).toEqual([]);
});

Cấu hình đúng tên hai browser project trong Playwright rồi chạy lattice governance run. Collector đọc annotation lattice-axe từ JSON reporter; nó không tự đi qua toàn bộ route. Evidence chuẩn hóa chỉ lưu đường dẫn trang, rule và selector, không lưu URL đầy đủ hoặc nội dung trang. Báo cáo HTML/JSON liệt kê route đã quét, finding và project còn thiếu.

Hiểu kết luận

pass nghĩa là các phép kiểm tự động đã cấu hình không phát hiện vi phạm trên đúng route và ngữ cảnh đã test. Kết quả đó không chứng minh tuân thủ WCAG đầy đủ. Tài liệu Playwright nêu rõ công cụ tự động không phát hiện hết vấn đề; thao tác bàn phím, thứ tự focus, screen reader, ngôn ngữ và ý nghĩa nội dung cần người kiểm tra. Android Chrome ở đây được mô phỏng, không phải thiết bị thật. Người viết test có thể bỏ qua route hoặc tạo annotation giả; vì vậy phải bảo vệ CI và review thay đổi test.

Đây là baseline sản phẩm của NKLattice dựa trên các rule axe gắn nhãn WCAG 2.1 A/AA. Thông tư 26/2020/TT-BTTTT có đối tượng áp dụng và viện dẫn riêng. Báo cáo là bằng chứng kỹ thuật, không tự kết luận tuân thủ pháp luật cho website.