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

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 ​

  1. Mở https://tara.phillipcli.cloud.
  2. 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.
  3. GitHub hỏi có cho Tara đọc thông tin tài khoản không, bạn bấm Authorize.
  4. 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ãnGiá 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 **.

markdown
## 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út

Dev 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ếtMởỞ mục
Tổng quan dự án: tiến độ, duyệt lần đầu, làm lại, chi phí AI, task rủi roTaraProjects (dự án), bấm vào một dự án
Tiến độ sprintWeb BandumBoard, chọn repo và sprint
Task chờ kiểm thử, task bị trả lạiWeb BandumBoard, 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 BandumMetrics (số liệu)
Luồng công việc (Flow) và việc dùng AI của dự ánTaraProjects, phần Workflow (Flow) và AI
Tài nguyên AI của tổ chứcTaraExplore (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).

Board là nơi bạn bắt đầu: task nào ở cột Waiting for testing là đến lượt bạn.

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

  1. Mở web Bandum, đăng nhập qua Tara, vào Board rồi bấm task ở cột Waiting for testing.
  2. 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).
  3. 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.
  4. 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.
  5. Nếu cần, thêm General note (ghi chú chung).
  6. 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.

Phần Manual testing liệt kê từng testcase để bạn chấm Pass hoặc Fail, rồi bấm Approve hoặc Send back.
Nền tảngQuyền token cần
GitHubFine-grained: Issues, Pull requests, Contents đều Read and write trên repo dự án. Hoặc classic: repo
GitLabScope 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à:

bash
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ự án

Nếu danh sách trống, kiểm tra tổ chức đang dùng bằng ph org current.

Trang dự án trên Tara gom task theo trạng thái, chi phí AI và các chỉ số Flow của từng tuần.

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
VelocitySố task xong trong tuầnXem xu hướng qua các tuần
Flow time (trung vị, p85)Từ lần đầu "in progress" đến khi xongp85 xa trung vị nhiều nghĩa là có vài task nằm rất lâu
Flow efficiencyTỷ 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
WIPSố 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 taskDưới 80% thì phần theo loại hoặc theo task chưa đáng tin
Chi phí làm lạiChi phí AI phát sinh sau lần đầu task bị trả lạiCao 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.

Đọc thêm ​