# Test Strategy — [Tên dự án]

> **Vị trí file thật:** `AK-Docs/03.Testing/00.Strategies/Test-Strategy.md` (project-level, 1 file cho cả dự án).
> **Ai điền:** AI điền trước toàn bộ phần suy luận được (xem 3 mức dưới đây) — QA Lead / PM chỉ chốt phần chính sách.
> **Ai đọc:** workflow `create-testcase` đọc file này ở **Gate 1 Bước 0.7**. Thiếu mục `[CHỐT]` → Gate 1 dừng; thiếu mục `[AI SUY LUẬN]` → **không** dừng.
>
> **3 mức của mỗi mục:**
>
> | Mức | Ai điền | Thiếu thì sao |
> |---|---|---|
> | **[CHỐT]** | QA Lead / PM quyết. AI vẫn phải **đề xuất sẵn một giá trị** kèm lý do để QA chỉ cần trả lời "ĐỒNG Ý". | **Chặn Gate 1** — vì đây là các mục quyết định *số lượng* và *cách tách* Test Case; sai thì phải làm lại toàn bộ cấu trúc ở Gate 4. |
> | **[AI SUY LUẬN]** | **AI tự điền**, bắt buộc kèm nguồn: `<giá trị> [AI — nguồn: <file/tài liệu/quy ước>]`. Không tìm được bằng chứng → dùng giá trị mặc định ghi ngay trong mục đó và ghi `[AI — mặc định]`. | **Không chặn.** AI đi tiếp, ghi mục này vào danh sách "AI đã tự điền" để QA rà lại 1 lần duy nhất khi xác nhận strategy. |
> | **[TUỲ CHỌN]** | Để trống được; AI dùng giá trị mặc định ghi ở mục đó. | Không chặn, không cần báo. |
>
> **Quy ước điền:**
> - Không áp dụng cho dự án → ghi đúng `N/A — <lý do>` (vd `N/A — dự án chỉ chạy trên PC`). `N/A` không kèm lý do bị coi là **chưa điền**.
> - AI **không được** hỏi QA từng mục `[AI SUY LUẬN]` một. Suy luận → điền → gộp vào một bảng xác nhận duy nhất (xem workflow Bước 0.7).
> - Đổi nội dung file này sau khi đã có TestCase → tăng `Strategy-Version` ở mục 0. `create-testcase` ghi version này vào TestCase để biết TestCase cũ đang theo strategy nào.

---

## 0. Metadata

| Mục | Giá trị |
|---|---|
| **Strategy-Version** [AI SUY LUẬN] | `<v1>` — AI tăng version mỗi lần file đổi nội dung |
| **Người chốt** [AI SUY LUẬN] | `<tên QA Lead / PM đã trả lời xác nhận>` — AI điền tên người xác nhận ở Bước 0.7 |
| **Ngày chốt** [AI SUY LUẬN] | `<YYYY-MM-DD>` — ngày QA xác nhận |
| **Domain nghiệp vụ** [CHỐT] | `<vd: Blockchain / Wallet / Staking; NFT / Gacha / Marketplace; E-commerce; CMS; Internal tool>` — AI suy từ UC Spec + repo và **đề xuất sẵn**; QA xác nhận. Quyết định domain skill nào trong `08-domain-skills/` được nạp, tức là quyết định **sàn bao phủ** của cả bộ TC — điền sai thì thiếu hẳn một mảng case đặc thù, phải làm lại từ Gate 2. Một dự án có thể khớp **nhiều** domain (vd Gacha trả bằng token → `NFT-Gacha-Marketplace.md` + `Blockchain-Wallet-Staking.md`) — liệt kê đủ, không chọn một. Không khớp domain nào: ghi `Chung — không có domain skill riêng` kèm lý do |

## 1. Môi trường chạy test (Platforms)

### 1.1. PC — Trình duyệt [AI SUY LUẬN]

| Trình duyệt | Version | OS | Bắt buộc / Tham khảo |
|---|---|---|---|
| `<Chrome>` | `<latest>` | `<Windows 11 / macOS 14>` | `<Bắt buộc>` |

> Nguồn suy luận: `browserslist` / `package.json`, config Playwright–Cypress, tài liệu `00.Strategies/` có sẵn, ghi chú môi trường trong UC Spec.
> Mặc định: `Chrome latest — Bắt buộc` (thêm `Safari latest` nếu strategy có iOS ở mục 1.2).
> Không test trên PC → `N/A — <lý do>`.

### 1.2. Mobile — Thiết bị [AI SUY LUẬN]

