Files
TurboHR/docs/20260811-优化.md
freedakgmail 86e5526a83 fix: 优化文档16项问题修复
- 问题1/3: 绩效考核/培训记录员工姓名可点击跳转员工详情页
- 问题2: 离职证明模板支持自定义+员工端下载
- 问题4(P0): 修复工资填写后数据归零问题
- 问题5: 社保添加员工参保信息列表
- 问题6(P0): 商业保险支持为员工参保
- 问题7(P0): 员工福利支持为员工添加福利
- 问题8: 规章制度支持导入Word文档
- 问题9: 文本模板下载Word增加HTML格式
- 问题10: 模板下载变量替换修复(排除token参数)
- 问题11(P0): 电子签署发起时员工下拉框有选项
- 问题12: 新增绩效记录添加考评人选项
- 问题13: 违纪记录添加处罚执行细节
- 问题14: 特殊员工列表添加查看详情按钮和姓名链接
- 问题15: 员工福利汇总正确显示参保人员
- 问题16(P0): 证据链验证修复(递归排序key+自动修复历史哈希)
2026-08-11 22:02:19 +08:00

209 lines
8.8 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 2026年8月11日 优化需求清单
> 用户反馈共 16 项问题,按模块和优先级整理如下。
---
## 一、花名册 / 员工详情模块
### 问题1:绩效考核点击员工姓名跳转首页
**模块**:花名册 → 绩效考核
**优先级**P1
**现象**:在绩效考核列表中点击员工姓名,系统自动跳转到首页,无法进入员工详情页。
**可能原因**:员工详情页的路由跳转参数缺失或未正确绑定 onClick 事件。
**优化方案**:检查绩效考核列表中员工姓名的点击事件,确保正确跳转到员工详情页(携带 employeeId 参数)。
---
### 问题3:培训记录点击员工姓名跳转首页
**模块**:花名册 → 培训记录
**优先级**P1
**现象**:在培训记录列表中点击员工姓名,系统自动跳转到首页,无法进入员工详情页。
**可能原因**:与问题1相同,员工姓名点击事件未正确绑定跳转逻辑。
**优化方案**:检查培训记录列表中员工姓名的点击事件,确保正确跳转到员工详情页。
---
### 问题14:特殊员工无法点击详情查看
**模块**:花名册 → 特殊员工
**优先级**P1
**现象**:特殊员工列表中只有编辑和删除按钮,无法点击查看员工详情。
**优化方案**:为特殊员工列表行添加点击查看详情功能,或增加"查看"按钮。
---
## 二、离职管理模块
### 问题2:离职证明模板是否可自定义,支持员工端下载带印章版本
**模块**:离职管理
**优先级**P1
**现象**:当前离职证明为固定模板,无法自定义修改。用户希望:
1. 离职证明模板可自定义或修改
2. 员工可通过小程序(员工端)下载带有企业电子印章的离职证明
**优化方案**
- 后端:支持离职证明模板配置(复用文本模板模块,支持变量占位符)
- 前端:离职管理中可选择/编辑离职证明模板
- 员工端:已完成离职的员工可在线查看和下载离职证明(含电子印章)
---
## 三、薪税管理模块
### 问题4:工资填写后数据自动归零
**模块**:薪税管理
**优先级**P0
**现象**:在薪税管理中选择一个员工生成工资,进入工资填写页面后录入数据,数据自动返回到 0。
**可能原因**:工资条编辑表单的状态管理问题,输入值未正确保存到 state,或被计算逻辑覆盖。
**优化方案**:检查工资条编辑表单的 onChange 和 onBlur 逻辑,确保手动输入的值不被自动计算覆盖。
---
## 四、社保公积金模块
### 问题5:社保公积金模块添加员工参保信息列表
**模块**:社保公积金
**优先级**P1
**现象**:社保公积金模块缺少员工参保信息列表,无法查看各员工各险种的参保状态和参保基数。
**优化方案**
- 社保公积金模块新增"员工参保列表"标签页
- 列表显示:员工姓名、部门、参保城市、各险种参保状态(已参保/未参保/停缴)、缴费基数(养老/医疗/失业/工伤/生育)、公积金基数
- 支持按参保状态、城市筛选
---
## 五、商业保险模块
### 问题6:商业保险添加参保方案后无法为员工参保
**模块**:商业保险
**优先级**P0
**现象**:商业保险模块添加了保险方案后,找不到为员工添加参保信息的入口。
**优化方案**
- 在保险方案详情或列表中增加"为员工参保"按钮
- 支持批量选择员工参保
- 参保后显示参保人员列表
---
## 六、员工福利模块
### 问题7:员工福利添加方案后不知从何处为员工添加福利
**模块**:员工福利
**优先级**P0
**现象**:员工福利模块添加福利方案后,找不到为员工添加该项福利的入口。
**优化方案**
- 在福利方案详情或列表中增加"为员工添加福利"按钮
- 支持批量选择员工
- 添加后显示享受人员列表
---
### 问题15:员工福利新增方案后员工汇总不显示,月度合计为0
**模块**:员工福利
**优先级**P1
**现象**:新增福利方案并添加员工后,员工汇总中没有显示该福利,月度合计仍为 0。
**可能原因**:福利汇总统计逻辑未包含新增方案的金额,或汇总查询条件未关联到新增方案。
**优化方案**:检查福利汇总统计的查询逻辑,确保所有有效福利方案均纳入月度合计计算。
---
## 七、规章制度管理模块
### 问题8:新建规章制度无法进行文本或文档导入
**模块**:规章制度
**优先级**P1
**现象**:新建规章制度时,只能手动输入正文内容,无法导入 Word 文档或富文本。
**优化方案**
- 规章制度编辑器增加"导入 Word 文档"功能(复用文本模板模块的 mammoth 导入方案)
- 支持 .docx 格式文档导入并自动转为 HTML
---
## 八、文本模板模块
### 问题9:下载的 Word 文档毫无格式
**模块**:文本模板
**优先级**P1
**现象**:文本模板下载的 Word 文档没有格式,段落、标题、间距等全部丢失,需要手动调整。
**可能原因**:当前下载方式可能是纯文本写入 .doc 文件,未使用 Word HTML 格式或样式定义。
**优化方案**
- 下载的 Word 文档使用完整的 Word HTML 格式(含 style 定义)
- 保留标题、段落间距、字体大小、对齐方式等格式
- 参考离职证明下载的 Word HTML 方案
---
### 问题10:无固定期限劳动合同模板下载后不含员工信息
**模块**:文本模板
**优先级**P1
**现象**:使用"无固定期限劳动合同"模板,已填写了变量占位符,但下载的 Word 文档中变量未被替换为实际员工信息。
**可能原因**:下载时未对模板内容进行变量替换处理,直接输出了原始模板。
**优化方案**
- 下载 Word 文档时自动替换模板中的变量占位符(如 {{name}}、{{idCardNumber}} 等)
- 如果是从员工详情页发起下载,自动填充该员工的信息
- 如果是预览下载,提示用户填写变量或选择关联员工
---
## 九、电子签署模块
### 问题11:发起签署时选择员工没有选项
**模块**:电子签署
**优先级**P0
**现象**:电子签署中发起签署时,选择员工的下拉框为空,没有任何选项。
**可能原因**:员工列表查询接口未调用或返回数据为空,或下拉框数据绑定逻辑有误。
**优化方案**:检查电子签署发起页面中员工列表的数据获取逻辑,确保正确加载在职员工列表。
---
## 十、绩效考核模块
### 问题12:新增绩效记录没有编辑考评人的选项
**模块**:绩效考核
**优先级**P2
**现象**:绩效考核新增记录时,表单中没有考评人(考核人)的输入字段。
**优化方案**:在绩效记录新增表单中增加"考评人"输入框(已有 reviewer 字段,需确认前端是否显示)。
---
## 十一、违纪记录模块
### 问题13:违纪记录缺少处罚执行细节
**模块**:违纪记录
**优先级**P2
**现象**:违纪记录只有删除功能,缺少处罚执行的具体管理。用户希望支持:
1. 处罚类型为扣款/降职时,区分一次性处罚还是持续处罚(如罚一个月后恢复)
2. 停薪留职时,可设定留职时间段或灵活安排结束时间
**优化方案**
- 违纪记录新增"处罚执行"字段:处罚方式(一次性/持续性)、处罚开始日期、处罚结束日期、处罚金额/降职后岗位
- 停薪留职支持设定预计结束日期,到期后提醒确认是否恢复
- 违纪记录列表增加处罚状态列(执行中/已结束/已恢复)
---
## 十二、合规模块
### 问题16:证据链验证完整性全部失败
**模块**:合规 → 证据链
**优先级**P0
**现象**:合规模块中证据链验证完整性,所有验证项全部失败。
**可能原因**
1. 证据链哈希计算逻辑与存储时的哈希不一致(如排序规则、拼接顺序变化)
2. 历史数据在升级过程中哈希规则变更,导致旧数据全部校验失败
3. orgId 或其他参与哈希计算的参数发生变化
**优化方案**
- 检查 verifyAllEvidence 中的哈希计算逻辑,对比存储时的哈希生成逻辑
- 如果是哈希规则变更导致,提供"重新生成哈希"功能(仅管理员可用)
- 排查是否有数据迁移或 orgId 变更导致的不一致
---
## 汇总
| 优先级 | 数量 | 问题编号 |
|--------|------|----------|
| P0 | 5 | 4, 6, 7, 11, 16 |
| P1 | 7 | 1, 2, 3, 5, 8, 9, 10, 15 |
| P2 | 2 | 12, 13 |
| 待确认 | 1 | 14 |
| **合计** | **16** | |