Просмотр исходного кода

📝 docs(story): 更新人才UI包开发配置和脚本说明

- 在验收标准中添加每个UI包必须包含`dev: "tsc --watch"`脚本的要求
- 更新任务3标题,明确包含开发脚本配置
- 在任务3中新增3.6步骤,详细说明每个UI包必须配置的scripts脚本,特别是`dev`脚本用于TypeScript编译监视
- 新增任务9:配置开发服务器并行启动,详细说明根目录package.json中如何添加rencai系列UI包的开发脚本
- 更新`dev:mini-ui-packages`脚本配置,将rencai系列UI包添加到concurrently并行命令中
- 在项目结构说明中新增“根目录package.json脚本配置”部分,展示完整的开发服务器启动配置
- 强调每个UI包的`dev`脚本使用`tsc --watch`,在开发时自动编译TypeScript文件
yourname 3 недель назад
Родитель
Сommit
6b99391a4c
1 измененных файлов с 87 добавлено и 3 удалено
  1. 87 3
      docs/stories/017.001.story.md

+ 87 - 3
docs/stories/017.001.story.md

@@ -57,12 +57,16 @@
 - [ ] exports字段包含页面组件的导出路径(如`"./pages/LoginPage/LoginPage"`)
 - [ ] 参照yongren-dashboard-ui的package.json格式
 - [ ] 正确配置workspace依赖关系
+- [ ] 每个UI包包含dev脚本: `"dev": "tsc --watch"` 用于TypeScript编译监视
 
 ### 项目集成
 - [ ] mini-talent项目的路由结构配置完成,支持页面导航
 - [ ] 页面组件使用exports配置的完整路径导入: `import LoginPage from '@d8d/rencai-auth-ui/pages/LoginPage/LoginPage'`
 - [ ] 基础布局组件(状态栏、底部导航、页面容器)可用并符合移动端设计
 - [ ] 人才用户认证框架就绪,支持后续登录页面集成
+- [ ] 根目录package.json配置了rencai系列UI包的开发脚本
+- [ ] `dev:mini-ui-packages`脚本包含所有rencai UI包的并行编译监视
+- [ ] `pnpm run dev`命令能够正常启动所有服务,包括rencai UI包的编译监视
 
 ### 兼容性验证
 - [ ] 现有mini-talent项目功能不受影响
