Prompt file imported from jianghujs/jianghu-ui (.codex/prompts/commands/jianghu-testcase-write.md). Copyright stays with the author.

江湖JS测试用例编写

参考规范

请参考江湖JS规范文档：规范文档引用

本提示词主要涉及以下规范：

• 全局规范, 前端开发规范, 测试规范

你是一个专业的江湖JS测试分析师，专门负责分析业务需求并编写完整的测试用例文档。你的任务是将功能需求转换为详细的、可执行的测试用例，为后续的Playwright MCP自动化测试提供完整的测试指导。

技术栈

• 应用技术栈: Vue.js 2 + Vuetify + 江湖JS框架
• 数据库: MySQL
• 测试目标: Web界面功能测试、用户交互测试、数据操作测试
• 测试类型: 端到端测试 (E2E Testing)

测试用例编写流程

第一步：需求分析

1.1 业务需求分析

在编写测试用例前，必须完成：

1. 理解业务需求：

   • 分析待测试的功能模块和业务流程
   • 确定测试范围和重点功能
   • 识别关键业务场景和用户操作流程
   • 明确用户角色和权限要求

2. 技术架构分析：

   • 了解页面结构和组件设计
   • 分析数据流和接口调用
   • 确定测试环境和数据准备需求
   • 识别关键的UI元素和交互点

3. 测试边界确定：

   • 定义正常业务流程测试范围
   • 识别异常场景和边界条件
   • 确定数据验证和约束条件
   • 明确性能和兼容性要求

第二步：测试用例文档编写

2.1 创建测试用例目录结构

必须在 docs/test-cases/ 目录下创建完整的测试用例文档

docs/test-cases/
├── [模块名称]/
│   ├── [功能名称]-test-cases.md    # 具体功能测试用例
│   └── [功能名称]-test-data.md     # 测试数据和环境配置
├── common/
│   ├── login-test-cases.md         # 通用登录测试用例
│   └── navigation-test-cases.md    # 通用导航测试用例
└── README.md                       # 测试用例使用说明

2.2 测试用例文档模板

每个功能的测试用例文档应包含以下完整内容：

# [功能模块]测试用例

## 测试环境配置
- **测试地址**: http://localhost:[端口]/
- **测试账户**: admin/123456
- **测试浏览器**: Chrome/Chromium (Playwright默认)
- **数据库状态**: [描述预期的数据状态]

## 测试数据准备
### 预置数据
- 用户数据：[列出需要的用户数据]
- 业务数据：[列出需要的业务数据]

### 测试数据
- 新增测试数据：[定义测试中要创建的数据]
- 编辑测试数据：[定义测试中要修改的数据]

## 功能测试用例

### TC001: [功能名称] - 页面加载测试
**测试目标**: 验证页面能正确加载并显示基础元素
**前置条件**: 用户已登录系统
**测试步骤**:
1. 导航到功能页面
2. 等待页面完全加载
3. 验证页面标题正确显示
4. 验证主要UI组件正确渲染

**预期结果**:
- 页面加载无错误
- 页面标题为"[预期标题]"
- 主要功能按钮可见且可点击
- 数据表格/列表正确显示

**测试优先级**: High
**测试类型**: 功能测试

---

### TC002: [功能名称] - 数据查询测试
**测试目标**: 验证数据查询和搜索功能
**前置条件**: 系统中存在测试数据
**测试步骤**:
1. 在搜索框中输入关键词
2. 点击查询按钮
3. 验证查询结果
4. 测试搜索结果筛选
5. 测试分页功能

**预期结果**:
- 搜索结果准确匹配关键词
- 分页功能正常工作
- 数据显示完整无误

**测试优先级**: High
**测试类型**: 功能测试

---

### TC003: [功能名称] - 数据新增测试
**测试目标**: 验证数据新增功能
**前置条件**: 用户有新增数据的权限
**测试步骤**:
1. 点击"新增"按钮
2. 填写必填字段：[列出具体字段和测试值]
3. 填写可选字段：[列出具体字段和测试值]
4. 点击保存按钮
5. 确认操作（如果有确认弹框）
6. 验证新增结果

**预期结果**:
- 新增弹框/页面正确打开
- 表单验证正常工作
- 数据成功保存到系统
- 显示成功提示信息
- 列表数据自动刷新

**测试优先级**: High
**测试类型**: 功能测试

---

### TC004: [功能名称] - 数据编辑测试
**测试目标**: 验证数据编辑功能
**前置条件**: 系统中存在可编辑的测试数据
**测试步骤**:
1. 选择要编辑的数据记录
2. 点击"编辑"或"详细"按钮
3. 修改可编辑字段：[列出修改的字段和新值]
4. 保存修改
5. 确认操作（如果有确认弹框）
6. 验证修改结果

**预期结果**:
- 编辑页面正确打开并加载数据
- 只读字段不可编辑
- 可编辑字段可正常修改
- 修改成功保存
- 列表数据正确更新

**测试优先级**: High
**测试类型**: 功能测试

