# HƯỚNG DẪN VÀ TEMPLATE REVIEW RESULT (MD FORMAT)

Template cho file `[functionId]_Review Result.md` — kết quả Gate 4 của workflow `create-testcase`. Thay cho `04_Test_Cases_Final_Result.md` và `04_Test_Review_QA.md`.

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

> ⚠️ **Không chép Test Case vào file này.** Bộ TC chỉ nằm ở `[functionId]_TestCase.md`. Gate 4 sửa TC bằng Edit trực tiếp trên `TestCase.md`; file này chỉ ghi Findings và dẫn TC ID.
>
> ⚠️ **Câu hỏi không nằm ở đây.** Issue cần người khác trả lời → ghi vào `[functionId]_QnA Log.md` (mã `TQ-xx`), Findings dẫn mã đó.
>
> ⚠️ Hành văn theo `custom/rules/document-wording.md`. Tự kiểm: `ak tc lint --doc "<file Review Result>.md"`.

---

```markdown
# [functionId] - Review Result

## 1. Review Summary

| Mục | Giá trị |
|:---|:---|
| **TestCase** | `[functionId]_TestCase.md` |
| **Người review (Reviewer)** | [AI + tên QA] |
| **Ngày review** | [YYYY-MM-DD] |
| **Số TC trước review** | [498] |
| **Số TC xoá** | [6] (trùng: 4, out-of-scope: 2) |
| **Số TC thêm** | [3] |
| **Số TC sau review** | [495] = 498 − 6 + 3 |
| **`ak tc lint`** | [0 error / 2 warn — lý do ở mục 2] |

> Số TC sau review phải bằng `trước − xoá + thêm` và khớp số TC thực tế trong `TestCase.md`.

## 2. Findings

Mỗi section của `TestCase.md` có **một dòng kết quả**, kể cả section không có finding.

| Section | Kết quả |
|---|---|
| 3.1 Access & Authorization | [0 finding] |
| 3.2 UI/UX | [2 finding: F-01, F-02] |
| 3.3 Input Validation | [1 finding: F-03] |
| 3.4 Business Rules | [0 finding] |
| 3.5 Exceptions & Systems | [1 finding: F-04] |

| Finding ID | Section | TC ID | Severity | Vấn đề | Xử lý |
|---|---|---|---|---|---|
| F-01 | 3.2 | TC-GRP-104 | Minor | [Expected Result không đo được: "hiển thị đúng"] | [Đã Edit Expected Result] |
| F-02 | 3.2 | TC-GRP-110, TC-GRP-111 | Minor | [Hai TC kiểm cùng một điều] | [Xoá TC-GRP-111] |
| F-03 | 3.3 | TC-GRP-305 | Major | [Thiếu message lỗi nguyên văn] | [Chờ TQ-07 — `[PENDING - TQ-07]`] |

`warn` của `ak tc lint` chưa sửa: ghi từng dòng kèm lý do.

## 3. Coverage Validation

| Kiểm tra | Kết quả |
|---|---|
| Mọi Req ID có TC | [✅ / ❌ thiếu BR-07 → F-05] |
| Coverage Matrix (Test Plan Phần 3) khớp `TestCase.md` | [✅ `ak tc build --plan` không báo lỗi] |
| Mỗi tổ hợp chiều `split` có đủ khối TC | [✅] |
| Mỗi chiều `column` có đủ cột kết quả | [✅] |
| Coverage floor domain skill | [✅ 100% / N/A có lý do] |
| Ma trận Error × Điểm submit | [✅ mọi ô khả thi có TC] |
| Đối chiếu số lượng (lệch > 10% có giải thích) | [✅] |
| Mode UPDATE — tổ hợp BR mới × BR cũ | [✅ đã rà / không áp dụng] |
| Mục AI tự điền ở Test Strategy | [không đổi / đã sửa `Test-Strategy.md` v3 → v4] |

## 4. RTM Final

| Req ID | Scenario ID | TC ID |
|---|---|---|
| [BR-01] | [TS_06_001] | [TC-GRP-001, TC-GRP-002] |

## 5. Dev Checklist

[Số dòng FE / BE; Mode UPDATE: số dòng thêm / xoá / sửa. Vùng thiếu TC đại diện → ghi là lỗ hổng của bộ TC, không bịa dòng checklist.]

## 6. Sign-off

| Status | Điều kiện |
|---|---|
| ✅ **Fully Approved** | 0 Critical / 0 Major / 0 Minor còn mở, 0 `[PENDING - TQ-xx]` |
| ✅ **Conditionally Approved** | 0 Critical / 0 Major, còn Minor hoặc `[PENDING - TQ-xx]` — được phép thực thi trừ TC còn PENDING |
| ⚠️ **Need Update** | Còn Major chưa giải quyết |
| ❌ **Rejected** | Còn Critical, coverage < 100%, hoặc vi phạm template |

**Kết quả:** [✅ Conditionally Approved — còn TQ-07 (TC-GRP-305)]
```
