Tuyên bố về trợ năng

SoftHarbor muốn ai cần tìm phần mềm cũng dùng được — kể cả người chỉ dùng bàn phím, trình đọc màn hình, phóng to màn hình, điều khiển bằng giọng nói hay giao diện tương phản cao. Trang này nói rõ mục tiêu của chúng tôi, những gì trang đã làm được, những gì còn chưa ổn, và cách báo cho chúng tôi khi bạn gặp trở ngại.

Mục tiêu

Mục tiêu của chúng tôi là Web Content Accessibility Guidelines (WCAG) 2.2 ở mức AA. Đây là đích hướng tới cho công việc, không phải lời khẳng định mọi trang đều đã đạt: chưa có đánh giá độc lập nào.

Trang đã làm được gì

• Mọi thứ dùng được chỉ với bàn phím. Điểm dừng đầu tiên trên mỗi trang là liên kết “Tới nội dung chính”, và mục đang chọn luôn có viền bao quanh.
• Trang được dựng bằng tiêu đề, danh sách và vùng mốc thật, đồng thời khai báo ngôn ngữ, để trình đọc màn hình phát âm đúng tiếng Anh và tiếng Việt.
• Chữ và nút giữ độ tương phản ở cả giao diện sáng lẫn tối, được kiểm tra bằng bài test tự động: 7:1 cho chữ nội dung, 4.5:1 cho chữ khác, 3:1 cho viền điều khiển.
• Không có gì chỉ dựa vào màu sắc: trạng thái bảo mật có hình biểu tượng riêng, và mục bạn đang xem được gạch chân.
• Phần cài đặt hiển thị (nút thanh trượt ở góc trên bên phải) có giao diện sáng hoặc tối, giảm chuyển động, thanh cuộn mảnh hoặc ẩn, và công tắc tắt phím tắt tìm kiếm “/”. Trang cũng làm theo thiết lập giảm chuyển động và màu tương phản cao của hệ điều hành.
• Chữ phóng to được đến 200 %, và bố cục tự sắp lại đến cỡ màn hình điện thoại hẹp mà không phải cuộn ngang.
• Khi bạn tìm kiếm hay lọc, số kết quả được đọc cho trình đọc màn hình.
• Không có hình ảnh chứa chữ. Logo ứng dụng chỉ để trang trí; tên ứng dụng luôn là chữ.

Chúng tôi kiểm tra thế nào

• Mỗi lần thay đổi: kiểm tra trợ năng tự động (axe, theo các quy tắc WCAG 2.0 đến 2.2 mức A và AA) trên các trang chính ở cả hai giao diện, trên màn hình máy tính và cỡ điện thoại, cùng các bài test dùng bàn phím, tự sắp lại bố cục, màu tương phản cao và độ tương phản.
• Kiểm tra tay, ngày 9/11/2026: chỉ dùng bàn phím, và trình đọc màn hình Narrator, trên Windows 11 với Chrome, Brave và Firefox.
• Chưa kiểm tra: NVDA, JAWS, VoiceOver (macOS và iOS), TalkBack và Safari. Chúng tôi rất mong nhận phản hồi từ những công cụ này.

Hạn chế đã biết

• Sau khi bạn chấp nhận thông báo pháp lý, một bước kiểm tra bot ngắn của Cloudflare (Turnstile) sẽ chạy. Đây là tiện ích của bên thứ ba mà chúng tôi không kiểm soát được hoàn toàn. Nếu nó không chạy xong, bạn vẫn được vào — sau 10 giây, hoặc 2 phút nếu nó yêu cầu bấm.
• Mỗi ứng dụng trong danh mục dẫn đến trang web và bộ cài của chính nhà phát triển. Mức độ trợ năng ở đó nằm ngoài tầm kiểm soát của chúng tôi; hãy báo cho nhà phát triển, và báo cho chúng tôi nếu mục giới thiệu nên ghi chú điều đó.
• Thẻ ứng dụng rút gọn phần tóm tắt còn hai dòng. Toàn văn có ở trang riêng của từng ứng dụng.
• Các trang pháp lý tiếng Việt là bản dịch; bản tiếng Anh là bản có giá trị.

Báo một trở ngại

Gửi email đến accessibility@poli0981.dev, hoặc mở một issue về trợ năng trên GitHub (cần tài khoản GitHub; email thì không cần). Nếu được, hãy cho biết bạn đang ở trang nào, định làm gì, chuyện gì đã xảy ra, và bạn dùng thiết bị, trình duyệt, công nghệ hỗ trợ nào. Ảnh chụp hay video màn hình luôn được hoan nghênh nhưng không bắt buộc, và bạn không bao giờ cần cho chúng tôi biết về tình trạng khuyết tật. Bạn có thể viết bằng tiếng Việt hoặc tiếng Anh.

Sau khi bạn báo

SoftHarbor do một người vận hành, nên đây là những cam kết giữ được. Chúng tôi trả lời trong vòng 7 ngày và đánh giá mức độ trở ngại:

• Nghiêm trọng — khiến bạn không tìm, đọc hay mở được liên kết của ứng dụng: sửa trong 30 ngày;
• Nặng — khó vượt qua, dù vẫn có cách khác: trong 60 ngày;
• Vừa hoặc nhẹ — gây phiền hoặc thiếu nhất quán: trong 90 ngày.

Nếu trễ hạn, chúng tôi sẽ nói rõ lý do, đưa ra cách tạm thời, và hẹn ngày mới. Chúng tôi có thể nhờ bạn xác nhận bản sửa trước khi đóng báo cáo.

Dành cho người đóng góp

Cách chúng tôi giữ cho mọi thay đổi đều dễ tiếp cận — các bước kiểm tra một pull request phải qua và những gì cần thử bằng tay — nằm trong ACCESSIBILITY.md ở kho mã nguồn.