@relipa/ai-flow-kit 0.1.2-beta.0 → 0.1.3

package/custom/skills/generate-testcase/SKILL.md

@@ -0,0 +1,303 @@
+---
+name: generate-testcase
+description: Use when TESTER needs to create test checklist or test cases from requirements. Follows 5-step process across Gate 2 Phase 2a (Dev Artifacts Check + scenarios/checklist), 2b (generate testcase + test-plan.md), 2c (review & optimize with action list). TESTER must approve each phase before AI proceeds.
+keywords: testcase, checklist, qa, testing, test plan, scenarios, validation, boundary value, equivalence partitioning
+---
+
+# Generate Testcase — Gate 2 (Phase 2a → 2c)
+
+> **Phạm vi:** Gate 2 Phase 2a → 2b → 2c trong workflow 4-gate (`docs/workflow.md`)
+> **TESTER phải gõ `APPROVED` sau mỗi bước — AI KHÔNG tự động chuyển bước.**
+
+---
+
+## Quy trình 5 bước (theo thứ tự, không bỏ qua)
+
+### Bước 1 — Phân tích Requirement
+
+Trước khi tạo bất kỳ testcase nào:
+- Đọc `test-plan/test-analysis.md` (Gate 1 output đã approved)
+- Xác định: scope, field types, business rules, validations, roles
+- Nếu requirement chưa rõ → hỏi TESTER từng câu một, chờ trả lời
+- **KHÔNG tạo testcase ở bước này**
+
+---
+
+### Bước 2 — Dev Artifacts Check (Phase 2a — trước checklist)
+
+Xác định phạm vi ảnh hưởng thật từ code dev **trước khi** generate scenarios:
+
+- **Nếu TESTER khai báo `PR: <url>`** hoặc AI phát hiện PR link trên ticket → **invoke `pr-impact-analysis` skill**:
+  - Fetch PR diff qua `gh pr view`, phân tích theo layer, map code → regression scope
+  - Lưu kết quả vào `test-plan/impact-analysis.md`
+  - Lấy danh sách regression scenarios để bổ sung vào checklist Bước 3
+- **Nếu chưa có PR** → tạo `test-plan/impact-analysis.md` với nội dung "chưa có dev artifacts — sẽ re-check ở Gate 3", **không block bước**
+- **Nếu không có PR nào và ticket không đề cập** → bỏ qua, đi thẳng Bước 3
+
+> ⚠️ PR diff chỉ dùng để **mở rộng coverage** (thêm regression TCs). Tuyệt đối không dùng để xác định expected result — expected result chỉ lấy từ ticket/spec của BA/PM.
+
+---
+
+### Bước 3 — Generate Checklist (Phase 2a)
+
+Liệt kê scenarios theo nhóm, output vào `test-plan/checklist.md`:
+
+| ID | Scenario/Checklist Item | Mục đích kiểm tra | Expected Result |
+
+**Nhóm cần cover:**
+
+📗 **Functional**
+- Happy Path / Positive Cases
+- Negative Cases
+- Validation Cases (input validation, format, required fields)
+- Boundary Value Analysis
+- Edge Cases
+- Equivalence Partitioning
+- Decision Table Cases
+- State Transition Cases
+- Permission / Role-based Cases
+- UI/UX Cases
+
+📘 **Non-Functional**
+- Accessibility Cases (WCAG compliance)
+- Compatibility Cases (Browser/Device/OS)
+- Localization / i18n Cases
+
+📙 **Data & Integration**
+- Data Integrity Cases
+- Concurrent Access Cases
+- Integration / API Cases
+- Error Handling / Recovery Cases
+
+📕 **Exploratory**
+- Error Guessing
+- Pairwise Testing
+
+📙 **Regression** _(nếu Dev Artifacts Check Bước 2 tìm thấy impacted areas)_
+- Mỗi item ghi rõ: "Regression — [vùng ảnh hưởng] — [lý do từ PR diff]"
+
+```
+⏸️ GATE 2 — PHASE 2a: SCENARIOS READY
+Scenarios: [N] total
+- Functional: [N] | Non-functional: [N] | Integration: [N] | Exploratory: [N] | Regression: [N]
+→ Review: test-plan/checklist.md
+→ Type APPROVED to proceed to Phase 2b
+```
+
+---
+
+### Bước 4 — Generate Testcase + Test Plan (Phase 2b)
+
+> ⚠️ CHỈ TẠO — KHÔNG REVIEW. Review ở Bước 5.
+
+**Dùng template:** `templates/testcase.md` — giữ nguyên toàn bộ cột và cấu trúc sections.
+
+**Quy tắc TC_ID:** `[ScreenID]_[3 chữ số]`
+- `ScreenID` là **mã màn hình/chức năng theo quy ước của từng dự án** — không cố định. Ví dụ: `AD10_001`, `LOGIN_001`, `ORD_002`, `USR_015`
+- Nếu dự án chưa có convention → hỏi TESTER trước khi tạo TC đầu tiên
+- Nếu đã có TC cũ trong dự án → đọc các file `test-plan/test-cases/` hiện tại để suy ra convention đang dùng
+
+**Nhóm testcase theo sections:**
+- **3.1 Access & Authorization** — URL trực tiếp, menu, phân quyền theo role
+- **3.2 UI/UX** — Layout, placeholder, label, dấu *, responsive
+- **3.3 Input Validation** — Theo từng field type (xem Validation Rules bên dưới)
+- **3.4 Business Rules** — Logic nghiệp vụ, unique, dynamic form, save to DB
+- **3.5 Exceptions & Systems** — Double click, mất mạng, back button
+
+**Yêu cầu từng cột:**
+- **Steps:** Đánh số `1. 2. 3.` — rõ ràng, execute được ngay
+- **Expected Result:** Cụ thể, verify được — ví dụ: `"Hiển thị thông báo 'Lưu thành công' và chuyển về trang danh sách"`
+- **Severity:** Critical / High / Medium / Low
+- Mỗi testcase độc lập, có thể execute riêng lẻ
+
+Output testcases: `test-plan/test-cases/[ScreenID]-testcases.md`
+
+**Tạo thêm `test-plan/test-plan.md`** — kế hoạch tổng thể:
+
+```markdown
+# Test Plan — [Feature Name]
+
+**Ticket:** [ID] | **Date:** [YYYY-MM-DD] | **Tester:** [Name]
+
+## 1. Objectives
+[Mục tiêu của đợt testing này — 1-2 câu]
+
+## 2. Scope
+- **In-scope:** [danh sách module/màn hình từ test-analysis.md Section 1]
+- **Out-of-scope:** [từ test-analysis.md Section 9]
+
+## 3. Test Types
+| Type | Số lượng | Ghi chú |
+|------|---------|---------|
+| Functional (positive) | [N] | |
+| Functional (negative) | [N] | |
+| Edge cases | [N] | |
+| Regression | [N] | từ Dev Artifacts Check |
+| Accessibility / Compatibility | [N] | |
+
+## 4. Entry Criteria
+- [ ] Gate 1 APPROVED — test-analysis.md
+- [ ] Test environment sẵn sàng (app running tại BASE_URL)
+- [ ] Test data đã chuẩn bị
+
+## 5. Exit Criteria
+- [ ] 100% TCs executed
+- [ ] 0 Critical bugs unresolved
+- [ ] 0 High bugs unresolved (hoặc có deferred plan rõ ràng)
+- [ ] Test report ký duyệt (Gate 4 APPROVED)
+
+## 6. Schedule Estimate
+| Phase | Effort |
+|-------|--------|
+| Gate 2 (Planning) | [S/M/L] |
+| Gate 3 (Execution) | [S/M/L] |
+| Gate 4 (Report) | S |
+| **Total** | **[S/M/L/XL]** |
+```
+
+```
+⏸️ GATE 2 — PHASE 2b: TESTCASES GENERATED
+Test cases: [N] total ([N] positive / [N] negative / [N] edge)
+Test plan:  test-plan/test-plan.md
+→ Review: test-plan/test-cases/
+→ Type APPROVED to proceed to Phase 2c (Review & Optimize)
+→ Or provide feedback to update
+```
+
+---
+
+### Bước 5 — Review & Optimize (Phase 2c)
+
+> ⚠️ CHỈ REVIEW — KHÔNG tạo lại toàn bộ.
+
+Kiểm tra theo thứ tự, output vào `test-plan/review-report.md`:
+
+```
+1. ❌ DUPLICATE TESTCASE
+   | TC_ID | TC trùng với | Đề xuất |
+
+2. ⚠️ TESTCASE CÓ VẤN ĐỀ
+   | TC_ID | Vấn đề | Đề xuất sửa |
+   (Scenario mơ hồ / Steps không cụ thể / Expected Result không verify được / thiếu Precondition)
+
+3. 🔧 TESTCASE CẦN OPTIMIZE
+   | TC_ID | Vấn đề | Đề xuất |
+   (Quá dài → tách / có thể gộp / thiếu test data)
+
+4. ➕ MISSING TESTCASE
+   (Case chưa cover → đề xuất TC mới đầy đủ với TC_ID, Scenario, Steps, Expected Result)
+
+5. 📊 COVERAGE GAPS
+   (Vùng/feature chưa phủ đủ, business rules còn thiếu, edge cases bị miss)
+
+6. ♿ ACCESSIBILITY / COMPATIBILITY CHECK
+   (Đã đủ chưa? Đề xuất bổ sung nếu thiếu)
+
+7. 📋 DANH SÁCH CẦN SỬA
+   Tổng hợp TẤT CẢ action items từ sections 1–6, sắp xếp theo Priority:
+
+   | TC_ID | Vấn đề | Đề xuất sửa | Priority |
+   |-------|--------|------------|---------|
+   | AD10_003 | Duplicate với AD10_001 | Xóa AD10_003 | High |
+   | AD10_007 | Expected Result mơ hồ | Sửa thành "Hiển thị error 'Email không hợp lệ'" | High |
+   | AD10_012 | Thiếu TC keyboard navigation | Thêm TC mới AD10_015 | Medium |
+   | AD10_005 | Steps quá dài, 2 luồng | Tách thành AD10_005 và AD10_016 | Low |
+
+   Priority: High (phải fix trước Phase 2d) / Medium / Low (có thể defer)
+```
+
+```
+⏸️ GATE 2 — PHASE 2c: REVIEW COMPLETE
+Issues: [N] duplicate | [N] problematic | [N] to optimize | [N] missing
+→ Review: test-plan/review-report.md
+→ Type APPROVED to proceed to Phase 2d (Coverage Check & Final Output)
+→ Or provide specific fixes to apply
+```
+
+---
+
+## Validation Rules — 14 Field Types
+
+### 1. String Field (textbox, textarea)
+- **Required:** empty → error; non-empty → accepted
+- **Length:** 0, 1, max-1, max, max+1
+- **Format** (nếu có rule): invalid format, valid format
+- **Special chars:** ký tự đặc biệt (%&# ...), leading/trailing spaces, toàn khoảng trắng
+- **Case sensitivity:** lowercase, uppercase, mixed
+
+### 2. Number Field
+- **Required:** empty
+- **Datatype:** số hợp lệ, chữ cái (abc), ký tự đặc biệt (@#$), số âm, 0, thập phân
+- **Range:** value < min → error; = min; between; = max; > max → error
+- **Boundary:** min-1, max+1
+- **Format:** leading zero (00123), overflow int
+
+### 3. Radio Button
+- **Required:** không chọn → error; chọn 1 → accepted
+- **Behavior:** mutually exclusive, chuyển đổi option
+- **Boundary:** test từng option
+- **Default:** verify nếu có default
+
+### 4. Checkbox
+- **Required** (nếu có): 0 checked → error; ≥1 → accepted
+- **Behavior:** chọn nhiều, bỏ chọn từng cái, check all, uncheck all
+- **Max selection** (nếu có): = max; > max → error
+- **Default:** verify
+
+### 5. Dropdown
+- **Required:** không chọn → error; chọn hợp lệ → accepted
+- **Selection:** từng option, thay đổi selection
+- **Boundary:** option đầu, option cuối, scroll list dài
+- **Data integrity:** label vs value, disabled option
+
+### 6. Date Picker
+- **Required, Format sai** (32/13/2025) → error
+- **Range:** ngày < min → error; = min; trong range; = max; > max → error
+- **Boundary:** ngày cuối tháng (28,29,30,31), 29/02 năm nhuận
+- **Input:** nhập tay vs chọn calendar, copy-paste
+
+### 7. File Upload
+- **Required, Type:** đúng format → accepted; sai format → error
+- **Size:** < max, = max → accepted; > max → error
+- **File name:** ký tự đặc biệt, tên dài
+- **Multiple** (nếu có): số lượng vượt giới hạn → error
+- **Drag & drop, File spoofing** (đổi đuôi .exe → .jpg, check MIME type)
+
+### 8. Password Field
+- **Required, Length:** < min → error; = min → accepted; > max → error
+- **Complexity** (theo rule): thiếu hoa / thường / số / ký tự đặc biệt → error; đủ → accepted
+- **Security:** hiển thị dạng mask, toggle show/hide
+
+### 9. Confirm Password
+- Empty → error; không khớp → error; khớp → accepted
+
+### 10. Search Field
+- Empty → show all / no result (theo spec)
+- Keyword hợp lệ → trả về đúng kết quả
+- Ký tự đặc biệt, keyword dài, không tồn tại → "No data"
+
+### 11. Textarea
+- Length: min/max boundary; rất dài (stress)
+- Multi-line input, copy-paste text dài
+
+### 12. Toggle/Switch
+- Default state (ON/OFF); toggle ON→OFF; toggle OFF→ON
+- Ảnh hưởng field khác (enable/disable)
+
+### 13. Hidden/System Field
+- Giá trị được set đúng; không bị user chỉnh sửa (inspect element)
+
+### 14. Auto-complete
+- Nhập ký tự → hiển thị suggestion; không match → không hiển thị
+- Chọn từ list → đúng value; nhập tự do (nếu cho phép)
+
+---
+
+## Severity Level
+
+| Level | Mô tả |
+|---|---|
+| **Critical** | Crash app, mất data, không vào được màn hình |
+| **High** | Chức năng chính không hoạt động đúng |
+| **Medium** | Chức năng phụ bị ảnh hưởng, workaround có thể có |
+| **Low** | UI/UX nhỏ, cosmetic, không ảnh hưởng chức năng |

package/custom/skills/generate-testcase/templates/testcase.md

@@ -0,0 +1,88 @@
+# [Screen_ID]_[Screen_Name] - Test Cases
+
+## 1. Thông tin chung
+
+| Mục | Chi tiết |
+|:---|:---|
+| **Mã màn hình - Tên màn hình** | [VD: AD10_Create Product] |
+| **Tài liệu tham chiếu (SRS)** | [VD: [Project]_SRS_v1.0] |
+| **Người tạo (Author)** | |
+| **Ngày tạo (Created Date)** | |
+| **Người kiểm duyệt (Reviewer)** | |
+| **Ngày kiểm duyệt (Review Date)** | |
+
+## 2. Kết quả kiểm thử tổng hợp (Test Execution Summary)
+
+| Vòng kiểm thử (Round) | Đạt (Passed) | Lỗi (Failed) | Chưa test (Untest) | Chờ (Pending) | Tổng số (Total) | Tỷ lệ đạt (%) |
+|:---|:---:|:---:|:---:|:---:|:---:|:---:|
+| Round 1 | 0 | 0 | 0 | 0 | 0 | 0% |
+| Round 2 | 0 | 0 | 0 | 0 | 0 | 0% |
+
+---
+
+## 3. Danh sách Test Cases Chi Tiết
+
+### 3.1. Kiểm thử Truy cập & Phân quyền (Access & Authorization)
+
+| TC ID | Test Case Name | Severity | Pre-condition | Steps | Data Test | Expected Result | Ticket ID | Comment | R1 Result | R1 Date | R1 Tester | R2 Result | R2 Date | R2 Tester |
+|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
+| [ID]_001 | Truy cập trực tiếp qua URL khi chưa đăng nhập | High | Người dùng chưa đăng nhập hệ thống | 1. Nhập URL màn hình vào thanh địa chỉ trình duyệt.<br>2. Nhấn Enter. | URL của màn hình | Hệ thống không cho phép truy cập.<br>Tự động chuyển hướng về trang đăng nhập (Login). | | | | | | | | |
+| [ID]_002 | Truy cập trực tiếp qua URL khi đã đăng nhập | Medium | Người dùng đã đăng nhập thành công | 1. Nhập URL màn hình vào thanh địa chỉ trình duyệt.<br>2. Nhấn Enter. | URL của màn hình | Hệ thống cho phép truy cập.<br>Hiển thị đúng giao diện màn hình. | | | | | | | | |
+| [ID]_003 | Truy cập qua button/menu điều hướng | Low | Người dùng đang ở màn hình danh sách | 1. Click vào nút "Thêm mới" hoặc menu tương ứng. | - | Hệ thống mở màn hình đăng ký/thực hiện tương ứng thành công. | | | | | | | | |
+
+### 3.2. Kiểm thử Giao diện Người dùng (UI/UX)
+
+| TC ID | Test Case Name | Severity | Pre-condition | Steps | Data Test | Expected Result | Ticket ID | Comment | R1 Result | R1 Date | R1 Tester | R2 Result | R2 Date | R2 Tester |
+|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
+| [ID]_004 | Kiểm tra hiển thị giao diện tổng quan | Low | Màn hình hiển thị bình thường | 1. Quan sát giao diện màn hình.<br>2. Kiểm tra layout, màu sắc, font chữ, khoảng cách giữa các trường. | - | 1. Layout cân đối, font chữ và cỡ chữ đồng nhất.<br>2. Các trường bắt buộc nhập có dấu sao đỏ (*).<br>3. Không có lỗi chính tả.<br>4. Định dạng placeholder hiển thị chính xác theo thiết kế. | | | | | | | | |
+
+### 3.3. Kiểm thử Validation các trường nhập liệu (Input Validation)
+
+*(Tạo riêng từng bảng hoặc nhóm theo từng Field để dễ theo dõi)*
+
+#### * Đối với Trường [Tên Trường] — Text
+
+| TC ID | Test Case Name | Severity | Pre-condition | Steps | Data Test | Expected Result | Ticket ID | Comment | R1 Result | R1 Date | R1 Tester | R2 Result | R2 Date | R2 Tester |
+|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
+| [ID]_0xx | Kiểm tra giá trị mặc định | Low | Đã truy cập màn hình | 1. Quan sát trường [Tên Trường]. | - | Giá trị mặc định là trống (blank).<br>Hiển thị đúng Placeholder theo thiết kế. | | | | | | | | |
+| [ID]_0xx | Kiểm tra trường bắt buộc nhập để trống | High | Đã truy cập màn hình | 1. Để trống trường [Tên Trường].<br>2. Bấm nút thực hiện (Đăng ký/Lưu). | Empty | 1. Hiển thị thông báo lỗi: "Hãy nhập [Tên Trường]".<br>2. Field bị highlight viền đỏ. | | | | | | | | |
+| [ID]_0xx | Kiểm tra nhập ký tự khoảng trắng (Spaces) | Medium | Đã truy cập màn hình | 1. Nhập toàn khoảng trắng vào trường.<br>2. Bấm nút thực hiện hoặc focus out. | `"   "` | Hệ thống xem như để trống.<br>Báo lỗi bắt buộc nhập (nếu là trường Required) hoặc tự động trim khoảng trắng. | | | | | | | | |
+| [ID]_0xx | Kiểm tra nhập khoảng trắng ở đầu/cuối chuỗi | Low | Đã truy cập màn hình | 1. Nhập chuỗi có khoảng trắng ở đầu/cuối.<br>2. Bấm nút thực hiện (Đăng ký/Lưu). | `"  data_test  "` | Hệ thống tự động cắt bỏ (trim) khoảng trắng ở đầu và cuối chuỗi trước khi lưu vào DB. | | | | | | | | |
+| [ID]_0xx | Kiểm tra nhập độ dài tối thiểu/tối đa (Boundary Value) | Medium | Đã truy cập màn hình, biết Maxlength = N | 1. Nhập chuỗi độ dài N-1 ký tự.<br>2. Nhập chuỗi độ dài N ký tự.<br>3. Nhập chuỗi độ dài > N ký tự. | Chuỗi test tương ứng | - Độ dài <= N: cho phép nhập và lưu bình thường.<br>- Độ dài > N: hệ thống chặn trực tiếp trên UI hoặc báo lỗi hợp lệ. | | | | | | | | |
+| [ID]_0xx | Kiểm tra nhập ký tự đặc biệt | Medium | Đã truy cập màn hình | 1. Nhập các ký tự đặc biệt (!@#$%^&*).<br>2. Bấm nút thực hiện. | `"!@#$%"` | Hệ thống lưu trữ đúng định dạng ký tự đã nhập (hoặc báo lỗi nếu có quy định hạn chế định dạng). | | | | | | | | |
+| [ID]_0xx | Kiểm tra thao tác Copy/Paste | Low | Đã truy cập màn hình | 1. Copy một chuỗi hợp lệ.<br>2. Paste vào trường thông tin.<br>3. Bấm nút thực hiện. | - | Cho phép paste dữ liệu vào field thành công và xử lý lưu bình thường. | | | | | | | | |
+
+#### * Đối với Trường Số (Number / Price / Quantity)
+
+| TC ID | Test Case Name | Severity | Pre-condition | Steps | Data Test | Expected Result | Ticket ID | Comment | R1 Result | R1 Date | R1 Tester | R2 Result | R2 Date | R2 Tester |
+|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
+| [ID]_0xx | Kiểm tra nhập chữ cái và ký tự đặc biệt | Medium | Đã truy cập màn hình | 1. Cố gắng nhập chữ cái (a, b, c...) hoặc ký tự đặc biệt.<br>2. Bấm nút thực hiện. | `"abc"`, `"@#$"` | UI ngăn không cho nhập chữ cái/ký tự đặc biệt, chỉ chấp nhận chữ số. | | | | | | | | |
+| [ID]_0xx | Kiểm tra nhập số âm | High | Đã truy cập màn hình | 1. Nhập số âm.<br>2. Bấm nút thực hiện. | `-10` | Báo lỗi giá trị phải lớn hơn hoặc bằng 0 (hoặc chặn dấu trừ `-` trực tiếp từ UI). | | | | | | | | |
+| [ID]_0xx | Kiểm tra nhập số thập phân | High | Đã truy cập màn hình | 1. Nhập số có dấu phẩy thập phân.<br>2. Bấm nút thực hiện. | `1.5`, `2,3` | Báo lỗi chỉ chấp nhận số nguyên (hoặc chấp nhận số thập phân tùy đặc tả nghiệp vụ). | | | | | | | | |
+| [ID]_0xx | Kiểm tra hiển thị định dạng phân tách hàng nghìn | Low | Đã truy cập màn hình | 1. Nhập số lớn.<br>2. Focus out khỏi trường nhập liệu. | `1000000` | Số tự động định dạng phân tách hàng nghìn (VD: `1,000,000`). | | | | | | | | |
+
+#### * Đối với Trường File Upload (Hình ảnh)
+
+| TC ID | Test Case Name | Severity | Pre-condition | Steps | Data Test | Expected Result | Ticket ID | Comment | R1 Result | R1 Date | R1 Tester | R2 Result | R2 Date | R2 Tester |
+|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
+| [ID]_0xx | Kiểm tra không upload file (Trường tùy chọn) | Medium | Đã truy cập màn hình | 1. Không chọn file upload.<br>2. Bấm nút thực hiện. | - | Hệ thống cho phép thực hiện thành công mà không báo lỗi. | | | | | | | | |
+| [ID]_0xx | Kiểm tra upload file sai định dạng | High | Định dạng cho phép: jpeg, png | 1. Chọn upload file có định dạng không được phép (xlsx, gif, pdf...).<br>2. Tiến hành upload. | File `.pdf`, `.xlsx` | Upload không thành công. Hiển thị thông báo lỗi đúng thiết kế: "Hình ảnh phải là định dạng jpeg hoặc png." | | | | | | | | |
+| [ID]_0xx | Kiểm tra upload dung lượng vượt quá giới hạn | High | Giới hạn dung lượng: tối đa 10MB | 1. Chọn file có kích thước > 10MB.<br>2. Tiến hành upload. | File kích thước `10.5MB` | Upload thất bại. Hiển thị lỗi cảnh báo: "Dung lượng hình ảnh vượt quá 10MB." | | | | | | | | |
+| [ID]_0xx | Kiểm tra upload file giả mạo đuôi mở rộng (Spoofing) | High | Đã truy cập màn hình | 1. Đổi đuôi file thực thi nguy hiểm `.exe` thành `.jpg`.<br>2. Chọn upload file này. | File `.exe` đổi tên thành `.jpg` | Hệ thống kiểm tra phần thân file (MIME type) thực tế và báo lỗi không đúng định dạng. | | | | | | | | |
+| [ID]_0xx | Kiểm tra kéo thả file (Drag & Drop) | Low | Đã truy cập màn hình | 1. Kéo file ảnh thả vào vùng upload. | File `.png` hợp lệ | Upload file thành công và hiển thị thumbnail ảnh xem trước trên giao diện. | | | | | | | | |
+
+### 3.4. Kiểm thử Logic Nghiệp vụ (Business Rules - BR)
+
+| TC ID | Test Case Name | Severity | Pre-condition | Steps | Data Test | Expected Result | Ticket ID | Comment | R1 Result | R1 Date | R1 Tester | R2 Result | R2 Date | R2 Tester |
+|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
+| [ID]_0xx | Kiểm tra ràng buộc trùng lặp dữ liệu duy nhất (Unique) | High | Đã tồn tại bản ghi trong DB | 1. Nhập thông tin trùng khóa chính/mã duy nhất với bản ghi cũ.<br>2. Điền các thông tin hợp lệ khác.<br>3. Bấm Đăng ký. | Mã trùng lặp | Hệ thống báo lỗi trùng lặp: "Mã/Tên này đã tồn tại trong hệ thống. Vui lòng kiểm tra lại." | | | | | | | | |
+| [ID]_0xx | Kiểm tra logic liên kết dữ liệu động (Dynamic Form Control) | High | Điều kiện thay đổi hiển thị | 1. Tích chọn/Bỏ tích chọn [Checkbox điều kiện]. | - | Giao diện tự động thay đổi hiển thị ẩn/hiện hoặc disable/enable các trường thông tin liên quan theo đúng mô tả Business Rule. | | | | | | | | |
+| [ID]_0xx | Kiểm tra lưu dữ liệu vào Database thành công | Critical | Nhập đầy đủ và chính xác tất cả dữ liệu hợp lệ | 1. Nhập toàn bộ dữ liệu hợp lệ.<br>2. Bấm nút Đăng ký.<br>3. Kiểm tra DB và màn hình danh sách. | Dữ liệu hợp lệ | 1. Lưu bản ghi mới thành công.<br>2. Hiển thị thông báo thành công.<br>3. Dữ liệu trong Database khớp hoàn toàn các trường thông tin đã điền trên UI. | | | | | | | | |
+
+### 3.5. Kiểm thử Ngoại lệ & Hệ thống (Exceptions & Systems)
+
+| TC ID | Test Case Name | Severity | Pre-condition | Steps | Data Test | Expected Result | Ticket ID | Comment | R1 Result | R1 Date | R1 Tester | R2 Result | R2 Date | R2 Tester |
+|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
+| [ID]_0xx | Bấm nút Đăng ký nhiều lần liên tiếp (Double Click) | High | Đã điền đầy đủ dữ liệu hợp lệ | 1. Click liên tiếp nhiều lần vào nút Đăng ký/Lưu. | - | Nút bấm bị disable ngay sau lượt click đầu tiên. Hệ thống chỉ xử lý và tạo duy nhất 1 bản ghi trong DB, không tạo trùng lặp. | | | | | | | | |
+| [ID]_0xx | Kiểm tra mất kết nối mạng đột ngột khi bấm Lưu | High | Điền đầy đủ dữ liệu hợp lệ | 1. Bấm nút Lưu.<br>2. Đồng thời ngắt kết nối mạng. | - | Hệ thống hiển thị loading và thông báo lỗi kết nối mạng, không bị crash hoặc treo màn hình trắng. | | | | | | | | |
+| [ID]_0xx | Kiểm tra nhấn nút Quay lại | Low | Đã điền một số dữ liệu | 1. Nhập một số thông tin.<br>2. Bấm nút Quay lại. | - | Hệ thống chuyển hướng về màn hình danh sách trước đó.<br>Bản ghi mới không được tạo trong DB. | | | | | | | | |

package/custom/skills/log-bug/SKILL.md

@@ -0,0 +1,131 @@
+---
+name: log-bug
+description: Use when a test case fails during Gate 3 execution and a bug needs to be logged with full reproduction steps and evidence. Creates a structured bug report file in the bugs/ directory. Different from investigate-bug which is for developers debugging root causes.
+keywords: bug report, log bug, test fail, defect, reproduction steps, evidence, severity, gate 3
+---
+
+# Log Bug — Gate 3
+
+> **Phạm vi:** Gate 3 — mỗi khi test case fail, AI tạo file bug report chuẩn trong `bugs/`.
+> **TESTER** xác nhận severity và nội dung trước khi submit lên Backlog/Jira.
+
+---
+
+## Khi nào log bug
+
+- Test case fail sau khi execute (Playwright hoặc manual)
+- Actual result khác Expected result — dù là lỗi nhỏ
+- App crash, timeout, lỗi console không mong đợi
+- Hành vi không nhất quán giữa các lần chạy
+
+---
+
+## Quy trình
+
+### Bước 1 — Xác định thông tin bug
+
+Thu thập ngay khi test fail:
+- TC ID và tên test case bị fail
+- Actual result nhận được vs Expected result trong testcase
+- Screenshot/log evidence từ `evidence/[TC-ID]/`
+- Browser, OS, build/version đang test
+
+### Bước 2 — Đánh giá Severity
+
+| Severity | Tiêu chí |
+|---|---|
+| **Critical** | App crash, mất data, không vào được màn hình, security breach |
+| **High** | Chức năng chính không hoạt động, không có workaround |
+| **Medium** | Chức năng phụ bị lỗi, có workaround tạm thời |
+| **Low** | UI/UX nhỏ, cosmetic, typo, không ảnh hưởng chức năng |
+
+### Bước 3 — Tạo file bug report
+
+**File naming:** `bugs/BUG-[số thứ tự 3 chữ số]-[tên ngắn kebab-case].md`
+**Ví dụ:** `bugs/BUG-001-login-button-not-disabled-on-submit.md`
+
+**Dùng template bên dưới.**
+
+### Bước 4 — Thông báo TESTER
+
+```
+🐛 BUG LOGGED: BUG-[XXX]
+
+TC: [TC_ID] — [Tên test case]
+Severity: [Critical / High / Medium / Low]
+File: bugs/BUG-[XXX]-[name].md
+
+→ Review bug report
+→ Type RETEST: [TC_ID] after dev fixes to re-execute
+```
+
+---
+
+## Bug Report Template
+
+```markdown
+# BUG-[XXX] — [Tiêu đề mô tả ngắn gọn vấn đề]
+
+## Thông tin chung
+
+| Property | Value |
+|---|---|
+| **Bug ID** | BUG-[XXX] |
+| **Severity** | Critical / High / Medium / Low |
+| **TC ID** | [TC_ID] |
+| **Reported By** | [Tester Name] |
+| **Report Date** | [Date] |
+| **Status** | Open |
+
+## Môi trường
+
+| Property | Value |
+|---|---|
+| **Browser** | [Chrome 120 / Firefox 121 / ...] |
+| **OS** | [Windows 11 / macOS / ...] |
+| **Build/Version** | [v1.2.3 / commit hash] |
+| **Test Environment** | [Staging / Dev / UAT] |
+
+## Mô tả
+
+[Mô tả ngắn gọn vấn đề trong 1-2 câu]
+
+## Preconditions
+
+[Điều kiện cần thiết trước khi reproduce bug]
+
+## Steps to Reproduce
+
+1. [Bước 1]
+2. [Bước 2]
+3. [Bước 3]
+...
+
+## Expected Result
+
+[Kết quả mong đợi theo testcase / spec]
+
+## Actual Result
+
+[Kết quả thực tế nhận được]
+
+## Evidence
+
+- Screenshot: [evidence/[TC-ID]/step-XX-description.png]
+- Video: [evidence/[TC-ID]/recording.mp4] (nếu có)
+- Console log: [evidence/[TC-ID]/console.log] (nếu có)
+
+## Notes
+
+[Ghi chú thêm nếu có: intermittent, chỉ xảy ra trên specific browser, ...]
+```
+
+---
+
+## Mandatory Rules
+
+- ❌ KHÔNG tự đánh giá root cause — chỉ mô tả WHAT happened, không WHY
+- ❌ KHÔNG bỏ qua bug dù severity thấp — log tất cả, TESTER quyết định defer
+- ✅ Steps to Reproduce PHẢI đủ để dev reproduce mà không cần hỏi thêm
+- ✅ Evidence PHẢI link cụ thể đến file screenshot/log trong `evidence/`
+- ✅ Expected Result PHẢI lấy từ testcase / spec của BA, không từ cách dev implement