Browse Source

📝 docs(stories): 更新基础设施包拆分文档

- 将shared-test-util package相关任务从待办改为已完成
- 在版本历史中添加2.3版本记录:shared-test-util包完成
- 补充开发代理记录中shared-test-util包的实现细节
- 添加shared-test-util包的新增文件列表
yourname 4 tuần trước cách đây
mục cha
commit
6bba5083f1
1 tập tin đã thay đổi với 28 bổ sung7 xóa
  1. 28 7
      docs/stories/005.001.infrastructure-packages-split.md

+ 28 - 7
docs/stories/005.001.infrastructure-packages-split.md

@@ -39,13 +39,13 @@ Draft
   - [x] 配置 TypeScript 编译选项(包含 `"composite": true`)
   - [x] 编写单元测试(放在 tests/unit/)
 
-- [ ] 创建 shared-test-util package (测试基础设施依赖)
-  - [ ] 创建 package.json 配置
-  - [ ] 迁移并通用化集成测试数据库工具(基于 user-module/tests/utils/integration-test-db.ts)
-  - [ ] 迁移并通用化集成测试断言工具(基于 user-module/tests/utils/integration-test-utils.ts)
-  - [ ] 迁移并通用化测试生命周期钩子(基于 user-module/tests/utils/integration-test-db.ts 中的 setupIntegrationDatabaseHooks)
-  - [ ] 配置 TypeScript 编译选项(包含 `"composite": true`)
-  - [ ] 编写基础测试
+- [x] 创建 shared-test-util package (测试基础设施依赖)
+  - [x] 创建 package.json 配置
+  - [x] 迁移并通用化集成测试数据库工具(基于 user-module/tests/utils/integration-test-db.ts)
+  - [x] 迁移并通用化集成测试断言工具(基于 user-module/tests/utils/integration-test-utils.ts)
+  - [x] 迁移并通用化测试生命周期钩子(基于 user-module/tests/utils/integration-test-db.ts 中的 setupIntegrationDatabaseHooks)
+  - [x] 配置 TypeScript 编译选项(包含 `"composite": true`)
+  - [x] 编写基础测试
 
 - [x] 创建 shared-crud package (AC: 3)
   - [x] 创建 package.json 配置
@@ -332,6 +332,7 @@ Draft
 | 2025-11-10 | 2.0 | **重大架构调整**:从功能分包改为模块分包架构,按照 users/auth/files 模块组织 | Bob (Scrum Master) |
 | 2025-11-10 | 2.1 | **shared-crud 包完成**:通用 CRUD 服务模式、路由模式和测试全部完成 | Claude Code |
 | 2025-11-10 | 2.2 | **user-module 包完成**:用户管理模块(实体、服务、路由、测试)全部完成 | Claude Code |
+| 2025-11-10 | 2.3 | **shared-test-util 包完成**:测试基础设施包(集成测试工具、断言工具、生命周期钩子)全部完成 | Claude Code |
 
 ## Dev Agent Record
 *此部分由开发代理在实现过程中填写*
@@ -375,6 +376,14 @@ Claude Sonnet 4.5 (claude-sonnet-4-5-20250929)
   - ✅ 创建了测试数据工厂和断言工具
   - ✅ 遵循现有的测试模式和代码风格
   - ✅ 所有路由测试通过(13/13 路由测试,54/54 总测试)
+- ✅ **shared-test-util package 创建完成**
+  - ✅ 集成测试数据库工具已通用化(IntegrationTestDatabase)
+  - ✅ 集成测试断言工具已通用化(IntegrationTestAssertions、ApiResponseAssertions)
+  - ✅ 测试生命周期钩子已通用化(setupIntegrationDatabaseHooks)
+  - ✅ TypeScript 配置完成(包含 composite: true)
+  - ✅ 基础测试编写完成并通过(31/31 测试)
+  - ✅ 修复了 expectNotFound 测试中的大小写问题
+  - ✅ 依赖版本与 packages/server 保持一致
 
 ### File List
 **新增文件:**
@@ -450,6 +459,18 @@ Claude Sonnet 4.5 (claude-sonnet-4-5-20250929)
 - `packages/auth-module/src/routes/logout.route.ts` - 登出路由
 - `packages/auth-module/src/routes/sso-verify.route.ts` - SSO验证路由
 
+**新增文件:**
+- `packages/shared-test-util/package.json` - 包配置
+- `packages/shared-test-util/tsconfig.json` - TypeScript 配置
+- `packages/shared-test-util/vitest.config.ts` - 测试配置
+- `packages/shared-test-util/src/index.ts` - 包入口
+- `packages/shared-test-util/src/integration-test-db.ts` - 集成测试数据库工具
+- `packages/shared-test-util/src/integration-test-utils.ts` - 集成测试断言工具
+- `packages/shared-test-util/src/setup-hooks.ts` - 测试生命周期钩子
+- `packages/shared-test-util/src/mock-utils.ts` - 模拟工具
+- `packages/shared-test-util/tests/unit/integration-test-db.test.ts` - 集成测试数据库工具测试
+- `packages/shared-test-util/tests/unit/integration-test-utils.test.ts` - 集成测试断言工具测试
+
 **依赖关系:**
 - shared-utils 依赖 shared-types
 - shared-crud 依赖 shared-types 和 shared-utils