TurboHR/20260723-优化-3.md

劳动用工合规 SaaS — 功能层面优化清单

文档编号: 20260723-优化-3.md 日期: 2026-07-23 来源: 对 Money.tsx、Termination.tsx、SocialInsurance.tsx、Roster.tsx 四个核心业务页面深入研究后得出

---

一、高优先级（核心业务缺陷）

1. Money — 发薪批次创建后无法重命名

现状: 批次列表只显示自动生成的名称（如"2026-01 第1批 发薪"），创建后名称固定不可修改。当企业有多个批次（按部门/按职级分批发薪）时，列表难以区分。

建议:

• 后端：PUT /payroll2/batches/:id 支持更新 name 字段
• 前端：在 BatchDetail 右上角增加「重命名」按钮，弹出编辑框修改批次名称

涉及文件: backend/src/routes/payroll2.routes.ts、frontend/src/pages/Money.tsx

---

2. Termination — 费用计算与表单完全割裂

现状: costResult 是纯前端 useMemo 计算，但编辑表单字段（解聘日期、解聘原因）时不会实时触发重算。用户必须切到 Step 4 才能看到费用变化，导致操作反馈链路过长。

建议:

• 将 costResult 的依赖项（terminationDate、socialAvgWage、reason）用 useEffect 驱动，每次表单变更实时展示费用预览
• 在 Step 1（选择员工）和 Step 2（解聘方式）之间增加一个「实时费用预览区」，显示经济补偿金、赔偿金、代通知金的大致金额，降低误操作风险

涉及文件: frontend/src/pages/Termination.tsx

---

3. Termination — 模拟计算结果被静默覆盖

现状: handleSimulate 只将数据存入本地 state savedItems，costResult 依赖的是表单实时值。当用户修改参数后，之前的模拟结果会被静默覆盖，无法对比不同参数下的补偿金额。

建议:

• savedItems 每条记录增加 version 字段和 isSimulated: boolean 标记
• 每次模拟生成新版本而非覆盖，用户可在右侧列表查看多个版本的对比
• 模拟结果与实际保存结果分开展示，避免混淆

涉及文件: frontend/src/pages/Termination.tsx

---

4. Roster — 批量续签无合规预检

现状: 批量续签直接提交 contractIds，无任何预览或合规检查。用户可能对已连续签订两次固定期限合同的员工续签固定期（法律上应签无固定期限）。

建议:

• 选择员工后，先调用后端接口 GET /employees/contracts/preview-renew 返回每个员工的合规提示
• 展示预览列表：每个员工一行，显示「可续签固定期」或「应签无固定期限（已连续签订X次）」等提示
• 用户确认后再提交，避免法律风险

涉及文件: frontend/src/pages/Roster.tsx、backend/src/routes/employee.routes.ts

---

5. SocialInsurance — 社保基数调整只能一次性操作

现状: adjustmentDone 标志为 true 后无法再次调整基数。但实践中基数可能需要多次修正（员工投诉、基数算错、重新申报）。

建议:

• 增加「重置调整」接口 POST /social/config/:id/reset-adjustment，允许管理员撤销本次调整重新来过
• 或改为记录每次调整的版本历史，支持查看历史调整记录

涉及文件: backend/src/routes/social.routes.ts、frontend/src/pages/SocialInsurance.tsx

---

二、中优先级（高频操作体验）

6. Roster — 员工搜索无分页、无法多选过滤

现状: 花名册仅支持姓名/部门 substring 搜索，无分页和高级过滤。添加人员到批次时取 pageSize: 100，超过 100 人就覆盖不全。

建议:

• 花名册搜索增加状态过滤（在职/预入职/离职）、合同状态过滤（正常/即将到期/已过期/未签合同）、合同到期时间范围过滤
• 添加人员到批次改为服务端搜索，支持分页 + 关键词搜索 + 多选，超 100 人场景也能覆盖

涉及文件: frontend/src/pages/Roster.tsx、backend/src/routes/roster.routes.ts、backend/src/routes/payroll2.routes.ts

---

7. Money — 批次列表无月份范围筛选

现状: 只有单月筛选，企业要查看历史所有批次只能逐月切换，且无状态（草稿/归档）过滤。

建议:

• 批次列表增加月份范围选择器（开始月份 ~ 结束月份）
• 增加状态过滤（全部/草稿/已归档）
• 增加批次类型过滤（全部/常规发薪/离职结算/年终奖/补偿金）

涉及文件: frontend/src/pages/Money.tsx、backend/src/routes/payroll2.routes.ts

