Bỏ qua, đến phần nội dung

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.

Hai đường kiểm thử nghiệm thu hội tụ vào một quyết định. Đường tự động chạy ph bandum verify và đọc kết quả JUnit theo mã testcase. Đường tay chạy ph bandum test rồi chấm từng testcase Đạt hoặc Không đạt trên web hoặc bằng cờ cli. Cả hai ghi kết quả vào acceptance.md, rồi task được Duyệt hoặc Trả lại.Tự độngTayKiểm tự độngph bandum verifyĐọc kết quả JUnitghép test với mã TCKiểm thử tayph bandum testChấm từng TCĐạt hoặc Không đạt,trên web hoặc --cliGhi kết quảacceptance.md,commit và pushDuyệtstatus: approvedTrả lạistatus: rejected

Vuốt ngang để xem hết sơ đồ.

Cả hai đường đều ghi vào acceptance.md, mang tên tài khoản của người kiểm thử. Người mở PR không tự duyệt PR của mình.

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 taskThư mục trong nhánh PR
S, Mdocs/acceptance/GH-<số>/
Ldocs/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:

bash
ph bandum verify GH-12

Phillip 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:

bash
ph bandum test GH-12

Cách thứ ba là làm ngay trong terminal, không cần web:

bash
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.

Trang task giữ lại từng lần kiểm thử, nên bạn thấy ngay testcase nào đã không đạt ở lần trướ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.

  1. Xem nhận xét của lần kiểm thử gần nhất:

    bash
    ph bandum pull GH-12
  2. Giao agent sửa theo nhận xét, testcase và AC:

    bash
    ph bandum fix GH-12

    Nếu cần truyền thêm tham số cho Claude Code thì đặt sau --, xem ph bandum.

  3. Chạy lại kiểm thử rồi chuyển lại:

    bash
    ph 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ấyCách xử lý
Nút Approve hoặc Send back không bấm đượcCò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.jsonDự á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ó testcaseNhờ Dev bổ sung testcases.md rồi chuyển lại kiểm thử

Đọc thêm ​