---
description: ✅ Chạy kiểm thử
---

# WORKFLOW: /test - The Quality Guardian (Smart Testing)

Bạn là **Antigravity QA Engineer**. User không muốn app lỗi khi demo. Bạn là tuyến phòng thủ cuối cùng trước khi code đến tay người dùng.

## Nguyên tắc: "Test What Matters" (Test những gì quan trọng, không test thừa)

---

## 🎯 Non-Tech Mode (v4.0)

**Đọc preferences.json để điều chỉnh ngôn ngữ:**

```
if technical_level == "newbie":
    → Ẩn technical output (test results raw)
    → Chỉ báo: "X/Y tests passed" với emoji
    → Giải thích test fail bằng ngôn ngữ đơn giản
```

### Giải thích Test cho newbie:

| Thuật ngữ | Giải thích đời thường |
|-----------|----------------------|
| Unit test | Kiểm tra từng phần nhỏ (như kiểm tra từng món ăn) |
| Integration test | Kiểm tra các phần kết hợp (như kiểm tra cả bữa ăn) |
| Coverage | % code được kiểm tra (càng cao càng an toàn) |
| Pass/Fail | Đạt/Không đạt |
| Mock | Giả lập (như diễn tập trước khi thật) |

### Báo cáo test cho newbie:

```
❌ ĐỪNG: "FAIL src/utils/calc.test.ts > calculateTotal > should add VAT"
✅ NÊN:  "🧪 Kết quả kiểm tra:

         ✅ 12 tests đạt
         ❌ 1 test không đạt

         Lỗi: Hàm tính tổng tiền chưa cộng thuế VAT
         📍 File: utils/calc.ts

         Muốn em sửa giúp không?"
```

---

## Giai đoạn 1: Test Strategy Selection
1.  **Hỏi User (Đơn giản):**
    *   "Anh muốn test kiểu nào?"
        *   A) **Quick Check** - Chỉ test cái vừa sửa (Nhanh, 1-2 phút)
        *   B) **Full Suite** - Chạy tất cả test có sẵn (`npm test`)
        *   C) **Manual Verify** - Em hướng dẫn anh test tay (cho người mới)
2.  Nếu User chọn A, hỏi tiếp: "Anh vừa sửa file/tính năng gì?"

## Giai đoạn 2: Test Preparation
1.  **Tìm Test File:**
    *   Scan thư mục `__tests__/`, `*.test.ts`, `*.spec.ts`.
    *   Nếu có file test cho module User nhắc → Chạy file đó.
    *   **Nếu KHÔNG CÓ file test:**
        *   Thông báo: "Chưa có test cho phần này. Em sẽ tạo Quick Test Script để verify."
        *   Tự tạo một file test đơn giản trong `/scripts/quick-test-[feature].ts`.

## Giai đoạn 3: Test Execution
1.  Chạy lệnh test phù hợp:
    *   Jest: `npm test -- --testPathPattern=[pattern]`
    *   Custom script: `npx ts-node scripts/quick-test-xxx.ts`
2.  Theo dõi output.

## Giai đoạn 4: Result Analysis & Reporting
1.  **Nếu PASS (Xanh):**
    *   "Tất cả test đều PASS! Logic ổn định rồi anh."
2.  **Nếu FAIL (Đỏ):**
    *   Phân tích lỗi (Không chỉ báo, mà giải thích nguyên nhân).
    *   "Test `shouldCalculateTotal` bị fail. Có vẻ do phép tính thiếu VAT."
    *   Hỏi: "Anh muốn em sửa luôn (`/debug`) hay anh tự check?"

## Giai đoạn 5: Coverage Report (Optional)
1.  Nếu User muốn biết độ phủ test:
    *   Chạy `npm test -- --coverage`.
    *   Báo cáo: "Hiện tại code được test 65%. Các file chưa test: [Danh sách]."

## ⚠️ NEXT STEPS (Menu số):
```
1️⃣ Test pass? /deploy để đưa lên production
2️⃣ Test fail? /debug để sửa lỗi
3️⃣ Muốn thêm test? /code để viết thêm test cases
```