Kiểm thử và nghiệm thu
Dev, Test và BA nghiệm thu một task bằng hai cách: chạy tự động với ph bandum verify, hoặc chấm tay với ph bandum test. Trang này đi qua cả hai, và cả việc xử lý khi task bị trả lại. Task cần đang ở trạng thái status: review, xem Vòng đời một task.
Vuốt ngang để xem hết sơ đồ.
Testcase nằm ở đâu?
Mỗi task có file testcases.md liệt kê các testcase (TC). Mỗi TC gắn với ít nhất một tiêu chí nghiệm thu (AC), và mỗi AC phải có ít nhất một TC. File nằm trong nhánh PR, tùy mức task.
| Mức task | Thư mục trong nhánh PR |
|---|---|
| S, M | docs/acceptance/GH-<số>/ |
| L | docs/features/GH-<số>-<tên>/ |
Trong thư mục có testcases.md, acceptance.md (kết quả các lần kiểm thử) và evidence/ (ảnh chụp). Bạn chỉ thêm vào cuối acceptance.md, không sửa các lần cũ, và nếu có ai sửa thì ph bandum check báo acceptance_edited. Định dạng đầy đủ nằm ở Định dạng Bandum.
Kiểm thử tự động
Dự án khai cách chạy trong .bandum.json ở gốc repo, gồm setup, run, test và report. Lệnh verify lấy nhánh PR về một worktree, chạy các bước đó, đọc kết quả JUnit theo mã TC rồi ghi vào acceptance.md:
ph bandum verify GH-12Phillip ghép test với TC qua tên. Tên test (hoặc classname) cần chứa mã TC đứng riêng, ví dụ TC-1 (AC-1.1) đăng nhập đúng mật khẩu. TC nào không có test, hoặc test bị bỏ qua, thì tính là không đạt. Lệnh thoát với mã 0 khi đạt và 2 khi trả lại, nên chạy được trong CI. Thêm --quiet nếu muốn bớt log.
Kiểm thử tay
Bạn chấm tay khi TC cần người nhìn kết quả, và có ba cách.
Cách thứ nhất là web Bandum. Bạn mở trang task, vào phần Manual testing (kiểm thử tay), chấm từng TC Pass (đạt) hoặc Fail (không đạt) (không đạt thì phải mô tả lỗi), rồi bấm Approve (duyệt) nếu mọi TC đạt, hoặc Send back (trả lại). Các bước chi tiết cho BA nằm ở Bắt đầu cho BA, PO, PM. Nếu dự án khai stagingUrl thì trang task có thêm nút Open staging (mở môi trường staging).
Cách thứ hai là để lệnh test mở sẵn web. Lệnh lấy nhánh PR về, chạy ứng dụng, mở app và trang task để bạn chấm:
ph bandum test GH-12Cách thứ ba là làm ngay trong terminal, không cần web:
ph bandum test GH-12 --cli # hỏi từng TC
ph bandum test GH-12 --pass TC-1,TC-2 --fail "TC-3=Không bị khóa" --note "Đã thử trên Chrome"Hai cách sau đều để Phillip ghi acceptance.md, commit và push lên nhánh PR, review PR và đặt nhãn status: approved hoặc status: rejected. Bạn thêm --evidence <file> để đính ảnh chụp. Kết quả luôn mang tên tài khoản GitHub hoặc GitLab của người kiểm thử, và người mở PR không tự duyệt PR của mình được.
Task bị trả lại thì làm gì?
Task bị trả lại khi có ít nhất một TC không đạt. Lúc này Dev xử lý theo ba bước.
Xem nhận xét của lần kiểm thử gần nhất:
bashph bandum pull GH-12Giao agent sửa theo nhận xét, testcase và AC:
bashph bandum fix GH-12Nếu cần truyền thêm tham số cho Claude Code thì đặt sau
--, xemph bandum.Chạy lại kiểm thử rồi chuyển lại:
bashph bandum verify GH-12 ph bandum review GH-12
Bandum và Ryoma tổng hợp tỷ lệ duyệt lần đầu và số lần trả lại theo dự án. Đây là số liệu của luồng việc, không dùng để đánh giá từng người.
Gặp lỗi thì xem ở đâu?
| Thấy | Cách xử lý |
|---|---|
| Nút Approve hoặc Send back không bấm được | Còn TC chưa chấm, hoặc có TC không đạt mà chưa mô tả lỗi. Approve chỉ bấm được khi mọi TC đạt |
| "The PR branch just changed" | Bấm Reload (tải lại) và kiểm thử bản mới |
The repo has no .bandum.json | Dự án chưa khai cách chạy ứng dụng, bạn dùng --cli hoặc hỏi Dev |
| Task không có testcase | Nhờ Dev bổ sung testcases.md rồi chuyển lại kiểm thử |