Tạo BRD
Route: Open BRD Generation
Assignee: Business Analyst 📝
BRD (Business Requirement Document) là tài liệu mô tả toàn bộ yêu cầu nghiệp vụ của một tính năng từ góc nhìn business. AIPD sinh BRD qua luồng 3 bước tuần tự: cấu hình nguồn → trả lời tiêu chí → nhận tài liệu hoàn chỉnh. Nội dung được stream realtime — chữ xuất hiện dần dần thay vì chờ đến khi xong.
Giao diện tổng quan
Màn hình chia thành hai vùng:
- Cột trái (Ticket Sidebar): Danh sách BRD tickets của project, có ô tìm kiếm và nút tạo mới.
- Vùng phải (Main Panel): Workspace 3 bước làm việc với ticket đang chọn.
Trạng thái ticket hiển thị bằng badge màu:
| Trạng thái | Ý nghĩa |
|---|---|
CREATED | Ticket vừa tạo, chưa bắt đầu phân tích |
DRAFTING | Đang soạn thảo BRD |
WAITING_REVIEW | Đã gửi yêu cầu review |
APPROVED | BRD đã được phê duyệt |
REJECTED | BRD bị từ chối, cần chỉnh sửa lại |
Bước 1: Tạo BRD Ticket
Nhấn nút "+" ở đầu cột trái để mở modal tạo ticket mới.
| Trường | Bắt buộc | Ghi chú |
|---|---|---|
| Jira Ticket ID | Không | Liên kết với Jira ticket tương ứng |
| Summary | Có | Tiêu đề ngắn gọn của yêu cầu |
| Description | Có | Mô tả chi tiết ngữ cảnh |
| Type | Có | Epic hoặc Task |
| Due Date | Có | Hạn chót |
| Assignee | Có | Người phụ trách |
| Labels | Không | Nhãn phân loại |
| Components | Không | Thành phần liên quan |
Nhấn "Create" để tạo. Ticket mới xuất hiện trong danh sách với trạng thái CREATED.
Bước 2: Source — Cấu hình nguồn phân tích
Chọn ticket từ danh sách. Tab "Source" mở ra mặc định.
Thêm các nguồn thông tin để AI có đủ ngữ cảnh sinh BRD chính xác:
| Nguồn | Mô tả |
|---|---|
| Jira Tickets | Các Jira ticket liên quan — AI đọc để hiểu yêu cầu gốc |
| Confluence Pages | Trang tài liệu tham khảo từ Confluence |
| Uploaded Files | Upload file tài liệu (BRD, TRD hoặc tài liệu khác) |
| System Features | Chọn system và features bị ảnh hưởng bởi yêu cầu này |
| High Level Requirement | Ô mô tả thêm ngữ cảnh trực tiếp cho AI |
Sau khi thêm đủ nguồn, nhấn "Analyse".
Hệ thống chuyển sang bước tiếp theo và hiển thị "AI is processing data... / Please wait while AI generates results" trong lúc xử lý.
Bước 3: Information Collection — Trả lời tiêu chí
Sau khi phân tích xong, tab tự chuyển sang "Information Collection".
AI sinh ra danh sách các câu hỏi tiêu chí (Criteria Questions) — mỗi câu là một khía cạnh nghiệp vụ cần làm rõ trước khi viết BRD. Ví dụ: phạm vi áp dụng, điều kiện tiên quyết, trường hợp ngoại lệ...
Thực hiện với từng câu hỏi:
-
Đọc nội dung câu hỏi và gợi ý (hint) kèm theo.
-
Nhập câu trả lời vào ô input phía dưới.
-
Nhấn "Verify" — hệ thống kiểm tra câu trả lời và cập nhật trạng thái:
- ✅ Pass — câu trả lời đủ thông tin
- ❌ Fail — cần bổ sung thêm
-
Lần lượt trả lời tất cả các câu.
Sau khi tất cả câu hỏi đều Pass, hệ thống tự động chuyển sang bước tiếp theo và bắt đầu sinh BRD.
Với những câu hỏi không có thông tin để trả lời hoặc không áp dụng cho tính năng này, nhấn "Skip" để bỏ qua. Câu hỏi được skip sẽ không ảnh hưởng đến quá trình sinh BRD — AI sẽ bỏ qua tiêu chí đó và tiếp tục với các câu còn lại.
Câu trả lời càng cụ thể và đầy đủ, BRD được sinh ra càng ít cần chỉnh sửa. Thay vì trả lời ngắn như "Có", hãy giải thích rõ bối cảnh và điều kiện cụ thể.
Bước 4: BRD — Đọc, chỉnh sửa và lưu
Tab "BRD" hiển thị nội dung được stream realtime vào editor — chữ xuất hiện dần dần cho đến khi hoàn tất.
Chỉnh sửa nội dung
Sau khi stream xong:
- Nhấn "Edit" (icon bút chì) để vào chế độ chỉnh sửa.
- Chỉnh sửa trong rich text editor — hỗ trợ heading, bullet list, bảng, code block và Markdown.
- Nhấn "Save" (icon ✓) để lưu thay đổi.
Nhấn "Cancel" để huỷ và quay về nội dung trước.
Chuyển sang BDD
Dropdown phía trên editor cho phép chuyển chế độ xem:
- BRD — Business Requirement Document (mặc định)
- BDD — Behavior Driven Development format (Given/When/Then)
Gửi BRD để Review
Khi nội dung BRD đã hoàn chỉnh, nhấn "Request Review" ở footer. Trạng thái ticket chuyển thành WAITING_REVIEW.
Reviewer nhận được thông báo và có thể:
- Nhấn "Approve" → trạng thái chuyển thành
APPROVED - Nhấn "Reject" → trạng thái chuyển thành
REJECTED, BA cần chỉnh sửa và gửi lại
BRD được phê duyệt (APPROVED) sẽ tự động được đưa vào Knowledge Base. Từ thời điểm đó, AI Agent có thể tham chiếu BRD này khi sinh Implementation Plan và Test Cases cho cùng tính năng.