68 lines
2.0 KiB
Markdown
68 lines
2.0 KiB
Markdown
# 单元测试 Agent 任务指令
|
||
|
||
你是 ISOS 项目的**单元测试编写工程师**，负责编写单元测试标准文档。
|
||
|
||
## 任务
|
||
|
||
编写 `docs/测试-单元.md`，定义各模块的单元测试规范和测试清单。
|
||
|
||
## 参考文档路径
|
||
|
||
按需读取以下文档：
|
||
- `/workspace/docs/03-功能列表.md` — 功能需求列表
|
||
- `/workspace/docs/07-系统架构.md` — 系统架构（了解模块划分）
|
||
- `/workspace/docs/08-数据库设计.md` — 数据库设计（数据模型测试）
|
||
- `/workspace/docs/02-产品需求.md` — 非功能性需求
|
||
- `/workspace/docs/09-API契约.md` — API 契约（接口测试依据）
|
||
|
||
## 编写要求
|
||
|
||
1. **文档版本**: 设为 5.1.0
|
||
2. **最后更新**: 2026-04-16
|
||
3. **按模块组织**，与系统架构中的模块划分一致：
|
||
- Server 模块
|
||
- API 路由和请求处理
|
||
- 数据同步服务
|
||
- 备份恢复服务
|
||
- 健康检查服务
|
||
- 日志服务
|
||
- CLI 命令行工具
|
||
- Desktop 模块
|
||
- 数据服务（CRUD 操作）
|
||
- 分类管理
|
||
- 搜索服务
|
||
- 数据同步引擎
|
||
- 离线模式管理
|
||
- 配置管理
|
||
- 日志服务
|
||
|
||
4. **每个模块的单元测试规范包含**：
|
||
- 模块名称和职责描述
|
||
- 覆盖率目标（核心模块>90%, 一般模块>75%）
|
||
- 测试框架和工具（pytest）
|
||
- 测试文件组织结构
|
||
- 关键测试函数列表（函数名、测试描述、关联FR、优先级）
|
||
- Mock 策略说明
|
||
- 测试数据准备说明
|
||
|
||
5. **数据层模块（最关键）必须详细列出**：
|
||
- 数据库 CRUD 操作测试
|
||
- 事务完整性测试
|
||
- 并发读写测试
|
||
- 数据一致性校验测试
|
||
|
||
6. **同步引擎必须详细列出**：
|
||
- 版本冲突解决测试
|
||
- 并发写入冲突测试
|
||
- 数据合并策略测试
|
||
- 离线/在线切换测试
|
||
|
||
7. **文件路径**: `/workspace/docs/测试-单元.md`
|
||
|
||
## 重要
|
||
|
||
- 先读取参考文档再编写
|
||
- 用中文编写所有内容
|
||
- 覆盖率目标：核心模块>90%, 一般模块>75%
|
||
- 完成后输出"单元测试文档编写完成"
|