Преглед на файлове

📝 docs(prd): update api actual request testing epic description

- 修改当前相关功能描述,明确使用自定义测试工具而非官方hono/testing
- 更新新增内容,强调迁移到hono/testing官方测试工具
- 调整集成方式说明,指出使用testClient()替代自定义实现

📝 docs(story): update testing framework information

- 修改测试框架为Vitest 2.x + Hono Testing (testClient)
- 更新现有测试基础设施说明,明确需要迁移到hono/testing
- 修改测试工具实现描述,强调使用testClient()替代自定义ApiClient
yourname преди 2 месеца
родител
ревизия
84b15f1790
променени са 2 файла, в които са добавени 8 реда и са изтрити 7 реда
  1. 4 4
      docs/prd/epic-004-api-actual-request-testing.md
  2. 4 3
      docs/stories/004.001.story.md

+ 4 - 4
docs/prd/epic-004-api-actual-request-testing.md

@@ -6,14 +6,14 @@
 ## Epic Description
 
 ### 现有系统上下文
-- **当前相关功能**:已有完整的API集成测试框架,但全部使用mock服务和模拟数据
+- **当前相关功能**:已有完整的API集成测试框架,但使用自定义测试工具而非官方hono/testing
 - **技术栈**:Node.js + TypeScript + Hono + TypeORM + PostgreSQL + Vitest
 - **集成点**:数据库连接、认证中间件、CRUD服务、API路由
-- **现有测试**:`src/server/api/__integration_tests__/users.integration.test.ts` - 纯mock测试
+- **现有测试**:使用自定义ApiClient而非hono/testing的testClient()
 
 ### 增强详情
-- **新增内容**:创建实际HTTP请求测试套件,连接真实测试数据库进行端到端测试
-- **集成方式**:在现有测试框架基础上扩展,使用测试专用数据库环境
+- **新增内容**:迁移到hono/testing官方测试工具,创建实际HTTP请求测试套件,连接真实测试数据库进行端到端测试
+- **集成方式**:使用hono/testing的testClient()替代自定义实现,提供更好的类型安全和开发体验
 - **成功标准**:
   - 所有核心API端点都有实际请求测试
   - 测试覆盖CRUD操作的实际数据库交互

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

@@ -47,7 +47,7 @@ Ready for Review
 ## Dev Notes
 
 ### 技术栈和测试框架 [Source: architecture/tech-stack.md#测试框架]
-- **测试框架**: Vitest 2.x + Supertest 6.x
+- **测试框架**: Vitest 2.x + Hono Testing (testClient)
 - **测试位置**: `src/server/api/__integration_tests__/` 目录
 - **数据库**: 使用真实PostgreSQL数据库连接进行测试
 - **覆盖率目标**: 核心API端点测试覆盖率100%
@@ -59,10 +59,11 @@ Ready for Review
 - 测试工具函数位于 `src/server/__test_utils__/`
 
 ### 现有测试基础设施 [Source: 现有代码分析]
-- 已有测试工具: `src/server/__test_utils__/api-client.ts`
+- 已有测试工具: `src/server/__test_utils__/api-client.ts` (需要迁移到hono/testing)
 - 已有测试工具: `src/server/__test_utils__/test-db.ts`
 - 已有Mock集成测试示例: `src/server/api/__integration_tests__/users.integration.test.ts` (当前使用mock数据)
 - 需要创建新的实际集成测试文件: `src/server/api/users/__tests__/users.integration.test.ts`
+- 使用hono/testing的testClient()替代自定义ApiClient,提供更好的类型安全
 - 使用真实数据库连接而不是mock,遵循架构文档结构
 
 ### 测试标准要求 [Source: architecture/coding-standards.md#测试标准]
@@ -129,7 +130,7 @@ Ready for Review
 1. ✅ 配置了真实的PostgreSQL测试数据库环境
 2. ✅ 创建了测试数据工厂和清理工具
 3. ✅ 实现了测试专用的数据库连接管理
-4. ✅ 开发了完整的集成测试工具函数集
+4. ✅ 迁移到hono/testing的testClient(),提供更好的类型安全
 5. ✅ 实现了用户API所有端点的实际请求测试
 6. ✅ 集成了GitHub Actions CI/CD流水线
 7. ✅ 支持测试报告生成和覆盖率统计