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