$generate-test-data — Sinh Test Data Có Cấu Trúc

User cung cấp feature/module hoặc test cases cần sinh data. AI phân tích fields, constraints, sinh bộ data đầy đủ (positive, negative, boundary, edge cases) với format sẵn sàng sử dụng.

BẮT BUỘC (MANDATORY): Trước khi bắt đầu, PHẢI nạp và đọc kỹ:

• Skill: .agents/skills/test-data-generator/SKILL.md — Quy tắc sinh data
• Rule: .agents/rules/automation_rules.md — Section Test Data

Input cần từ User

Các bước thực hiện

Bước 1: Phân tích Fields & Constraints

1. Xác định nguồn thông tin:

   Nguồn	Cách lấy	Ưu tiên
   User cung cấp trực tiếp	Đọc từ input	⭐ Cao nhất
   DOM thực tế (UI form)	browser_navigate → browser_snapshot → phân tích input fields	⭐ Cao
   Swagger/OpenAPI spec	read_url_content → parse schema + constraints	⭐ Cao
   Test cases đã có	Đọc test steps → trích xuất fields	Trung bình
   Đoán từ tên module	Dựa trên kinh nghiệm domain	⭐ Thấp nhất

2. Với mỗi field, xác định:

   Attribute	Ví dụ
   Tên field	email, password, name, phone
   Kiểu dữ liệu	string, number, boolean, date, file, enum
   Required?	Bắt buộc hay tùy chọn
   Validation rules	min/maxLength, pattern/regex, format (email, phone), unique
   Giá trị mặc định	Nếu có
   Enum values	VD: status = ["AVAILABLE", "UNAVAILABLE"]
   Quan hệ phụ thuộc	VD: password_confirm phải khớp password

3. Trình bày bảng Fields cho User xác nhận (CHECKPOINT ⏸️):

   | # | Field | Type | Required | Constraints | Notes |
   |---|-------|------|----------|-------------|-------|
   | 1 | email | string | ✅ | format: email, unique | Dùng để login |
   | 2 | password | string | ✅ | minLength: 6 | |
   | 3 | name | string | ✅ | maxLength: 100 | |
   | 4 | phone | string | ❌ | pattern: /^0[0-9]{9}$/ | 10 chữ số, bắt đầu bằng 0 |

   Chờ User xác nhận hoặc bổ sung constraints trước khi sang Bước 2.

Bước 2: Sinh Test Data theo 4 Categories

Với mỗi field đã xác định, sinh data theo bảng sau:

2A. Positive Data (Happy Path)

• Giá trị hợp lệ, đúng format, trong constraints
• Tất cả required fields được điền
• Dữ liệu phải unique + traceable

Format unique data:

<prefix>_<testName>_<timestamp>

Ví dụ:

email:    auto_register_1712049200@test.com
username: user_login_1712049200
code:     TC_BOOK_1712049200

2B. Negative Data

2C. Boundary Values

2D. Edge Cases

Bước 3: Đóng gói Output

Trả kết quả theo format User yêu cầu (mặc định: JSON):

Format JSON (mặc định)

{
  "module": "User Registration",
  "totalDataSets": 15,
  "fields": ["email", "password", "name", "phone"],
  "positive": [
    {
      "id": "POS_01",
      "description": "Đăng ký thành công với tất cả fields hợp lệ",
      "data": {
        "email": "auto_register_1712049200@test.com",
        "password": "Test@12345",
        "name": "Auto User Register",
        "phone": "0912345001"
      },
      "expectedResult": "Tạo tài khoản thành công, status 201"
    }
  ],
  "negative": [
    {
      "id": "NEG_01",
      "description": "Email trống",
      "data": { "email": "", "password": "Test@12345", "name": "Test User" },
      "expectedResult": "Lỗi validation: Email is required",
      "targetField": "email",
      "negativeType": "missing_required"
    },
    {
      "id": "NEG_02",
      "description": "Email sai format",
      "data": { "email": "not-email", "password": "Test@12345", "name": "Test User" },
      "expectedResult": "Lỗi validation: Invalid email format",
      "targetField": "email",
      "negativeType": "invalid_format"
    }
  ],
  "boundary": [
    {
      "id": "BND_01",
      "description": "Password đúng min length (6 chars)",
      "data": { "email": "auto_bnd01_1712049200@test.com", "password": "Abc@12", "name": "Test User" },
      "expectedResult": "Thành công",
      "targetField": "password",
      "boundaryType": "min"
    }
  ],
  "edgeCases": [
    {
      "id": "EDGE_01",
      "description": "Name chứa Unicode tiếng Việt + emoji",
      "data": { "email": "auto_edge01_1712049200@test.com", "password": "Test@12345", "name": "Nguyễn Văn 🎉" },
      "expectedResult": "Thành công — hệ thống chấp nhận Unicode",
      "targetField": "name",
      "edgeType": "unicode"
    }
  ]
}

Format Markdown Table

| ID | Category | Description | email | password | name | Expected Result |
|----|----------|-------------|-------|----------|------|-----------------|
| POS_01 | Positive | Đăng ký thành công | auto_reg@test.com | Test@12345 | Auto User | 201 Created |
| NEG_01 | Negative | Email trống | (empty) | Test@12345 | Test User | 422: Email is required |
| BND_01 | Boundary | Password min length | auto_bnd@test.com | Abc@12 | Test User | 201 Created |

Format Code (TypeScript example)

// test-data/registration.data.ts
export const registrationData = {
  positive: {
    email: `auto_register_${Date.now()}@test.com`,
    password: 'Test@12345',
    name: 'Auto User Register',
    phone: '0912345001',
  },
  negative: {
    emptyEmail: { email: '', password: 'Test@12345', name: 'Test' },
    invalidEmail: { email: 'not-email', password: 'Test@12345', name: 'Test' },
    shortPassword: { email: `auto_neg_${Date.now()}@test.com`, password: '123', name: 'Test' },
  },
  boundary: {
    minPassword: { email: `auto_bnd_${Date.now()}@test.com`, password: 'Abc@12', name: 'Test' },
    maxName: { email: `auto_bnd_${Date.now()}@test.com`, password: 'Test@12345', name: 'A'.repeat(100) },
  },
};

Data Rules (BẮT BUỘC)

NGHIÊM CẤM

Checklist cuối

• Đã phân tích đầy đủ fields + constraints
• User đã xác nhận bảng fields trước khi sinh data
• Data có đủ 4 categories (Positive, Negative, Boundary, Edge Cases)
• Mỗi data set có expected result rõ ràng
• Data unique + traceable (prefix + timestamp/random)
• Không chứa real PII
• Format output đúng yêu cầu User (JSON/CSV/Markdown/Code)
• Boundary values đúng theo constraints (min, min-1, max, max+1)