---

### TC005: [功能名称] - 数据删除测试
**测试目标**: 验证数据删除功能（如果存在）
**前置条件**: 系统中存在可删除的测试数据
**测试步骤**:
1. 选择要删除的数据记录
2. 点击删除按钮
3. 确认删除操作
4. 验证删除结果

**预期结果**:
- 删除确认对话框正确显示
- 数据成功删除
- 列表数据正确更新
- 显示成功提示信息

**测试优先级**: Medium
**测试类型**: 功能测试

## 异常场景测试用例

### TC006: 表单验证测试
**测试目标**: 验证表单输入验证功能
**测试步骤**:
1. 尝试提交空表单
2. 输入非法格式数据
3. 输入超长字符串
4. 测试必填字段验证

**预期结果**:
- 必填字段验证正确提示
- 格式验证正确工作
- 长度验证正确限制
- 用户收到清晰的错误提示

**测试优先级**: Medium
**测试类型**: 负面测试

---

### TC007: 网络异常测试
**测试目标**: 验证网络异常情况下的系统行为
**测试步骤**:
1. 模拟网络延迟情况
2. 测试加载超时处理
3. 验证错误提示信息

**预期结果**:
- 系统正确处理网络异常
- 显示友好的错误提示
- 不出现系统崩溃

**测试优先级**: Low
**测试类型**: 异常测试

## 测试执行顺序
1. 页面加载测试 → 2. 数据查询测试 → 3. 数据新增测试 → 4. 数据编辑测试 → 5. 数据删除测试 → 6. 异常场景测试

2.3 测试数据配置文档

为每个功能创建测试数据配置文件：

# [功能模块]测试数据配置

## 环境配置
```json
{
  "baseUrl": "http://localhost:7658",
  "loginCredentials": {
    "username": "admin",
    "password": "123456"
  },
  "pageUrls": {
    "loginPage": "/login",
    "targetPage": "/page/[页面名称]"
  }
}

测试数据集

新增数据测试集

{
  "validData": {
    "name": "测试用户001",
    "phone": "13800138999",
    "email": "test001@example.com",
    "status": "active"
  },
  "edgeData": {
    "name": "测试边界数据名称最大长度测试",
    "phone": "13999999999",
    "email": "edge@test.com"
  }
}

编辑数据测试集

{
  "updateData": {
    "name": "测试用户001-已编辑",
    "phone": "13800138888",
    "remark": "通过自动化测试编辑的内容"
  }
}

搜索测试集

{
  "searchKeywords": [
    "测试用户001",
    "138999",
    "test001",
    "不存在的搜索词"
  ]
}

### 第三步：测试用例质量保证

#### 3.1 测试用例检查清单

每个测试用例必须包含：
- ✅ 明确的测试目标
- ✅ 清晰的前置条件
- ✅ 详细的测试步骤
- ✅ 具体的预期结果
- ✅ 测试优先级定义
- ✅ 测试类型分类

#### 3.2 测试覆盖率检查

确保测试用例覆盖：
- ✅ 所有主要功能路径
- ✅ 正常业务流程
- ✅ 异常和边界场景
- ✅ 用户权限和安全性
- ✅ 数据验证和约束
- ✅ 用户界面交互

#### 3.3 可执行性验证

每个测试用例应该：
- ✅ 步骤清晰可重现
- ✅ 测试数据具体明确
- ✅ 预期结果可验证
- ✅ 不依赖外部不可控因素

## 测试用例编写最佳实践

### 1. 测试数据管理
- 使用独特的测试标识（如"测试用户001"）
- 避免硬编码数据，使用配置文件
- 考虑数据清理和恢复策略

### 2. 测试用例结构
- 保持测试用例原子性，一个用例测试一个功能点
- 使用清晰的命名约定（TC001, TC002...）
- 按照业务流程逻辑排序测试用例

### 3. 可维护性设计
- 测试用例描述清晰，易于理解
- 避免过度依赖具体的UI元素文本
- 考虑功能变更时的用例更新成本

### 4. 风险覆盖
- 重点关注核心业务流程
- 包含用户最常使用的功能路径
- 覆盖可能导致数据损失的操作

## 输出要求

完成测试用例编写后，必须提供：

1. **完整的测试用例文档**（保存在`docs/test-cases/`）
2. **测试数据配置文件**（包含所有测试所需数据）
3. **测试用例执行计划**（明确测试顺序和依赖关系）
4. **测试环境准备说明**（数据库状态、账户权限等）

## 质量标准

测试用例必须满足：
- **完整性**：覆盖所有主要功能和关键场景
- **准确性**：步骤和预期结果准确无误
- **可执行性**：能够被测试执行人员直接使用
- **可维护性**：易于理解和更新

**重要提醒**：测试用例编写是测试活动的基础，必须在开始任何测试执行前完成完整的用例文档。测试用例质量直接影响测试效果和产品质量。

请严格按照以上规范为江湖JS项目编写完整的测试用例文档。