# HƯỚNG DẪN VÀ TEMPLATE TEST PLAN (MD FORMAT)

Template cho file `[functionId]_Test Plan.md` của workflow `create-testcase`. Một file duy nhất, ghi dần qua 3 gate:

| Phần | Gate ghi | Thay cho file cũ |
|---|---|---|
| Thông tin chung + Phần 1 — Phân tích | Gate 1 | `01_Requirement_Analysis_Result.md` |
| Phần 2 — Scenario | Gate 2 | `02_Test_Scenarios_Result.md` |
| Phần 3 — Coverage | Gate 3 | Phần ngoài bảng TC của `03_Test_Cases_Draft_Result.md` |

Lưu: `AK-Docs/03.Testing/01.Testcases/[functionId]/[functionId]_Test Plan.md`

> ⚠️ **Không chép lại UC Spec / System Requirement.** Main Flow, Alternative Flow, Business Rules, Validations, State, API đã có trong tài liệu đã Approved — Test Plan chỉ dẫn ID gốc (`BR-xx`, `VR-xx`, `FR-xx`, `ER-xx`, `AT-xx`). Gate 3 đọc thẳng UC Spec / System Requirement để lấy message và giá trị nguyên văn.
>
> ⚠️ **Câu hỏi không nằm ở đây.** Mọi câu hỏi, câu trả lời, quyết định ghi vào `[functionId]_QnA Log.md`. Chỗ nào còn chờ câu trả lời thì đặt marker `[PENDING - TQ-xx]`.
>
> ⚠️ **Hành văn:** `custom/rules/document-wording.md` (mục 3 — kết luận lấy từ code viết thành câu nghiệp vụ + dòng/cột `Source code:`), thuật ngữ theo `custom/rules/domain-terminology.md` + `AK-Docs/00.Project-Overview/Glossary.md`, động từ UI theo `custom/rules/ui-action-wording.md`. Tự kiểm: `ak tc lint --doc "<file Test Plan>.md"`.
>
> ⚠️ **Tên mục cố định.** `ak tc build --plan` đọc bảng `Thông tin chung`, bảng scenario ở `Phần 2` và bảng `Coverage Matrix` ở `Phần 3` theo đúng tên cột bên dưới. Không đổi tên cột.

---

