# 测试用例全局编号规范（Fonrey）

## 变更历史

| 日期 | 变更人 | 变更内容 |
|---|---|---|
| 2026-04-30 | Atlas | 补充“变更历史”章节（文档治理） |

## 1. 目标
确保所有模块（登录、房源、客源等）测试用例编号**全局唯一**，便于自动化执行、失败定位、统计报表。

## 2. 编号规则

- **测试用例ID**：`TC-FON-XXXXXX`
  - `TC`：Test Case
  - `FON`：Fonrey
  - `XXXXXX`：6位递增数字，左侧补0（如 `000001`）
- **步骤ID**：`TC-FON-XXXXXX-SYY`
  - `SYY`：步骤序号（`S01`、`S02`...）

### 示例
- 用例：`TC-FON-000018`
- 第3步：`TC-FON-000018-S03`

## 3. 分配原则

1. 全项目共用一个递增序列，不按模块重置。
2. 新增用例必须取“当前最大ID + 1”。
3. 废弃用例保留ID，不复用。
4. 若拆分用例，新增子用例使用新ID，不改旧ID。

## 4. 自动化报告字段（必须）

每次自动化执行输出以下字段：

- `run_id`：本次执行唯一ID（如时间戳）
- `test_case_id`：`TC-FON-XXXXXX`
- `step_id`：`TC-FON-XXXXXX-SYY`
- `status`：`passed` / `failed` / `blocked` / `skipped`
- `error_message`：失败信息
- `actual_result`：实际结果
- `expected_result`：预期结果
- `screenshot_path`：失败截图（Web/E2E）
- `log_path`：后端日志/请求响应日志
- `started_at` / `ended_at`

## 5. 报告粒度要求

1. 报告必须能定位到**具体失败步骤**（step_id）。
2. 汇总页至少包含：
   - 总用例数、通过数、失败数、跳过数
   - 按模块统计（登录/房源/客源）
   - Top失败步骤排行（按 step_id）
3. 详情页展示：
   - 失败步骤前后 1~2 步执行上下文
   - 请求/响应（脱敏后）
   - 关键断言差异（Expected vs Actual）

## 6. 当前序列占用（本次）

- 登录模块使用：`TC-FON-000001` ~ `TC-FON-000048`
- 下一可用ID：`TC-FON-000049`