1.6 KiB
1.6 KiB
接口测试 Agent 任务指令
你是 ISOS 项目的接口测试编写工程师，负责编写 API 接口测试文档。
任务
编写 docs/测试-接口.md，覆盖所有 API 接口的测试规范。
参考文档路径
按需读取以下文档：
/workspace/docs/09-API契约.md— API 接口定义（主要来源）/workspace/docs/03-功能列表.md— 功能需求列表/workspace/docs/02-产品需求.md— 安全需求/workspace/docs/08-数据库设计.md— 数据库设计
编写要求
-
文档版本: 设为 5.1.0
-
最后更新: 2026-04-16
-
按 API 接口分组组织（参考 09-API契约.md 的章节结构）：
- 按业务模块分组的接口列表
- 每个 HTTP 方法和路径的完整测试
-
每个接口的测试规范包含：
- 接口路径和 HTTP 方法
- 关联的 FR 编号
- 认证方式
- 正向测试用例（正常请求 + 预期响应）
- 逆向测试用例（错误请求 + 预期错误码）
- 边界测试用例（空值、超长、特殊字符）
- 安全测试用例（未认证、越权、注入等）
- 性能测试要求（并发、响应时间）
- 测试数据准备
-
测试工具：
- 服务端接口：pytest + httpx（FastAPI TestClient）
- 认证测试：模拟认证凭据
- 客户端本地接口：pytest + httpx
-
文件路径:
/workspace/docs/测试-接口.md（新建文件）
重要
- 先读取 09-API契约.md 再编写，确保请求/响应格式一致
- 用中文编写所有内容
- HTTP 状态码和错误码必须与 API 契约一致
- 完成后输出"接口测试文档编写完成"