# Ether 项目测试用例总索引

**创建日期**: 2026-02-12  
**版本**: v1.0  
**状态**: 已完成

---

## 一、测试用例统计

| 模块 | 优先级 | 用例数量 | 文件路径 |
|------|--------|----------|----------|
| 系统初始化向导 | P0 | 8 | [系统初始化向导集成测试用例.md](./SETUP_WIZARD_INTEGRATION_CASES.md) |
| 登录认证 | P0 | 16 | [登录认证测试用例.md](./登录认证/登录认证测试用例.md) |
| 用户管理 | P0 | 23 | [用户管理测试用例.md](./用户管理/用户管理测试用例.md) |
| 角色权限 | P0 | 27 | [角色权限测试用例.md](./角色权限/角色权限测试用例.md) |
| 项目管理 | P0 | 25 | [项目管理测试用例.md](./项目管理/项目管理测试用例.md) |
| 工单管理 | P1 | 28 | [工单管理测试用例.md](./工单管理/工单管理测试用例.md) |
| 巡检管理 | P1 | 18 | [巡检管理测试用例.md](./巡检管理/巡检管理测试用例.md) |
| 访客管理 | P1 | 22 | [访客管理测试用例.md](./访客管理/访客管理测试用例.md) |
| 设备管理 | P2 | 27 | [设备管理测试用例.md](./设备管理/设备管理测试用例.md) |
| **合计** | - | **194** | - |

---

## 二、测试用例目录结构

```
docs/测试用例/
├── README.md                    # 本文件（总索引）
├── 登录认证/
│   └── 登录认证测试用例.md
├── 用户管理/
│   └── 用户管理测试用例.md
├── 角色权限/
│   └── 角色权限测试用例.md
├── 项目管理/
│   └── 项目管理测试用例.md
├── 工单管理/
│   └── 工单管理测试用例.md
├── 巡检管理/
│   └── 巡检管理测试用例.md
├── 访客管理/
│   └── 访客管理测试用例.md
└── 设备管理/
    └── 设备管理测试用例.md
```

---

## 三、测试用例规范

### 3.1 用例编号规则

- 格式：`TC-{模块缩写}-{序号}`
- 示例：`TC-AUTH-001`（登录认证模块第1个用例）

### 3.2 模块缩写对照

| 缩写 | 模块 |
|------|------|
| AUTH | 登录认证 |
| USER | 用户管理 |
| ROLE | 角色管理 |
| PERM | 权限管理 |
| PROJ | 项目管理 |
| WORK | 工单管理 |
| INSP | 巡检管理 |
| VISIT | 访客管理 |
| ASSET | 设备管理 |

### 3.3 用例要素说明

每个测试用例包含以下要素：

| 要素 | 说明 |
|------|------|
| 测试权限 | 执行该测试所需的用户角色和权限级别 |
| 前置条件 | 执行测试前必须满足的条件 |
| 测试步骤 | 详细的操作步骤，按顺序编号 |
| 期望结果 | 预期的界面表现、数据变化、系统响应等 |
| 验证方法 | 如何验证测试结果是否符合预期 |

---

## 四、测试环境要求

### 4.1 测试账号

| 账号类型 | 用户名 | 密码 | 用途 |
|---------|--------|------|------|
| 超级管理员 | admin | Admin@123 | 系统管理、权限验证 |
| 项目管理员 | project_admin | Project@123 | 项目级管理功能测试 |
| 普通用户 | normal_user | Normal@123 | 基础功能测试 |
| 维保人员 | maintenance_user | Maintenance@123 | 设备维保测试 |
| 巡检人员 | inspector_user | Inspector@123 | 巡检任务测试 |

### 4.2 测试数据

- 使用独立的测试数据库
- 准备初始化测试数据（见各模块测试用例中的数据准备脚本）
- 测试数据与生产数据隔离

---

## 五、测试执行指南

### 5.1 执行顺序

建议按以下顺序执行测试：

1. **P0模块**：登录认证 → 用户管理 → 角色权限 → 项目管理
2. **P1模块**：工单管理 → 巡检管理 → 访客管理
3. **P2模块**：设备管理

### 5.2 执行记录

每个测试用例文件末尾包含执行记录表格，执行测试时需填写：

- 执行日期
- 执行人
- 结果（通过/失败/阻塞）
- 备注（问题描述、缺陷编号等）

---

## 六、缺陷管理

### 6.1 缺陷严重程度

| 级别 | 说明 | 示例 |
|------|------|------|
| 致命 | 系统崩溃、数据丢失、安全漏洞 | 登录功能完全不可用 |
| 严重 | 主要功能无法使用 | 无法创建用户 |
| 一般 | 功能部分不可用或体验问题 | 搜索结果不准确 |
| 轻微 | 界面问题、文案错误 | 按钮位置偏移 |
| 建议 | 优化建议 | 建议增加快捷操作 |

### 6.2 缺陷状态

- 新建：新发现的缺陷
- 确认：已确认是缺陷
- 处理中：开发人员正在修复
- 已修复：缺陷已修复，待验证
- 已关闭：验证通过，缺陷关闭
- 重新打开：修复后仍存在问题

---

## 七、相关文档

- [需求澄清文档](../需求澄清文档.md)
- [E2E测试前端初始化检测机制](../.trae/documents/E2E测试前端初始化检测机制.md)
- [领域技术方案](../02-设计文档/领域技术方案/)

---

## 八、版本历史

| 版本 | 日期 | 修改内容 | 修改人 |
|------|------|----------|--------|
| v1.0 | 2026-02-12 | 初始版本，完成8个模块186个测试用例 | AI Assistant |

---

## 九、联系方式

如有测试相关问题，请联系：
- 测试负责人：[待填写]
- 开发负责人：[待填写]
