Kaynağa Gözat

📝 docs(server): 完善服务器测试环境文档

- 添加web/tests/utils/server测试工具目录说明,包含数据库、认证、服务mock等工具
- 明确测试工具复制要求,列出需要复制的关键测试文件
- 补充测试工具要求部分,详细说明各类测试工具的用途和复制需求
yourname 4 hafta önce
ebeveyn
işleme
fe2c6a7dde
1 değiştirilmiş dosya ile 21 ekleme ve 0 silme
  1. 21 0
      docs/stories/005.001.server-test-environment.md

+ 21 - 0
docs/stories/005.001.server-test-environment.md

@@ -71,11 +71,20 @@ Draft
 ### 现有配置参考
 - **web/vitest.config.ts**: 现有的web测试配置可作为参考
 - **web/package.json**: 现有的测试脚本配置可作为参考
+- **web/tests/utils/server/**: 现有的测试工具目录,包含以下重要文件:
+  - `integration-test-db.ts` - 集成测试数据库工具,使用真实PostgreSQL数据库
+  - `test-db.ts` - 单元测试数据库工具,使用SQLite内存数据库
+  - `test-auth.ts` - 认证测试工具,包含mock认证上下文和中间件
+  - `integration-test-utils.ts` - 集成测试断言工具
+  - `service-mocks.ts` - 各种服务mock工具
+  - `service-stubs.ts` - 服务stub工具
 
 ### 项目结构注意事项
 - packages/server目前没有测试配置和测试文件
 - 需要创建与web目录类似的测试目录结构
 - 测试配置需要针对纯Node.js环境(无前端组件测试)
+- web/tests/utils/server目录下的测试工具需要复制到packages/server/tests/utils/目录
+- 这些测试工具提供了数据库mock、认证mock、服务mock等关键测试基础设施
 
 ### Testing
 
@@ -95,6 +104,18 @@ Draft
 - **测试工具**: hono/testing (用于API测试)
 - **类型定义**: @types/node (已存在)
 
+#### 测试工具要求
+- **数据库测试工具**: 需要复制web/tests/utils/server目录下的数据库测试工具
+  - `test-db.ts` - 单元测试数据库mock工具
+  - `integration-test-db.ts` - 集成测试真实数据库工具
+- **认证测试工具**: 需要复制认证相关的mock工具
+  - `test-auth.ts` - mock认证上下文和中间件
+- **服务mock工具**: 需要复制各种服务mock工具
+  - `service-mocks.ts` - HTTP服务、认证服务、邮件服务等mock
+  - `service-stubs.ts` - 服务stub工具
+- **测试断言工具**: 需要复制集成测试断言工具
+  - `integration-test-utils.ts` - 响应状态码、数据结构等断言工具
+
 ## Change Log
 | Date | Version | Description | Author |
 |------|---------|-------------|--------|