71 lines
2.5 KiB
Markdown
71 lines
2.5 KiB
Markdown
# {{任务编号}} 测试任务：{{测试标题}}
|
||
|
||
## 概述
|
||
|
||
{{一段描述：测试范围}}
|
||
|
||
**前置依赖**: {{依赖任务列表}}
|
||
|
||
## tmux 执行协议
|
||
|
||
- **Session**: `arno-team`，始终复用 `项目` / `后端` / `前端` / `测试` 四个 pane，禁止新建 tmux session / window / pane
|
||
- **环境重置**: 开始前确保目标 pane 中是新启动的 `cc` 环境（/exit 后重启，清除遗留上下文）
|
||
- **分发方式**: 由 `项目` pane 发送简短提示词，让目标 pane 自行读取任务文件
|
||
|
||
## 前置文档（必读）
|
||
|
||
> 执行本任务前必须加载以下文档，作为测试策略和被测模块规范。
|
||
|
||
### 测试规范（所有测试任务通用）
|
||
- `docs/10-测试-方案.md` §1（测试策略/原则/级别/覆盖率要求）、§2（单元测试：框架/文件组织/Mock 策略/测试执行命令）
|
||
- `docs/11-工程规范.md` §1.5（术语使用规范）| §2（编码规范）
|
||
|
||
### 按任务选取
|
||
| 任务 | 被测模块文档 | API 契约 | 测试用例参考 |
|
||
|------|------------|---------|------------|
|
||
| M2-003 | `docs/08-数据库设计.md` §2.2.1 | `docs/09-API契约.md` §5、§7.1~§7.5 | — |
|
||
| M3-005 | `docs/08-数据库设计.md` §3.2.5、§3.2.7 | `docs/09-API契约.md` §9.1、§9.2 | — |
|
||
| M4-006 | `docs/08-数据库设计.md` §3.2.1、§3.2.3 | `docs/09-API契约.md` §9.3~§9.7 | — |
|
||
| M5-004 | `docs/08-数据库设计.md` §3.2.3、§3.2.5 | `docs/09-API契约.md` §6（同步接口） | — |
|
||
| M6-004 | `docs/运维-部署实施.md` | `docs/09-API契约.md` §8.1（健康检查） | — |
|
||
| M7-006 | `docs/08-数据库设计.md` §3.2.2、§3.2.7 | `docs/09-API契约.md` §9.8~§9.11 | — |
|
||
| M8-005 | `docs/08-数据库设计.md` §2.2.3、§2.2.4、§3.2.6 | `docs/09-API契约.md` §7.6~§7.8 | — |
|
||
|
||
## 测试范围
|
||
|
||
{{被测模块列表}}
|
||
|
||
## 需要创建的文件（覆盖率：{{阈值}}）
|
||
|
||
### 1. `tests/{{path}}/test_{{module}}.py` — {{测试类名}}
|
||
|
||
```python
|
||
class Test{{ClassName}}:
|
||
def test_{{功能}}_{{场景}}(self):
|
||
"""{{描述}}"""
|
||
```
|
||
|
||
### 2. 其他测试文件
|
||
|
||
{{附加测试类/方法}}
|
||
|
||
## 编码规范
|
||
|
||
- Python 3.12+，mypy strict
|
||
- 测试函数命名：`test_{功能}_{场景}`
|
||
- 使用真实 SQLite (:memory:)，不 mock 数据库
|
||
- TypeScript 测试使用 vitest
|
||
|
||
## 验收标准
|
||
|
||
- 所有测试通过（uv run pytest / npx vitest run）
|
||
- 覆盖率 >= {{阈值}}%
|
||
|
||
## 验证命令
|
||
|
||
```bash
|
||
{{具体命令}}
|
||
```
|
||
|
||
完成后将产出物清单写入 `/workspace/tasks/result/{{任务编号}}.md`。
|