| Nền tảng | Thiết bị / Model | OS version | Hình thức (Browser / Native app / WebView) | Trình duyệt (nếu Browser) |
|---|---|---|---|---|
| `<Android>` | `<Pixel 7 / Galaxy S23>` | `<Android 14>` | `<Browser>` | `<Chrome>` |
| `<iOS>` | `<iPhone 15>` | `<iOS 17>` | `<Browser>` | `<Safari>` |

> Nguồn suy luận: UC Spec/prototype có layout mobile không; repo có React Native / Flutter / WebView; config responsive.
> Mặc định: màn hình chỉ dùng nội bộ (Admin/CMS) → `N/A — màn hình chỉ dùng trên PC`; màn hình người dùng cuối → `Android Chrome (bản latest) + iPhone Safari (bản latest)`.

### 1.3. Responsive [AI SUY LUẬN]

| Breakpoint | Độ rộng (px) | Thiết bị đại diện |
|---|---|---|
| `<Mobile>` | `<375>` | `<iPhone 13>` |
| `<Tablet>` | `<768>` | `<iPad>` |
| `<Desktop>` | `<1440>` | `<PC>` |

> Nguồn suy luận: breakpoint thật trong repo (`tailwind.config.*`, biến SCSS, `@media` trong CSS), prototype của UC Spec.
> Mặc định: `375 / 768 / 1440`. Site không responsive → `N/A — <lý do>`.

### 1.4. Môi trường hệ thống (Server environment) [AI SUY LUẬN]

| Môi trường | URL | Phạm vi chạy (Full / Rút gọn theo priority) | Ghi chú (mock / testnet / mainnet ...) |
|---|---|---|---|
| `<Dev>` | `<https://dev...>` | `<Rút gọn: Critical + High>` | |
| `<Staging>` | `<https://stg...>` | `<Full>` | |

> Nguồn suy luận: `.env*`, `README`, config CI/CD, tài liệu môi trường trong `AK-Docs/`.
> Mặc định (không cần hỏi): **Staging = Full**, **Dev = Rút gọn: Critical + High**, Production = `N/A — không chạy test case trên môi trường thật`. URL không tìm thấy → `<chưa xác định>`, không chặn.

## 2. Ngôn ngữ (Localization)

| Mục | Giá trị |
|---|---|
| **Danh sách ngôn ngữ** [AI SUY LUẬN] | `<JP, EN>` — suy từ file i18n trong repo (`locales/`, `messages/`, `*.po`, `i18n/*.json`) hoặc text trong UC Spec. Mặc định: đúng 1 ngôn ngữ = ngôn ngữ đang dùng trong UC Spec |
| **Ngôn ngữ chính** [AI SUY LUẬN] | `<JP>` — mặc định: ngôn ngữ của UC Spec / ngôn ngữ fallback trong cấu hình i18n |
| **Phạm vi lặp cho ngôn ngữ phụ** [CHỐT — chỉ khi > 1 ngôn ngữ] | `<full>` = lặp **toàn bộ** TC cho từng ngôn ngữ phụ · `<ui-text>` = chỉ lặp TC có kiểm tra text/label/message/format hiển thị/email (logic nghiệp vụ chỉ chạy trên ngôn ngữ chính). **AI đề xuất mặc định: `ui-text`** (nhân số TC ít hơn nhiều) — QA đổi sang `full` nếu logic khác nhau theo ngôn ngữ |
| **Nguồn text chuẩn từng ngôn ngữ** [TUỲ CHỌN] | `<file i18n / sheet wording>` — mặc định: text trong UC Spec / Prototype |

## 3. Chính sách tách Test Case theo chiều (Dimension Policy) [CHỐT]

> Đây là phần quyết định **số lượng** Test Case, và là **mục `[CHỐT]` quan trọng nhất** của file này. AI phải đề xuất đủ bảng dưới đây kèm lý do từng dòng; QA chỉ cần trả lời "ĐỒNG Ý" hoặc sửa những dòng muốn đổi.
>
> | Chính sách | Nghĩa | Ảnh hưởng số TC |
> |---|---|---|
> | `split` | Tách **thành TC riêng** cho từng giá trị (TC ID riêng, section riêng). **Không gộp.** | Nhân số TC theo số giá trị |
> | `column` | 1 TC, nhưng có **cột kết quả riêng** cho từng giá trị (vd cột PC / Android / iPhone) | Không nhân số TC, nhân số lượt thực thi |
> | `sample` | Chạy trên 1 giá trị đại diện, ghi rõ giá trị đó | Không nhân |
> | `N/A` | Không áp dụng | — |

