# 单元测试 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%
- 完成后输出"单元测试文档编写完成"