2
0
Эх сурвалжийг харах

docs(story): 根据原型对比分析为011.003补充缺失功能任务

- 添加任务7:实现历史工作内容时间线
- 添加任务8:实现工作视频管理
- 添加任务9:添加详情页操作按钮
- 更新组件规范详细说明原型功能
- 添加原型对比分析章节

🤖 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 долоо хоног өмнө
parent
commit
557630f178

+ 60 - 0
docs/stories/011.003.story.md

@@ -51,6 +51,21 @@ Ready for Review
   - [x] 编写详情页数据展示测试
   - [x] 测试多模块API集成
   - [x] 验证与基础框架的集成
+- [ ] 任务7:实现历史工作内容时间线(原型增强功能)
+  - [ ] 集成企业专用工作历史API获取完整工作经历
+  - [ ] 实现时间线布局展示历史工作记录
+  - [ ] 展示每段工作的公司、岗位、薪资、时间段、工作描述
+  - [ ] 区分当前工作和历史工作的视觉样式
+- [ ] 任务8:实现工作视频管理(原型增强功能)
+  - [ ] 集成视频文件管理API(如需新API则需后端支持)
+  - [ ] 展示视频类型分类:个税视频、工资视频、工作视频
+  - [ ] 实现视频预览和下载功能
+  - [ ] 添加视频上传功能(如有权限)
+- [ ] 任务9:添加详情页操作按钮(原型增强功能)
+  - [ ] 在详情页底部添加固定操作按钮区域
+  - [ ] 实现"联系"按钮功能(跳转或拨打电话)
+  - [ ] 实现"编辑"按钮功能(跳转编辑页面或弹出编辑表单)
+  - [ ] 确保按钮样式符合原型设计
 
 ## 开发笔记
 
@@ -79,6 +94,26 @@ Ready for Review
   - **企业专用API客户端**:`enterpriseDisabilityClient`已集成到API客户端
 - **访问控制**:人才管理功能需要用户登录后才能访问,可使用`useRequireAuth`钩子进行权限保护
 
+### 原型对比与增强功能说明
+**原型对比分析**:通过对比原型文件 `docs/小程序原型/yongren.html` 和实际代码实现,发现以下差异:
+
+**核心功能已完整实现**(对应验收标准1-5):
+1. 人才列表页:搜索、筛选、分页、卡片展示 ✓
+2. 人才详情页:基本信息、工作信息、薪资信息、个人征信文件 ✓
+3. 薪资历史查看:表格展示、趋势图表 ✓
+4. 页面设计:严格对照原型第419-560行(列表页)和第561-864行(详情页) ✓
+
+**原型包含但当前未实现的功能**(已添加为增强任务):
+1. **历史工作内容时间线**(原型第673-739行):时间线展示完整工作经历 → **任务7**
+2. **工作视频管理**(原型第765-829行):个税视频、工资视频、工作视频管理 → **任务8**
+3. **详情页操作按钮**(原型第831-839行):底部"联系"和"编辑"按钮 → **任务9**
+4. **薪资信息展示差异**:原型简化显示(仅当前月薪+历史按钮),实现扩展显示(更多字段) → **已在组件规范中说明**
+
+**实施建议**:
+- 核心验收标准已全部满足,故事状态保持"Ready for Review"
+- 新增任务7-9作为原型增强功能,可根据优先级安排后续实现
+- 如需要严格遵循原型设计,可考虑简化薪资信息展示
+
 ### 架构变更说明(mini-ui-packages拆分)
 **背景**:为实现更好的模块化和代码复用,史诗011的UI组件已拆分为独立的mini-ui-packages。
 
@@ -373,6 +408,30 @@ Ready for Review
 - 标题:`<h3 class="font-semibold text-gray-700 mb-3">薪资信息</h3>`
 - 列表布局:类似工作信息卡片
 - 字段包括:当前薪资、薪资结构、发薪日、薪资历史等
+- **注意:原型与实现差异**:原型中薪资信息卡片仅显示当前月薪和"薪资历史"按钮。实际实现根据故事需求扩展了更多字段(薪资结构、发薪日、薪资周期等),并单独实现了薪资历史记录表格。如需要严格遵循原型设计,可考虑简化展示。
+
+**历史工作内容时间线**(原型第673-739行):
+- **当前状态**:已添加为任务7(原型增强功能),待实现
+- **容器**:`card bg-white p-4 mb-4`
+- **标题**:`<h3 class="font-semibold text-gray-700 mb-3">历史工作内容</h3>`
+- **时间线布局**:垂直时间线展示工作经历
+- **每段工作展示**:公司名称、岗位、薪资、时间段、工作描述
+- **视觉区分**:当前工作使用蓝色圆点,历史工作使用灰色圆点
+- **数据源**:使用企业专用工作历史API获取完整工作经历
+
+**工作视频管理区域**(原型第765-829行):
+- **当前状态**:已添加为任务8(原型增强功能),待实现
+- **容器**:`card bg-white p-4 mb-4`
+- **标题**:`<h3 class="font-semibold text-gray-700">工作视频</h3>`,右侧有"查看更多"链接
+- **视频分类**:个税视频、工资视频、工作视频
+- **每项视频**:图标、标题、上传时间、预览和下载按钮
+- **数据源**:可能需要扩展文件管理API支持视频分类
+
+**详情页操作按钮**(原型第831-839行):
+- **当前状态**:已添加为任务9(原型增强功能),待实现
+- **容器**:`flex space-x-3`,底部固定按钮区域
+- **按钮1**:`flex-1 bg-blue-500 text-white py-3 rounded-lg font-medium`,图标`<i class="fas fa-phone mr-2"></i>`,文本"联系"
+- **按钮2**:`flex-1 bg-gray-100 text-gray-800 py-3 rounded-lg font-medium`,图标`<i class="fas fa-edit mr-2"></i>`,文本"编辑"
 
 **个人征信文件区域**(原型中可能在其他位置):
 - 文件列表展示,支持预览和下载
@@ -479,6 +538,7 @@ Ready for Review
 | 2025-12-18 | 1.9 | 更新API规范:添加企业专用残疾人才API和依赖故事012.011 | Claude Code |
 | 2025-12-19 | 1.10 | 修复人才详情页API使用:改用enterpriseDisabilityClient企业专用API,修复RPC客户端路径参数语法 | Claude Code |
 | 2025-12-20 | 1.11 | 更新文档以反映mini-ui-packages拆分后的实际情况:更新文件位置、组件规范,添加架构变更说明 | James(开发工程师) |
+| 2025-12-20 | 1.12 | 根据原型对比分析,补充缺失功能任务:添加任务7-9实现历史工作内容时间线、工作视频管理和详情页操作按钮,更新组件规范和原型对比说明 | James(开发工程师) |
 
 ## 开发代理记录