# Skill: Template Phân Tích Ban Đầu - Phiên bản v1

Mẫu tài liệu này được sử dụng để trình bày kết quả phân tích yêu cầu ban đầu sau khi bóc tách từ tài liệu thô.

> ⚠️ **Thuật ngữ bắt buộc:** `custom/rules/domain-terminology.md` + `AK-Docs/00.Project-Overview/Glossary.md`. Từ dùng ở đây là từ mà QnA-Log, UC Spec, System Requirement sẽ dùng lại — chọn đúng từ Glossary ngay từ bản này.
>
> ⚠️ **Động từ thao tác UI & thuật ngữ IT:** `custom/rules/ui-action-wording.md` — `Click button`, `Click menu item`, `Enter <value> into <field>`, `Select`, `Check`, trạng thái `Displayed` / `Enabled` / `Disabled`; thuật ngữ IT giữ tiếng Anh (field, toast, modal, server, cache, redirect…); không viết "bấm", "nhấn", "tích chọn", "chọn tay".

---

# Tài liệu Phân Tích Yêu Cầu Ban Đầu: [Tên Chức Năng]

## 1. Mục tiêu chức năng
*Mô tả ngắn gọn chức năng này dùng để làm gì? Giải quyết nhu cầu gì của doanh nghiệp hoặc người dùng?*

## 2. Các tác nhân chính (Actors)
*Liệt kê danh sách các tác nhân (User, Admin, Manager...) sẽ tương tác trực tiếp hoặc gián tiếp với chức năng.*

## 3. Yêu cầu chức năng chi tiết (Functional Requirements)
*Bóc tách chi tiết các tính năng nhỏ, các nút bấm, các hành động mà hệ thống phải xử lý.*
- **Giao diện/Trường thông tin:** Liệt kê các trường dữ liệu cần hiển thị hoặc nhập liệu.
- **Quy tắc nhập liệu sơ bộ:** Định dạng, bắt buộc hay không (Required/Optional).

## 4. Yêu cầu phi chức năng (Non-Functional Requirements)
*Các yêu cầu về bảo mật, hiệu suất, khả năng tương thích, hoặc giao diện UX/UI đặc thù.*

## 5. Bảng Phân Tích Khoảng Trống & Giả Định (Gap & Assumption Analysis)

*Chỉ liệt kê các Gap còn **Open** (chưa Confirmed) — Gap đã Confirmed được tích hợp thẳng vào mục 1-4 phía trên, không giữ lại ở bảng này. Cột Mức độ ảnh hưởng: 🔴 Blocking (chặn gate tiếp theo) / 🟡 Non-blocking (được phép defer, có marker `[PENDING - QA-ID]`).*

| # | Tính năng/Luồng nghiệp vụ | Hiện trạng mô tả thô | Khoảng trống (Gap) / Sự mơ hồ phát hiện | Giả định của BA (Assumption) | Mức độ ảnh hưởng | Đề xuất giải pháp / Q&A ID tương ứng |
| :-: | :--- | :--- | :--- | :--- | :-: | :--- |
| 1 | *Ví dụ: Nhập Password* | *Mật khẩu được che giấu* | *Có nút show/hide mật khẩu hay không? Đăng nhập sai bao nhiêu lần thì khóa?* | *Chưa có giả định — cần khách hàng xác nhận số lần khóa vì ảnh hưởng luồng chính* | 🔴 Blocking | *Xem [PENDING - QA-01]* |
| 2 | *Ví dụ: Thông báo lỗi* | *Không nêu rõ text lỗi* | *Text thông báo lỗi cụ thể là gì?* | *Tạm dùng text mặc định, có thể đổi sau* | 🟡 Non-blocking | *Xem [PENDING - QA-02]* |

*Lưu ý: Bảng này là cơ sở quan trọng nhất để tạo ra danh sách câu hỏi Q&A chuẩn xác cho khách hàng. Số dòng phải phản ánh đúng số Gap thực tế tìm được — không rút gọn cho "gọn tài liệu" nếu vẫn còn Gap chưa được hỏi.*

## 6. Yêu cầu và Acceptance Criteria (REQ / AC)

*Mỗi yêu cầu có mã `REQ-xxx` cố định qua các version, mỗi REQ có ít nhất một tiêu chí nghiệm thu `AC-xxx` dạng Given/When/Then với số liệu cụ thể (KIT-22, KIT-23). Mã này được UC Spec, System Requirement, story và test case dùng lại để truy vết — không đánh số lại khi cập nhật: mục giữ nguyên hoặc sửa thì giữ mã, mục mới lấy số tiếp theo, mục bỏ thì không dùng lại mã. Câu còn Open thì tiêu chí liên quan ghi marker `[PENDING - QA-ID]`.*

- **REQ-001**: *[Một việc hệ thống phải làm — đo được, không dùng từ mơ hồ như "phù hợp", "nhanh"]*
- **REQ-002**: ...

- **AC-001** (REQ-001): Given *[trạng thái ban đầu]* When *[thao tác theo `custom/rules/ui-action-wording.md`]* Then *[kết quả quan sát được, có số liệu]*
- **AC-002** (REQ-001, REQ-002): Given ... When ... Then ...

*Yêu cầu sửa chức năng đã có (Mode UPDATE): thêm bảng thay đổi so với bản đã ký.*

| Mã | Thay đổi | Ghi chú |
| :--- | :--- | :--- |
| REQ-002 | modified | *[sửa gì, theo câu trả lời / ticket nào]* |
| AC-004 | added | ... |

