Files
TurboHR/docs/20260811-优化.md
T
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

8.8 KiB
Raw Blame History

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