Số liệu trong mục Projects
Số liệu của tổ chức bạn nằm ở một chỗ: mục Projects trong Portal, ở thanh điều hướng phía trên, địa chỉ /<org>/projects. Bạn không cần cài gì. Mở Portal và bấm Projects. (Link cũ /<org>/insights vẫn mở được và tự chuyển về đây.)
Ai xem được
Mọi vai trò trong tổ chức: Owner, Admin, Member và Viewer. BA, PO, PM (Viewer) là nhóm dùng chính. Bạn chỉ thấy tổ chức nằm trên địa chỉ, và không thấy dữ liệu của tổ chức khác, kể cả khi bạn thuộc cả hai. Nhân viên nền tảng cũng không có thêm quyền gì với tổ chức của khách.
Số liệu đến từ Ryoma, nơi gom phiên AI và tiến độ task của từng tổ chức. Portal hỏi Ryoma thay bạn, nên số bạn thấy luôn là của tổ chức đang mở.
Đo những gì
Chỉ có hai khung:
- Flow Framework: tốc độ hoàn thành (flow velocity), thời gian xử lý (flow time), hiệu suất dòng chảy (flow efficiency), việc đang làm (flow load) và cơ cấu loại việc (flow distribution).
- Khung đo AI: mức dùng AI, mức chấp nhận, chi phí và tỷ lệ công việc có dùng AI.
Không có chỉ số DORA, không có khảo sát. Mọi số đều đo theo project và theo quy trình, không bao giờ theo từng người. Hãy so một project với chính nó qua thời gian, đừng so với project khác.
Khoảng thời gian
Ở đầu danh sách Projects và đầu trang của từng project, bạn chọn khoảng thời gian (7, 30, 90 ngày gần nhất, hoặc tự chọn). Lựa chọn nằm trên địa chỉ, nên gửi link là người kia thấy đúng màn hình của bạn, và khi mở một project thì khoảng thời gian vẫn giữ.
Biểu đồ gom công việc theo tuần, tuần bắt đầu từ thứ Hai. Khoảng thời gian được làm tròn theo tuần, dài nhất 51 tuần. Số task theo trạng thái, chi phí dự báo và task rủi ro luôn là tình trạng ngay lúc này, nên khoảng thời gian không áp dụng cho các số đó.
Danh sách Projects
/<org>/projects là màn hình của cả tổ chức:
- Bốn số chính, mỗi số so với tuần trước: số việc xong, flow time (trung vị), việc có AI và chi phí AI (kèm chi phí trên mỗi việc xong ở dòng dưới).
- Hai biểu đồ: số việc xong mỗi tuần theo loại việc, và chi phí AI mỗi tuần.
- Một bảng, mỗi project một dòng: repo, task theo trạng thái, số việc xong, flow time, hiệu suất, việc đang làm, việc có AI, chi phí AI và task rủi ro. Bấm tiêu đề cột để sắp xếp, bấm tên project để mở trang của nó. Repo chưa thuộc project nào được nhắc trong một dòng chú thích dưới bảng.
Trang của một project
/<org>/projects/<mã> cho thấy một project, cùng khoảng thời gian đó:
- Phần đầu. Các repo và liên kết của project (board Bandum), cùng nút gắn hoặc sửa repo nếu bạn có quyền.
- Người duyệt release. Ai được duyệt release của project trên Bandum. Owner của tổ chức luôn duyệt được. Chưa có danh sách thì owner và admin duyệt được; có danh sách thì chỉ người trong danh sách và owner (admin không có tên thì không duyệt được). Owner và admin đổi bằng nút Change.
- Các số chính. Bốn số như trên, thêm hiệu suất và số việc đang làm.
- Flow. Số việc xong mỗi tuần theo loại việc, flow time (trung vị và p85), hiệu suất, việc đang làm mỗi ngày và cơ cấu loại việc. Nếu ít việc xong có nhãn loại việc, trang sẽ có cảnh báo.
- AI. Việc có AI, chi phí AI mỗi tuần (tổng và phần gắn vào task), độ phủ chi phí, và chi phí mỗi việc xong theo loại việc. Nếu ít chi phí gắn được vào task, trang có một dòng lưu ý.
- Trước và sau khi dùng AI. Các tuần trước khi project dùng AI đặt cạnh số tuần tương đương sau đó: số task xong mỗi tuần, flow time, hiệu suất, việc đang làm, tỷ lệ duyệt lần đầu và làm lại. Xem bên dưới.
- Báo cáo tháng. Tải một tháng dưới dạng PDF một trang hoặc CSV. Xem bên dưới.
- Releases. Các release mới nhất của project, mỗi release kèm release wait time và chi phí AI. Release wait time tính từ lúc release sẵn sàng (task cuối cùng được duyệt hoặc đóng) tới lúc release được tạo. Đây là một đoạn trong flow time của các task đó, đo theo release. Chi phí AI là tổng chi phí AI của các task trong release. Release làm ngoài Bandum không có bản ghi duyệt nên hiện dấu gạch. Mục này trống cho tới khi có release được duyệt trên Bandum.
- Task. Task theo trạng thái, tỷ lệ đạt ngay lần đầu, tỷ lệ làm lại, thời gian trung bình ở mỗi trạng thái và chi phí dự báo.
- Task rủi ro. Những task chưa xong cần chú ý, kèm lý do.
Trước và sau khi dùng AI
Project có nhanh hơn sau khi dùng AI không? Khung Before and after AI trên trang project đặt hai giai đoạn cạnh nhau: 8 tuần trước khi project bắt đầu dùng AI và 8 tuần sau đó. Cả hai lấy từ lịch sử task đã đồng bộ, theo cùng định nghĩa Flow với các biểu đồ. Cột Change cho biết mỗi số đã đổi bao nhiêu.
- Ngày bắt đầu. Mặc định là ngày đầu tiên Ryoma nhận được telemetry từ các repo của project, và khung có ghi rõ như vậy. Owner hoặc admin của tổ chức đổi được bằng Change start date (ví dụ khi nhóm đã dùng AI từ trước bằng công cụ khác), và quay về mặc định bằng Use first telemetry day. Các vai trò khác chỉ xem.
- Ít task. Giai đoạn nào có dưới 10 task xong thì khung cảnh báo là so sánh chưa đáng tin. Hãy coi đó là gợi ý, không phải bằng chứng.
- Mới bắt đầu. Nếu project mới dùng AI chưa đủ 8 tuần, giai đoạn sau ngắn hơn. Hãy so số theo tuần, đừng so tổng.
- Chưa có ngày bắt đầu. Khi telemetry chưa về và chưa ai đặt ngày, khung chỉ báo như vậy.
Đây là tương quan, không phải bằng chứng về nguyên nhân, và đo theo project chứ không theo người. Giai đoạn trước không có chi phí AI vì lúc đó chưa có AI để đo.
Báo cáo tháng
Trên trang project, và ở đầu danh sách Projects cho cả tổ chức, mục Monthly report cho bạn chọn một tháng rồi tải:
- PDF, một trang A4 để đưa cho người ngoài nhóm đọc. Đầu trang ghi kỳ báo cáo và ngày tạo, tiếp đó là vài câu bình thường, rồi đến số của tháng đặt cạnh giai đoạn trước khi dùng AI: chi phí AI trên mỗi task được duyệt, bao nhiêu task được duyệt ngay lần đầu, bao nhiêu task bị trả lại (làm lại) và flow time. Cuối trang là các ghi chú về dữ liệu, ví dụ thiếu nhãn hoặc máy không gửi telemetry.
- CSV, số liệu theo tuần: mỗi dòng là một project trong một tuần chạm tháng đó, gồm các số Flow và chi phí AI của tuần.
Mọi vai trò trong tổ chức đều tải được. Tháng hiện tại là báo cáo dở dang, tính đến hôm nay. Tệp được dựng từ đúng số liệu mà các trang Projects đang đọc, và không bao giờ có số của từng người.
Số đếm của Guardrails
Guardrails đã chặn, hỏi lại hay che bao nhiêu lần không phải là chỉ số của project, nên nó nằm cùng chỗ với chính sách: Settings → Guardrails policy, mục What guardrails did (last 30 days). Mục này có bốn số đếm (Block, Ask, Mask, False positives) và một bảng theo project và theo luật. Chỉ có số đếm, không có tên người, và ai mở được trang Settings đó cũng thấy.
Ý nghĩa từng chỉ số
| Chỉ số | Cho bạn biết gì |
|---|---|
| Items done (flow velocity) | Số việc đã xong trong khoảng thời gian chọn. |
| Flow time | Một việc mất bao lâu, từ lúc có người bắt đầu làm đến lúc xong. Trung vị nghĩa là một nửa số việc xong nhanh hơn. p85 nghĩa là 85% số việc xong trong mức đó. |
| Flow efficiency | Phần thời gian của một việc thực sự được làm, so với thời gian chờ kiểm thử, chờ sửa hoặc chờ merge. Số thấp nghĩa là việc chờ nhiều hơn chạy. |
| Work in progress (flow load) | Số việc đã bắt đầu mà chưa xong, trung bình mỗi ngày. Nhiều việc cùng lúc thường làm mỗi việc lâu hơn. |
| Work mix (flow distribution) | Tỷ lệ việc xong theo loại: feature, bug, debt hoặc risk. Cho thấy công sức đang đổ vào đâu. |
| Work type coverage | Tỷ lệ việc xong có gắn nhãn loại việc. Dưới 80% thì cơ cấu loại việc chưa đáng tin. |
| AI users | Số người khác nhau đã dùng AI trong repo của project. Chỉ đếm, không nêu tên. |
| Items with AI | Tỷ lệ việc xong có ít nhất một phiên AI gắn mã task. |
| Cost coverage | Bao nhiêu chi phí AI gắn được vào task. Thấp nghĩa là nhiều phiên AI không ghi lại làm cho task nào. |
| AI cost | Chi phí AI quy đổi theo giá API. Đây là ước tính, không phải hóa đơn. "Attributed" là phần gắn được vào task. |
| AI cost per done item | Chi phí AI của các việc xong trong kỳ, chia cho số việc xong. |
| Release wait time | Một release đã xong phải chờ bao lâu, từ lúc task cuối cùng được duyệt hoặc đóng tới lúc tạo release. Một đoạn trong flow time của việc, đo theo release. |
| AI cost per release | Chi phí AI của mọi task trong một release cộng lại, theo giá API (ước tính). Dấu gạch nghĩa là không task nào có phiên AI. |
| First-pass approval | Tỷ lệ task được duyệt ngay ở lần kiểm thử đầu, trong số task đã kiểm thử. |
| Rework rate | Tỷ lệ task đã kiểm thử bị trả lại ít nhất một lần. |
| At-risk tasks | Task chưa xong mà chờ kiểm thử quá lâu, nằm quá lâu ở đang làm, bị trả lại nhiều lần, hoặc tốn AI nhiều hơn hẳn bình thường. |
| Forecast cost | Chi phí AI ước tính để làm nốt phần việc còn lại, dựa trên các task tương tự đã xong. |
| Guardrails decisions | Guardrails đã chặn, hỏi lại hay che bao nhiêu lần. Chỉ có số đếm, theo project và theo luật, không có tên người. |
| False positives | Những lần chặn mà người dùng báo là chặn nhầm. Một luật bị báo nhiều thì cần chỉnh lại. |
Chỉ số nào chưa có dữ liệu sẽ hiện dấu gạch (—), không bao giờ hiện số 0 giả.
Khi trang còn trống
Tổ chức mới chưa có gì để hiện, và điều đó bình thường. Mỗi màn hình trống đều chỉ bước tiếp theo:
- Chưa có project. Kết nối repo GitHub và gắn repo vào project. Xem Kết nối GitHub và Tổ chức.
- Chưa có số AI. Cài Phillip trên máy dev và chạy một task để telemetry bắt đầu về. Xem Bắt đầu cho dev và tester.
- Chưa có số Flow. Task lấy từ GitHub qua Bandum. Chạy task bằng
bandum startđể task đi qua các trạng thái. - Cơ cấu loại việc sai lệch. Gắn nhãn
type: feature,type: bug,type: debthoặctype: riskcho mỗi task.
Số mới có thể mất vài phút mới hiện. Portal nhớ kết quả 45 giây.
Xem cùng số liệu trong terminal
ph insights # tổng quan, mỗi project một dòng
ph insights flow --days 90
ph insights ai --project shop-web
ph insights health --json
ph insights flow --compare --project shop-web # trước và sau khi dùng AI
ph insights releases --project shop-web # release wait time và chi phí AI theo release
ph insights report --month 2026-12 --format pdf --project shop-web
ph insights report --month 2026-12 --lang vi # PDF bằng tiếng Việt (mặc định là en)
ph project release-approvers shop-web set maya.chen bo # owner hoặc admin: ai được duyệt release
ph project adoption shop-web --set 2026-09-01 # owner hoặc admin: đổi ngày bắt đầuCú pháp là ph insights [flow|ai|health|releases|report] [--project key] [--days N] [--from YYYY-MM-DD --to YYYY-MM-DD] [--json]. Lệnh in đúng số như các trang Projects, vai trò nào cũng dùng được. --json in dữ liệu gốc. ph insights report lưu PDF hoặc CSV của một tháng ra tệp (-o); thêm --lang vi thì nhãn, phần tóm tắt và ghi chú dữ liệu trong PDF viết bằng tiếng Việt (nút tải trên Portal theo ngôn ngữ bạn đang dùng ở đó), còn ph project adoption <key> xem, đặt hoặc xóa ngày project bắt đầu dùng AI. Xem ph insights.