Bladeren bron

📝 docs(stories): 更新多个UI包文档,添加文件管理UI组件依赖

- 用户管理UI包:添加`@d8d/file-management-ui`依赖,集成FileSelector组件替换头像上传逻辑
- 广告管理UI包:添加`@d8d/file-management-ui`依赖,集成FileSelector组件替换图片上传逻辑
- 商品管理UI包:添加`@d8d/file-management-ui`依赖,使用FileSelector组件实现商品图片上传功能
- 各文档版本更新至1.1,记录文件管理UI包集成信息及相关测试要求
yourname 1 maand geleden
bovenliggende
commit
a034a0c2ba

+ 6 - 1
docs/stories/007.017.user-management-ui-package.story.md

@@ -31,13 +31,14 @@ Ready for Review
 
 - [x] 任务 2 (AC: 1): 配置包依赖和构建
   - [x] 创建 `packages/user-management-ui/package.json` 包配置
-  - [x] 添加依赖:`@d8d/shared-ui-components`、`@d8d/user-module`
+  - [x] 添加依赖:`@d8d/shared-ui-components`、`@d8d/user-module`、`@d8d/file-management-ui`
   - [x] 配置构建脚本和TypeScript配置
 
 - [x] 任务 3 (AC: 2, 3): 复制并调整用户管理界面组件
   - [x] 复制 `web/src/client/admin/pages/Users.tsx` 为 `packages/user-management-ui/src/components/UserManagement.tsx`
   - [x] 更新组件导入路径,使用共享UI组件包
   - [x] 调整API客户端,使用用户模块包
+  - [x] 集成文件选择器组件,使用 `@d8d/file-management-ui` 中的 `FileSelector` 组件替换原有的头像上传逻辑
 
 - [x] 任务 4 (AC: 3, 6): 创建API客户端和类型定义
   - [x] 创建 `packages/user-management-ui/src/api/userClient.ts` API客户端
@@ -48,6 +49,7 @@ Ready for Review
   - [x] 实现用户列表查询和分页功能
   - [x] 实现用户创建、编辑、删除功能
   - [x] 实现用户状态管理和角色权限管理
+  - [x] 使用 `FileSelector` 组件实现头像上传和显示功能
   - [x] 实现搜索和过滤功能
 
 - [x] 任务 6 (AC: 8): 创建测试套件