---

8. Termination — 无批量解聘能力

现状: 只能逐个处理。当企业裁员时（如一次性解除 20 人），需重复操作 20 次，体验极差。

建议:

• 在「解聘补偿」页面增加「批量解聘」入口
• 选择员工后批量填写共性参数（解聘日期、解聘原因、社保截止月份），差异项（补偿金金额）可逐个补充或批量默认
• 批量提交后统一生成解聘记录和调薪批次

涉及文件: frontend/src/pages/Termination.tsx、backend/src/services/termination.service.ts

---

9. Roster — 合同到期预警机制缺失

现状: 花名册表头显示合同状态标签（expiring、expired），但系统无主动预警。用户需主动逐个查看。

建议:

• Dashboard 增加合同到期预警卡片，显示 30 天内到期、60 天内到期、90 天内到期的员工数量
• 点击卡片跳转花名册，预设筛选条件为「合同到期时间 ≤ N 天」
• Roster 列表页增加「合同到期时间」列，支持按到期时间排序

涉及文件: frontend/src/pages/Dashboard.tsx、frontend/src/pages/Roster.tsx、backend/src/routes/roster.routes.ts

---

10. Money — 无工资条税率试算预览

现状: PayslipManager 只能从批次汇总生成工资条，无法单独查看某员工的个税明细和实发金额分解。

建议:

• 在批次详情页或员工 profile 的 payslip tab 中，增加「税率试算」功能
• 展示个税计算过程：应发金额 → 社保公积金扣除 → 个税起征点扣除 → 应纳税所得额 → 税率/速算扣除数 → 个税 → 实发金额
• 支持单员工试算，不依赖批次

涉及文件: frontend/src/pages/Money.tsx、frontend/src/pages/Roster.tsx、backend/src/services/payroll.service.ts

---

三、低优先级（功能补全）

11. SocialInsurance — 仅支持北京配置，无多城市扩展

现状: newVersion 硬编码北京配置，版本历史中城市字段存在但无人使用。

建议:

• 后续扩展多城市时，社保配置表增加 cityCode 字段
• 版本历史按城市分组展示
• 城市列表可配置（新增城市配置时自动出现在下拉）

涉及文件: backend/prisma/schema.prisma、frontend/src/pages/SocialInsurance.tsx

---

12. Termination — 离职与解聘入口分离不清晰

现状: ResignModal（员工主动离职）和解聘向导（公司主导）是两套流程，但在同一个「解聘补偿」模块中容易让用户困惑。

建议:

• 在 Step 1 员工选择后，优先展示「员工主动离职」vs「公司解聘」两个入口
• 选择「主动离职」则弹出简化版离职表单（仅需离职日期和原因）
• 选择「公司解聘」则进入完整解聘向导

涉及文件: frontend/src/pages/Termination.tsx、frontend/src/pages/Roster.tsx

---

13. Roster — 员工附件上传无预览

现状: 合同扫描件以 DataURL 形式存储，无文件大小校验，无 PDF/Word 在线预览。

建议:

• 附件上传增加文件类型限制（仅 PDF/图片）和大小限制（最大 10MB）
• 员工 profile 附件 tab 增加文件预览功能（图片直接显示，PDF 用 iframe 或第三方预览组件）
• 上传前显示文件大小提示

涉及文件: frontend/src/pages/Roster.tsx

---

14. Money — 加班费 CSV 导入无批量编辑

现状: CSV 导入后只能整体确认，无法逐条修改导入数据中的工时数值。

建议:

• 导入预览阶段支持逐行编辑工时数据（工作日/休息日/节假日小时数）
• 增加「校验」按钮，对齐员工姓名未匹配的记录高亮提示
• 支持从预览中删除不需要的记录

涉及文件: frontend/src/pages/Money.tsx（OvertimeCalculator 组件）

---

四、优先级总览

优先级	编号	功能	工作量
P0	1	发薪批次重命名	小
P0	2	费用计算实时预览	中
P0	4	批量续签合规预检	中
P0	5	社保基数调整可重复操作	小
P1	3	模拟计算版本管理	小
P1	6	员工搜索分页+多选过滤	中
P1	7	批次列表范围筛选	小
P1	8	批量解聘	大
P1	9	合同到期预警	中
P1	10	工资条税率试算	中
P2	12	离职/解聘入口分离	小
P2	13	附件上传预览	中
P2	14	加班费导入批量编辑	中
P3	11	多城市社保配置	大