Răsfoiți Sursa

docs(story): 更新011.001故事文档以反映mini-ui-packages拆分架构

- 更新UI组件使用说明,说明基础UI组件来自独立的UI包
- 重写文件位置部分,描述当前mini-ui-packages架构
- 添加架构变更说明章节,说明拆分背景和影响
- 在实施总结中添加注释,说明组件重构到UI包的情况
- 更新变更日志记录本次更新

🤖 Generated with [Claude Code](https://claude.com/claude-code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
yourname 4 săptămâni în urmă
părinte
comite
9050df6ae6
1 a modificat fișierele cu 44 adăugiri și 8 ștergeri
  1. 44 8
      docs/stories/011.001.story.md

+ 44 - 8
docs/stories/011.001.story.md

@@ -100,20 +100,49 @@
 - 统计卡片:圆角12px,阴影 `box-shadow: 0 2px 8px rgba(0, 0, 0, 0.05)`,padding 16px
 
 **UI组件开发**:
-- **独立开发小程序UI组件**:基于原型文件`docs/小程序原型/yongren.html`独立设计开发小程序UI组件
-- **复用现有小程序通用组件**:复用mini项目中已有的通用UI组件(如登录注册相关组件),只修改样式,保持核心认证逻辑不变
-- **注意**:史诗011针对mini小程序,UI组件应独立设计,而非复用管理后台的`@d8d/allin-*`系列UI包
+- **基础UI组件包**:`@d8d/mini-shared-ui-components` - 提供基础UI组件如PageContainer、UserStatusBar等
+- **业务UI组件包**:`@d8d/yongren-shared-ui` - 提供业务专用组件如YongrenTabBarLayout
+- **注意**:史诗011针对mini小程序,UI组件已拆分为独立的mini-ui-packages,实现模块化和代码复用
+- **桥接模式**:mini项目中保留桥接文件,从UI包导入实际组件,确保路由兼容性
 
 ### 文件位置
-**mini项目结构**:
-- `mini/src/api.ts` - API客户端主文件,需要扩展
-- `mini/src/pages/` - 页面组件目录,需要新增用人方小程序页面
-- `mini/src/layouts/` - 布局组件目录,可添加标签栏布局
-- `mini/src/components/` - 公共组件目录,可添加基础布局组件
+**当前架构(已按mini-ui-packages拆分)**:
+
+**基础UI包**:
+- **包名称**:`@d8d/mini-shared-ui-components`(位于`mini-ui-packages/mini-shared-ui-components/`)
+  - `src/components/page-container.tsx` - 页面容器组件
+  - `src/components/user-status-bar.tsx` - 用户状态栏组件
+  - `src/components/navbar.tsx` - 导航栏组件
+  - `src/components/tab-bar.tsx` - 标签栏组件
+  - 以及其他基础UI组件(button、card、dialog、form、input等)
+
+**业务UI包**:
+- **包名称**:`@d8d/yongren-shared-ui`(位于`mini-ui-packages/yongren-shared-ui/`)
+  - `src/components/YongrenTabBarLayout.tsx` - 用人方小程序底部导航布局组件
+
+**桥接文件位置**(在mini项目中):
+- `mini/src/api.ts` - API客户端主文件(保持不变)
+- `mini/src/app.config.ts` - 路由配置(保持不变)
+- 页面组件桥接文件:在mini项目中保留桥接文件,从UI包导入实际组件
 
 **设计原型位置**:
 - `docs/小程序原型/yongren.html` - 用人方小程序完整原型设计 [来源:docs/prd/epic-011-employer-mini-program-implementation.md#页面功能基于]
 
+### 架构变更说明(mini-ui-packages拆分)
+**背景**:为实现更好的模块化和代码复用,史诗011的UI组件已拆分为独立的mini-ui-packages。
+
+**当前架构**:
+- **基础UI包**:`@d8d/mini-shared-ui-components` - 提供基础UI组件如PageContainer、UserStatusBar、Navbar、TabBar等
+- **业务UI包**:`@d8d/yongren-shared-ui` - 提供业务专用组件如YongrenTabBarLayout
+- **页面UI包**:其他UI包提供具体页面组件(如登录页面、首页、人才管理页面等)
+- **桥接模式**:mini项目中保留桥接文件,从UI包导入实际组件
+
+**影响**:
+- 基础布局组件现在位于独立的UI包中,而非mini项目内
+- 组件导入路径已更新为从UI包导入
+- 测试策略相应调整,UI包内包含单元测试
+- 确保与现有路由配置的兼容性
+
 ### 技术约束
 - **兼容性要求**:现有mini项目功能不受影响(登录、注册、个人资料等)[来源:docs/prd/epic-011-employer-mini-program-implementation.md#兼容性要求]
 - **API客户端模式**:遵循现有`api.ts` RPC客户端模式,新增客户端与原有客户端兼容
@@ -136,6 +165,7 @@
 | 2025-12-18 | 1.2 | 修复测试问题,完成路由配置测试 | James |
 | 2025-12-18 | 1.3 | 优化页面结构:删除重复yongren登录页,改造原有登录页为企业用户登录,统一认证系统,清理注册页面,更新测试 | Claude Code |
 | 2025-12-18 | 1.4 | 修复tabbar使用问题:更新7个企业页面使用YongrenTabBarLayout,改造profile页面为企业账户页;清理无用页面:删除pages/index/和pages/explore/目录,优化路由配置;修复导入导出问题:统一YongrenTabBarLayout导出方式,更新所有页面导入 | Claude Code |
+| 2025-12-20 | 1.5 | 更新文档以反映mini-ui-packages拆分架构:更新UI组件使用说明、文件位置部分,添加架构变更说明 | James(开发工程师) |
 
 ## 开发代理记录
 ### 2025-12-17 开始实施
@@ -230,6 +260,12 @@
 4. **企业用户认证框架**:创建了 `EnterpriseAuthProvider` 和 `useEnterpriseAuth` 钩子,提供了企业用户登录、登出、状态管理功能,并创建了权限检查框架。
 5. **基础测试**:创建了API客户端测试、路由配置测试和布局组件测试,现有功能回归测试通过。
 
+**注意**:上述布局组件和企业认证框架后来被重构到独立的mini-ui-packages中:
+- 基础UI组件(PageContainer、UserStatusBar等)现在位于 `@d8d/mini-shared-ui-components` 包
+- 业务UI组件(YongrenTabBarLayout)现在位于 `@d8d/yongren-shared-ui` 包
+- 企业认证框架现在位于 `@d8d/mini-enterprise-auth-ui` 包
+- 页面组件现在位于对应的UI包中,mini项目中保留桥接文件
+
 **验收标准完成情况:**
 - [x] AC1:allin系统模块及史诗012补充API的RPC客户端成功集成到 `mini/src/api.ts`
 - [x] AC2:用人方小程序的路由结构配置完成,支持页面导航