| Chiều | Giá trị | Chính sách | Đề xuất mặc định của AI |
|---|---|---|---|
| Ngôn ngữ | `<JP, EN>` | `<split>` | `split` nếu mục 2 là `full`; `split` chỉ cho nhóm TC hiển thị nếu là `ui-text` |
| Thiết bị / Platform | `<PC, Android, iPhone>` | `<column>` | `column` — cùng kịch bản, khác thiết bị |
| Trình duyệt PC | `<Chrome, Safari>` | `<sample: Chrome>` | `sample: Chrome` |
| Breakpoint responsive | `<375, 768, 1440>` | `<column>` | `column` |
| Biến thể nghiệp vụ (loại token / loại sản phẩm / loại thành viên ...) | `<AUBE, OWL, ETH>` | `<split>` | `split` — biến thể có logic/ràng buộc khác nhau thì không được gộp (vd ETH trả gas bằng chính nó, token ERC-20 trả gas bằng ETH). AI liệt kê biến thể tìm được trong UC Spec |
| Role / Actor | `<User thường, Admin>` | `<split>` | `split` theo danh sách Actor của UC Spec |
| Tuỳ chọn luồng (vd bật/tắt OTP) | `<OTP on, OTP off>` | `<split>` | `split` cho mỗi điểm rẽ nhánh có logic riêng sau đó |

> Chiều nào dự án không có → giữ dòng, ghi `N/A — <lý do>`. Thêm dòng nếu dự án có chiều khác.

## 4. Loại test & độ sâu xác minh (Test Types & Verification Depth)

| Mục | Giá trị |
|---|---|
| **Loại test trong scope** [AI SUY LUẬN] | `<Manual UI, API, DB verify, Automation E2E>` — suy từ repo (có test E2E sẵn? có tầng API?). Mặc định: `Manual UI` + `API` nếu UC có gọi API |
| **Xác minh DB** [AI SUY LUẬN] | Mặc định: `Chỉ Critical` (TC ghi dữ liệu, mức Critical thì kiểm DB) |
| **Xác minh API response** [AI SUY LUẬN] | Mặc định: `Có` nếu repo/UC có API công khai cho màn hình này, ngược lại `Không` |
| **Tiêu chí PASS cho giao dịch bất đồng bộ** [CHỐT — chỉ khi có xử lý async / blockchain / webhook] | `<vd: Success 4 lớp = DB + API + tx_hash on-chain + UI>` — AI đề xuất theo domain skill tương ứng, QA xác nhận |
| **Test bằng cách gọi API trực tiếp (tamper / bỏ qua FE)** [AI SUY LUẬN] | Mặc định: `Có — bắt buộc cho mọi validation server-side`, `Không` nếu không có API |
| **Non-functional** [TUỲ CHỌN] | `<Performance / Security / Accessibility (WCAG level)>` — mặc định: chỉ accessibility cơ bản (bàn phím, label) |

## 5. Dữ liệu & tài khoản test

| Mục | Giá trị |
|---|---|
| **Tài khoản test theo role / platform** [AI SUY LUẬN] | `<link sheet / vault — KHÔNG ghi password thật vào file này>`. Mặc định khi chưa có: `Chưa có nguồn tài khoản — TC ghi theo vai trò (vd "tài khoản User thường"), QA cấp tài khoản thật khi thực thi` |
| **Cách chuẩn bị dữ liệu** [AI SUY LUẬN] | Suy từ repo: có script seed/fixture/factory → `seed DB`; có màn Admin tạo được dữ liệu → `qua Admin`; có API tạo dữ liệu → `qua API`; blockchain testnet có faucet → `faucet testnet`. Mặc định khi không có bằng chứng: `qua giao diện (tạo dữ liệu bằng chính luồng nghiệp vụ)` |
| **Giả lập dịch vụ ngoài** [TUỲ CHỌN] | `<mock blockchain-service, mailbox test (Mailpit) ...>` — suy từ `docker-compose*`, config môi trường |

## 6. Ưu tiên & quy ước ghi Test Case

| Mục | Giá trị |
|---|---|
| **Định nghĩa Priority/Severity** [TUỲ CHỌN] | mặc định: theo `qa-writing-standards.md` mục 2 |
| **Ngôn ngữ viết Test Case** [AI SUY LUẬN] | `<Tiếng Việt, giữ nguyên tên màn hình/nút tiếng Nhật>` — mặc định: ngôn ngữ đang dùng trong các tài liệu `AK-Docs/` của dự án, giữ nguyên tên UI theo ngôn ngữ sản phẩm |
| **Định dạng bàn giao** [TUỲ CHỌN] | `<Markdown / Excel theo sheet テストケース>` — mặc định Markdown |
| **Nguồn regression bắt buộc đọc** [TUỲ CHỌN] | `<link danh sách bug / ticket đã fix của phase trước>` — AI sinh TC regression cho từng bug trong danh sách |

## 7. Out-of-scope toàn dự án [TUỲ CHỌN]

- `<vd: Không test IE, không test tablet landscape>`
