Sfoglia il codice sorgente

📝 docs(infrastructure): update infrastructure core packages documentation

- add user-core package to architecture description and task list
- adjust task numbering to account for new user-core package
- update dependency hierarchy to include user-core
- add user-core package.json configuration example
- update version history with user-core addition
yourname 4 settimane fa
parent
commit
fba2160ae8
1 ha cambiato i file con 29 aggiunte e 20 eliminazioni
  1. 29 20
      docs/stories/005.001.infrastructure-core-packages.md

+ 29 - 20
docs/stories/005.001.infrastructure-core-packages.md

@@ -12,11 +12,12 @@ Draft
 1. shared-types package 创建完成,包含所有通用类型定义
 2. auth-core package 创建完成,提供认证相关的核心服务
 3. utils-core package 创建完成,提供通用的工具函数
-4. 所有基础设施包通过 pnpm workspace 正确配置依赖关系
-5. 现有 server package 重构为使用新的基础设施包
-6. 所有基础设施包通过单元测试和集成测试
-7. 现有功能通过回归测试验证无影响
-8. 所有新包的依赖版本与 packages/server 保持一致
+4. user-core package 创建完成,提供用户管理相关的核心服务
+5. 所有基础设施包通过 pnpm workspace 正确配置依赖关系
+6. 现有 server package 重构为使用新的基础设施包
+7. 所有基础设施包通过单元测试和集成测试
+8. 现有功能通过回归测试验证无影响
+9. 所有新包的依赖版本与 packages/server 保持一致
 
 ## Tasks / Subtasks
 - [x] 创建 shared-types package (AC: 1)
@@ -36,19 +37,25 @@ Draft
   - [ ] 提供常用工具类
   - [ ] 配置 TypeScript 编译选项(包含 `"composite": true`)
   - [ ] 编写单元测试(放在 tests/unit/)
-- [ ] 配置 pnpm workspace 依赖关系 (AC: 4)
+- [ ] 创建 user-core package (AC: 4)
+  - [ ] 创建 package.json 配置
+  - [ ] 迁移用户管理相关的核心服务
+  - [ ] 提供用户 CRUD 操作
+  - [ ] 配置 TypeScript 编译选项(包含 `"composite": true`)
+  - [ ] 编写单元测试(放在 tests/unit/)
+- [ ] 配置 pnpm workspace 依赖关系 (AC: 5)
   - [ ] 更新根目录 package.json workspace 配置
   - [ ] 配置各 package 间的依赖关系
   - [ ] 验证依赖解析正确
-- [ ] 重构 server package 依赖 (AC: 5)
+- [ ] 重构 server package 依赖 (AC: 6)
   - [ ] 更新 server package.json 依赖
   - [ ] 重构代码导入路径
   - [ ] 验证编译通过
-- [ ] 执行回归测试 (AC: 6, 7)
+- [ ] 执行回归测试 (AC: 7, 8)
   - [ ] 运行所有单元测试(tests/unit/)
   - [ ] 运行集成测试(tests/integration/)
   - [ ] 验证现有功能无回归
-- [ ] 验证依赖版本对齐 (AC: 8)
+- [ ] 验证依赖版本对齐 (AC: 9)
   - [ ] 检查所有新包的依赖版本与 packages/server 保持一致
   - [ ] 验证关键依赖版本(typeorm、hono、zod等)完全一致
   - [ ] 确保开发依赖版本也保持一致
@@ -58,12 +65,13 @@ Draft
 ### 技术架构信息
 - **项目技术栈**: Node.js 20.19.2 + TypeScript + Hono + TypeORM + PostgreSQL
 - **包管理**: pnpm workspace
-- **依赖层次**: shared-types → auth-core/utils-core → 业务模块 → server
+- **依赖层次**: shared-types → auth-core/utils-core/user-core → 业务模块 → server
 
 ### 现有代码结构参考
 - **当前共享类型位置**: packages/server/src/types/
 - **当前认证核心**: packages/server/src/auth/
 - **当前工具函数**: packages/server/src/utils/
+- **当前用户管理**: packages/server/src/modules/users/
 
 ### Package 配置要求
 - 所有 package 使用 TypeScript 编译
@@ -82,16 +90,6 @@ Draft
   "dependencies": {}
 }
 
-// database-core package.json
-{
-  "name": "@d8d/database-core",
-  "dependencies": {
-    "@d8d/shared-types": "workspace:*",
-    "typeorm": "^0.3.20",
-    "pg": "^8.16.3"
-  }
-}
-
 // auth-core package.json
 {
   "name": "@d8d/auth-core",
@@ -109,6 +107,16 @@ Draft
     "@d8d/shared-types": "workspace:*"
   }
 }
+
+// user-core package.json
+{
+  "name": "@d8d/user-core",
+  "dependencies": {
+    "@d8d/shared-types": "workspace:*",
+    "typeorm": "^0.3.20",
+    "pg": "^8.16.3"
+  }
+}
 ```
 
 ### 关键依赖版本对齐要求
@@ -143,6 +151,7 @@ Draft
 | 2025-11-10 | 1.2 | 添加 TypeScript composite 配置要求 | Bob (Scrum Master) |
 | 2025-11-10 | 1.3 | 修正 Package 输出配置指向 src 目录 | Bob (Scrum Master) |
 | 2025-11-10 | 1.4 | 移除 database-core package,简化架构 | James (Developer) |
+| 2025-11-10 | 1.5 | 添加 user-core package 需求 | James (Developer) |
 
 ## Dev Agent Record
 *此部分由开发代理在实现过程中填写*