# TEMPLATE BRIEF CHUNG GATE 3 (`create-testcase`)

Agent chính điền template này **một lần** ở đầu Gate 3, lưu thành file tạm, rồi giao cho từng agent `tc-writer` cùng phần scenario của section đó. Mọi agent dùng cùng một brief để câu chữ, Pre-condition và TC ID đồng nhất — không agent nào tự soạn quy ước riêng.

Lưu tạm: `AK-Docs/03.Testing/01.Testcases/[functionId]/_parts/gate3-brief.md` (thư mục `_parts/` bị xoá sau khi `ak tc build` thành công).

---

```markdown
# Gate 3 Brief — [functionId]

## 1. Nguồn bắt buộc đọc

- UC Spec: `AK-Docs/02.BA-Specs/04.UC-Specs/[functionId]/UC-Spec_v[N].md` — lấy message, nhãn, giá trị **nguyên văn**
- System Requirement: `AK-Docs/02.BA-Specs/00.Requirements/[functionId]/System-Requirement_v[N].md` — `VR-*`, `ER-*`, `AT-*`
- Test Plan: `AK-Docs/03.Testing/01.Testcases/[functionId]/[functionId]_Test Plan.md` — **chỉ** Phần 1.5 (Test Strategy áp dụng), 1.6 (Risk) và các dòng scenario được giao bên dưới
- QnA Log: `AK-Docs/03.Testing/01.Testcases/[functionId]/[functionId]_QnA Log.md` — bảng "Quyết định đã chốt"
- Template + quy tắc: `testcase-template.md`, `qa-writing-standards.md` mục 6, `custom/rules/document-wording.md`, `custom/rules/domain-terminology.md`, `custom/rules/ui-action-wording.md`
- Domain skill: [tên file, hoặc "không có"]

## 2. Thuật ngữ (trích Glossary)

| Từ dự án | Viết trong tài liệu |
|---|---|
| [グループ] | [`group`] |

## 3. Câu Pre-condition chuẩn theo role

Dùng đúng câu này khi TC cần trạng thái tương ứng. Mỗi TC **vẫn viết Pre-condition đầy đủ** trong ô của nó — không ghi mã, không ghi "như trên", không tham chiếu TC khác.

| Role / trạng thái | Câu Pre-condition chuẩn |
|---|---|
| [System Admin, Supplier site] | [System Admin có đủ 4 quyền `group` đã login Supplier site.] |

## 4. Quy ước TC ID

- Format: `TC-<FEATURE>-<SEQ>`; có chiều `split`: `TC-<FEATURE>-<VARIANT>-<LANG>-<SEQ>`
- `<FEATURE>` = [GRP]

## 5. Phân công

| Agent | Section | Scenario ID được giao | Dải TC ID | File part |
|---|---|---|---|---|
| tc-writer #1 | 3.1 Access & Authorization | [TS_06_001…TS_06_012] | `TC-GRP-100..TC-GRP-199` | `_parts/03_part-3.1.md` |
| tc-writer #2 | 3.3 Input Validation | [TS_06_040…TS_06_095] | `TC-GRP-300..TC-GRP-399` | `_parts/03_part-3.3.md` |

Dải ID đủ rộng cho số TC dự kiến của section (Test Plan Phần 2.2) cộng dư 30%.

## 6. Quy tắc file part

- Dòng đầu: `<!-- ak-part: section=<số section> range=<ID đầu>..<ID cuối> -->`
- Sau đó: tiêu đề section (`### 3.x. ...`, sub-table `#### * ...` nếu có) và bảng TC đúng cột của template (thêm cột kết quả theo chiều `column` nếu có)
- Chỉ dùng TC ID trong dải được giao. Không sửa file part khác, không sửa `TestCase.md`
- Chạy `ak tc lint "<file part>"` tới khi 0 `error`
- Gặp điểm chưa rõ không có trong QnA Log → ghi `[PENDING - TQ-xx]` nếu đã có câu hỏi, hoặc báo lại agent chính; không tự đặt câu hỏi mới với QA
```
