Nạp tài liệu & duyệt Wiki — role tri thức Arkon

Đối tượng: Arkon contributor (viết/propose) và knowledge_manager (duyệt). Portal: Arkon :3119. Phạm vi áp dụng: Department của bạn + Global. Out-of-scope chỉ lộ tên scope, không lộ nội dung.

Bạn là ai

Role	Quyền cốt lõi	Bạn làm gì
viewer	doc/wiki/skill:read:own_dept	Đọc tri thức trong dept mình + global
contributor	+ doc:create:own_dept, wiki:write:own_dept, skill:create:own_dept	Upload tài liệu, propose draft Wiki/skill
knowledge_manager	doc/wiki/skill:*:all + skill:contribution:review + quản departments/employees/audit	Duyệt nội dung toàn hệ thống, quản category
admin	ALL_PERMISSIONS	Quản trị hệ thống — xem Vận hành

Quy tắc phân biệt quan trọng: propose draft cần wiki:write:*, nhưng direct edit/approve cần wiki:write:all — contributor không tự duyệt bài mình.

Đừng cấu hình theo tài liệu Workspace cũ

Tài liệu Arkon cũ còn mô tả Workspace realm + routers/projects.py, nhưng code hiện tại không còn — thực tế dùng Department / Global scope.

Nạp tài liệu vào Wiki — pipeline MRP

1. Knowledge → Upload Source: tải PDF/DOCX/MD/URL (ảnh được vision-caption trước khi biên dịch).
2. Pipeline MRP chạy: Map → Reduce → Plan-review → Refine → Verify → Commit. Mọi lần nạp sinh plan duyệt trước khi ghi (liệt kê trang nào tạo/cập nhật) — bạn xem plan, Approve Plan (hoặc Regenerate kèm feedback) rồi Arkon mới biên dịch cây trang liên kết chéo.
3. Trang mới merge (không overwrite) khi chạm trang cũ; mọi claim ghi nguồn biên dịch; draft persist giữa pipeline — crash chạy lại không mất việc LLM đắt tiền.
4. Theo dõi trạng thái nguồn: pending → processing → plan_ready → ready. Nguồn error → xem Xử lý sự cố.

Đề xuất và duyệt Wiki draft

• Propose (contributor): Wiki → Propose page (hoặc agent Board propose_wiki_edit / wikiProposals trong result.json tự thành draft). Draft vào hàng đợi.
• Review (knowledge_manager/admin): Wiki Review (/wiki/review, 3 pane queue/diff/meta, filter pending/needs_revision/approved/rejected, phím j/k/a/r/c/Esc/?) → đọc diff proposed/current + panel AI check + cảnh báo has_conflict → Approve & Merge / Request changes (note ≥ 20 ký tự) / Reject.
• Tác giả theo dõi draft của mình ở ?mine=true, có thể Withdraw/Resubmit.
• Conflict khi approve: vào Wiki Rebase (/wiki/branches/[id]/rebase) gỡ rồi merge lại.

Checklist tự xác minh

• Upload 1 file nhỏ → thấy plan_ready → Approve Plan → trang Wiki xuất hiện, có backlinks/outlinks, version history ghi nguồn.
• Propose 1 draft → manager thấy trong Review Queue → approve → trang live; thử Request changes note dưới 20 ký tự → bị từ chối đúng kỳ vọng.
• Tìm ngữ nghĩa ra trang mới nạp (chứng tỏ embedding chạy); đổi scope global/department thấy tập trang đổi theo.

Đọc tiếp: Board ↔ Wiki, Skills & MCP.