Bắt đầu cho BA, PO, PM
BA, PO và PM làm mọi việc trên trình duyệt, không phải cài gì. Bạn đăng nhập Tara một lần, sau đó viết task, kiểm thử nghiệm thu và theo dõi dự án ngay trên web.
Tara, Ryoma và web Bandum đều chạy online. Bạn cần có một tổ chức trên Tara: hoặc Owner, Admin mời bạn vào với role Viewer, hoặc bạn tự tạo tổ chức. Xem Tạo hoặc vào một tổ chức. Viewer miễn phí và không tốn seat. Trong tài liệu này, địa chỉ Tara viết là https://tara.phillipcli.cloud. Nếu muốn kiểm thử ngay trên máy bằng lệnh thì xem Dev và Test.
Đăng nhập lần đầu
- Mở
https://tara.phillipcli.cloud. - Bấm Continue with GitHub. Nếu tổ chức bật đăng nhập một lần thì bấm nút SSO.
- GitHub hỏi có cho Tara đọc thông tin tài khoản không, bạn bấm Authorize.
- Nếu Owner hoặc Admin đã mời bạn, bạn vào thẳng tổ chức của họ. Nếu chưa, Tara hiện Get started, ở đó bạn mở link mời hoặc tạo tổ chức.
Khi thấy tên tổ chức và tên mình ở góc trên là bạn đã đăng nhập xong. Web Bandum có nút đăng nhập qua Tara, bạn dùng đúng tài khoản này, không có mật khẩu riêng.
Nếu chưa thấy tổ chức nào, bạn nhờ Owner hoặc Admin gửi lời mời. Nếu bạn thuộc nhiều tổ chức, dùng bộ chuyển ở phía trên để chọn. Các lỗi khác có trong Xử lý sự cố.
Gắn nhãn cho issue
Bandum đọc issue của bạn trên GitHub hoặc GitLab, nên issue cần hai nhãn: một nhãn cho biết đây là việc gì, một nhãn cho biết việc lớn hay nhỏ.
| Nhãn | Giá trị |
|---|---|
type: | feature, bug, debt, risk |
level: | S, M, L (kích cỡ công việc) |
Ryoma dựa vào type: để chia số liệu theo loại việc, nên thiếu nhãn này thì báo cáo sẽ lệch. Còn nhãn status: ... thì Bandum tự đổi, bạn không cần gắn. Vòng đời đầy đủ nằm ở Vòng đời một task.
Viết tiêu chí nghiệm thu
Mỗi tiêu chí nghiệm thu (AC) nằm trên một dòng riêng trong mô tả issue và bắt đầu bằng mã AC-<số>.<số>. Trước mã có thể có - , - [ ] hoặc **.
## Tiêu chí nghiệm thu
- [ ] AC-1.1 Đăng nhập đúng mật khẩu thì vào trang chủ
- [ ] AC-1.2 Sai mật khẩu 5 lần thì khóa tài khoản 15 phút
- [ ] AC-2.1 Quên mật khẩu gửi email đặt lại trong 1 phútDev dựa vào các mã này để viết testcase, và ph bandum review không cho chuyển sang kiểm thử khi còn AC chưa có testcase. Vì vậy mỗi AC nên kiểm tra được bằng một thao tác rõ ràng, đừng viết những câu kiểu "hệ thống chạy nhanh".
Task mức L thì spec nằm trong repo, ở docs/features/GH-<số>-<tên>/spec.md, và mỗi AC là một tiêu đề #### AC-1.1 .... Quy tắc đầy đủ có ở Định dạng Bandum.
Xem thông tin ở đâu
| Bạn muốn biết | Mở | Ở mục |
|---|---|---|
| Tổng quan dự án: tiến độ, duyệt lần đầu, làm lại, chi phí AI, task rủi ro | Tara | Projects (dự án), bấm vào một dự án |
| Tiến độ sprint | Web Bandum | Board, chọn repo và sprint |
| Task chờ kiểm thử, task bị trả lại | Web Bandum | Board, cột tương ứng |
| Tỷ lệ duyệt lần đầu, số lần trả lại, thời gian chờ kiểm thử | Web Bandum | Metrics (số liệu) |
| Luồng công việc (Flow) và việc dùng AI của dự án | Tara | Projects, phần Workflow (Flow) và AI |
| Tài nguyên AI của tổ chức | Tara | Explore (khám phá), lọc theo loại |
Bandum lấy số liệu từ GitHub hoặc GitLab. Nếu thấy số cũ, bạn bấm Sync now (đồng bộ ngay) trên Board. Nếu không thấy dự án của mình trong mục Projects, bạn nhờ Admin kiểm tra xem project đã có trong tổ chức chưa (Settings, rồi Projects).
Kiểm thử nghiệm thu trên web
Khi Dev làm xong, task chuyển sang cột Waiting for testing (chờ kiểm thử). Mỗi task có một danh sách testcase (TC), mỗi TC gắn với một hay nhiều AC, và bạn chấm từng TC là Pass (đạt) hoặc Fail (không đạt).
- Mở web Bandum, đăng nhập qua Tara, vào Board rồi bấm task ở cột Waiting for testing.
- Kéo xuống phần Manual testing (kiểm thử tay). Lần đầu sẽ hiện hộp Connect (kết nối), bạn dán token GitHub hoặc GitLab của mình vào rồi bấm Connect (quyền token ở bảng bên dưới).
- Nếu dự án có môi trường staging thì bấm Open staging (mở môi trường staging) để thử. Nếu chưa có, trang task sẽ hướng dẫn chạy ứng dụng trên máy bạn.
- Làm theo từng TC rồi chọn Pass hoặc Fail. Nếu chọn Fail, bạn phải mô tả lỗi.
- Nếu cần, thêm General note (ghi chú chung).
- Khi mọi TC đều đạt, bấm Approve (duyệt). Nếu có TC không đạt, bấm Send back (trả lại).
Làm xong thì trang hiện "Recorded run N" kèm kết quả, và task chuyển cột trên Board. Mỗi lần kiểm thử được thêm vào file acceptance.md của task trong nhánh PR, các lần trước không bị sửa.
| Nền tảng | Quyền token cần |
|---|---|
| GitHub | Fine-grained: Issues, Pull requests, Contents đều Read and write trên repo dự án. Hoặc classic: repo |
| GitLab | Scope api, vai trò Developer trở lên |
Cách tạo token từng bước có ảnh minh họa ở Kết nối GitHub hoặc GitLab.
Token chỉ nằm trong cookie đã mã hóa của trình duyệt, máy chủ không lưu. Bạn bấm Disconnect (ngắt kết nối) hoặc đăng xuất là token bị xóa. Kết quả được ghi dưới tên bạn, và người mở PR không tự duyệt PR của mình được.
Nếu thích dòng lệnh, bạn dùng ph bandum test GH-12. Cách chấm đầy đủ có ở Kiểm thử và nghiệm thu.
Báo bug khi đang kiểm thử
Nếu lỗi nằm ngay trong task đang kiểm thử, bạn chấm TC đó Fail và mô tả lỗi, Dev sẽ nhận lại qua nhận xét. Còn lỗi ngoài phạm vi task thì dùng mục Report a bug (báo bug) ở trang task để tạo issue mới có nhãn type: bug. Chi tiết ở Báo bug.
Theo dõi sức khỏe dự án (PM)
Mọi người trong tổ chức, kể cả Viewer, xem được mọi project của tổ chức. Ở Tara, mục Projects cho biết task theo trạng thái, tỷ lệ duyệt lần đầu, làm lại, chi phí AI và bảng task rủi ro kèm lý do.
Ngoài ra người liên hệ của project nhận bản tin tuần, mặc định vào sáng thứ Hai. Bản tin tóm tắt velocity, flow time, WIP, chi phí làm lại và độ phủ nhãn của tuần qua, kèm hướng tăng giảm so với tuần trước, và không chấm tốt xấu. Cảnh báo task rủi ro mới cũng đến qua kênh thông báo mà tổ chức đã bật.
Nếu bạn có dùng Phillip, lệnh tương ứng là:
ph ryoma projects # dự án bạn được xem
ph ryoma report --project <mã> # sức khỏe dự án và task rủi ro
ph ryoma alerts # hạn mức của dự ánNếu danh sách trống, kiểm tra tổ chức đang dùng bằng ph org current.
Dashboard
Số liệu nằm trong Portal, ở mục Projects. Danh sách cho bạn chỉ số Flow và AI của cả tổ chức, trang của từng project cho chi tiết, đều theo khoảng thời gian bạn chọn, mỗi chỉ số có một câu giải thích ngắn. Xem Số liệu trong Projects.
Đọc số liệu Flow và AI
Hai phần này nằm trong trang chi tiết của dự án trên Tara. Rê chuột lên tên chỉ số là thấy lời giải thích.
| Chỉ số | Nghĩa là | Cách đọc |
|---|---|---|
| Velocity | Số task xong trong tuần | Xem xu hướng qua các tuần |
| Flow time (trung vị, p85) | Từ lần đầu "in progress" đến khi xong | p85 xa trung vị nhiều nghĩa là có vài task nằm rất lâu |
| Flow efficiency | Tỷ lệ thời gian task được làm so với tổng thời gian làm và chờ | Thấp nghĩa là task chờ nhiều hơn được làm |
| WIP | Số task đang làm hoặc đang chờ | Cao thường đi cùng flow time dài |
| Độ phủ nhãn, độ phủ chi phí | Tỷ lệ task có nhãn type:, tỷ lệ chi phí AI gắn được vào task | Dưới 80% thì phần theo loại hoặc theo task chưa đáng tin |
| Chi phí làm lại | Chi phí AI phát sinh sau lần đầu task bị trả lại | Cao thì xem lại chất lượng AC và testcase |
Số liệu không dùng để chấm từng người
Đây là số liệu của dự án và luồng việc. Bạn đừng so dự án này với dự án khác, đừng dùng để đánh giá người, và đừng coi chênh lệch giữa có AI và không AI là quan hệ nhân quả. Thấy task nằm lâu thì hỏi cả nhóm xem đang vướng gì. Số liệu của từng người chỉ chính người đó xem được, quản trị viên cũng xem để quản lý hạn mức. Xem thêm Đo lường.