Browse Source

📝 docs(test): update API测试文档结构和标准

- 添加架构设计遵循说明,明确API测试文件位置要求
- 完善目录结构规范,区分真实集成测试和Mock集成测试存放位置
- 更新测试示例说明,明确需要创建新的实际集成测试文件
- 补充使用真实数据库连接的要求,确保遵循架构文档结构
yourname 2 months ago
parent
commit
76a1352df4
1 changed files with 6 additions and 4 deletions
  1. 6 4
      docs/stories/004.001.story.md

+ 6 - 4
docs/stories/004.001.story.md

@@ -42,15 +42,17 @@ Draft
 - **覆盖率目标**: 核心API端点测试覆盖率100%
 
 ### 项目结构指导 [Source: architecture/source-tree.md#API测试]
-- API测试文件应位于对应API端点的 `__tests__` 文件夹中
-- 集成测试应使用 `__integration_tests__` 目录结构
+- **遵循架构设计**: API测试文件应位于对应API端点的 `__tests__` 文件夹中
+- **目录结构**: 真实集成测试放到 `src/server/api/users/__tests__/`
+- **测试分离**: Mock集成测试保留在 `src/server/api/__integration_tests__/`
 - 测试工具函数位于 `src/server/__test_utils__/`
 
 ### 现有测试基础设施 [Source: 现有代码分析]
 - 已有测试工具: `src/server/__test_utils__/api-client.ts`
 - 已有测试工具: `src/server/__test_utils__/test-db.ts`
-- 已有集成测试示例: `src/server/api/__integration_tests__/users.integration.test.ts` (当前为mock测试)
-- 需要修改为使用真实数据库连接而不是mock
+- 已有Mock集成测试示例: `src/server/api/__integration_tests__/users.integration.test.ts` (当前使用mock数据)
+- 需要创建新的实际集成测试文件: `src/server/api/users/__tests__/users.integration.test.ts`
+- 使用真实数据库连接而不是mock,遵循架构文档结构
 
 ### 测试标准要求 [Source: architecture/coding-standards.md#测试标准]
 - 测试文件命名: `*.integration.test.ts`