@@ -95,6 +97,7 @@ Ready for Review
 ### 依赖关系
 - **共享UI组件包**: `@d8d/shared-ui-components` - 提供基础UI组件 [Source: architecture/source-tree.md#实际项目结构]
 - **单租户用户模块**: `@d8d/user-module` - 提供用户管理API [Source: docs/prd/epic-007-multi-tenant-package-replication.md#用户管理界面包]
+- **文件管理UI包**: `@d8d/file-management-ui` - 提供文件选择器组件,用于用户头像上传和选择功能
 
 ### 从前一个故事吸取的经验教训
 - **useQuery测试策略**: 使用真实的QueryClientProvider而不是mock react-query,在TestWrapper中提供完整的react-query上下文 [Source: docs/stories/007.015.auth-management-ui-package.story.md#测试策略关键发现]
@@ -140,6 +143,7 @@ Ready for Review
 #### 特定测试要求
 - **用户CRUD测试**: 验证用户创建、读取、更新、删除功能
 - **角色权限测试**: 验证用户角色分配和权限管理
+- **文件选择器集成测试**: 验证与 `FileSelector` 组件的集成,包括头像上传和显示功能
 - **搜索过滤测试**: 验证搜索和过滤功能正常工作
 - **表单验证测试**: 验证表单验证和错误处理
 - **API集成测试**: 验证与用户模块的API集成
@@ -155,6 +159,7 @@ Ready for Review
 | 日期 | 版本 | 描述 | 作者 |
 |------|------|------|------|
 | 2025-11-15 | 1.0 | 初始故事创建 | Bob (Scrum Master) |
+| 2025-11-16 | 1.1 | 添加对文件管理UI包中FileSelector组件的依赖 | John (PM) |
 
 ## Dev Agent Record
 

+ 6 - 3
docs/stories/007.019.advertisement-management-ui-package.story.md

@@ -31,7 +31,7 @@ Draft
 
 - [ ] 任务 2 (AC: 1): 配置包依赖和构建
   - [ ] 创建 `packages/advertisement-management-ui/package.json` 包配置
-  - [ ] 添加依赖:`@d8d/shared-ui-components`、`@d8d/advertisements-module`
+  - [ ] 添加依赖:`@d8d/shared-ui-components`、`@d8d/advertisements-module`、`@d8d/file-management-ui`
   - [ ] 配置构建脚本和TypeScript配置
 
 - [ ] 任务 3 (AC: 2, 3): 复制并调整广告管理界面组件
@@ -39,6 +39,7 @@ Draft
   - [ ] 复制 `web/src/client/admin/components/AdvertisementTypeSelector.tsx` 为 `packages/advertisement-management-ui/src/components/AdvertisementTypeSelector.tsx`
   - [ ] 更新组件导入路径,使用共享UI组件包
   - [ ] 调整API客户端,使用广告模块包
+  - [ ] 集成文件选择器组件,使用 `@d8d/file-management-ui` 中的 `FileSelector` 组件替换原有的图片上传逻辑
 
 - [ ] 任务 4 (AC: 3, 6): 创建API客户端和类型定义
   - [ ] 创建 `packages/advertisement-management-ui/src/api/advertisementClient.ts` API客户端
@@ -49,7 +50,7 @@ Draft
   - [ ] 实现广告列表查询和分页功能
   - [ ] 实现广告创建、编辑、删除功能
   - [ ] 实现广告状态管理和类型选择功能
-  - [ ] 实现图片上传和预览功能
+  - [ ] 使用 `FileSelector` 组件实现图片上传和预览功能
   - [ ] 实现搜索和过滤功能
 
 - [ ] 任务 6 (AC: 8): 创建测试套件
@@ -97,6 +98,7 @@ Draft
 ### 依赖关系
 - **共享UI组件包**: `@d8d/shared-ui-components` - 提供基础UI组件 [Source: architecture/source-tree.md#实际项目结构]
 - **单租户广告模块**: `@d8d/advertisements-module` - 提供广告管理API [Source: docs/prd/epic-007-multi-tenant-package-replication.md#广告管理界面包]
+- **文件管理UI包**: `@d8d/file-management-ui` - 提供文件选择器组件,用于广告图片上传和选择功能
 
 ### 从前一个故事吸取的经验教训
 - **useQuery测试策略**: 使用真实的QueryClientProvider而不是mock react-query,在TestWrapper中提供完整的react-query上下文 [Source: docs/stories/007.017.user-management-ui-package.story.md#从前一个故事吸取的经验教训]
@@ -143,7 +145,7 @@ Draft
 
 #### 特定测试要求
 - **广告CRUD测试**: 验证广告创建、读取、更新、删除功能
-- **图片上传测试**: 验证图片上传和预览功能
+- **文件选择器集成测试**: 验证与 `FileSelector` 组件的集成,包括图片选择和预览功能
 - **类型选择测试**: 验证广告类型选择器正常工作
 - **搜索过滤测试**: 验证搜索和过滤功能正常工作
 - **表单验证测试**: 验证表单验证和错误处理
@@ -160,6 +162,7 @@ Draft
 | 日期 | 版本 | 描述 | 作者 |
 |------|------|------|------|
 | 2025-11-16 | 1.0 | 初始故事创建 | Bob (Scrum Master) |
+| 2025-11-16 | 1.1 | 添加对文件管理UI包中FileSelector组件的依赖 | John (PM) |
 
 ## Dev Agent Record
 

+ 6 - 1
docs/stories/007.025.goods-management-ui-package.story.md

@@ -31,13 +31,14 @@ Draft
 
 - [ ] 任务 2 (AC: 1): 配置包依赖和构建
   - [ ] 创建 `packages/goods-management-ui/package.json` 包配置
-  - [ ] 添加依赖:`@d8d/shared-ui-components`、`@d8d/goods-module`
+  - [ ] 添加依赖:`@d8d/shared-ui-components`、`@d8d/goods-module`、`@d8d/file-management-ui`
   - [ ] 配置构建脚本和TypeScript配置
 
 - [ ] 任务 3 (AC: 2, 3): 复制并调整商品管理界面组件
   - [ ] 复制 `web/src/client/admin/pages/Goods.tsx` 为 `packages/goods-management-ui/src/components/GoodsManagement.tsx`
   - [ ] 更新组件导入路径,使用共享UI组件包
   - [ ] 调整API客户端,使用商品模块包
+  - [ ] 集成文件选择器组件,使用 `@d8d/file-management-ui` 中的 `FileSelector` 组件替换原有的图片上传逻辑
 
 - [ ] 任务 4 (AC: 3, 6): 创建API客户端和类型定义
   - [ ] 创建 `packages/goods-management-ui/src/api/goodsClient.ts` API客户端
@@ -48,6 +49,7 @@ Draft
   - [ ] 实现商品列表查询和分页功能
   - [ ] 实现商品创建、编辑、删除功能
   - [ ] 实现库存管理和价格管理
+  - [ ] 使用 `FileSelector` 组件实现商品主图和轮播图上传功能
   - [ ] 实现搜索和过滤功能
 
 - [ ] 任务 6 (AC: 8): 创建测试套件
@@ -100,6 +102,7 @@ Draft
 ### 依赖关系
 - **共享UI组件包**: `@d8d/shared-ui-components` - 提供基础UI组件 [Source: architecture/source-tree.md#实际项目结构]
 - **单租户商品模块**: `@d8d/goods-module` - 提供商品管理API [Source: docs/prd/epic-007-multi-tenant-package-replication.md#商品管理界面包]
+- **文件管理UI包**: `@d8d/file-management-ui` - 提供文件选择器组件,用于商品主图和轮播图上传选择功能
 
 ### 从前一个故事吸取的经验教训
 - **useQuery测试策略**: 使用真实的QueryClientProvider而不是mock react-query,在TestWrapper中提供完整的react-query上下文 [Source: docs/stories/007.017.user-management-ui-package.story.md#从前一个故事吸取的经验教训]
@@ -147,6 +150,7 @@ Draft
 - **商品CRUD测试**: 验证商品创建、读取、更新、删除功能
 - **库存管理测试**: 验证库存数量管理和预警功能
 - **价格管理测试**: 验证价格设置和调整功能
+- **文件选择器集成测试**: 验证与 `FileSelector` 组件的集成,包括商品主图和轮播图上传功能
 - **搜索过滤测试**: 验证搜索和过滤功能正常工作
 - **表单验证测试**: 验证表单验证和错误处理
 - **API集成测试**: 验证与商品模块的API集成
@@ -162,6 +166,7 @@ Draft
 | 日期 | 版本 | 描述 | 作者 |
 |------|------|------|------|
 | 2025-11-16 | 1.0 | 初始故事创建,包含pnpm install任务 | Bob (Scrum Master) |
+| 2025-11-16 | 1.1 | 添加对文件管理UI包中FileSelector组件的依赖 | John (PM) |
 
 ## Dev Agent Record