@@ -108,7 +112,7 @@
   // 不再导出任何内容,所有工具和组件通过具体路径导入
   ```
 
-### 任务3: 配置每个UI包的package.json和Jest配置 (AC: package.json配置)
+### 任务3: 配置每个UI包的package.json、Jest配置和开发脚本 (AC: package.json配置)
 - [ ] 3.1 参照`yongren-dashboard-ui/package.json`创建每个UI包的package.json
 - [ ] 3.2 配置包名称为`@d8d/rencai-<name>-ui`
 - [ ] 3.3 配置exports字段,支持以下导出路径:
@@ -124,10 +128,22 @@
   - `@tarojs/plugin-platform-weapp`: "4.1.4"
   - `@tarojs/react`: "4.1.4"
   - `@tarojs/taro`: "4.1.4"
-- [ ] 3.6 配置测试相关依赖:
+- [ ] 3.6 配置scripts脚本 (必须包含以下脚本):
+  ```json
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage"
+  }
+  ```
+  **重要**: `dev`脚本使用`tsc --watch`,用于开发时监视TypeScript文件变化并自动编译
+- [ ] 3.7 配置测试相关依赖:
   - devDependencies中添加: `"@d8d/mini-testing-utils": "workspace:*"`
   - 其他测试依赖: `jest`, `ts-jest`, `@testing-library/react`, 等
-- [ ] 3.7 创建`jest.config.cjs`配置文件,参照`yongren-dashboard-ui/jest.config.cjs`:
+- [ ] 3.8 创建`jest.config.cjs`配置文件,参照`yongren-dashboard-ui/jest.config.cjs`:
   ```javascript
   module.exports = {
     preset: 'ts-jest',
@@ -195,6 +211,41 @@
 - [ ] 8.4 验证mini-talent项目现有功能不受影响
 - [ ] 8.5 运行`pnpm typecheck`确保类型检查通过
 
+### 任务9: 配置开发服务器并行启动 (AC: 项目集成)
+- [ ] 9.1 在根目录`package.json`的`scripts`中添加rencai系列UI包的开发脚本:
+  ```json
+  "dev:rencai-dashboard-ui": "pnpm --filter \"@d8d/rencai-dashboard-ui\" run dev",
+  "dev:rencai-auth-ui": "pnpm --filter \"@d8d/rencai-auth-ui\" run dev",
+  "dev:rencai-personal-info-ui": "pnpm --filter \"@d8d/rencai-personal-info-ui\" run dev",
+  "dev:rencai-attendance-ui": "pnpm --filter \"@d8d/rencai-attendance-ui\" run dev",
+  "dev:rencai-employment-ui": "pnpm --filter \"@d8d/rencai-employment-ui\" run dev",
+  "dev:rencai-settings-ui": "pnpm --filter \"@d8d/rencai-settings-ui\" run dev",
+  "dev:rencai-shared-ui": "pnpm --filter \"@d8d/rencai-shared-ui\" run dev"
+  ```
+- [ ] 9.2 更新`dev:mini-ui-packages`脚本,将rencai系列UI包添加到concurrently命令中:
+  ```json
+  "dev:mini-ui-packages": "concurrently \
+    \"pnpm run dev:dev:allin-enums\" \
+    \"pnpm run dev:mini-enterprise-auth-ui\" \
+    \"pnpm run dev:mini-shared-ui-components\" \
+    \"pnpm run dev:yongren-shared-ui\" \
+    \"pnpm run dev:yongren-dashboard-ui\" \
+    \"pnpm run dev:yongren-order-management-ui\" \
+    \"pnpm run dev:yongren-settings-ui\" \
+    \"pnpm run dev:yongren-statistics-ui\" \
+    \"pnpm run dev:yongren-talent-management-ui\" \
+    \"pnpm run dev:mini-charts\" \
+    \"pnpm run dev:rencai-shared-ui\" \
+    \"pnpm run dev:rencai-dashboard-ui\" \
+    \"pnpm run dev:rencai-auth-ui\" \
+    \"pnpm run dev:rencai-personal-info-ui\" \
+    \"pnpm run dev:rencai-attendance-ui\" \
+    \"pnpm run dev:rencai-employment-ui\" \
+    \"pnpm run dev:rencai-settings-ui\""
+  ```
+- [ ] 9.3 验证`pnpm run dev`命令能够正常启动所有服务,包括rencai系列UI包的编译监视
+- [ ] 9.4 确认rencai系列UI包的TypeScript编译输出正确,无编译错误
+
 ## 开发者笔记
 
 ### 前置故事见解
@@ -450,6 +501,39 @@ mini-ui-packages/
 └── rencai-shared-ui/          # [待创建] 人才共享组件
 ```
 
+**根目录package.json脚本配置:**
+
+开发服务器启动使用concurrently并行运行所有服务的编译监视:
+```json
+{
+  "scripts": {
+    "dev": "concurrently \
+      \"pnpm run dev:mini\" \
+      \"pnpm run dev:mini-talent\" \
+      \"pnpm run dev:web\" \
+      \"pnpm run dev:weapp\" \
+      \"pnpm run dev:weapp-talent\" \
+      \"pnpm run dev:mini-ui-packages\" ",
+
+    "dev:mini-ui-packages": "concurrently \
+      [... existing yongren packages ...] \
+      \"pnpm run dev:rencai-shared-ui\" \
+      \"pnpm run dev:rencai-dashboard-ui\" \
+      \"pnpm run dev:rencai-auth-ui\" \
+      \"pnpm run dev:rencai-personal-info-ui\" \
+      \"pnpm run dev:rencai-attendance-ui\" \
+      \"pnpm run dev:rencai-employment-ui\" \
+      \"pnpm run dev:rencai-settings-ui\"",
+
+    "dev:rencai-dashboard-ui": "pnpm --filter \"@d8d/rencai-dashboard-ui\" run dev",
+    "dev:rencai-auth-ui": "pnpm --filter \"@d8d/rencai-auth-ui\" run dev",
+    // ... 其他rencai UI包
+  }
+}
+```
+
+**重要**: 每个UI包的`dev`脚本使用`tsc --watch`,在开发时监视TypeScript文件变化并自动编译到`dist/`目录。
+
 ### 原型设计参考
 
 **来源**: [docs/小程序原型/rencai.html](../小程序原型/rencai.html)