Theo dõi tiến độ — dành cho Viewer

Đối tượng: stakeholder, PO, khách mời, auditor chỉ đọc. Role kỹ thuật: Board viewer (bảng space_members) và/hoặc Arkon viewer (doc:read:own_dept, wiki:read:own_dept, skill:read:own_dept).

Bạn là ai / không phải ai

• Bạn là: người cần nắm tiến độ, đọc đặc tả, tra cứu tri thức.
• Bạn không phải: người tạo task, chạy agent, duyệt merge, sửa Wiki trực tiếp.
• Ranh giới duy nhất cần nhớ: mọi nút "làm" và "duyệt" đều bị chặn với bạn — đó là thiết kế, không phải lỗi. Chi tiết bảng quyền: Phân quyền Board.

Màn hình bạn dùng

Màn hình	Đường vào	Bạn làm gì ở đây
Board View	Header → Board (mặc định)	Xem 4 cột Backlog → In Progress → Review → Done, đọc thẻ task (mã, tiêu đề, priority, agent type, badge blocked), mở panel Agent ở chế độ đọc (tab Event Stream / Changes)
Tree View	Header → Tree	Xem cây epic → story → task, tiến độ done/total từng nhánh — view tốt nhất để hỏi "còn bao nhiêu việc"
Wiki View (tab Documentation)	Header → Wiki	Đọc cây trang, nội dung, tìm Semantic Search; không thấy nút Approve/Reject
Arkon portal :3119 (Wiki, Graph)	menu Wiki / Wiki Graph	Đọc trang theo scope global + department của bạn, xem đồ thị liên kết, lịch sử phiên bản

Bạn không cần Planner View, Review View, Task Group, New Task / New Group — mở ra cũng chỉ để xem.

Theo dõi tiến độ dự án (5 phút mỗi sáng)

1. Mở Space → Board View: đếm thẻ từng cột. Thẻ có badge blocked nghĩa là đang chờ task khác done. (Vì sao? Xem Vì sao task chỉ mở khi blocker done.)
2. Cần nhảy nhanh? Bấm Cmd+K (macOS) / Ctrl+K (Windows/Linux) → gõ mờ tên Space, Epic, task hoặc view (gõ tắt kiểu epq vẫn trúng "Epic Payment Queue") → Enter để nhảy tới.
3. Chuyển Tree View khi cần nhìn kế hoạch lớn (Epic → Story → Task) thay vì thẻ rời rạc.
4. Muốn biết task cụ thể đang ở đâu trong vòng đời: đối chiếu cột Kanban + reviewState (peer-review = AI đang xem, human-gate = chờ người duyệt, approved = đã merge xong). Bảng đầy đủ: Máy trạng thái task.
5. Mở task → tab Comments: đọc realtime (có comment/xóa comment mới tự hiện, mất mạng tự tải lại khi nối lại); chip subtask ([mã] tiêu đề @persona) bấm để nhảy tới task con.

Badge realtime ở Header:

Badge	Ý nghĩa
Live	Đang nhận cập nhật
No updates yet	Đã nối nhưng phòng realtime của Space chưa vào (quá 5s chờ) — chưa có cập nhật
No updates	Server từ chối phòng (hết quyền) — sẽ không có cập nhật tới khi tải lại / được cấp quyền
Reconnecting…	Mất nối, đang nối lại

Đọc đặc tả và tri thức

1. Wiki View → Documentation: tìm trang spec (Planner tự sinh trang spec/<epic-key> khi apply plan).
2. Cần ngữ cảnh doanh nghiệp rộng hơn: sang Arkon :3119 → Wiki → tìm theo ngữ nghĩa, xem Knowledge Graph.
3. Thấy trang thiếu/sai? Bạn không tự sửa — ghi nhận và gửi cho member/contributor trong team để họ tạo draft. Quy trình duyệt draft: Nạp tài liệu & duyệt Wiki.

Phối hợp với team (không chạm nút)

• Muốn đổi yêu cầu: nhắn cho member/owner, họ sửa description / acceptance criteria của task.
• Muốn ưu tiên việc khác: nhắn cho member/owner kéo thẻ hoặc đổi priority — bạn không kéo-thả được.
• Muốn biết vì sao việc A chưa chạy: hỏi blocker của nó là task nào (xem quan hệ blocks ở Tree View).

Việc bạn KHÔNG làm được (và vì sao)

Bạn thử	Kết quả kỳ vọng	Vì sao
Bấm Approve / Request Changes	403, nút bị chặn	Approve cần Board admin và actor là con người có quyền — bạn là viewer
Tạo task, chạy agent, apply plan	403	Cần tối thiểu member
Duyệt Wiki draft	403	Cần admin (Board) hoặc wiki:write:all (Arkon)
Mở Space mà thấy trống / 403 mọi thứ	đúng thiết kế	Chưa có membership — nhờ owner Space cấp quyền. Phân quyền fail-closed: không membership = không quyền gì
Đọc trang Wiki của department khác	không thấy / chỉ thấy tên scope	Arkon cô lập theo department; out-of-scope chỉ lộ tên scope, không lộ nội dung

Checklist tự xác minh

• Đăng nhập xong thấy danh sách Space mình được mời (trống = chưa được cấp quyền, không phải lỗi hệ thống).
• Mở được Board, Tree, Wiki ở chế độ đọc; không thấy nút Approve khả dụng.
• Hiểu badge blocked và phân biệt review (đang thẩm định) với done (đã merge).
• Biết khi cần thay đổi thì liên hệ ai (member để sửa task, contributor để sửa Wiki, owner để cấp quyền).

Gặp 403 ở mọi thứ? → Xử lý sự cố.