Pārlūkot izejas kodu

📝 docs(story): add reference links for system config UI package tasks

- add component implementation references for all subtasks in system config UI package story
- specify reference files for component structure, API integration and tenant support
- add detailed reference paths for advertisement management components and tests
- update test file structure and test scenarios with specific reference examples
yourname 1 mēnesi atpakaļ
vecāks
revīzija
1bf7db0e74
1 mainītis faili ar 34 papildinājumiem un 26 dzēšanām
  1. 34 26
      docs/stories/010.004.system-config-ui-package.story.md

+ 34 - 26
docs/stories/010.004.system-config-ui-package.story.md

@@ -17,24 +17,24 @@ Draft
 
 ## Tasks / Subtasks
 - [ ] 创建系统配置UI包 (AC: 1)
-  - [ ] 创建系统配置列表页面组件
-  - [ ] 创建系统配置创建/编辑表单组件
-  - [ ] 创建系统配置详情查看组件
-  - [ ] 添加租户筛选器组件
+  - [ ] 创建系统配置列表页面组件 [参照: packages/advertisement-management-ui-mt/src/components/AdvertisementManagement.tsx]
+  - [ ] 创建系统配置创建/编辑表单组件 [参照: packages/advertisement-management-ui-mt/src/components/AdvertisementManagement.tsx]
+  - [ ] 创建系统配置详情查看组件 [参照: packages/advertisement-management-ui-mt/src/components/AdvertisementManagement.tsx]
+  - [ ] 添加租户筛选器组件 [参照: packages/advertisement-management-ui-mt/src/components/AdvertisementManagement.tsx]
 - [ ] 集成系统配置UI包到管理后台 (AC: 2)
-  - [ ] 在管理后台路由中添加系统配置页面路由
-  - [ ] 在管理后台菜单中添加系统配置菜单项
-  - [ ] 配置系统配置页面的权限控制
+  - [ ] 在管理后台路由中添加系统配置页面路由 [参照: web/src/client/admin/routes.tsx]
+  - [ ] 在管理后台菜单中添加系统配置菜单项 [参照: web/src/client/admin/menu.tsx]
+  - [ ] 配置系统配置页面的权限控制 [参照: web/src/client/admin/routes.tsx]
 - [ ] 实现系统配置管理功能 (AC: 3, 4)
-  - [ ] 实现系统配置列表查询和分页
-  - [ ] 实现系统配置创建功能
-  - [ ] 实现系统配置编辑功能
-  - [ ] 实现系统配置删除功能
-  - [ ] 实现按租户筛选系统配置
+  - [ ] 实现系统配置列表查询和分页 [参照: packages/advertisement-management-ui-mt/src/components/AdvertisementManagement.tsx]
+  - [ ] 实现系统配置创建功能 [参照: packages/advertisement-management-ui-mt/src/components/AdvertisementManagement.tsx]
+  - [ ] 实现系统配置编辑功能 [参照: packages/advertisement-management-ui-mt/src/components/AdvertisementManagement.tsx]
+  - [ ] 实现系统配置删除功能 [参照: packages/advertisement-management-ui-mt/src/components/AdvertisementManagement.tsx]
+  - [ ] 实现按租户筛选系统配置 [参照: packages/advertisement-management-ui-mt/src/components/AdvertisementManagement.tsx]
 - [ ] 创建系统配置UI包测试 (AC: 5)
-  - [ ] 创建系统配置UI组件单元测试
-  - [ ] 创建系统配置页面集成测试
-  - [ ] 验证现有管理后台功能无回归
+  - [ ] 创建系统配置UI组件单元测试 [参照: packages/advertisement-management-ui-mt/tests/integration/advertisement-management.integration.test.tsx]
+  - [ ] 创建系统配置页面集成测试 [参照: packages/advertisement-management-ui-mt/tests/integration/advertisement-management.integration.test.tsx]
+  - [ ] 验证现有管理后台功能无回归 [参照: packages/advertisement-management-ui-mt/tests/integration/advertisement-management.integration.test.tsx]
 
 ## Dev Notes
 
