Nhận và trả việc
- PM điền
owner, reviewer, due cho trang trong assets/manifest.js.
- Người viết đổi
status sang "dang-viet", đọc Mục tiêu & phạm vi và Thuật ngữ.
- Sửa bản nháp: xác nhận hoặc thay từng nhãn , điền ….
- Khi trang không còn nhãn giả định: đổi
status sang "review", báo reviewer.
- Reviewer góp ý trực tiếp (comment PR hoặc ghi vào mục Câu hỏi mở). Đạt → reviewer đổi sang
"da-chot", bản 1.0.
Một người — một fileChỉ sửa trang mình phụ trách và dòng của mình trong manifest. Cần sửa trang người khác: ghi vào mục Câu hỏi mở của trang đó hoặc báo người viết.
Cấu trúc trang
Trang module giữ đúng thứ tự mục của trang mẫu. Trang tổng quan, kênh, phi chức năng được bỏ mục không hợp, nhưng luôn giữ Câu hỏi mở và Lịch sử thay đổi.
| Mục | Trả lời câu hỏi |
|---|
| Mục tiêu | Làm để đạt gì, đo bằng gì, không làm gì |
| Vai trò & quyền | Ai được làm gì |
| User stories | Nhu cầu từng vai trò, ưu tiên |
| Luồng chính | Các bước theo thứ tự |
| Màn hình | Màn nào, có gì, bấm gì |
| Quy tắc nghiệp vụ | Điều kiện, giới hạn, công thức |
| Trường dữ liệu | Lưu gì, kiểu, ràng buộc |
| Trạng thái | Vòng đời đối tượng, ai chuyển |
| Ngoại lệ & lỗi | Hỏng thì sao, báo người dùng gì |
| Tiêu chí nghiệm thu | QA kiểm gì để đóng |
Văn phong
| Quy tắc | Nên | Không nên |
|---|
| Bảng trước văn xuôi | Liệt kê quy tắc thành bảng có mã | Đoạn văn dài nhiều điều kiện |
| Kiệm chữ | "Mỗi SĐT tối đa 3 lượt/ngày." | "Hệ thống sẽ cần phải đảm bảo rằng mỗi số điện thoại…" |
| Đo được | "Phản hồi ≤ 300 ms ở p95" | "Nhanh", "mượt", "thân thiện" |
| Một ý một nơi | Link sang trang chủ quản | Chép lại quy tắc của trang khác |
| Tiếng Việt | Giữ thuật ngữ quen: campaign, booth, voucher, OTP | Dịch gượng ("chiến dịch kích hoạt ngoại tuyến") |
| Tên gọi | Đúng bảng Thuật ngữ | Tự đặt tên mới ("giải thưởng", "phần quà" lẫn lộn) |
| Tiêu chí nghiệm thu | "Cho … khi … thì …" | "Chức năng hoạt động đúng" |
Kỹ thuật
| Việc | Cách làm |
|---|
| Thêm trang | Copy _mau/trang-mau.html → thêm 1 dòng vào manifest.js |
| Mở xem | Mở thẳng file HTML trong trình duyệt, hoặc chạy python3 -m http.server ở thư mục gốc dự án rồi vào /docs/ |
| Số mục, mục lục, menu | Tự sinh — chỉ viết <section id><h2> |
| Ảnh | Đặt cạnh trang trong thư mục img/ của nhóm, định dạng WebP/PNG, ≤ 300 KB |
| Mockup | Dẫn link Figma hoặc màn mẫu trong design/templates/; không dán ảnh chụp lớn |
| Màu, chữ, component | Chỉ dùng lớp .doc-*, .ds-* có sẵn. Không viết style="" |
| Git | Mỗi trang một nhánh/PR; tiêu đề PR: docs(<MOD>): … |
Lịch sử thay đổi
| Bản | Ngày | Người sửa | Nội dung |
|---|
| 0.1 | 2026-11-11 | PM | Khởi tạo |