Technical Cheatsheets
Metadata Quản trị Tài liệu
| Trường kiểm soát | Giá trị | Diễn giải kiểm soát |
|---|---|---|
| Artifact ID | TECHNICAL_CHEATSHEETS |
Định danh duy nhất cho tài liệu tổng hợp các bảng tra cứu kỹ thuật. ID này đảm bảo khả năng truy vết và tham chiếu nhất quán trong toàn bộ corpus (tập hợp tài liệu) học liệu. |
| Tên tệp được kiểm soát | /04-cheatsheets/technical-cheatsheets.md |
Đường dẫn canonical (chuẩn mực) của tài liệu này. Mọi bản sao, trích dẫn hoặc tệp xuất (ví dụ: PDF) không thay thế tệp gốc được kiểm soát. |
| Tiêu đề tài liệu | Technical Cheatsheets (Các Bảng Tra Cứu Kỹ Thuật) |
Tên chính thức của tài liệu, phản ánh mục đích cung cấp thông tin kỹ thuật nhanh gọn, cô đọng cho người học và người tham khảo. |
| Status (Trạng thái) | IN_REVIEW |
Tài liệu đang trong quá trình xem xét, có thể có các thay đổi nhỏ. Trạng thái này không có nghĩa là tài liệu đã được APPROVED (Phê duyệt), BASELINED (Thiết lập đường cơ sở), sẵn sàng cho môi trường production (sản xuất) hoặc đã được người dùng chấp thuận. |
| Version (Phiên bản) | v0.9.0 |
Phiên bản hiện tại của tài liệu, phản ánh giai đoạn phát triển ban đầu. Mọi thay đổi lớn sau này sẽ dẫn đến việc cập nhật số phiên bản và ghi lại lịch sử thay đổi một cách minh bạch. |
| History (Lịch sử thay đổi) | v0.9.0 — bổ sung trường history trong metadata quản trị; trạng thái vẫn là IN_REVIEW. |
Owner ghi nhận thay đổi quan trọng theo phiên bản, gồm thay đổi, tác nhân thực hiện, ngày cập nhật, lý do và tác động đến artifact. Bản ghi này tạo dấu vết truy vết; không tạo approval, không thiết lập baseline, không xác nhận nội dung cho production. |
| Owner (Chủ sở hữu) | Principal IT Business Analyst / Technical Curriculum Author | Cá nhân hoặc vai trò chịu trách nhiệm duy trì tính toàn vẹn, cập nhật nội dung, kiểm soát phiên bản và đảm bảo tính nhất quán quản trị của tài liệu này trong corpus. |
| Trách nhiệm Owner | Duy trì tính chính xác, tính thời sự của các thông tin trong bảng tra cứu, kiểm soát phiên bản, ghi nhận lịch sử thay đổi và bảo toàn các liên kết truy vết với các nguồn gốc (source) đã xác minh. Owner cũng chịu trách nhiệm đảm bảo tài liệu tuân thủ các ranh giới sử dụng đã định, đặc biệt là việc không diễn giải như tài liệu thực tế của Nova Foods. |
|
| Giới hạn thẩm quyền Owner | Owner không có quyền tự thiết lập baseline, không ghi nhận approval, không xác nhận yêu cầu nghiệp vụ (business requirement) của Nova Foods là đúng cho môi trường vận hành thực tế, không diễn giải pháp lý, không quyết định kế toán hoặc thuế, không xác nhận tuân thủ (compliance) và không cho phép triển khai hoặc sử dụng trong môi trường production. |
|
| Last updated date (Ngày cập nhật cuối) | 2026-08-07 |
Ngày cuối cùng metadata (siêu dữ liệu) này được cập nhật, được hiểu theo múi giờ quản trị của corpus là Asia/Ho_Chi_Minh. |
| Timezone (Múi giờ quản trị) | Asia/Ho_Chi_Minh |
Múi giờ chuẩn để ghi nhận thời điểm của các sự kiện quản trị (ví dụ: cập nhật, xem xét, thay đổi) liên quan đến tài liệu, đảm bảo tính đồng bộ và truy vết thời gian chính xác. |
| Locale (Ngôn ngữ & bối cảnh) | vi-VN |
Tài liệu được viết bằng tiếng Việt, với bối cảnh áp dụng tại Việt Nam và sử dụng đơn vị tiền tệ mô phỏng VND (Đồng Việt Nam) cho các ví dụ liên quan đến Nova Foods. |
| Case-study reference (Tham chiếu tình huống học tập) | Nova Foods Trading & Manufacturing — mô phỏng giáo dục, dữ liệu tổng hợp | Toàn bộ các ví dụ, tên tổ chức, quy trình và dữ liệu trong tài liệu này đều thuộc về Nova Foods Trading & Manufacturing, một công ty hư cấu được tạo ra cho mục đích giáo dục và chỉ sử dụng synthetic data (dữ liệu tổng hợp). Điều này có nghĩa là Nova Foods không phải là một doanh nghiệp có thật, các quy trình hay dữ liệu không phản ánh hoạt động thực tế hoặc cấu hình ERP thực tế. |
| Phân loại artifact | Tài liệu tra cứu kỹ thuật nhanh (Technical Cheatsheet); hỗ trợ học liệu và tham khảo. |
Mục đích chính là cung cấp các thông tin kỹ thuật, quy tắc, hướng dẫn tham khảo nhanh cho người học và các thành viên dự án, không phải tài liệu thiết kế chi tiết hoặc đặc tả triển khai chính thức. |
| Trạng thái baseline | Chưa có baseline reference (tham chiếu đường cơ sở) tại phiên bản v0.9.0. Trạng thái IN_REVIEW không được diễn giải là BASELINED. |
Việc thiếu baseline đồng nghĩa rằng nội dung vẫn có thể thay đổi và chưa được chính thức đóng băng (frozen) tại một thời điểm cụ thể để sử dụng làm căn cứ vững chắc cho các giai đoạn phát triển tiếp theo. |
| Trạng thái approval | Chưa có approval reference (tham chiếu phê duyệt) tại phiên bản v0.9.0. Sự tồn tại của metadata này, vai trò Owner hoặc quá trình xem xét không tạo ra sự chấp thuận ngầm định từ bất kỳ bên liên quan nào. |
Mọi yêu cầu phê duyệt cần được ghi nhận minh bạch và rõ ràng trong tài liệu kiểm soát tương ứng (ví dụ: manifest - bảng kê khai) để đảm bảo tính pháp lý và trách nhiệm. |
1. Purpose, Scope, and Governance
Đối tượng, Ranh giới và Nguồn tham chiếu
Tài liệu này hướng dẫn học viên Business Analyst (BA) về nghiệp vụ, kỹ thuật. Mục tiêu: trang bị kiến thức dự án ERP Nova Foods, môi trường mô phỏng.
Ranh giới sử dụng và không sử dụng
| Mục đích sử dụng | Không được sử dụng | Lý do | Tham chiếu |
|---|---|---|---|
| Tài liệu học tập | Quyết định vận hành sản xuất (production) | Nova Foods là case study mô phỏng giáo dục (simulated educational case study). | 00_SOURCE_MAP.md SRC-READY-010 |
| Tham khảo phương pháp BA | Tư vấn pháp lý, kế toán, thuế | Nội dung không thay thế chuyên gia pháp lý, kế toán. Owner không có thẩm quyền này. | 01_CURRICULUM_ARCHITECTURE.md, TRACEABILITY_ID_REGISTRY.md |
| Hướng dẫn kỹ thuật tổng quát | Xác nhận yêu cầu nghiệp vụ thật (actual business requirements approval) | Nova Foods dùng dữ liệu tổng hợp (synthetic data). Không phải yêu cầu dự án thật. | CANONICAL_BUSINESS_RULES.md |
| Hiểu các tiêu chuẩn | Duyệt bảo mật (security sign-off), compliance | Không cấp phép triển khai. Phải có vai trò chuyên trách. | CANONICAL_DATA_DICTIONARY.md |
| Nền tảng xây dựng tài liệu | Bằng chứng phê duyệt (approval), baseline | IN_REVIEW trạng thái. Không có phê duyệt người dùng. |
CHAPTER_MANIFEST.md |
Nguồn tham chiếu và điều hướng
Tài liệu sử dụng nguồn xác minh để đảm bảo tính chính xác, nhất quán. Nguồn bao gồm tiêu chuẩn quốc tế và pháp luật Việt Nam. /00-research/00_SOURCE_MAP.md chứa danh sách đầy đủ.
Nguồn tham chiếu chính
| Nguồn | Mục đích | Ranh giới sử dụng |
|---|---|---|
| BABOK Guide (tiếng Việt: Hướng dẫn BABOK) | Kiến thức nghiệp vụ BA cốt lõi | Khái niệm, kỹ thuật, vùng kiến thức. |
| ISO/IEC/IEEE 29148 | Chuẩn về quy trình yêu cầu | Cấu trúc tài liệu yêu cầu. |
| BPMN, UML | Ngôn ngữ mô hình hóa quy trình, hệ thống | Ký hiệu chuẩn, ngữ nghĩa. |
| ISTQB CTFL | Chuẩn về kiểm thử phần mềm | Thuật ngữ kiểm thử, kỹ thuật hộp đen. |
| Luật Bảo vệ dữ liệu cá nhân | Tuân thủ pháp luật Việt Nam | Xác định nghĩa vụ bảo vệ dữ liệu. |
| OWASP ASVS, API Security Top 10 | Chuẩn bảo mật ứng dụng, API | Đánh giá rủi ro, thực hành tốt bảo mật. |
Điều hướng nội bộ
Sử dụng định danh (ID) và đường dẫn tệp để truy vết nội dung, nguồn gốc.
| Loại định danh | Mục đích | Ví dụ |
|---|---|---|
| Artifact ID | Định danh duy nhất cho tài liệu kiểm soát | 00_SOURCE_MAP, CHAPTER_MANIFEST |
| Tên tệp được kiểm soát | Đường dẫn canonical (tiếng Việt: chuẩn) của artifact | /01-curriculum/CANONICAL_BUSINESS_RULES.md |
| Trace ID (tiếng Việt: ID truy vết) | Liên kết yêu cầu, quy tắc, kiểm thử | REQ-NF-001, BR-NF-ACC-005 (sẽ được dùng sau) |
3. Giải thích Mô phỏng Nova Foods và Giới hạn Thẩm quyền
Nova Foods Trading & Manufacturing là case study (tiếng Việt: tình huống nghiên cứu) mô phỏng giáo dục. Mục đích duy nhất là cung cấp một bối cảnh thực hành cho việc học Business Analysis (tiếng Việt: Phân tích Nghiệp vụ), không đại diện cho một doanh nghiệp có thật hoặc cấu hình ERP (tiếng Việt: Hệ thống Hoạch định Nguồn lực Doanh nghiệp) thực tế. Mọi dữ liệu sử dụng trong tài liệu này là dữ liệu tổng hợp (synthetic data), được tạo ra nhằm minh họa các khái niệm và kỹ thuật phân tích, không phải dữ liệu thật của bất kỳ tổ chức nào. Việc giữ Nova Foods ở tính chất mô phỏng này được ghi nhận và kiểm soát qua SRC-READY-010 trong /00-research/00_SOURCE_MAP.md. Lý do chính là để người học tập trung vào quy trình và nguyên tắc BA mà không cần lo lắng về các ràng buộc pháp lý, tài chính hoặc rủi ro vận hành trong môi trường thực.
Tài liệu này và mọi nội dung trong corpus học liệu không cấu thành thẩm quyền (authority) pháp lý, kế toán, thuế, kinh doanh thực tế, hoặc phê duyệt triển khai sản xuất (production deployment). Vai trò của Principal IT Business Analyst / Technical Curriculum Author (tiếng Việt: Trưởng phòng Phân tích Nghiệp vụ IT / Tác giả Chương trình Học Kỹ thuật) là duy trì tính nhất quán quản trị của học liệu và tính chính xác của thông tin kỹ thuật được trình bày. Owner không có quyền tự xác lập baseline (tiếng Việt: đường cơ sở) cho bất kỳ yêu cầu nào của Nova Foods, phê duyệt nội dung nghiệp vụ hoặc cấp phép vận hành. Mọi quyết định hoặc xác nhận có ý nghĩa pháp lý, tài chính, bảo mật hoặc nghiệp vụ thực tế phải được xác minh và phê duyệt bởi các vai trò có thẩm quyền chuyên môn tương ứng.
Bảng dưới đây tóm tắt các giới hạn thẩm quyền mà tài liệu này không thể cung cấp:
| Loại Quyết Định (Decision Type) | Mô tả (Description) | Tài liệu này KHÔNG cung cấp (This document DOES NOT provide) | Yêu cầu thẩm quyền từ (Requires authority from) |
|---|---|---|---|
| Pháp lý (Legal) | Xác nhận tuân thủ quy định pháp luật (ví dụ: Luật Bảo vệ dữ liệu cá nhân, Luật An toàn thực phẩm). | Xác nhận tuân thủ pháp lý, tư vấn pháp luật. | Legal Owner, Regulatory Compliance Officer. |
| Kế toán/Thuế (Accounting/Tax) | Xác nhận nghiệp vụ kế toán, quy trình tài chính, nghĩa vụ thuế (ví dụ: Luật Kế toán, Nghị định Hóa đơn, chứng từ). | Tư vấn kế toán, xác nhận quy tắc ghi sổ, thuế. | Accounting Owner, CFO, Tax Consultant. |
| Vận hành/Nghiệp vụ Thực tế (Actual Business Operations) | Quyết định về quy trình kinh doanh, chiến lược sản phẩm, hoạt động vận hành của Nova Foods. | Quyết định kinh doanh, chiến lược sản phẩm, vận hành. | Business Owner, Operations Lead, Product Owner. |
| Triển khai Sản xuất (Production Deployment) | Cấp phép triển khai các hệ thống hoặc tính năng Nova Foods vào môi trường vận hành thực. | Quyết định triển khai phần mềm, cấu hình ERP. | Technical Lead, Architect, Operations Lead. |
| Bảo mật Thông tin (Information Security) | Xác nhận tuân thủ chuẩn bảo mật (ví dụ: OWASP ASVS, API Security Top 10) cho một hệ thống thật. | Đánh giá bảo mật, chứng nhận an toàn hệ thống. | Security Architect, CISO, Security Auditor. |
| Phê duyệt Baseline/Thiết kế (Baseline/Design Approval) | Phê duyệt các yêu cầu, thiết kế, kiến trúc hệ thống chính thức của Nova Foods. | Xác nhận baseline cho requirement, architecture. | Project Sponsor, Business Owner, Architect, QA Lead. |
Các giới hạn này đảm bảo rằng nội dung học liệu được sử dụng đúng mục đích giáo dục, tránh việc hiểu nhầm thành các chỉ dẫn áp dụng thực tế hoặc quyết định mang tính ràng buộc. Người học cần luôn tham khảo các nguồn chuẩn và vai trò chuyên môn tương ứng cho các quyết định ngoài phạm vi mô phỏng này.
2. Core Reference Map
Phần này định nghĩa các artifact cốt lõi (tài liệu hoặc sản phẩm làm việc được kiểm soát) trong corpus Nova Foods mô phỏng. Hiểu rõ các artifact này giúp Business Analyst (BA) truy vết thông tin, đảm bảo tính nhất quán và tuân thủ các quy tắc quản trị. Nova Foods là môi trường mô phỏng giáo dục, mọi dữ liệu là tổng hợp (synthetic data).
Bảng sau cung cấp định nghĩa và mối quan hệ giữa các artifact quản trị và lập kế hoạch chính:
| Artifact Cốt Lõi (Core Artifact) | Artifact ID (Định danh) | Mục đích chính (Primary Purpose) | Nội dung tiêu biểu (Typical Content) | Mối quan hệ chính (Key Relationship) |
|---|---|---|---|---|
| Siêu dữ liệu quản trị artifact (Artifact Governance Metadata) | (Thuộc tính của mọi artifact) | Xác định thông tin kiểm soát: chủ sở hữu (Owner), phiên bản (Version), trạng thái (Status) của mọi artifact. |
Artifact ID, Status (Trạng thái), Version (Phiên bản), Owner (Chủ sở hữu), Last updated date (Ngày cập nhật cuối). |
Nền tảng quản trị bắt buộc cho mọi artifact khác trong corpus. |
| Bản đồ nguồn tham khảo (Source Map) | 00_SOURCE_MAP |
Liệt kê các nguồn gốc bên ngoài (pháp luật, tiêu chuẩn, đặc tả) cho thông tin trong corpus, kèm giới hạn sử dụng (Safe use boundary). |
Tên nguồn, nhà phát hành, URL chính thức, Safe use boundary (Giới hạn sử dụng an toàn). |
Mọi artifact tham chiếu nguồn bên ngoài phải dựa vào 00_SOURCE_MAP để đảm bảo tính xác thực và tuân thủ giới hạn. |
| Kiến trúc chương trình học (Curriculum Architecture) | 01_CURRICULUM_ARCHITECTURE |
Phác thảo cấu trúc tổng thể chương trình đào tạo IT Business Analyst, đảm bảo luồng kiến thức logic, tránh trùng lặp hoặc thiếu sót. | Sơ đồ module, mục tiêu học tập, điều kiện tiên quyết giữa các phần kiến thức. | Là khung sườn quy hoạch cho CHAPTER_MANIFEST và TEMPLATE_MANIFEST, định hướng việc phát triển nội dung. |
| Bảng kê chương (Chapter Manifest) | CHAPTER_MANIFEST |
Danh sách các chương (chapters) của handbook, cung cấp định danh duy nhất (Chapter ID) và trạng thái cho mỗi chương. |
Chapter ID, Title (Tiêu đề), File path (Đường dẫn tệp), Status. |
Được định nghĩa bởi Curriculum Architecture. Mỗi Chapter ID phải được đăng ký trong TRACEABILITY_ID_REGISTRY. |
| Bảng kê mẫu tài liệu (Template Manifest) | TEMPLATE_MANIFEST |
Danh sách các mẫu tài liệu (templates) chuẩn được thiết kế cho BA thực hành, với mô tả và các phụ thuộc đầu vào (Input Dependencies). |
Template ID, Description (Mô tả), Input Dependencies (Phụ thuộc đầu vào). |
Được định nghĩa bởi Curriculum Architecture. Mỗi Template ID phải được đăng ký trong TRACEABILITY_ID_REGISTRY. |
| Sổ đăng ký định danh truy vết (Traceability ID Registry) | TRACEABILITY_ID_REGISTRY |
Quản lý tập trung các mã định danh (IDs) duy nhất, đảm bảo khả năng truy vết các yêu cầu, quy tắc, dữ liệu qua các artifact khác nhau. |
ID Pattern (Mẫu ID), Scope (Phạm vi), Purpose (Mục đích), Owner. |
Cung cấp và quản lý các ID cho CANONICAL_BUSINESS_RULES, CANONICAL_DATA_DICTIONARY, các yêu cầu chức năng và phi chức năng. |
| Quy tắc nghiệp vụ chuẩn (Canonical Business Rules) | CANONICAL_BUSINESS_RULES |
Tập hợp các quy tắc nghiệp vụ cốt lõi, là nguồn chân lý duy nhất cho logic hệ thống Nova Foods mô phỏng, đảm bảo tính nhất quán và tránh hiểu sai yêu cầu. | Rule ID, Description (Mô tả), Source (Nguồn gốc), Trigger (Điều kiện kích hoạt), Expected Outcome (Kết quả mong đợi). |
Sử dụng Rule ID từ TRACEABILITY_ID_REGISTRY. Được tham chiếu trực tiếp bởi các yêu cầu hệ thống và test cases. |
| Từ điển dữ liệu chuẩn (Canonical Data Dictionary) | CANONICAL_DATA_DICTIONARY |
Định nghĩa chuẩn hóa mọi phần tử dữ liệu quan trọng trong hệ thống Nova Foods mô phỏng, bao gồm kiểu dữ liệu (Data Type), định dạng và ràng buộc (Constraints). |
Data Element ID, Name (Tên), Description (Mô tả), Data Type (Kiểu dữ liệu), Format (Định dạng), Constraints (Ràng buộc), Business Owner. |
Sử dụng Data Element ID từ TRACEABILITY_ID_REGISTRY. Cung cấp định nghĩa cho các trường dữ liệu sử dụng trong các yêu cầu, thiết kế database và API. |
Thuật ngữ tiếng Anh cốt lõi. Diễn giải tiếng Việt.
Hiểu thuật ngữ nền tảng. BA giao tiếp chính xác. Đây khái niệm chính, diễn giải từ nguyên lý đầu. Áp dụng Nova Foods ERP (mô phỏng).
| Thuật ngữ tiếng Anh | Diễn giải tiếng Việt | Giải thích nguyên lý đầu tiên | Áp dụng Nova Foods (mô phỏng) |
|---|---|---|---|
| Requirement | Yêu cầu | Điều kiện, khả năng hệ thống cần. Hoặc đặc tính người dùng cần. Giải quyết vấn đề, đạt mục tiêu. Gốc rễ BA việc. | Nova Foods ERP cần. Kế toán, Kho, Sản xuất đưa yêu cầu. Ví dụ: "Hệ thống cho phép nhập đơn hàng bán." |
| Business Process | Quy trình nghiệp vụ | Chuỗi hoạt động cấu trúc. Người hoặc hệ thống làm. Đạt mục tiêu nghiệp vụ cụ thể. Mô tả "cách làm việc". | Quy trình Xử lý Đơn hàng Nova Foods: nhận đơn, kiểm tồn kho, xuất kho, tạo hóa đơn, giao hàng. ERP hỗ trợ các bước. |
| Stakeholder | Các bên liên quan | Cá nhân, nhóm, tổ chức. Có lợi ích, bị ảnh hưởng, ảnh hưởng dự án/hệ thống. Hiểu họ, thu thập yêu cầu đúng. | Giám đốc Sản xuất, Trưởng phòng Kế toán, Người dùng cuối (nhân viên kinh doanh, thủ kho), IT Manager. Yêu cầu họ định hình ERP Nova Foods. |
| Functional Requirement | Yêu cầu chức năng | Mô tả hành vi cụ thể hệ thống làm. Định nghĩa "hệ thống làm gì". Thường là hành động, tính năng. | ERP Nova Foods phải "tạo báo cáo doanh thu theo khu vực". Phải "quản lý thông tin nhà cung cấp." |
| Non-Functional Requirement (NFR) | Yêu cầu phi chức năng | Mô tả cách hệ thống làm chức năng. Liên quan chất lượng, hiệu suất, bảo mật, sử dụng. Định nghĩa "hệ thống hoạt động thế nào". | ERP Nova Foods phải phản hồi trong 2 giây tìm mã sản phẩm. Dữ liệu khách hàng phải mã hóa. Phải chạy Chrome. |
| Acceptance Criteria | Tiêu chí chấp nhận | Điều kiện cụ thể, kiểm chứng được. Giải pháp/tính năng phải đáp ứng. Được bên liên quan chấp nhận. Trả lời "khi nào xong?". | Tính năng "Nhập đơn hàng": "Đơn hàng lưu thành công DB." "Báo lỗi số lượng vượt tồn kho." "Tổng giá trị đơn hàng đúng sau thuế." |
| Traceability | Khả năng truy vết | Theo dõi yêu cầu. Từ gốc đến triển khai, kiểm thử. Ngược lại. Đảm bảo mọi phần hệ thống có lý do, được kiểm tra. | Yêu cầu NF-REQ-001 (Quản lý kho). Nối đặc tả thiết kế, module ERP "Warehouse Management", test case NF-TC-005, màn hình WH_01. |
| Baseline | Đường cơ sở | Tập hợp sản phẩm làm việc phê duyệt. Thời điểm cụ thể. Dùng điểm tham chiếu thay đổi tương lai. Mọi thay đổi sau đó cần quản lý chính thức. | Sau phân tích, Requirement Document v1.0 Nova Foods baseline. Mọi thay đổi sau đó theo quy trình kiểm soát thay đổi. |
Nguyên tắc sử dụng bảng trong cheatsheet kỹ thuật
Tài liệu cheatsheet kỹ thuật (technical cheatsheet) là công cụ tra cứu nhanh, cung cấp thông tin cốt lõi. Bảng (table) là định dạng hiệu quả nhất để trình bày dữ liệu cấu trúc, giúp người dùng dễ dàng định vị và sử dụng thông tin.
1. Bảng dễ quét (Scan-friendly tables): Bảng phải có cấu trúc rõ ràng, dễ đọc. Thiết kế giúp người đọc lướt qua nhanh để nắm bắt thông tin quan trọng. * Tiêu đề cột (Column headers): Ngắn gọn, mô tả chính xác nội dung cột. Dùng ngôn ngữ nhất quán. * Dữ liệu ô (Cell data): Súc tích, không chứa thông tin dư thừa. * Định dạng: Sử dụng định dạng nhất quán cho từng loại dữ liệu. * Lý do: Cheatsheet dùng để tra cứu tức thì. Cấu trúc dễ quét giảm thời gian tìm kiếm, tăng hiệu quả. Điều này phù hợp với mục đích "First-principles lookup" của phần "Core Reference Map".
2. Không bỏ qua dòng (No omitted rows):
Mọi mục thông tin liên quan đến phạm vi bảng phải được liệt kê đầy đủ. Tuyệt đối không dùng ký hiệu "..." hoặc "các mục khác" để đại diện cho dòng bị thiếu. Nếu dữ liệu quá nhiều, cần chia thành nhiều bảng nhỏ hơn hoặc cung cấp tham chiếu (reference) rõ ràng đến nguồn chứa thông tin đầy đủ.
* Lý do: Đảm bảo tính toàn vẹn và độ tin cậy của thông tin. Cheatsheet là nguồn tham khảo chính, thiếu dòng có thể dẫn đến hiểu lầm, quyết định sai lầm hoặc yêu cầu kiểm tra lại nguồn khác. Nguyên tắc này hỗ trợ truy vết (traceability) và tính nhất quán với các artifact quản trị khác như /01-curriculum/TRACEABILITY_ID_REGISTRY.md.
3. Cấu trúc bảng mẫu cho định nghĩa và ánh xạ (Sample Table Structure for Definitions and Mappings): Đây là cấu trúc bảng mẫu thường dùng trong cheatsheet để định nghĩa các khái niệm, ánh xạ các định danh, hoặc tóm tắt các quy tắc nghiệp vụ ngắn gọn.
| Trường thông tin | Loại dữ liệu | Mục đích | Nguồn tham chiếu (Artifact ID) |
|---|---|---|---|
| ID (Định danh) | Chuỗi ký tự | Mã định danh duy nhất của mục. | TRACEABILITY_ID_REGISTRY |
| Thuật ngữ tiếng Anh (English Term) | Chuỗi ký tự | Tên chính thức của thuật ngữ theo nguồn. | 00_SOURCE_MAP (liên kết chuẩn) |
| Diễn giải tiếng Việt (Vietnamese Explanation) | Chuỗi ký tự | Giải thích ý nghĩa thuật ngữ một cách rõ ràng. | N/A (diễn giải tại chỗ) |
| Ví dụ Nova Foods (Nova Foods Example) | Tùy loại | Dữ liệu tổng hợp minh họa trong bối cảnh Nova Foods. | N/A (dữ liệu mô phỏng) |
4. Bảo đảm quản trị (Governance Assurance):
Mọi dữ liệu trong bảng phải có nguồn gốc rõ ràng và có thể truy vết. Khi định nghĩa một ID, cần liên kết đến TRACEABILITY_ID_REGISTRY.md. Khi trình bày quy tắc, liên kết đến CANONICAL_BUSINESS_RULES.md. Dữ liệu Nova Foods luôn là mô phỏng (simulated data) và không thay thế dữ liệu nghiệp vụ thực tế.
* Lý do: Tăng độ tin cậy và khả năng kiểm soát thông tin. Bảng không chỉ là nơi trình bày mà còn là điểm liên kết đến "nguồn chân lý" (single source of truth).
Ví dụ ứng dụng cấu trúc (Simulated Nova Foods Example Application): Đây là một ví dụ về cấu trúc bảng trình bày các trạng thái của một đối tượng trong hệ thống Nova Foods, minh họa nguyên tắc dễ quét và không bỏ qua dòng.
| Mã trạng thái tài liệu (Document Status Code) | Mô tả tiếng Anh (English Description) | Diễn giải nghiệp vụ Nova Foods (Nova Foods Business Explanation) | Nguồn (Source) |
|---|---|---|---|
DRAFT |
Document in draft stage. | Tài liệu đang được soạn thảo, chưa hoàn chỉnh, không có hiệu lực. | Nova Foods (simulated) |
IN_REVIEW |
Document pending review. | Tài liệu đang chờ phê duyệt từ quản lý hoặc bộ phận liên quan. | Nova Foods (simulated) |
APPROVED |
Document approved. | Tài liệu đã được chấp thuận, có hiệu lực sử dụng. | Nova Foods (simulated) |
REJECTED |
Document rejected. | Tài liệu bị từ chối, cần sửa đổi hoặc hủy bỏ. | Nova Foods (simulated) |
ARCHIVED |
Document archived. | Tài liệu đã được lưu trữ, không còn sử dụng nhưng cần giữ cho mục đích lịch sử. | Nova Foods (simulated) |
→ skipped: actual Nova Foods ERP status codes, add when CANONICAL_DATA_DICTIONARY.md or CANONICAL_BUSINESS_RULES.md defines specific document workflows and their status sets.
3. Applied Nova Foods Reference
Trong phần này, chúng ta sẽ xem xét các ví dụ cụ thể của Nova Foods được áp dụng trong bối cảnh ERP. Các ví dụ này giúp người học hiểu cách các khái niệm trừu tượng như “đối tượng nghiệp vụ” (Business Objects), “định danh” (Identifiers), “quy tắc” (Rules) và “cổng chất lượng” (Quality Gates) được hiện thực hóa trong một hệ thống thực tế. Mọi dữ liệu về Nova Foods ở đây là mô phỏng (simulated data) và chỉ dùng cho mục đích giáo dục.
3.1. Dữ liệu gốc sản phẩm (Product Master Data) – Ví dụ Nova Foods
Dữ liệu gốc sản phẩm (Product Master Data) là tập hợp thông tin cốt lõi, ổn định về các mặt hàng mà Nova Foods sản xuất hoặc kinh doanh. Đây là “nguồn chân lý” (single source of truth) cho thông tin sản phẩm trên toàn hệ thống ERP, đảm bảo tính nhất quán và chính xác.
Ví dụ: Sản phẩm Bánh mì lúa mì nguyên cám hữu cơ Nova Foods 500g
3.1.1. Cấu trúc định danh sản phẩm (Product Identification Structure)
Nova Foods sử dụng một cấu trúc mã sản phẩm (Product ID) và mã đơn vị lưu kho (SKU – Stock Keeping Unit) để định danh duy nhất từng sản phẩm.
| Trường định danh (Identifier Field) | Mô tả (Description) | Định dạng (Format) | Ví dụ (Example) | Nguồn (Source) |
|---|---|---|---|---|
PRODUCT_ID |
Định danh duy nhất cho sản phẩm chính. | NF-PD-[Loại SP]-[Số tuần tự 4 chữ số] |
NF-PD-BM-0001 |
Nova Foods (simulated) |
SKU |
Mã đơn vị lưu kho, bao gồm thông tin chi tiết về quy cách đóng gói, khối lượng. | NF-SKU-[PRODUCT_ID]-[Định dạng/Khối lượng] |
NF-SKU-NF-PD-BM-0001-500G |
Nova Foods (simulated) |
BARCODE_EAN13 |
Mã vạch chuẩn Châu Âu (EAN-13) cho sản phẩm bán lẻ. | 13 chữ số |
8934567890123 |
Nova Foods (simulated) |
- Giải thích:
PRODUCT_IDgiúp nhóm các biến thể của một sản phẩm cơ bản (ví dụ: bánh mì lúa mì nguyên cám).SKUđịnh danh từng biến thể cụ thể, cần cho quản lý kho (inventory management), bán hàng và kế toán.BARCODE_EAN13là định danh vật lý dùng cho điểm bán hàng (POS – Point of Sale) và theo dõi vận chuyển.
3.1.2. Phân loại sản phẩm (Product Classification)
Nova Foods phân loại sản phẩm để hỗ trợ phân tích, báo cáo và quản lý tồn kho. Phân loại tuân thủ theo cây phân cấp đã định.
| Cấp phân loại (Classification Level) | Mô tả (Description) | Ví dụ cho NF-PD-BM-0001 |
Nguồn (Source) |
|---|---|---|---|
CATEGORY (Danh mục) |
Nhóm sản phẩm rộng. | Sản phẩm bánh mì & ngũ cốc |
Nova Foods (simulated) |
SUB_CATEGORY (Danh mục con) |
Nhóm nhỏ hơn trong danh mục. | Bánh mì tươi |
Nova Foods (simulated) |
TYPE (Loại) |
Đặc tính cụ thể của sản phẩm. | Lúa mì nguyên cám |
Nova Foods (simulated) |
ORGANIC_CERT (Chứng nhận hữu cơ) |
Có chứng nhận hữu cơ không? | Có (certified) |
Nova Foods (simulated) |
- Giải thích: Cấu trúc phân loại giúp Nova Foods dễ dàng truy vấn thông tin, áp dụng quy tắc khuyến mãi hoặc quản lý chuỗi cung ứng theo nhóm sản phẩm. Ví dụ, tất cả "Sản phẩm bánh mì & ngũ cốc" có thể có yêu cầu bảo quản riêng.
3.1.3. Các thuộc tính sản phẩm chính (Key Product Attributes)
Mỗi sản phẩm có một tập hợp các thuộc tính (attributes) mô tả đặc điểm của nó. Các thuộc tính này được lưu trữ trong dữ liệu gốc sản phẩm.
| Thuộc tính (Attribute) | Loại dữ liệu (Data Type) | Mô tả (Description) | Ví dụ (Example) | Nguồn (Source) |
|---|---|---|---|---|
PRODUCT_NAME_VI |
Văn bản (Text) | Tên sản phẩm tiếng Việt. | Bánh mì lúa mì nguyên cám hữu cơ |
Nova Foods (simulated) |
PRODUCT_NAME_EN |
Văn bản (Text) | Tên sản phẩm tiếng Anh. | Organic Whole Wheat Bread |
Nova Foods (simulated) |
UNIT_OF_MEASURE |
Danh mục (Lookup) | Đơn vị tính cơ bản. | gram (g) |
Nova Foods (simulated) |
NET_WEIGHT_VALUE |
Số (Numeric) | Khối lượng tịnh. | 500 |
Nova Foods (simulated) |
GROSS_WEIGHT_VALUE |
Số (Numeric) | Khối lượng tổng. | 520 |
Nova Foods (simulated) |
SHELF_LIFE_DAYS |
Số nguyên (Integer) | Thời hạn sử dụng (số ngày). | 7 |
Nova Foods (simulated) |
STORAGE_CONDITIONS |
Văn bản (Text) | Điều kiện bảo quản. | Nhiệt độ phòng mát, khô ráo |
Nova Foods (simulated) |
IS_HALAL_CERTIFIED |
Boolean | Có chứng nhận Halal không? | False |
Nova Foods (simulated) |
- Giải thích: Các thuộc tính này cung cấp thông tin chi tiết cần thiết cho các hoạt động nghiệp vụ như dán nhãn sản phẩm (labeling), tính giá, quản lý chất lượng và tuân thủ các quy định về an toàn thực phẩm (
Luật An toàn thực phẩm55/2010/QH12).
3.1.4. Quy tắc nghiệp vụ dữ liệu sản phẩm (Product Data Business Rules)
Các quy tắc nghiệp vụ (Business Rules) đảm bảo tính toàn vẹn và chính xác của dữ liệu sản phẩm.
| Mã quy tắc (Rule ID) | Mô tả quy tắc (Rule Description) | Tham chiếu (Reference) | Nguồn (Source) |
|---|---|---|---|
BR-PD-001 |
PRODUCT_ID và SKU phải là duy nhất trên toàn hệ thống. |
CANONICAL_BUSINESS_RULES |
Nova Foods (simulated) |
BR-PD-002 |
NET_WEIGHT_VALUE phải lớn hơn 0. |
CANONICAL_BUSINESS_RULES |
Nova Foods (simulated) |
BR-PD-003 |
Nếu ORGANIC_CERT là 'Có', thì phải có số chứng nhận hợp lệ. |
CANONICAL_BUSINESS_RULES |
Nova Foods (simulated) |
BR-PD-004 |
SHELF_LIFE_DAYS không được để trống và phải là số nguyên dương. |
CANONICAL_BUSINESS_RULES |
Nova Foods (simulated) |
- Giải thích: Các quy tắc này được kiểm tra khi tạo hoặc cập nhật sản phẩm. Ví dụ,
BR-PD-001ngăn chặn việc trùng lặp định danh, điều tối quan trọng trong quản lý ERP.BR-PD-003là một ví dụ về quy tắc nghiệp vụ điều kiện (conditional business rule) liên quan đến tuân thủ.
3.1.5. Cổng chất lượng dữ liệu sản phẩm (Product Data Quality Gates)
Trước khi một sản phẩm mới có thể được “kích hoạt” (active) để mua bán hoặc sản xuất, nó phải vượt qua các cổng chất lượng (Quality Gates). Đây là các điểm kiểm tra bắt buộc để đảm bảo dữ liệu đầy đủ và hợp lệ.
| Cổng chất lượng (Quality Gate) | Mô tả kiểm tra (Check Description) | Vai trò chịu trách nhiệm (Responsible Role) | Tình trạng (Status) |
|---|---|---|---|
QG-PD-001 |
Tất cả thuộc tính bắt buộc đã được điền. | Data Entry Specialist |
PASSED / FAILED |
QG-PD-002 |
Tất cả Business Rules (BR-PD-001 đến BR-PD-004) đã được xác minh. |
Product Data Steward |
PASSED / FAILED |
QG-PD-003 |
Đã có phê duyệt từ Product Manager về thông tin sản phẩm. |
Product Manager |
APPROVED / REJECTED |
QG-PD-004 |
Đã có phê duyệt từ Quality Assurance (QA) về tuân thủ an toàn thực phẩm. |
QA Lead |
APPROVED / REJECTED |
- Giải thích: Các cổng chất lượng này đảm bảo rằng chỉ có dữ liệu sản phẩm đạt chuẩn mới được đưa vào sử dụng trong các quy trình nghiệp vụ tiếp theo, giảm thiểu lỗi và rủi ro. Vai trò
Product Data Steward(Người quản lý dữ liệu sản phẩm) đóng vai trò trung tâm trong việc đảm bảo chất lượng dữ liệu.
→ skipped: detailed data entry forms, data validation logic implementation (code), actual ERP screenshot. add when CANONICAL_DATA_DICTIONARY.md specifies data types and validation, CANONICAL_BUSINESS_RULES.md fully defines all product rules, and TEMPLATE_MANIFEST.md includes templates for product creation forms or validation rules.
Ánh xạ Tác nhân, Tạo phẩm, Định danh, Quyết định và Cổng chất lượng trong quy trình Xử lý Đơn hàng Bán (Sales Order Processing) Nova Foods
Quy trình Xử lý Đơn hàng Bán (Sales Order Processing) là nghiệp vụ lõi. Nó chuyển yêu cầu khách hàng thành đơn hàng để thực hiện giao hàng và lập hóa đơn.
1. Tác nhân (Actors) và Trách nhiệm
Tác nhân là cá nhân hoặc hệ thống tương tác quy trình. Trách nhiệm là vai trò, công việc chính tác nhân.
| Tác nhân (Actor) | Vai trò Nova Foods | Trách nhiệm chính |
|---|---|---|
| Sales Representative | Đại diện Kinh doanh | Tạo đơn hàng bán (NF-SO-XXXXX). Nhập thông tin khách hàng, sản phẩm, số lượng, giá. |
| Credit Manager | Quản lý Tín dụng | Đánh giá, phê duyệt hạn mức tín dụng khách hàng. Xem xét kết quả kiểm tra tín dụng (NF-CCR-XXXXX). |
| Warehouse Manager | Quản lý Kho | Xác nhận tình trạng hàng tồn kho. Xác nhận khả năng cung ứng, giữ hàng (NF-SR-XXXXX). |
| Finance Controller | Kiểm soát Tài chính | Xem xét, phê duyệt điều khoản thanh toán, giá. Đảm bảo tuân thủ chính sách tài chính Nova Foods. |
2. Tạo phẩm (Artifacts) và Định danh (IDs) Mô phỏng
Tạo phẩm là sản phẩm đầu ra, đối tượng trung gian quy trình. Định danh (Identifiers) là mã duy nhất phân biệt tạo phẩm.
| Tạo phẩm (Artifact) | Định danh (ID) Mô phỏng | Mô tả | Quy tắc Định danh |
|---|---|---|---|
| Sales Order | NF-SO-YYYYNNNNN |
Yêu cầu mua hàng khách hàng, chờ thực hiện. | NF-SO-[Năm hiện hành][Số thứ tự 5 chữ số duy nhất trong năm] |
| Credit Check Result | NF-CCR-YYYYNNNNN |
Báo cáo chi tiết đánh giá tín dụng khách hàng. | NF-CCR-[Năm hiện hành][Số thứ tự 5 chữ số duy nhất trong năm] |
| Stock Reservation | NF-SR-YYYYNNNNN |
Ghi nhận hàng hóa đã được giữ cho đơn hàng cụ thể. | NF-SR-[Năm hiện hành][Số thứ tự 5 chữ số duy nhất trong năm] |
| Invoice | NF-INV-YYYYNNNNN |
Yêu cầu thanh toán chính thức đến khách hàng. | NF-INV-[Năm hiện hành][Số thứ tự 5 chữ số duy nhất trong năm] |
3. Quyết định (Decisions) và Quy tắc Nghiệp vụ (Business Rules) Nova Foods
Quyết định là lựa chọn tại điểm quy trình, dựa Quy tắc Nghiệp vụ (Business Rules). Quy tắc nghiệp vụ là tuyên bố xác định, giới hạn hoạt động kinh doanh.
Các quy tắc này là mô phỏng, tham chiếu từ /01-curriculum/CANONICAL_BUSINESS_RULES.md.
| Quyết định (Decision) | Quy tắc Nghiệp vụ Liên quan (Business Rule ID) | Mô tả Quy tắc Nghiệp vụ | Người ra quyết định |
|---|---|---|---|
| Phê duyệt Tín dụng | BR-SO-001 |
Hạn mức tín dụng khách hàng (CRM.CreditLimit) không vượt quá 500.000.000 VND (năm 2026). |
Credit Manager |
| Xác nhận Hàng tồn kho | BR-SO-002 |
Số lượng sản phẩm yêu cầu (SO.Item.Quantity) phải có sẵn trong kho (WH.AvailableStock) hoặc có kế hoạch nhập hàng trong 3 ngày làm việc (WH.PlannedReceiptDate). |
Warehouse Manager |
| Phê duyệt Đơn hàng Bán | BR-SO-003 |
Tất cả điều khoản thanh toán, giá cả đã được Kiểm soát Tài chính xem xét, chấp thuận. | Finance Controller |
BR-SO-004 |
Giá bán sản phẩm (SO.Item.UnitPrice) không thấp hơn giá vốn (Product.Cost) trừ biên độ lợi nhuận đã định (Config.MinMarginPercentage). |
Finance Controller |
4. Cổng chất lượng (Quality Gates) Nova Foods
Cổng chất lượng là điểm kiểm tra chính thức trong quy trình. Nó xác minh tiêu chí đã đạt trước bước tiếp theo. ID truy vết từ /01-curriculum/TRACEABILITY_ID_REGISTRY.md.
| ID Cổng chất lượng | Mô tả Cổng chất lượng | Tác nhân chịu trách nhiệm | Kết quả |
|---|---|---|---|
QG-SO-001 |
Kiểm tra Tín dụng Hoàn thành, phê duyệt. | Credit Manager | PASSED / FAILED |
QG-SO-002 |
Xác nhận Hàng tồn kho, giữ hàng. | Warehouse Manager | PASSED / FAILED |
QG-SO-003 |
Đơn hàng Bán đã Phê duyệt Cuối cùng. | Finance Controller | APPROVED / REJECTED |
- Giải thích: Các cổng chất lượng này đảm bảo mỗi bước trong quy trình xử lý đơn hàng tuân thủ quy tắc nghiệp vụ Nova Foods. Nó giảm rủi ro tài chính, lỗi giao hàng.
→ skipped: BPMN workflow, actual data structures (DB schema), detailed API contracts, specific system integration points. add when: BPMN diagramming requested, CANONICAL_DATA_DICTIONARY.md populated with SO entities, OpenAPI Specification introduced for system integrations, or specific ERP module guides developed.
Ví dụ API Nova Foods: Truy vấn Tình trạng Đơn hàng
Tạo phẩm này trình bày ví dụ thực thi (executable example) của một Giao diện Lập trình Ứng dụng (API - Application Programming Interface) mô phỏng trong hệ thống Hoạch định Tài nguyên Doanh nghiệp (ERP - Enterprise Resource Planning) của Nova Foods. Ví dụ này minh họa cách truy vấn tình trạng đơn hàng sản phẩm đông lạnh, tuân thủ các quy định chung của Đặc tả OpenAPI Specification (OAS) v3.1.1. Mục đích là thể hiện việc ánh xạ giữa tác nhân (actor), tạo phẩm (artifact), định danh (ID), quyết định (decision) và cổng chất lượng (quality gate) thông qua một kịch bản kỹ thuật cụ thể. Nova Foods là một hệ thống mô phỏng giáo dục, mọi dữ liệu đều là tổng hợp (synthetic data).
Ánh xạ Tác nhân, Tạo phẩm, Định danh, Quyết định và Cổng chất lượng:
| Khái niệm | Mô tả | Ví dụ Nova Foods (Mô phỏng) | Nguồn tham chiếu/Căn cứ |
|---|---|---|---|
| Tác nhân (Actor) | Vai trò hoặc hệ thống khởi tạo yêu cầu. | NV_CSKH_NF (Nhân viên Chăm sóc Khách hàng Nova Foods) |
BABOK Guide v3, Chương 2.1 |
| Tạo phẩm (Artifact) | Thành phần phần mềm hoặc tài liệu liên quan đến quá trình. | NF_ORDER_STATUS_API (API truy vấn trạng thái đơn hàng) |
ISO/IEC/IEEE 29148:2018 |
| Định danh (ID - Identifier) | Mã định danh duy nhất cho một thực thể. | ORD-20260715-001 (ID đơn hàng), PROD-IQF-CHICKEN-005 (ID sản phẩm) |
/01-curriculum/TRACEABILITY_ID_REGISTRY.md |
| Quyết định (Decision) | Lựa chọn logic dựa trên điều kiện nghiệp vụ. | Xác định TRẠNG_THÁI_GIAO_HÀNG (Delivery Status): ĐÃ_XÁC_NHẬN, ĐANG_VẬN_CHUYỂN, ĐÃ_GIAO, ĐÃ_HỦY. |
/01-curriculum/CANONICAL_BUSINESS_RULES.md |
| Cổng chất lượng (Quality Gate) | Điểm kiểm tra để đảm bảo tiêu chuẩn được đáp ứng. | Thành công: Mã trạng thái HTTP (HTTP Status Code) 200 OK. Không tìm thấy: 404 Not Found. |
ISTQB CTFL Syllabus v4.0.1, Chương 1.2.2 |
Ví dụ Truy vấn API (GET /api/v1/orders/{orderId}/status):
Yêu cầu HTTP (ví dụ curl - lệnh tương tác với API từ giao diện dòng lệnh):
curl -X GET "https://api.novafoods.vn/api/v1/orders/ORD-20260715-001/status" \
-H "Accept: application/json" \
-H "Authorization: Bearer YOUR_AUTH_TOKEN"
Phản hồi API (JSON - JavaScript Object Notation - một định dạng dữ liệu cấu trúc):
{
"orderId": "ORD-20260715-001",
"customerName": "Công ty TNHH Thực phẩm Sạch Minh Khôi",
"orderDate": "2026-07-15T10:30:00Z",
"status": "ĐANG_VẬN_CHUYỂN",
"deliveryStatusDetails": "Đang vận chuyển đến Kho trung chuyển HN",
"estimatedDeliveryDate": "2026-07-20",
"items": [
{
"productId": "PROD-IQF-CHICKEN-005",
"productName": "Ức gà phi lê IQF 1kg",
"quantity": 100,
"unitPrice": 85000.00,
"currency": "VND"
},
{
"productId": "PROD-SEA-SHRIMP-012",
"productName": "Tôm thẻ đông lạnh HOSO size 30",
"quantity": 50,
"unitPrice": 150000.00,
"currency": "VND"
}
],
"totalAmount": 16000000.00,
"currency": "VND",
"lastUpdated": "2026-07-18T14:45:00Z",
"trackingCode": "NF-TK-20260718-005"
}
Giải thích Chi tiết Ví dụ:
Mỗi trường trong phản hồi JSON cung cấp thông tin cụ thể về đơn hàng. orderId là định danh duy nhất của đơn hàng, giúp truy vết toàn bộ vòng đời đơn hàng. status phản ánh trạng thái nghiệp vụ hiện tại, tuân theo quy tắc nghiệp vụ (business rules) được định nghĩa trong /01-curriculum/CANONICAL_BUSINESS_RULES.md. estimatedDeliveryDate là ngày dự kiến giao. Mục items là một mảng (array) chứa chi tiết các sản phẩm, với productId và productName tương ứng với định danh trong /01-curriculum/TRACEABILITY_ID_REGISTRY.md và dữ liệu trong /01-curriculum/CANONICAL_DATA_DICTIONARY.md. totalAmount là tổng giá trị đơn hàng, sử dụng đơn vị tiền tệ mô phỏng VND.
Mọi truy vấn API cần có xác thực (authentication) và ủy quyền (authorization), như header Authorization: Bearer YOUR_AUTH_TOKEN chỉ ra. Điều này phù hợp với khuyến nghị bảo mật API từ OWASP API Security Top 10 (Phiên bản 2023) và OWASP ASVS (5.0.0). Thiết kế API này cũng tính đến yêu cầu toàn vẹn dữ liệu, khả năng truy vết, theo các tiêu chuẩn như Luật An toàn thực phẩm 55/2010/QH12 (áp dụng cho sản phẩm đông lạnh) và Nghị định 123/2020/NĐ-CP (liên quan hóa đơn chứng từ).
4. Senior Decision and Escalation Reference
Là chuyên viên Phân tích nghiệp vụ (Business Analyst - BA) cấp cao, cần hiểu rõ ranh giới thẩm quyền và khi nào cần leo thang vấn đề. Điều này đảm bảo dự án ERP mô phỏng Nova Foods không gặp rủi ro do quyết định sai phạm vi, hoặc bị chậm trễ do vấn đề không được giải quyết bởi đúng vai trò.
4.1 Đánh đổi (Trade-offs)
Đánh đổi (hay còn gọi là Thỏa hiệp - Trade-offs) là tình huống lựa chọn giữa các phương án, mỗi phương án đều có ưu và nhược điểm riêng. Việc chọn một phương án thường yêu cầu từ bỏ hoặc giảm ưu tiên cho một khía cạnh khác.
BA cần nhận diện các đánh đổi tiềm năng. Lý do: mọi dự án đều có ràng buộc về thời gian, chi phí, và tài nguyên. Ví dụ trong dự án ERP mô phỏng Nova Foods: việc ưu tiên triển khai nhanh module quản lý kho mới có thể đánh đổi bằng cách giảm tính linh hoạt cấu hình hoặc hoãn tích hợp với hệ thống vận chuyển của bên thứ ba. Điều này giúp đẩy nhanh thời gian ra thị trường nhưng có thể tăng chi phí bảo trì sau này hoặc giới hạn khả năng mở rộng.
Hành động của BA: Trình bày khách quan các lựa chọn, phân tích ưu nhược điểm của từng lựa chọn, và nêu rõ hậu quả tiềm ẩn nếu chọn từng phương án. BA không tự ý đưa ra quyết định đánh đổi cấp cao mà phải trình lên các bên có thẩm quyền kèm theo phân tích đầy đủ.
Thẩm quyền quyết định: Chủ sở hữu nghiệp vụ (Business Owner) hoặc Chủ dự án (Project Sponsor) là những người đưa ra quyết định đánh đổi cuối cùng, vì họ chịu trách nhiệm về giá trị kinh doanh và chiến lược tổng thể của Nova Foods, phù hợp với định nghĩa phạm vi trong /01-curriculum/01_CURRICULUM_ARCHITECTURE.md.
4.2 Ngoại lệ (Exceptions)
Ngoại lệ (Exceptions) là các trường hợp hiếm gặp, không tuân theo quy trình hoặc quy tắc nghiệp vụ (business rules) thông thường được thiết kế ban đầu.
Lý do cần xử lý: Hệ thống ERP thường được thiết kế cho quy trình chuẩn và các kịch bản phổ biến, không thể bao phủ mọi tình huống phức tạp hoặc bất thường. Ngoại lệ cần được nhận diện và xử lý rõ ràng để tránh lỗi hệ thống, mất dữ liệu, ảnh hưởng đến nghiệp vụ hoặc vi phạm quy định. Ví dụ: Nova Foods có quy trình hoàn tiền tự động cho khách hàng đã mua sản phẩm trong vòng 7 ngày, nhưng gặp trường hợp khách hàng VIP yêu cầu hoàn tiền cho sản phẩm đã hết hạn bảo hành 15 ngày do lỗi nhà sản xuất được xác nhận đặc biệt. Tình huống này không nằm trong quy tắc hoàn tiền tự động đã định nghĩa trong /01-curriculum/CANONICAL_BUSINESS_RULES.md.
Hành động của BA: Khi phát hiện ngoại lệ, BA phải ngay lập tức ghi nhận, phân tích nguyên nhân gốc rễ (root cause), đánh giá tác động đến quy trình nghiệp vụ và hệ thống. Đề xuất phương án xử lý cụ thể (ví dụ: quy trình thủ công tạm thời, điều chỉnh quy tắc nghiệp vụ có điều kiện, hoặc phát triển tính năng hỗ trợ đặc biệt). Sau đó, trình lên cho các bên liên quan để được phê duyệt chính thức.
Thẩm quyền phê duyệt: Chủ sở hữu nghiệp vụ sẽ phê duyệt phương án xử lý ngoại lệ. Trong các trường hợp phức tạp liên quan đến tài chính hoặc pháp lý, cần sự tham vấn và phê duyệt từ Legal Owner hoặc Accounting Owner.
4.3 Cờ đỏ (Red Flags)
Cờ đỏ (Red Flags) là những dấu hiệu cảnh báo sớm về các vấn đề tiềm ẩn, rủi ro có thể ảnh hưởng nghiêm trọng đến tiến độ, chất lượng, chi phí của dự án hoặc tính hợp lệ và an toàn của hệ thống.
Lý do: Phát hiện sớm Cờ đỏ giúp đội dự án phản ứng kịp thời, ngăn chặn các vấn đề nhỏ leo thang thành khủng hoảng lớn, gây thiệt hại nghiêm trọng cho Nova Foods.
Ví dụ về Cờ đỏ cho BA trong dự án ERP Nova Foods:
* Yêu cầu không rõ ràng hoặc mâu thuẫn: Hai phòng ban (ví dụ: Kế toán và Kinh doanh) có mô tả yêu cầu khác nhau cho cùng một báo cáo doanh thu, gây khó khăn trong việc xác định định dạng và nguồn dữ liệu. Điều này cho thấy sự thiếu đồng thuận ở cấp nghiệp vụ và có thể dẫn đến việc xây dựng sai tính năng, liên quan đến tính nhất quán của /01-curriculum/CANONICAL_DATA_DICTIONARY.md.
* Phạm vi thay đổi liên tục (Scope Creep): Các yêu cầu mới được thêm vào mà không có quy trình kiểm soát thay đổi rõ ràng hoặc đánh giá tác động đầy đủ, đe dọa lịch trình và ngân sách của dự án. Ví dụ: thêm một tính năng báo cáo tùy chỉnh phức tạp mà không có sự phê duyệt chính thức từ Chủ dự án.
* Thiếu tài nguyên hoặc chuyên môn: Đội phát triển không có đủ nhân lực hoặc kỹ năng cần thiết cho một tính năng phức tạp, ví dụ: tích hợp API của bên thứ ba đòi hỏi kiến thức chuyên sâu về OpenAPI Specification mà không có ai trong đội đáp ứng.
* Xung đột giữa các bên liên quan: Các stakeholder cấp cao của Nova Foods có mục tiêu đối lập rõ ràng và không thể đạt được sự đồng thuận trong các buổi họp, gây cản trở tiến độ ra quyết định.
* Rủi ro tuân thủ pháp lý: Yêu cầu hệ thống xử lý dữ liệu cá nhân khách hàng (theo Luật Bảo vệ dữ liệu cá nhân 91/2025/QH15) nhưng không có sự tham gia hoặc xác nhận từ Legal Owner, tiềm ẩn nguy cơ vi phạm pháp luật và phạt.
Hành động của BA: Khi nhận diện Cờ đỏ, BA phải ngay lập tức ghi nhận, phân tích mức độ nghiêm trọng và tác động tiềm ẩn. Sau đó, nhanh chóng báo cáo lên Quản lý dự án (Project Manager) cùng các bên liên quan cấp cao để thảo luận và đưa ra hành động khắc phục kịp thời.
4.4 Thẩm quyền (Authority) và Vai trò Quyết định
Thẩm quyền (Authority) là quyền hợp pháp hoặc chính thức được đưa ra các quyết định, phê duyệt, hoặc hướng dẫn trong một lĩnh vực cụ thể. Lý do: Phân định thẩm quyền rõ ràng là yếu tố then chốt để quản lý dự án hiệu quả, tránh sự chồng chéo, mâu thuẫn trong quyết định, và đảm bảo các vấn đề được giải quyết bởi người có đủ năng lực và trách nhiệm. Với tư cách BA, bạn cung cấp thông tin, phân tích, đề xuất, nhưng hiếm khi là người ra quyết định cuối cùng cho các vấn đề nghiệp vụ, pháp lý, tài chính hoặc kiến trúc. Các quyết định này phải được chuyển cho vai trò có thẩm quyền.
Bảng Phân Định Thẩm Quyền Quyết Định Chính cho Dự án Nova Foods ERP mô phỏng
| Loại Quyết Định | Vai Trò Chính Quyết Định | Lý Do và Tham Chiếu Nguồn |
|---|---|---|
| Phạm vi dự án (Project Scope) | Project Sponsor, Business Owner cấp cao | Quyết định tổng thể về những gì dự án sẽ mang lại. Ảnh hưởng trực tiếp đến chi phí, thời gian và giá trị kinh doanh tổng thể của Nova Foods. BA cung cấp phân tích và đề xuất phạm vi. |
| Quy tắc nghiệp vụ (Business Rules) | Business Owner (phòng ban liên quan) | Đảm bảo hệ thống hoạt động đúng theo yêu cầu kinh doanh và tuân thủ các quy định nội bộ Nova Foods. Nguồn gốc: /01-curriculum/CANONICAL_BUSINESS_RULES.md chứa các quy tắc chuẩn. |
| Cấu trúc dữ liệu (Data Structure) | Technical Architect, Data Owner (nếu có) | Quyết định về cách dữ liệu được tổ chức và lưu trữ trong hệ thống. Ảnh hưởng đến hiệu năng, bảo mật, khả năng tích hợp và mở rộng hệ thống. Nguồn gốc: /01-curriculum/CANONICAL_DATA_DICTIONARY.md là kế hoạch từ điển dữ liệu logic. |
| Quyết định pháp lý & tuân thủ (Legal & Compliance Decisions) | Legal Owner, Compliance Officer | Đảm bảo hệ thống tuân thủ các luật hiện hành (ví dụ: Luật Bảo vệ dữ liệu cá nhân 91/2025/QH15, Nghị định 123/2020/NĐ-CP về hóa đơn điện tử) và các chính sách của Nova Foods. BA chỉ ra rủi ro nhưng không quyết định tính pháp lý. |
| Quyết định bảo mật (Security Decisions) | Security Owner (CISO/Trưởng phòng An ninh thông tin) | Xác định các biện pháp bảo vệ dữ liệu và hệ thống khỏi các mối đe dọa, đảm bảo tính toàn vẹn, bảo mật, và sẵn sàng của hệ thống. Tham chiếu: OWASP ASVS (5.0.0), OWASP API Security Top 10 (2023). |
| Quyết định kế toán & tài chính (Accounting & Financial Decisions) | Accounting Owner (Kế toán trưởng/CFO) | Đảm bảo hệ thống ghi nhận và báo cáo tài chính chính xác, tuân thủ Luật Kế toán 88/2015/QH13 và các quy định kế toán liên quan của Nova Foods. |
| Kiến trúc kỹ thuật (Technical Architecture) | Technical Architect | Thiết kế tổng thể của hệ thống, bao gồm lựa chọn công nghệ, cấu trúc module, và các giải pháp kỹ thuật. Ảnh hưởng đến khả năng mở rộng, bảo trì, hiệu suất và chi phí vận hành. |
| Thay đổi yêu cầu (Requirement Change) | Business Owner, Project Manager (qua quy trình kiểm soát thay đổi) | Quản lý việc thêm, sửa đổi hoặc loại bỏ yêu cầu để kiểm soát phạm vi và tác động đến dự án. Nguồn: /01-curriculum/TRACEABILITY_ID_REGISTRY.md để theo dõi các ID yêu cầu và đảm bảo truy vết. |
BA phải duy trì tính toàn vẹn của thông tin, phân tích rõ ràng và trình bày cho đúng người có thẩm quyền để đưa ra quyết định. Việc nhầm lẫn thẩm quyền có thể dẫn đến hậu quả nghiêm trọng cho dự án và hoạt động của Nova Foods.
Phân biệt Sự thật, Giả định, Khuyến nghị và Quyết định
Trong vai trò Chuyên viên Phân tích Nghiệp vụ (Business Analyst), việc phân biệt rõ ràng giữa sự thật (Fact), giả định (Assumption), khuyến nghị (Recommendation) và quyết định (Decision) là nền tảng để xây dựng hệ thống nghiệp vụ vững chắc và giảm thiểu rủi ro cho các dự án ERP mô phỏng như Nova Foods. Sự nhầm lẫn giữa các khái niệm này có thể dẫn đến yêu cầu không chính xác, thiết kế lỗi và triển khai hệ thống thất bại. Mỗi loại thông tin có bản chất, yêu cầu bằng chứng, mức độ rủi ro và thẩm quyền xử lý khác nhau.
Sự thật (Fact): Một sự thật là một thông tin đã được xác minh khách quan và có bằng chứng rõ ràng, không thể tranh cãi. Sự thật cung cấp nền tảng vững chắc cho mọi phân tích và thiết kế. Việc sử dụng sự thật giúp giảm thiểu rủi ro và tăng tính chính xác của các yêu cầu. * Ví dụ Nova Foods: "Hệ thống quản lý kho hiện tại của Nova Foods ghi nhận trung bình 1,500 lượt nhập kho và 2,000 lượt xuất kho mỗi ngày làm việc." (Bằng chứng: Báo cáo vận hành hàng ngày của hệ thống cũ trong quý gần nhất, xác nhận bởi Trưởng phòng Vận hành Kho).
Giả định (Assumption): Một giả định là một điều kiện hoặc tình huống được chấp nhận là đúng cho mục đích lập kế hoạch, nhưng chưa được xác minh hoặc chứng minh đầy đủ. Giả định được dùng để lấp đầy khoảng trống thông tin khi không có đủ dữ liệu, nhưng luôn tiềm ẩn rủi ro nếu sau này bị chứng minh là sai. Mọi giả định trong corpus Nova Foods phải được ghi nhận rõ ràng và dán nhãn Verification required (Yêu cầu xác minh).
* Ví dụ Nova Foods: "Hệ thống ERP mới sẽ có khả năng tích hợp trực tiếp với máy quét mã vạch hiện có tại các kho của Nova Foods mà không cần phát triển phần mềm trung gian riêng." (Bằng chứng: Đánh giá ban đầu từ nhà cung cấp ERP; Verification required từ Kiến trúc sư Giải pháp hoặc Chuyên gia Kỹ thuật Phần cứng).
Khuyến nghị (Recommendation): Một khuyến nghị là một đề xuất hành động cụ thể, dựa trên phân tích, đánh giá và phán đoán của Chuyên viên Phân tích Nghiệp vụ nhằm giải quyết vấn đề hoặc cải thiện tình hình. Khuyến nghị không mang tính ràng buộc cho đến khi được phê duyệt bởi bên có thẩm quyền. * Ví dụ Nova Foods: "Để giảm thiểu sai sót trong quy trình đối chiếu công nợ nhà cung cấp, Nova Foods nên triển khai tính năng tự động đối chiếu hóa đơn điện tử với đơn đặt hàng và phiếu nhập hàng trong module kế toán mới." (Cơ sở: Phân tích chỉ ra 20% thời gian kế toán viên dành cho việc đối chiếu thủ công và 5% hóa đơn sai sót dẫn đến chậm thanh toán).
Quyết định (Decision): Một quyết định là một sự lựa chọn đã được thực hiện bởi một người hoặc một nhóm có thẩm quyền. Quyết định mang tính ràng buộc, phân bổ nguồn lực, thay đổi trạng thái của dự án và thường dẫn đến các hành động không thể đảo ngược hoặc rất tốn kém để đảo ngược. * Ví dụ Nova Foods: "Ban Giám đốc Nova Foods đã quyết định lựa chọn gói phần mềm ERP 'FusionPro' của Nhà cung cấp Z, phiên bản Enterprise, để triển khai trong 18 tháng tới." (Bằng chứng: Biên bản họp Ban Giám đốc ngày 2026-07-28, chữ ký của CEO và CFO).
Để quản lý hiệu quả trong dự án ERP, Chuyên viên Phân tích Nghiệp vụ cần nắm rõ sự khác biệt của từng khái niệm này theo bảng sau:
| Tiêu chí | Sự thật (Fact) | Giả định (Assumption) | Khuyến nghị (Recommendation) | Quyết định (Decision) |
|---|---|---|---|---|
| Bản chất | Đã xác minh, khách quan, có bằng chứng. | Chưa xác minh, chấp nhận tạm thời để tiến hành. | Đề xuất hành động, dựa trên phân tích. | Lựa chọn ràng buộc, hành động cụ thể. |
| Bằng chứng | Dữ liệu, tài liệu, quan sát có thể kiểm chứng. | Thiếu bằng chứng hoặc bằng chứng chưa đủ mạnh, dựa trên kinh nghiệm. | Phân tích, đánh giá ưu nhược điểm, so sánh các phương án. | Ghi nhận thẩm quyền phê duyệt, biên bản, chữ ký. |
| Mức độ rủi ro | Thấp (nếu bằng chứng đầy đủ, xác đáng). | Cao (có thể sai, gây chậm trễ, phát sinh chi phí). | Trung bình (cần đánh giá rủi ro nếu thực hiện khuyến nghị). | Trung bình đến Cao (tùy thuộc vào tác động và tính khó đảo ngược). |
| Thẩm quyền | Không cần thẩm quyền để là "sự thật", nhưng cần chấp nhận làm "nền tảng" trong dự án. | Cần sự chấp thuận của stakeholder để chấp nhận giả định cho mục đích lập kế hoạch. | Cần được trình bày và phê duyệt bởi stakeholder có thẩm quyền. | Cần thẩm quyền của người hoặc nhóm ra quyết định. |
| Hậu quả | Nền tảng đáng tin cậy cho việc lập yêu cầu và thiết kế. | Có thể dẫn đến thiết kế sai, lãng phí tài nguyên nếu giả định không đúng. Cần dán nhãn Verification required. |
Có thể cải thiện hoặc làm xấu đi tình hình nếu thực hiện theo. | Phân bổ nguồn lực, thay đổi đáng kể trạng thái dự án, tạo ra các phụ thuộc mới. |
| Hành động tiếp theo | Dùng làm cơ sở để xây dựng các yêu cầu nghiệp vụ. | Lập kế hoạch để xác minh, theo dõi, tìm kiếm bằng chứng. | Đánh giá, thảo luận với stakeholder, tìm kiếm phê duyệt. | Triển khai hành động đã quyết định, truyền đạt thông tin cho các bên liên quan. |
Điểm kích hoạt và Chủ sở hữu leo thang
Leo thang (Escalation): Đưa vấn đề lên cấp quản lý cao hơn. Cần thẩm quyền lớn hơn giải quyết. Điểm kích hoạt (Trigger): Điều kiện bắt đầu quá trình leo thang. Chủ sở hữu (Owner): Cá nhân, vai trò chịu trách nhiệm giải quyết vấn đề đã leo thang.
Bảng này mô tả các điểm kích hoạt (trigger) cần xem xét leo thang trong dự án ERP Nova Foods (mô phỏng).
| Mã kích hoạt | Điểm kích hoạt | Mô tả |
|---|---|---|
| NF-ESC-001 | Mâu thuẫn nguồn chân lý (Source of Truth Conflict) | Hai hoặc nhiều nguồn dữ liệu canonical (ví dụ: /01-curriculum/CANONICAL_BUSINESS_RULES.md, /01-curriculum/CANONICAL_DATA_DICTIONARY.md) có thông tin mâu thuẫn. |
| NF-ESC-002 | Vượt thẩm quyền BA (BA Authority Limit) | Quyết định yêu cầu phê duyệt pháp lý, kế toán, bảo mật hoặc nghiệp vụ cấp cao. BA không có quyền quyết định. |
| NF-ESC-003 | Rủi ro dự án (Project Risk Identified) | Phát hiện rủi ro ảnh hưởng lớn tiến độ, ngân sách hoặc chất lượng dự án ERP Nova Foods (mô phỏng). |
| NF-ESC-004 | Thiếu thông tin trọng yếu (Critical Information Gap) | Không thể tiếp tục công việc BA do thiếu thông tin quan trọng. Nỗ lực tìm kiếm bị chặn. |
| NF-ESC-005 | Quyết định không rõ ràng (Unclear Decision) | Sau thảo luận, quyết định vẫn mơ hồ, có nhiều cách hiểu, hoặc thiếu sự đồng thuận rõ ràng giữa các bên liên quan. |
| NF-ESC-006 | Chậm tiến độ quan trọng (Critical Path Delay) | Task BA hoặc task phụ thuộc bị chậm trễ, ảnh hưởng trực tiếp đến lộ trình tổng thể của dự án Nova Foods. |
Bảng này liệt kê các chủ sở hữu (owner) chịu trách nhiệm giải quyết khi vấn đề được leo thang, dựa trên loại vấn đề.
| Loại vấn đề | Chủ sở hữu leo thang chính | Vai trò hỗ trợ / Tham gia |
|---|---|---|
| Pháp lý (Legal) | Legal Owner / Compliance Officer (Người phụ trách pháp lý / Tuân thủ) | Project Manager, Senior BA |
| Kế toán / Thuế (Accounting / Tax) | Accounting Owner (Người phụ trách kế toán) | Project Manager, Senior BA, Business Owner |
| Bảo mật (Security) | Security Architect / CISO (Kiến trúc sư bảo mật / Giám đốc bảo mật thông tin) | Development Lead, Project Manager |
| Nghiệp vụ (Business Rule) | Business Owner (Chủ sở hữu nghiệp vụ) | Product Owner, Senior BA, Solution Architect |
| Kỹ thuật / Kiến trúc (Technical / Architecture) | Solution Architect / Technical Lead (Kiến trúc sư giải pháp / Trưởng nhóm kỹ thuật) | Senior Developer, Senior BA |
| Quản lý dự án (Project Management) | Project Manager (Quản lý dự án) | Sponsor (Người tài trợ dự án), Head of Department (Trưởng phòng ban) |
| Chất lượng (Quality Assurance) | QA Lead / Test Manager (Trưởng nhóm QA / Quản lý kiểm thử) | Senior Tester, Business Owner |
Ví dụ Nova Foods mô phỏng:
BA phát hiện định nghĩa phương thức thanh toán (payment method) trong /01-curriculum/CANONICAL_BUSINESS_RULES.md không khớp payment_type_code trong /01-curriculum/CANONICAL_DATA_DICTIONARY.md.
Điểm kích hoạt: NF-ESC-001 (Mâu thuẫn nguồn chân lý).
Hành động: BA gói vấn đề. Ghi rõ ID artifact mâu thuẫn. Ghi lại đề xuất.
Chủ sở hữu leo thang: Senior BA (đánh giá), Business Owner (quyết định nghiệp vụ chính xác), Solution Architect (định dạng kỹ thuật).
Mục đích: Đảm bảo duy nhất nguồn chân lý cho hệ thống ERP Nova Foods.
5. Quick Checks and Cross-File QA
Kiểm tra nhanh là bước cơ bản đảm bảo chất lượng, tính nhất quán và độ tin cậy của tài liệu phân tích nghiệp vụ. Business Analyst (BA) hoặc người đánh giá thực hiện kiểm tra trước khi chuyển giao hoặc review sâu. Kiểm tra phát hiện sớm mâu thuẫn, thiếu sót, thông tin không chính xác. Kết quả giảm chi phí sửa lỗi ở giai đoạn sau.
| Mục kiểm tra (Check Item) | Lý do (Reason) | Tham chiếu (Reference) | Hướng dẫn nhanh (Quick Guide) |
|---|---|---|---|
| Kiểm tra Metadata quản trị (Governance Metadata Check) | Đảm bảo metadata như Artifact ID (định danh tạo phẩm duy nhất), Status (trạng thái hiện tại), Version (phiên bản), Owner (người sở hữu) và Last updated date (ngày cập nhật cuối cùng) đầy đủ, chính xác, thống nhất. Metadata đúng giúp quản lý vòng đời tạo phẩm. |
/00-research/00_SOURCE_MAP.md (metadata) /01-curriculum/01_CURRICULUM_ARCHITECTURE.md (metadata) /01-curriculum/CHAPTER_MANIFEST.md (metadata) /01-curriculum/TEMPLATE_MANIFEST.md (metadata) /01-curriculum/TRACEABILITY_ID_REGISTRY.md (metadata) /01-curriculum/CANONICAL_BUSINESS_RULES.md (metadata) /01-curriculum/CANONICAL_DATA_DICTIONARY.md (metadata) |
Xác minh trường metadata chính trong tiêu đề hoặc bảng quản trị của từng tệp. Trạng thái IN_REVIEW không phải APPROVED (đã phê duyệt) hoặc BASELINED (đã có đường cơ sở). |
| Kiểm tra Định danh tệp và ID (Filename and ID Consistency) | Đảm bảo nhất quán giữa Artifact ID và tên tệp vật lý. Nhất quán giúp truy cập, quản lý, truy vết tài liệu trong toàn corpus. |
Trường Artifact ID và Tên tệp được kiểm soát trong metadata của từng tạo phẩm; /01-curriculum/TRACEABILITY_ID_REGISTRY.md; /01-curriculum/CHAPTER_MANIFEST.md; /01-curriculum/TEMPLATE_MANIFEST.md. |
Tên tệp phải khớp Artifact ID đã đăng ký. Ví dụ tệp /00-research/00_SOURCE_MAP.md có Artifact ID là 00_SOURCE_MAP. Khi không khớp, BA ghi nhận sai lệch, xác định artifact gốc, rồi cập nhật theo thẩm quyền. |
| Kiểm tra Tham chiếu nguồn gốc (Source Traceability) | Mọi thông tin quan trọng về pháp lý, tiêu chuẩn kỹ thuật, quy tắc nghiệp vụ phải có nguồn rõ ràng, đáng tin cậy. Truy vết nguồn bảo vệ tính hợp lệ nội dung. Canonical Source là nguồn thông tin chính thức đã đăng ký. |
/00-research/00_SOURCE_MAP.md; /01-curriculum/CANONICAL_BUSINESS_RULES.md; /01-curriculum/CANONICAL_DATA_DICTIONARY.md; /01-curriculum/TRACEABILITY_ID_REGISTRY.md. |
Mọi tuyên bố nghiệp vụ, pháp lý, kỹ thuật hoặc yêu cầu cụ thể phải liên kết tới nguồn đã đăng ký và được xác minh trong /00-research/00_SOURCE_MAP.md. BA không tự diễn giải thành yêu cầu pháp lý, quyết định kế toán, hoặc phê duyệt bảo mật. |
| Kiểm tra Từ ngữ và Thuật ngữ (Terminology Consistency) | Đảm bảo thuật ngữ chuẩn, rõ ràng, nhất quán, dễ hiểu cho người học mới. Thuật ngữ tiếng Anh chuyên ngành phải có diễn giải tiếng Việt ở lần dùng đầu tiên. | /05-glossary/ (khi có) /01-curriculum/CANONICAL_BUSINESS_RULES.md /01-curriculum/CANONICAL_DATA_DICTIONARY.md /04-cheatsheets/technical-cheatsheets.md. |
Đọc nội dung, tìm thuật ngữ chuyên ngành tiếng Anh. Xác nhận diễn giải tiếng Việt ở lần dùng đầu. Đảm bảo thuật ngữ mô phỏng Nova Foods như payment method (phương thức thanh toán) dùng nhất quán với quy tắc nghiệp vụ và từ điển dữ liệu. |
| Kiểm tra Trạng thái mô phỏng Nova Foods (Simulated Nova Foods Status) | Nhắc người học Nova Foods là môi trường giáo dục mô phỏng với dữ liệu tổng hợp. Việc này ngăn hiểu nhầm thành hệ thống thực, quy tắc nghiệp vụ thật, hoặc tuyên bố tuân thủ pháp lý hiện hành. | Quy tắc SRC-READY-010 trong /00-research/00_SOURCE_MAP.md; metadata Case-study reference của mọi tạo phẩm; /04-cheatsheets/technical-cheatsheets.md. |
Mọi ví dụ, quy trình, dữ liệu liên quan Nova Foods phải có nhãn mô phỏng giáo dục hoặc chỉ sử dụng dữ liệu tổng hợp. Không khẳng định dữ liệu là dữ liệu vận hành thực, không khẳng định quyết định là phê duyệt thực. |
| Kiểm tra Giới hạn Thẩm quyền Owner (Owner Authority Limits) | Ngăn hiểu lầm về vai trò và quyền hạn của Owner (người sở hữu) tạo phẩm. Owner chịu trách nhiệm duy trì kỹ thuật tạo phẩm, không có quyền phê duyệt nghiệp vụ, pháp lý, kế toán, bảo mật hoặc quyết định production. |
Trường Giới hạn thẩm quyền của Owner trong metadata của từng tạo phẩm; /00-research/00_SOURCE_MAP.md; /01-curriculum/01_CURRICULUM_ARCHITECTURE.md. |
Xác nhận nội dung không tuyên bố baseline, approval (phê duyệt), tuân thủ pháp luật, dữ liệu kế toán thực tế, hoặc quyền vận hành production khi Owner không có thẩm quyền đó. Nếu cần quyết định, BA chuyển vấn đề cho vai trò có thẩm quyền. |
| Kiểm tra Không dùng từ khóa giữ chỗ (No Forbidden Placeholders) | Đảm bảo nội dung tạo phẩm hoàn chỉnh, không có chỗ trống hoặc ký hiệu ngụ ý phần nội dung bị bỏ qua. Tạo phẩm hoàn chỉnh giúp người đọc xác định đầy đủ actor, hành động, đối tượng, kết quả, thẩm quyền, artifact, đánh đổi và hệ quả. | /04-cheatsheets/technical-cheatsheets.md; /00-research/00_SOURCE_MAP.md; /01-curriculum/01_CURRICULUM_ARCHITECTURE.md; /01-curriculum/CHAPTER_MANIFEST.md; /01-curriculum/TEMPLATE_MANIFEST.md; /01-curriculum/TRACEABILITY_ID_REGISTRY.md; /01-curriculum/CANONICAL_BUSINESS_RULES.md; /01-curriculum/CANONICAL_DATA_DICTIONARY.md. |
Rà soát toàn bộ nội dung từng artifact để tìm từ khóa hoặc ký hiệu cho thấy nội dung chưa hoàn chỉnh, gồm từ viết tắt chỉ việc cần làm, từ viết tắt chỉ nội dung chưa được xác định, và dấu ba chấm. Người sửa phải thay từng vị trí bằng nội dung đầy đủ hoặc tham chiếu tệp nguồn cụ thể. Không bỏ qua hàng, cột, tệp hoặc quan hệ phụ thuộc. |
| Kiểm tra Tính nhất quán liên file (Cross-File Consistency) | Đảm bảo tạo phẩm liên quan không mâu thuẫn về định nghĩa, quy tắc nghiệp vụ hoặc cấu trúc dữ liệu. Kiểm tra giữ một nguồn chân lý cho hệ thống ERP Nova Foods mô phỏng. | /01-curriculum/TRACEABILITY_ID_REGISTRY.md /01-curriculum/CANONICAL_BUSINESS_RULES.md /01-curriculum/CANONICAL_DATA_DICTIONARY.md /01-curriculum/CHAPTER_MANIFEST.md /01-curriculum/TEMPLATE_MANIFEST.md /04-cheatsheets/technical-cheatsheets.md. |
Kiểm tra nhất quán định nghĩa giữa tệp. Ví dụ định nghĩa phương thức thanh toán trong /01-curriculum/CANONICAL_BUSINESS_RULES.md phải khớp payment_type_code trong /01-curriculum/CANONICAL_DATA_DICTIONARY.md. Khi có mâu thuẫn, BA ghi nhận artifact gốc, artifact bị ảnh hưởng, tác động và vai trò cần review. |
5.2. Kiểm tra Liên kết Chéo và Nguồn Chuẩn Tắc
Kiểm tra liên kết chéo (cross-links) và nguồn chuẩn tắc (canonical sources) đảm bảo tính nhất quán, chính xác và khả năng truy vết (traceability) trong toàn bộ tài liệu. Nguồn chuẩn tắc là nguồn thông tin chính thức, được phê duyệt, được sử dụng làm cơ sở duy nhất cho một thông tin cụ thể. Sử dụng nguồn chuẩn tắc giúp tránh sai lệch, mâu thuẫn thông tin, và đảm bảo tuân thủ các quy định pháp lý hoặc tiêu chuẩn kỹ thuật. Nova Foods (mô phỏng) cũng tuân thủ nguyên tắc này.
1. Nguồn Chuẩn Tắc Chính và Phạm vi Sử dụng An toàn
Bảng này liệt kê các nguồn chuẩn tắc được sử dụng trong hệ thống tài liệu Nova Foods (mô phỏng) và giới hạn sử dụng an toàn của từng nguồn. Mọi thông tin tham chiếu từ các nguồn này phải khớp chính xác với bản gốc để đảm bảo tính pháp lý hoặc kỹ thuật.
| Nguồn chuẩn tắc (Canonical Source) | Tổ chức phát hành | Phiên bản/Tình trạng | Liên kết chính thức | Phạm vi sử dụng an toàn | Lý do có trong corpus (từ 00_SOURCE_MAP.md) |
|---|---|---|---|---|---|
| BABOK Guide | IIBA | Version 3 | https://www.iiba.org/career-resources/a-business-analysis-professionals-foundation-for-success/babok/ | Kiến thức BA, nhiệm vụ, năng lực và thuật ngữ. Không tự ý tạo tham chiếu. | Kiến thức cốt lõi cho BA. |
| ISO/IEC/IEEE 29148 | ISO/IEC/IEEE | 29148:2018, Ed 2 | https://www.iso.org/standard/72089.html | Tóm tắt và tình trạng thư mục. Điều khoản cụ thể cần xác minh bản quyền. | Chuẩn quốc tế về yêu cầu. |
| BPMN | OMG | BPMN 2.0.2 | https://www.omg.org/spec/BPMN/2.0.2/About-BPMN/ | Ký hiệu BPMN chuẩn tắc. Không gọi biểu đồ hoạt động PlantUML là BPMN. | Biểu diễn quy trình nghiệp vụ. |
| UML | OMG | UML 2.5.1 | https://www.omg.org/spec/UML/2.5.1/About-UML/ | Ngữ nghĩa UML chuẩn tắc. | Biểu diễn thiết kế hệ thống. |
| ISTQB CTFL | ISTQB | CTFL Syllabus v4.0.1 | https://www.istqb.org/wp-content/uploads/2024/11/ISTQB_CTFL_Syllabus_v4.0.1.pdf | Giáo trình kiểm thử, thuật ngữ, kỹ thuật hộp đen. | Nền tảng kiểm thử phần mềm. |
| OpenAPI Specification | OpenAPI Initiative | OAS 3.1.1 | https://spec.openapis.org/oas/v3.1.1.html | Tính năng OAS 3.1 và mô tả API HTTP. | Đặc tả API. |
| WCAG | W3C | WCAG 2.2 Recommendation | https://www.w3.org/TR/WCAG22/ | Khuyến nghị truy cập chuẩn tắc. Tiêu chí thành công phải khớp nguồn. | Khả năng tiếp cận hệ thống. |
| OWASP ASVS | OWASP Foundation | ASVS 5.0.0 | https://owasp.org/www-project-application-security-verification-standard/ | Tiêu chuẩn xác minh bảo mật. Không thay thế luật Việt Nam. | Bảo mật ứng dụng. |
| OWASP API Security Top 10 | OWASP Foundation | 2023 edition | https://owasp.org/API-Security/editions/2023/en/0x11-t10/ | Thực hành tốt bảo mật API. Không là tiêu chuẩn pháp lý. | Bảo mật API. |
| Luật Bảo vệ dữ liệu cá nhân | QH Việt Nam | Luật 91/2025/QH15 | https://vanban.chinhphu.vn/?classid=1&docid=214590&pageid=27160&typegroup= | Nguồn pháp lý chính thức. Yêu cầu hệ thống cần xác minh chủ sở hữu pháp lý. | Quy định pháp lý về dữ liệu. |
| Nghị định hướng dẫn bảo vệ dữ liệu cá nhân | CP Việt Nam | NĐ 356/2025/NĐ-CP | https://vanban.chinhphu.vn/?classid=1&docid=216387&pageid=27160 | Nguồn pháp lý chính thức. | Hướng dẫn luật bảo vệ dữ liệu. |
| Luật Kế toán | QH Việt Nam | Luật 88/2015/QH13 | https://vanban.chinhphu.vn/?docid=183198&pageid=27160 | Nguồn pháp lý. Giải thích kế toán cần vai trò kế toán/pháp lý. | Cơ sở pháp lý cho nghiệp vụ kế toán. |
| Hóa đơn, chứng từ | CP Việt Nam | NĐ 123/2020/NĐ-CP | https://vanban.chinhphu.vn/?docid=201365&pageid=27160 | Nguồn pháp lý. Cần xác minh sửa đổi trước khi dùng. | Quy định về chứng từ kế toán. |
| Luật An toàn thực phẩm | QH Việt Nam | Luật 55/2010/QH12 | https://vanban.chinhphu.vn/?docid=96032&pageid=27160 | Nguồn pháp lý cho truy xuất nguồn gốc. Cần xác minh chủ sở hữu nghiệp vụ và pháp lý. | Quy định pháp lý an toàn thực phẩm. |
2. Kiểm tra Liên kết Chéo (Cross-links) giữa các Artifact
Liên kết chéo là các tham chiếu giữa các tài liệu khác nhau trong hệ thống tài liệu Nova Foods (mô phỏng). Việc kiểm tra liên kết chéo đảm bảo thông tin nhất quán và có thể truy vết từ nguồn gốc đến tài liệu phái sinh. Artifact cốt lõi cần kiểm tra chéo gồm:
00-research/00_SOURCE_MAP.md: Bản đồ nguồn chính, chứa danh sách và mục đích của toàn bộ nguồn được sử dụng. Mọi nguồn được tham chiếu trong artifact khác phải có mặt và được định nghĩa rõ tại đây.01-curriculum/01_CURRICULUM_ARCHITECTURE.md: Kiến trúc tổng thể chương trình đào tạo, định nghĩa cấu trúc và quan hệ giữa các phần. ID artifact nhưCHAPTER_MANIFESThoặcTEMPLATE_MANIFESTphải khớp định nghĩa trong tài liệu này.01-curriculum/CHAPTER_MANIFEST.md: Danh sách toàn bộ chương học, ID và trạng thái. Khi chapter được nhắc đến, kiểm tra ID có khớp manifest này.01-curriculum/TEMPLATE_MANIFEST.md: Danh sách mẫu tài liệu, ID và trạng thái. Mọi mẫu được đề cập trong cheatsheet hoặc handbook phải có ID và mô tả khớp manifest này.01-curriculum/TRACEABILITY_ID_REGISTRY.md: Registry định danh chuẩn tắc. Mọi ID được tạo hoặc tham chiếu nhưNF-REQ-,NF-PROC-,NF-DATA-phải được đăng ký hoặc phù hợp cấu trúc trong registry này. Việc này đảm bảo duy nhất và truy vết từng phần tử.01-curriculum/CANONICAL_BUSINESS_RULES.md: Catalog quy tắc nghiệp vụ chuẩn tắc. Mọi quy tắc nghiệp vụNF-BR-được diễn giải trong tài liệu khác phải có nguồn gốc và định nghĩa rõ từ đây.01-curriculum/CANONICAL_DATA_DICTIONARY.md: Từ điển dữ liệu logic chuẩn tắc. Mọi định nghĩa dữ liệu, thuật ngữNF-TERM-, hoặc trường dữ liệu Nova Foods phải khớp từ điển này.04-cheatsheets/technical-cheatsheets.md: Cheatsheet kỹ thuật. Mọi liên kết nội bộ, tên artifact, nguồn chuẩn tắc, ví dụ Nova Foods và hướng dẫn kiểm tra phải khớp các artifact chuẩn tắc nêu trên.
Quy trình kiểm tra liên kết chéo:
- Xác minh ID: Đảm bảo toàn bộ ID được tham chiếu, ví dụ
NF-REQ-001,NF-BR-005, tồn tại và khớp/01-curriculum/TRACEABILITY_ID_REGISTRY.md. - Xác minh phiên bản và trạng thái: Kiểm tra phiên bản, ví dụ
v0.9.0, và trạng thái, gồmIN_REVIEW, của artifact phụ thuộc có nhất quán metadata quản trị.IN_REVIEWvẫn cần review; không làAPPROVEDhoặcBASELINED. - Kiểm tra ranh giới thẩm quyền: Xác nhận artifact không tự đưa quyết định như phê duyệt pháp lý hoặc kế toán ngoài phạm vi
Ownertrong metadata của chính artifact. - Xác minh đường dẫn và tên tệp: Đảm bảo mọi đường dẫn tham chiếu tồn tại trong corpus, tên tệp khớp manifest hoặc registry liên quan, và không dùng đường dẫn rút gọn làm mất ranh giới nguồn.
- Ghi nhận kết quả: BA ghi nhận artifact kiểm tra, liên kết đã kiểm tra, kết quả, sai lệch, tác động, người cần review và hành động tiếp theo. BA không tự phê duyệt thay đổi ngoài thẩm quyền.
Vấn đề Xác minh Mở và Quy tắc Lan truyền Thay đổi
1. Vấn đề Xác minh Đang Mở (Open Verification Issues)
Vấn đề xác minh đang mở là điểm nội dung tài liệu cần xác nhận chính thức từ vai trò có thẩm quyền ngoài tác giả chương trình, ví dụ Chủ sở hữu nghiệp vụ (Business Owner), Chuyên gia Pháp lý (Legal Expert), Kế toán trưởng (Chief Accountant), Kiến trúc sư Giải pháp (Solution Architect), hoặc Chuyên gia Bảo mật (Security Specialist). Tác giả chương trình IT Business Analyst (BA) chỉ xác định nhu cầu xác minh, không tự quyết định nội dung cuối cùng. Nova Foods là mô phỏng; các vấn đề này là ví dụ cho dự án thật.
| ID Vấn đề | Mô tả Vấn đề Xác minh | Artifact Ảnh hưởng | Trạng thái Xác minh | Chủ Sở hữu (giả lập) | Ngày Hạn chót (giả lập) |
|---|---|---|---|---|---|
| NVF-VER-001 | Diễn giải chính xác điều khoản Luật Bảo vệ dữ liệu cá nhân (Law on Personal Data Protection) 91/2025/QH15 liên quan đến lưu trữ dữ liệu khách hàng quốc tế. |
/01-curriculum/CANONICAL_BUSINESS_RULES.md, /01-curriculum/CANONICAL_DATA_DICTIONARY.md, /03-templates/DPPA.md |
IN_REVIEW |
Legal Owner | 2026-09-01 |
| NVF-VER-002 | Xác nhận phương pháp hạch toán doanh thu cho đơn hàng trực tuyến có quà tặng kèm theo Luật Kế toán 88/2015/QH13 và Nghị định 123/2020/NĐ-CP về hóa đơn. |
/01-curriculum/CANONICAL_BUSINESS_RULES.md, /01-curriculum/CANONICAL_DATA_DICTIONARY.md |
REQUESTED |
Accounting Owner | 2026-09-15 |
| NVF-VER-003 | Đánh giá yêu cầu bảo mật API cho cổng thanh toán bên thứ ba theo OWASP ASVS (Application Security Verification Standard) L2 và OWASP API Security Top 10. |
/01-curriculum/TRACEABILITY_ID_REGISTRY.md, /03-templates/API_SPEC.md |
PENDING_REVIEW |
Security Architect | 2026-09-30 |
| NVF-VER-004 | Xác định dữ liệu truy xuất nguồn gốc (traceability data) tối thiểu cho sản phẩm đông lạnh theo Luật An toàn thực phẩm 55/2010/QH12. |
/01-curriculum/CANONICAL_DATA_DICTIONARY.md, /01-curriculum/CANONICAL_BUSINESS_RULES.md |
IN_REVIEW |
Business Owner | 2026-10-01 |
| NVF-VER-005 | Giải quyết mâu thuẫn giữa CHAPTER_MANIFEST.md và TEMPLATE_MANIFEST.md về ID CURR-ASSMT-003 và GEN-TMPL-007. |
/01-curriculum/CHAPTER_MANIFEST.md, /01-curriculum/TEMPLATE_MANIFEST.md |
DETECTED |
Principal IT BA | 2026-08-14 |
2. Quy tắc Lan truyền Thay đổi (Change Propagation Rules)
Quy tắc lan truyền thay đổi là chỉ dẫn về cách thay đổi trong artifact hoặc nguồn canonical ảnh hưởng artifact phụ thuộc. Mục tiêu là duy trì tính nhất quán và toàn vẹn toàn bộ hệ thống tài liệu. Mọi thay đổi trong dự án Nova Foods mô phỏng cần theo quy tắc này để duy trì traceability (khả năng truy vết).
| Artifact Gốc (Triggering Artifact) | Loại Thay đổi | Artifact Bị Ảnh hưởng (Affected Artifacts) | Hành động Bắt buộc (Action Required) | Vai trò Trách nhiệm (Responsible Role) |
|---|---|---|---|---|
/00-research/00_SOURCE_MAP.md |
Cập nhật phiên bản hoặc trạng thái nguồn canonical, ví dụ Luật Bảo vệ dữ liệu cá nhân, BPMN. |
Toàn bộ artifact tham chiếu nguồn đó. | Đánh giá ảnh hưởng, cập nhật tham chiếu, xác minh lại nội dung liên quan. | Principal IT BA |
/01-curriculum/TRACEABILITY_ID_REGISTRY.md |
Thay đổi cấu trúc ID hoặc bổ sung loại ID mới. | /01-curriculum/CHAPTER_MANIFEST.md, /01-curriculum/TEMPLATE_MANIFEST.md, /04-cheatsheets/technical-cheatsheets.md, các artifact sử dụng ID. |
Cập nhật định dạng, kiểm tra nhất quán ID toàn corpus (tập hợp tài liệu). | Principal IT BA |
/01-curriculum/CANONICAL_BUSINESS_RULES.md |
Thêm, sửa, hoặc xóa quy tắc nghiệp vụ. | Yêu cầu (requirements), tiêu chí chấp nhận (acceptance criteria), kịch bản kiểm thử (test scenarios), thiết kế giải pháp (solution design) liên quan. | Đánh giá ảnh hưởng, cập nhật tài liệu phụ thuộc, yêu cầu review và phê duyệt từ Business Owner. | Principal IT BA (tạo), Business Owner (phê duyệt) |
/01-curriculum/CANONICAL_DATA_DICTIONARY.md |
Thêm, sửa, hoặc xóa định nghĩa trường dữ liệu. | Đặc tả API (API specifications), thiết kế cơ sở dữ liệu (database schemas), giao diện người dùng (UI), artifact mô tả luồng dữ liệu. | Đánh giá ảnh hưởng, cập nhật tài liệu phụ thuộc, yêu cầu review từ Solution Architect. | Principal IT BA (tạo), Solution Architect (phê duyệt) |
/01-curriculum/CHAPTER_MANIFEST.md hoặc /01-curriculum/TEMPLATE_MANIFEST.md |
Thay đổi cấu trúc chương hoặc danh mục template. | /04-cheatsheets/technical-cheatsheets.md, đặc biệt mục kiểm tra chéo, và artifact có liên kết nội bộ. |
Cập nhật liên kết chéo, kiểm tra tính toàn vẹn cấu trúc chương trình. | Principal IT BA |
ponytail: Các "Chủ sở hữu" và "Ngày Hạn chót" là giả lập cho mục đích đào tạo. Dự án thật cần tên người hoặc vai trò cụ thể và ngày được thống nhất chính thức. Nâng cấp khi có dữ liệu dự án thực.