Hướng dẫn Khung mẫu Tài liệu Yêu cầu Nghiệp vụ (BRD)¶
1. Giới thiệu¶
BRD (Business Requirements Document – Tài liệu Yêu cầu Nghiệp vụ) là tài liệu mô tả bối cảnh, mục tiêu, phạm vi, quy trình và các yêu cầu nghiệp vụ của một dự án hoặc sáng kiến.
BRD tập trung làm rõ hai nội dung chính: - Tại sao (Why): Dự án hoặc thay đổi nghiệp vụ cần được thực hiện. - Doanh nghiệp cần gì (What): Để giải quyết vấn đề hoặc đạt được mục tiêu đã xác định.
Tài liệu được xây dựng từ góc nhìn nghiệp vụ (Business Viewpoint) và là cơ sở để các bên liên quan thống nhất về nhu cầu trước khi yêu cầu được tiếp tục phân tích, phân rã và đặc tả ở các tài liệu sản phẩm, hệ thống và kỹ thuật.
flowchart LR
BRD["BRD\nBusiness Requirements\n(Business View)"] --> PRD["PRD\nProduct Requirements\n(Product View)"]
PRD --> SRS["SRS\nSoftware/System Requirements\n(System View)"]
SRS --> DEV["Development\n(Implementation)"]
SRS --> QA["Testing & UAT\n(Verification)"]Mối quan hệ giữa các nhóm tài liệu được phân định như sau:
| Tài liệu | Nội dung trọng tâm | Góc nhìn (Perspective) |
|---|---|---|
| BRD | Bối cảnh, mục tiêu, phạm vi và yêu cầu nghiệp vụ | Business |
| PRD | Khả năng và yêu cầu của sản phẩm | Product |
| SRS | Yêu cầu chức năng và phi chức năng của hệ thống | System / Software |
| Technical Design | Giải pháp và thiết kế phục vụ triển khai | Engineering |
[!NOTE] Nguyên tắc ranh giới: BRD không nhằm mô tả chi tiết giải pháp kỹ thuật. Các nội dung như kiến trúc phần mềm, thiết kế cơ sở dữ liệu vật lý, API, hạ tầng hoặc chi tiết triển khai được đặc tả trong các tài liệu kỹ thuật tương ứng.
2. Mục đích của Bộ khung BRD¶
Bộ khung BRD được xây dựng nhằm cung cấp một cấu trúc thống nhất cho việc lập, rà soát, phê duyệt và quản lý tài liệu yêu cầu nghiệp vụ trong các dự án.
Khung tài liệu hướng đến các mục tiêu: - Chuẩn hóa cách trình bày tài liệu BRD giữa các dự án. - Làm rõ bối cảnh, vấn đề và mục tiêu nghiệp vụ trước khi xác định giải pháp. - Xác định rõ phạm vi và ranh giới của dự án. - Thống nhất yêu cầu giữa Business Owner, Product Owner, Business Analyst và các bên liên quan. - Hỗ trợ truy vết từ mục tiêu nghiệp vụ đến yêu cầu và tiêu chí nghiệm thu. - Tạo đầu vào nhất quán cho PRD, SRS, Use Case và các tài liệu thiết kế tiếp theo. - Hỗ trợ quá trình review, phê duyệt và quản lý thay đổi yêu cầu.
Bộ khung được tổng hợp từ các phương pháp và mẫu BRD được sử dụng trong nhiều loại hình hệ thống và tổ chức, đồng thời được chuẩn hóa để có thể áp dụng thống nhất cho các dự án.
3. Nguyên tắc Xây dựng BRD¶
Khi sử dụng bộ mẫu, tài liệu BRD cần tuân thủ các nguyên tắc sau:
3.1. Tập trung vào Nhu cầu Nghiệp vụ¶
BRD cần làm rõ: - Bối cảnh và vấn đề cần giải quyết. - Mục tiêu nghiệp vụ. - Phạm vi dự án. - Quy trình hiện tại và quy trình mục tiêu. - Các bên liên quan. - Quy tắc nghiệp vụ. - Yêu cầu nghiệp vụ. - Dữ liệu nghiệp vụ liên quan. - Các ràng buộc, giả định và rủi ro. - Tiêu chí nghiệm thu nghiệp vụ.
BRD không đi sâu vào cách hiện thực giải pháp ở cấp độ kỹ thuật.
3.2. Yêu cầu phải có Khả năng Truy vết (Traceability)¶
Các thành phần quan trọng của BRD được định danh để hỗ trợ quản lý và truy vết xuyên suốt vòng đời dự án.
Quy ước định danh cơ bản:
| Thành phần | Mã định danh | Ví dụ |
|---|---|---|
| Business Objective | OBJ |
OBJ-01 |
| Business Requirement | BR |
BR-001 |
| Business Rule | RULE |
RULE-001 |
| Acceptance Criteria | AC |
AC-001 |
| Risk | RISK |
RISK-001 |
Quan hệ truy vết cơ bản:
flowchart LR
Problem["Business Problem"] --> OBJ["Business Objective\n(OBJ-xx)"]
OBJ --> BR["Business Requirement\n(BR-xxx)"]
BR --> AC["Acceptance Criteria\n(AC-xxx)"]
BR --> PRD["Product Requirement"]
PRD --> SRS["System Requirement"]
SRS --> TEST["Test Case & UAT"]3.3. Yêu cầu phải Rõ ràng và Có thể Kiểm chứng¶
- Yêu cầu cần được mô tả đủ rõ để các bên liên quan có cùng cách hiểu và có thể xác định điều kiện đáp ứng.
- Các yêu cầu mang tính chủ quan hoặc không có điều kiện đánh giá cụ thể cần được làm rõ trước khi phê duyệt.
3.4. Phân biệt Yêu cầu và Giải pháp¶
- BRD tập trung mô tả nhu cầu cần được đáp ứng.
- Việc lựa chọn công nghệ, kiến trúc, framework, database, cơ chế cache hoặc phương án triển khai thuộc phạm vi của các tài liệu thiết kế kỹ thuật.
4. Cấu trúc Tài liệu BRD¶
Khung BRD chuẩn mực gồm 12 nhóm nội dung, được đánh số thứ tự từ 0 đến 11:
| STT | Phần | Nội dung chính |
|---|---|---|
| 0 | Document Control | Thông tin tài liệu, lịch sử thay đổi, thành viên tham gia, review, phê duyệt và danh mục thuật ngữ. |
| 1 | Management Summary | Mục đích tài liệu, bối cảnh dự án, vấn đề nghiệp vụ, mục tiêu và tiêu chí thành công. |
| 2 | Current State / As-Is | Hiện trạng nghiệp vụ, quy trình hiện tại, điểm nghẽn, khoảng trống và các tác động liên quan. |
| 3 | Project Scope | Phạm vi thực hiện, ngoài phạm vi và các phụ thuộc liên quan. |
| 4 | Stakeholders & Business Roles | Các bên liên quan, trách nhiệm, RACI, vai trò người dùng và yêu cầu quyền ở mức nghiệp vụ. |
| 5 | To-Be Process & Business Requirements | Quy trình nghiệp vụ mục tiêu, danh mục yêu cầu nghiệp vụ, business rules và các kịch bản nghiệp vụ chính. |
| 6 | Business Data Requirements | Các đối tượng dữ liệu nghiệp vụ, dữ liệu quan trọng, quyền sở hữu, lưu trữ và yêu cầu bảo vệ dữ liệu. |
| 7 | Non-functional Business Expectations | Kỳ vọng nghiệp vụ về hiệu năng, khả dụng, bảo mật, liên tục dịch vụ và trải nghiệm người dùng. |
| 8 | Integration & External Dependencies | Nhu cầu tích hợp, hệ thống bên ngoài, dữ liệu trao đổi và các tham số nghiệp vụ có thể cấu hình. |
| 9 | Constraints, Assumptions & Risks | Các ràng buộc, giả định, phụ thuộc và rủi ro ảnh hưởng đến dự án. |
| 10 | Delivery & Business Acceptance | Các mốc bàn giao, tiêu chí nghiệm thu và điều kiện xác nhận mục tiêu nghiệp vụ. |
| 11 | Appendix & Governance | Tài liệu tham khảo, kế hoạch truyền thông, cơ chế escalation và xác nhận phê duyệt cuối cùng. |
Tùy theo quy mô và đặc thù của từng dự án, một số phần có thể được mở rộng, rút gọn hoặc đánh dấu không áp dụng. Tuy nhiên, việc thay đổi cấu trúc cần đảm bảo không làm mất các thông tin cần thiết cho việc xác định và phê duyệt yêu cầu nghiệp vụ.
5. Ranh giới Nội dung của BRD¶
Để tránh trùng lặp giữa các tài liệu, cần phân định rõ ràng nội dung thuộc BRD với các tài liệu đặc tả ở giai đoạn sau:
| Nội dung | BRD | PRD / SRS / Technical Design |
|---|---|---|
| Bối cảnh và vấn đề nghiệp vụ | Có | Tham chiếu |
| Business Objectives | Có | Tham chiếu |
| As-Is / To-Be nghiệp vụ | Có | Tham chiếu hoặc phân rã |
| Business Requirements | Có | Phân rã |
| Business Rules | Có | Chi tiết hóa khi cần |
| User Roles ở mức nghiệp vụ | Có | Chi tiết hóa quyền hệ thống |
| Business Data Entities | Có | Chi tiết hóa mô hình dữ liệu |
| ERD vật lý (Physical Schema) | Không | Có |
| Database Schema / DDL | Không | Có |
| API Endpoint & Request/Response | Không | Có |
| Kiến trúc phần mềm & Hạ tầng | Không | Có |
| Công nghệ triển khai (Tech Stack) | Không | Có |
| Acceptance Criteria nghiệp vụ | Có | Phân rã thành system/test criteria |
| Test Case chi tiết | Không | Có |
Nguyên tắc chung:
BRD xác định vấn đề, mục tiêu và yêu cầu nghiệp vụ cần được đáp ứng; các tài liệu tiếp theo xác định sản phẩm, hệ thống và giải pháp sẽ đáp ứng các yêu cầu đó như thế nào.
6. Đối tượng Sử dụng¶
Bộ tài liệu BRD được sử dụng bởi các nhóm tham gia vào quá trình xác định, phân tích, phê duyệt và triển khai yêu cầu, bao gồm: - Business Owner - Project Sponsor - Product Owner - Business Analyst - Project Manager - Solution Architect - Development Team - Quality Assurance (QA/QC) - Các đơn vị nghiệp vụ và bên liên quan khác
Mỗi nhóm có thể sử dụng BRD với mục đích khác nhau, nhưng tài liệu BRD đã được phê duyệt phải là nguồn tham chiếu thống nhất về phạm vi và yêu cầu nghiệp vụ của dự án.
7. Hướng dẫn Sử dụng Bộ Mẫu¶
7.1. Tạo Tài liệu BRD Mới¶
- Sử dụng BRD Template (_template.md) làm cấu trúc cơ sở khi lập BRD cho dự án hoặc phân hệ mới.
- Không chỉnh sửa trực tiếp
_template.mdđể chứa nội dung của một dự án cụ thể (hãy sao chép ra file mới).
7.2. Tham khảo Tài liệu Mẫu¶
- Sử dụng BRD Sample (sample-brd.md) để tham khảo cách áp dụng cấu trúc BRD, quy chuẩn định danh yêu cầu và phương pháp trình bày các nội dung chính.
- Tài liệu mẫu có thể được sử dụng để tham khảo cách xây dựng:
- Business Objectives
- As-Is và To-Be
- Business Requirements & Business Rules
- Acceptance Criteria
- Requirement Traceability
- Review và Sign-off
7.3. Quy trình Hoàn thiện Tài liệu¶
Khi xây dựng BRD mới, thực hiện tuần tự theo các bước: 1. Xác định bối cảnh và vấn đề nghiệp vụ. 2. Xác định mục tiêu và tiêu chí thành công. 3. Xác định phạm vi và các bên liên quan. 4. Mô tả hiện trạng nghiệp vụ (As-Is). 5. Xây dựng quy trình nghiệp vụ mục tiêu (To-Be). 6. Xác định và định danh các yêu cầu nghiệp vụ. 7. Xác định tiêu chí nghiệm thu. 8. Kiểm tra quan hệ truy vết giữa mục tiêu, yêu cầu và nghiệm thu. 9. Thực hiện review với các bên liên quan. 10. Phê duyệt và baseline tài liệu.
8. Quy chuẩn Áp dụng¶
Khi sử dụng bộ mẫu BRD:
1. Tính nhất quán: Giữ thống nhất cấu trúc và cách đánh số phần.
2. Thuật ngữ chuẩn: Sử dụng thuật ngữ thống nhất trong toàn bộ tài liệu.
3. Mã định danh: Sử dụng mã định danh (OBJ, BR, RULE, AC, RISK) cho các yêu cầu cần quản lý và truy vết.
4. Không lồng giải pháp: Không đưa các quyết định kỹ thuật chưa được phê duyệt vào Business Requirement.
5. Xử lý mục không áp dụng: Các nội dung không áp dụng cần được ghi rõ N/A thay vì tự ý loại bỏ nếu cấu trúc tài liệu của dự án yêu cầu duy trì.
6. Quản lý thay đổi: Mọi thay đổi sau khi tài liệu đã được phê duyệt cần được quản lý thông qua Revision History hoặc quy trình Change Management của dự án.
7. Cơ sở chuyển giao: Phiên bản BRD đã được phê duyệt là cơ sở để tiếp tục phân tích và xây dựng các tài liệu yêu cầu ở các cấp tiếp theo (PRD, SRS, Test Plan).
9. Danh mục Tài liệu trong Bộ BRD¶
| Tài liệu | Mục đích sử dụng |
|---|---|
| _template.md | Khung chuẩn để tạo một tài liệu BRD mới. |
| sample-brd.md | Tài liệu BRD mẫu minh họa cách áp dụng bộ khung cho dự án thực tế. |
| features.md | Cẩm nang cú pháp mở rộng (Keys, Highlight, Tabs, Details, Mermaid). |
| index.md | Trang tổng quan, nguyên tắc và hướng dẫn sử dụng bộ tài liệu BRD. |
Trang này đóng vai trò điểm bắt đầu của bộ tài liệu BRD, cung cấp thông tin tổng quan về mục đích, phạm vi, cấu trúc và cách sử dụng. Nội dung chi tiết của từng tài liệu được trình bày tại các trang tương ứng.