Thiết lập cấu trúc project
Role: Project Manager 📋
Project Organization là sơ đồ phân cấp nhân sự của dự án trong AIPD. Cấu trúc này xác định ai chịu trách nhiệm gì theo ba cấp độ, giúp AI Agent hiểu đúng ngữ cảnh phân quyền khi sinh tài liệu và thực thi task.
Ba cấp độ trong Project Organization
Project
├── Knowledge Owner (cấp 1 — quản lý knowledge & tài liệu nền)
│ ├── Task Manager (cấp 2 — điều phối và phân công công việc)
│ │ └── Task Executor (cấp 3 — thực thi task: BA, Dev, QA...)
│ └── Task Manager ...
└── Knowledge Owner ...
| Cấp | Label | Vai trò điển hình |
|---|---|---|
| 1 | Knowledge Owner | Solution Architect, Tech Lead |
| 2 | Task Manager | Project Manager, Team Lead |
| 3 | Task Executor | Business Analyst, Developer, QA |
Hướng dẫn thao tác
Trong sidebar, chọn Project Org thuộc nhóm Project Management.
Chọn project
Nhấn dropdown "Project" ở góc trên để chọn project cần cấu hình.
Xem sơ đồ tổ chức
Màn hình hiển thị toàn bộ sơ đồ theo ba hàng ngang, mỗi hàng là một cấp độ. Các node được nối với nhau bằng đường kẻ có animation. Số node của từng cấp hiển thị ở badge header.
- Nhấn một node để highlight node đó và các kết nối liên quan.
- Toggle "All Connections / Focus Mode" ở góc trên phải để chuyển đổi giữa chế độ xem tất cả kết nối và chỉ xem kết nối của node đang chọn.
- Dùng ô "Filter..." ở từng cấp để lọc node theo tên trong cấp đó.
Tạo và chỉnh sửa node
Nhấn đúp (double-click) vào bất kỳ node nào để mở modal chỉnh sửa:
| Trường | Bắt buộc | Ghi chú |
|---|---|---|
| Node Name | Có | Tên node (ví dụ: John Doe, Backend Team) |
| Node Description | Không | Mô tả ngắn về vai trò hoặc trách nhiệm |
| Node Level | Có | Chọn: Knowledge Owner, Task Manager, Task Executor |
| Parent Node | Không | Node cấp trên trực tiếp (dropdown từ danh sách các node cấp cao hơn) |
| Child Nodes | Không | Các node cấp dưới trực tiếp (multi-select) |
Nhấn "Save Changes" để cập nhật. Các đường kết nối trong sơ đồ tự vẽ lại ngay.
Xoá node: hover lên node → nhấn icon thùng rác 🗑️ xuất hiện ở góc → xác nhận.
Import sơ đồ từ Excel
Khi có sẵn danh sách nhân sự và phân cấp, dùng tính năng import để tạo nhanh toàn bộ sơ đồ:
- Nhấn nút "Import" ở góc trên phải.
- Chọn file
.xlsxhoặc.xlsđã chuẩn bị. - Hệ thống validate cấu trúc file và kiểm tra circular dependency.
- Nếu có xung đột với dữ liệu hiện tại, hộp thoại xác nhận override sẽ xuất hiện.
- Khi import thành công, sơ đồ tải lại tự động.
Export sơ đồ ra Excel
Nhấn nút "Export" → file {projectCode}_export.xlsx được tải về, chứa toàn bộ nodes, tên, mô tả và quan hệ phân cấp.
Lưu thay đổi
Mọi thao tác tạo/sửa/xoá node trên giao diện chỉ là thay đổi cục bộ cho đến khi nhấn "Save" (nút xanh, góc trên phải). Chỉ báo unsaved sẽ xuất hiện khi có thay đổi chưa lưu.
Thiết lập Project Organization trước khi bắt đầu sinh bất kỳ artifact nào. Sơ đồ này là ngữ cảnh để AI Agent biết ai đang yêu cầu, ai review, và ai thực thi — ảnh hưởng trực tiếp đến chất lượng output.
Sau khi hoàn tất sơ đồ tổ chức, chuyển sang bước 04 — Thiết lập configuration để cấu hình AI cho project.