@@ -84,11 +84,19 @@ Draft
 ### UI包创建策略
 - **包命名**: `system-config-management-ui-mt`
 - **包位置**: 在packages目录下创建
-- **组件结构**: 遵循现有管理后台组件模式
-- **API集成**: 使用Hono RPC客户端,类型安全
-- **租户支持**: 支持多租户筛选和管理
+- **组件结构**: 遵循现有管理后台组件模式 [参照: packages/advertisement-management-ui-mt/src/components/AdvertisementManagement.tsx]
+- **API集成**: 使用Hono RPC客户端,类型安全 [参照: packages/advertisement-management-ui-mt/src/api/advertisementClient.ts]
+- **租户支持**: 支持多租户筛选和管理 [参照: packages/advertisement-management-ui-mt/src/components/AdvertisementManagement.tsx]
 
 ### 关键参考文件路径
+- **广告管理主组件**: `packages/advertisement-management-ui-mt/src/components/AdvertisementManagement.tsx` - 完整的CRUD管理组件参考
+- **广告管理API客户端**: `packages/advertisement-management-ui-mt/src/api/advertisementClient.ts` - Hono RPC客户端实现参考
+- **广告管理类型定义**: `packages/advertisement-management-ui-mt/src/types/advertisement.ts` - TypeScript类型定义参考
+- **广告管理包配置**: `packages/advertisement-management-ui-mt/package.json` - 包依赖和配置参考
+- **广告管理集成测试**: `packages/advertisement-management-ui-mt/tests/integration/advertisement-management.integration.test.tsx` - 完整集成测试参考
+- **广告管理包导出**: `packages/advertisement-management-ui-mt/src/index.ts` - 包导出结构参考
+
+### 系统配置相关参考文件路径
 - **用户管理页面参考**: `web/src/client/admin/pages/Users.tsx`
 - **系统配置服务**: `packages/core-module-mt/system-config-module-mt/src/services/system-config.service.mt.ts`
 - **系统配置路由**: `packages/core-module-mt/system-config-module-mt/src/routes/system-config.routes.mt.ts`
@@ -104,16 +112,16 @@ Draft
 - **覆盖率目标**: 集成测试 ≥ 60%
 
 #### 测试文件结构
-- `packages/system-config-management-ui-mt/tests/unit/` - UI组件单元测试
-- `web/tests/integration/system-config.integration.test.ts` - 系统配置页面集成测试
+- `packages/system-config-management-ui-mt/tests/unit/` - UI组件单元测试 [参照: packages/advertisement-management-ui-mt/tests/integration/advertisement-management.integration.test.tsx]
+- `web/tests/integration/system-config.integration.test.ts` - 系统配置页面集成测试 [参照: packages/advertisement-management-ui-mt/tests/integration/advertisement-management.integration.test.tsx]
 
 #### 测试场景
-- 系统配置列表页面渲染测试
-- 系统配置创建功能测试
-- 系统配置编辑功能测试
-- 系统配置删除功能测试
-- 租户筛选功能测试
-- 现有管理后台功能回归测试
+- 系统配置列表页面渲染测试 [参照: packages/advertisement-management-ui-mt/tests/integration/advertisement-management.integration.test.tsx]
+- 系统配置创建功能测试 [参照: packages/advertisement-management-ui-mt/tests/integration/advertisement-management.integration.test.tsx]
+- 系统配置编辑功能测试 [参照: packages/advertisement-management-ui-mt/tests/integration/advertisement-management.integration.test.tsx]
+- 系统配置删除功能测试 [参照: packages/advertisement-management-ui-mt/tests/integration/advertisement-management.integration.test.tsx]
+- 租户筛选功能测试 [参照: packages/advertisement-management-ui-mt/tests/integration/advertisement-management.integration.test.tsx]
+- 现有管理后台功能回归测试 [参照: packages/advertisement-management-ui-mt/tests/integration/advertisement-management.integration.test.tsx]
 
 ## Change Log
 | Date | Version | Description | Author |