Nền tảng
Nội dung và ngôn ngữ
Đã đặc tảTiếng Việt là ngôn ngữ giao diện mặc định. Nhãn là động từ, không phải danh từ. Không bao giờ thiết kế cho một độ dài chuỗi cố định. Obligation A21–A24. Trang này nói về hình dạng của chữ trên giao diện; nó không sở hữu nội dung nghiệp vụ.
Nghĩa vụ
Obligation
A21
A21 Ngôn ngữ được khai báo
<html lang="vi">. Một đoạn bằng ngôn ngữ khác mang lang của chính nó. Screen reader chọn bộ phát âm theo lang; chữ tiếng Việt đọc bằng giọng tiếng Anh là không hiểu được. Tên riêng — NexoBox, NexoCrew, NexoFrame — không mang lang="en".
A22
A22 Nhãn mô tả việc
Nhãn nút là động từ cho hành động sắp xảy ra: Lưu, Gửi, Xoá nhân sự. Không phải OK, không phải Submit. Nếu một nút hiện chữ Lưu, tên trợ năng của nó phải chứa chữ Lưu (Label in Name). Sentence case — không TOÀN BỘ CHỮ HOA, vì dấu tiếng Việt trên chữ hoa bị chật và mất nét.
A23
A23 Lỗi nói được cách sửa
Thông báo lỗi nêu ba thứ: trường nào, sai cái gì, sửa thế nào. Email không hợp lệ mới có hai phần ba; Email cần có dạng ten@congty.vn đủ ba. Không chỉ bằng màu — viền đỏ là tín hiệu thứ hai, không phải duy nhất.
Cảnh báo
Không đổ lỗi. "Bạn nhập sai" là đổ lỗi. "Cần ít nhất 8 ký tự" là hướng dẫn.
A24
A24 Trợ giúp nhất quán
Nếu một cơ chế trợ giúp tồn tại — liên kết tài liệu, kênh liên hệ, ô tìm kiếm — nó nằm ở cùng vị trí tương đối trên mọi trang có nó. Trên site này, ô tìm kiếm sidebar và command palette (⌘K) là cơ chế trợ giúp; chúng giữ nguyên vị trí và phím tắt trên mọi route.
Quy tắc
Hình dạng chuỗi
| Thứ | Luật |
|---|---|
| Nhãn nút | Một tới ba từ. Động từ trước |
| Tiêu đề trang | Danh từ. Không kết thúc bằng dấu chấm |
| Câu trợ giúp | Một câu. Có dấu chấm |
| Nhãn trường | Danh từ, sentence case, không có dấu hai chấm |
| Placeholder | Ví dụ, không phải nhãn. Không bao giờ thay cho <label> |
| Trạng thái rỗng | Nói cái gì chưa có và bước tiếp theo là gì |
Đừng thiết kế cho một độ dài chuỗi. Lưu dài 3 ký tự, bản tiếng Đức Speichern dài 9 — nút phải giãn theo nội dung. Đừng ghép câu từ nhiều mảnh chuỗi: "Đã xoá " + n + " nhân sự" không dịch được và không xử lý được số nhiều ở các ngôn ngữ khác.
Định dạng
Số, ngày, tiền
Ngày dạng dd/mm/yyyy. Số dùng dấu chấm phân nhóm nghìn và dấu phẩy thập phân theo quy ước Việt Nam. Tiền ghi ₫ sau số. Giá trị và ngưỡng nghiệp vụ không thuộc trang này — chúng phải cite metric ID từ docs/10_metrics/registry.md.
Chưa quyết
Open questions
| Question | Owner | Resolves when |
|---|---|---|
| Giao diện có bản tiếng Anh không? | nexoboxvn@gmail.com | Một thị trường hoặc khách hàng trong docs/01_strategy/ yêu cầu |
| Có hỗ trợ RTL không? | nexoboxvn@gmail.com | Một ngôn ngữ RTL nằm trong phạm vi |
| Ai sở hữu thư viện chuỗi giao diện? | nexoboxvn@gmail.com | 05_content/ được mở |