```markdown
# [functionId] - Test Plan

## Thông tin chung

| Mục | Chi tiết |
|:---|:---|
| **functionId** | [vd AD06] |
| **Mã màn hình - Tên màn hình** | [vd AD06_Quản lý group] |
| **UC-Spec-Version** | [vd v3, hoặc "—" nếu không có UC Spec] |
| **System-Requirement-Version** | [vd v3, hoặc "—" nếu không có System Requirement] |
| **Test-Strategy-Version** | [vd v2] |
| **Mode** | [CREATE / UPDATE (từ TestCase UC-Spec v2)] |
| **Người tạo (Author)** | [tên QA] |
| **Ngày tạo (Created Date)** | [YYYY-MM-DD] |

---

## Phần 1 — Phân tích (Gate 1)

### 1.1. Phạm vi kiểm thử

| | Nội dung | Nguồn |
|---|---|---|
| **In-Scope** | [màn hình / chức năng / luồng được test] | [UC Spec mục ..., FR-xx] |
| **Out-of-Scope** | [phần không test, kèm lý do] | [UC Spec / quyết định TQ-xx] |

### 1.2. Actor & quyền

| Actor | Quyền liên quan tới chức năng này | Nguồn |
|---|---|---|
| [System Admin] | [xem, tạo, sửa, xoá `group`] | [BR-03] |

### 1.3. Biến thể nghiệp vụ

[Chỉ khi UC có biến thể: currency, loại thành viên, bật/tắt OTP... Ghi khác biệt logic giữa các biến thể, dẫn ID gốc. Không có thì ghi "Không có biến thể nghiệp vụ."]

### 1.4. Domain skill áp dụng

- [`Blockchain-Wallet-Staking.md` — lý do: UC nhắc ví custodial, gas]
- [hoặc "Không có domain skill phù hợp"]

### 1.5. Test Strategy áp dụng

[Tóm tắt ở Gate 1 Bước 0.7 bước 5: Strategy-Version, chiều `split` / `column` / `sample`, danh sách mục AI tự điền kèm nguồn. Gate 2/3/4 đọc lại từ đây, không đọc lại `Test-Strategy.md`.]

### 1.6. Risk Matrix

| Risk ID | Rủi ro / điểm dễ lỗi | Loại (kỹ thuật / dữ liệu / nghiệp vụ / hệ thống) | Mức độ | Nguồn | Hướng test |
|---|---|---|---|---|---|
| R-01 | [Mô tả rủi ro bằng câu nghiệp vụ] | [nghiệp vụ] | [High] | [BR-05, Source code: ...] | [Test cả FE và BE] |

[Có "Nguồn regression bắt buộc đọc" trong strategy → mỗi bug/ticket regression là một dòng Risk.]

### 1.7. Giả định & giới hạn

- [Cảnh báo ở Bước 0.6 (thiếu UC Spec / System Requirement, lệch version, chưa Approved)]
- [Giả định AI dùng khi chưa có câu trả lời — dẫn `[PENDING - TQ-xx]` nếu đang chờ]

---

## Phần 2 — Scenario (Gate 2)

### 2.1. Danh sách scenario

| Scenario ID | Feature/Module | Check List | Scenario Type | Target Req ID | Priority | Test Data | Chiều split áp dụng | Nguồn |
|---|---|---|---|---|---|---|---|---|
| TS_06_001 | [Màn hình danh sách `group`] | [Kiểm tra hiển thị danh sách khi chưa có `group` nào] | [Happy Path] | [BR-01] | [High] | [0 `group`] | [Tất cả] | [mới ở v1] |

- `Scenario ID`: `TS_<SCREEN_NUMBER>_<SEQ>`.
- `Chiều split áp dụng`: `Tất cả` · `Chỉ <giá trị>` · `Ngôn ngữ: chỉ chính`.
- `Nguồn` (Mode UPDATE): `carry-forward v{N_prev}` / `mới ở v{N}`. Mode CREATE ghi `mới ở v{N}`.

### 2.2. Dự kiến số lượng TC

| Nhóm scenario | Số scenario | Hệ số nhân (chiều split) | TC dự kiến |
|---|---|---|---|
| [Áp dụng mọi biến thể] | [120] | [Biến thể × 3] | [360] |
| **Tổng** | | | **[515]** |

### 2.3. Business Flow Mapping

[Sơ đồ E2E dạng text.]

### 2.4. Draft RTM

| Req ID | Scenario ID |
|---|---|
| [BR-01] | [TS_06_001, TS_06_002] |

---

## Phần 3 — Coverage (Gate 3)

### 3.1. Coverage Matrix

| Scenario ID | TC ID |
|---|---|
| TS_06_001 | TC-GRP-001, TC-GRP-002 |
| TS_06_014 | N/A — <lý do cụ thể> |

- Mỗi scenario ở Phần 2 có đúng một dòng. Cột `TC ID` liệt kê mọi TC (kể cả TC nhân bản theo chiều `split`), cách nhau bằng dấu phẩy.
- `ak tc build --plan` báo lỗi khi scenario không có dòng, ô `TC ID` trống, hoặc TC ID không có trong `TestCase.md`.

### 3.2. Coverage floor domain skill

| Viewpoint ID | TC ID |
|---|---|
| [D-03] | [TC-TRANSFER-ETH-JP-041 / N/A — <lý do>] |

### 3.3. Ma trận Error × Điểm submit

| Error code / message | [Validate FE] | [Submit bước Confirm] | [Submit bước Verify OTP] | [Gọi API trực tiếp] |
|---|---|---|---|---|
| [ER-04 Thiếu phí gas] | [TC-...] | [TC-...] | [Không khả thi — <lý do>] | [TC-...] |

### 3.4. Đối chiếu số lượng

| | Số TC |
|---|---|
| Dự kiến (Phần 2.2) | [515] |
| Thực tế (`ak tc build`) | [498] |
| Chênh lệch | [-3.3%] — [giải thích khi lệch > 10%] |

### 3.5. Test Data tổng hợp

| Dữ liệu | Giá trị / cách chuẩn bị | Dùng ở TC |
|---|---|---|
| [Tài khoản System Admin đủ 4 quyền `group`] | [Tạo qua màn hình quản lý tài khoản] | [TC-GRP-001…] |
```
