Đọc theo vai trò
Mỗi trang chức năng có cùng 10 mục (xem mẫu trang). Mỗi vai trò đọc và viết vào các mục khác nhau.
| Mục | BA | Dev | Tester |
|---|---|---|---|
| 1. Mục đích & phạm vi | Viết | Đọc | Đọc |
| 2. Vai trò | Viết | Đọc (phân quyền) | Đọc (test theo vai trò) |
| 3. Luồng chính | Viết | Đọc | Đọc |
| 4. Vòng đời trạng thái | Viết | Đọc (state machine) | Đọc (test chuyển trạng thái) |
| 5. Business rule | Viết | Trích mã BR-xxx vào code / comment |
Trích mã BR-xxx vào test case |
| 6. Field, validation & thông báo | Viết | Đọc | Đọc (so nguyên văn thông báo) |
| 7. Ghi chú Dev | Đọc | Viết | Đọc |
| 8. Ghi chú Test | Đọc | Đọc | Viết |
| 9. Quyết định đã chốt | Viết | Đọc | Đọc |
| 10. Câu hỏi mở | Viết, chốt | Thêm câu hỏi | Thêm câu hỏi |
Ai cũng được sửa mọi mục — cột “Viết” chỉ là người thường viết nhất.
- Khi BRD của một chức năng lên version mới: cập nhật trang, đổi field
brd:trong frontmatter sang tên file mới, đổistatus. - Khi user chốt một câu hỏi: chuyển dòng từ mục 10 sang mục 9, ghi mã
Q-…của nhật ký hỏi–đáp. - Theo dõi thay đổi của người khác qua lịch sử commit của repo (nút Watch trên GitHub để nhận thông báo).
- Code theo mục 5 và mục 4. Gặp chỗ BRD/trang này không nói, đừng tự đoán — thêm một dòng vào mục 10. Câu hỏi mở.
- Ghi vào mục 7 những gì người sau cần biết: API, bảng, edge case đã xử lý, chỗ hệ thật đang khác thiết kế. Ghi rõ nguồn và ngày (xem quy ước).
Tester
Phần tiêu đề “Tester”- Test case lấy từ mục 8 (kịch bản nghiệm thu) và mục 5 (mỗi
BR-xxxít nhất một case đúng, một case bị chặn). - So thông báo lỗi nguyên văn với mục 6.
- Ghi vào mục 8 ca biên mới, dữ liệu mẫu dùng được trên DEV, và kết quả chạy (ngày, môi trường).