# TurboHR 更新说明（2026-07-27） 访问地址：**https://on.hr8ai.top/** --- ## 一、社保管理 ### 1. 社保城市选择改下拉框 - 社保配置页面的城市选择从手动输入改为下拉框，可选择已有城市或添加新城市。 ### 2. AI 社保政策建议 - 新增「AI 建议」功能，点击后系统自动获取指定城市和年份的最新社保/公积金政策参数（基数范围、各项比例），一键填充到配置表单中。 ### 3. 社保上下限拆分（三险/医保独立基数） - 养老/失业/工伤保险使用 `baseMin/baseMax` 基数上下限。 - 医疗/生育保险使用独立的 `medicalBaseMin/medicalBaseMax` 基数上下限（为 0 时自动 fallback 到三险基数）。 - 适配河北省等地区三险与医保基数不同的政策。 ### 4. 附加险种模块（大病险/长护险等） - 社保配置新增附加险种动态配置区，支持添加/删除险种行。 - 每个附加险种支持三种计算方式：按养老基数比例、按医保基数比例、固定金额。 - 试算结果中显示附加险种明细。 - 预置河北省大病医疗（固定 5 元）和长期护理险（0.1%）。 ### 5. 公积金试算结果展示修复 - 修复公积金试算结果复用社保 `items.map()` 导致报错的问题。 - 公积金试算结果改为单独渲染（企业/个人缴纳金额、合计）。 ### 6. 预置河北省社保政策 - 系统预置河北省石家庄市社保配置（养老 16%/8%、医疗 8%/2%、失业 0.7%/0.3%、工伤 0.3%、生育 0.5%，基数 3920~19602）。 - 预置公积金配置（12%/12%）。 ### 7. 附加险种显示优化 - 社保配置展示中新增附加险种显示，统一附加险种格式。 --- ## 二、专项附加扣除 ### 1. 按月分项录入 - 新增专项附加扣除按月录入功能，支持五项分项：子女教育、赡养老人、住房贷款、继续教育、婴幼儿照护。 - 每月可独立编辑各项扣除金额，系统自动计算合计并同步到员工档案。 - 个税计算时使用按月实际扣除额，替代之前固定金额 × 月份的方式。 ### 2. 「复制上月」功能 - 专项附加扣除编辑页新增「复制上月」按钮，可一键批量复制上月所有人的专项附加扣除数据，无需逐人填写。 ### 3. 仅显示在保人员 - 专项附加扣除列表只显示当月社保在保人员，避免展示无关人员。 ### 4. 界面优化 - 专项附加扣除 Tab 页隐藏社保配置和试算区域，界面更简洁。 --- ## 三、合同附件 ### 1. 多文件上传 - 合同附件支持一次上传多个文件，可多次追加上传。 - 上传后显示文件名列表，每个文件可单独删除。 ### 2. 支持格式扩展 - 支持的格式：PDF、JPG、PNG、HEIC、GIF、BMP、WebP、TIFF、Word（.doc/.docx）、Excel（.xls/.xlsx）。 - 每个文件最大 10MB。 ### 3. 附件在线预览 - 点击文件名弹出预览窗口： - **图片**：直接在弹窗中显示。 - **PDF**：在弹窗中内嵌预览。 - **Word/Excel 等其他格式**：提示不支持在线预览，可点击下载查看。 - 弹窗顶部提供下载按钮。 ### 4. 标签更名 - 「合同扫描件」统一改为「合同附件」。 - 附件管理中「合同扫描件」类型也改为「合同附件」。 ### 5. 修复附件保存问题 - 修复了之前上传附件后保存合同时附件数据丢失的问题（后端 Schema 字段缺失导致）。 ### 6. 修复合同保存失败 - 修复了花名册中添加劳动合同信息无法正常保存的问题。 - 根因：前端提交日期为 `YYYY-MM-DD` 格式，后端 Zod 校验要求 ISO datetime 格式。 - 修复：前端提交前将日期转为 ISO 格式。 ### 7. 删除合同 - 每个合同卡片右侧新增删除按钮，点击后确认即可删除该合同记录。 --- ## 四、薪资批次管理 ### 1. 多批次发薪 - 一个月份支持创建多个发薪批次（如常规发薪、离职结算、年终奖、补偿金），每个批次独立计算，归档后汇总生成一张工资条。 - 当月存在未归档（草稿）批次时，不允许创建新批次，确保个税按批次累计计算正确。 ### 2. 四种批次类型 | 类型 | 说明 | 社保公积金 | 个税方式 | |------|------|-----------|---------| | 常规发薪 | 日常工资发放 | 正常扣缴 | 累计预扣法 | | 离职结算 | 离职员工末月结算 | 正常扣缴 | 累计预扣法 | | 年终奖/奖金 | 奖金发放 | 不扣 | 单独计税 | | 补偿金 | 经济补偿金 | 不扣 | 累计预扣法 | ### 3. 四种初始化模式 - **复制上月数据**：拉入在职员工，从上月工资条复制基本工资/津贴/扣款。 - **本月空白（拉入员工）**：拉入在职员工，金额为0，仅取员工档案基本工资。 - **空批次**：不拉入员工，后续手动添加。 - **复制已有批次**：从指定已归档批次复制员工和薪资数据。 ### 4. 社保公积金按员工个人扣缴 - 按员工个人维度计算，同月多批次时自动扣减已归档批次已扣金额。 - 第1批扣全额，第2批补扣差额或扣0（已足额）。 - 奖金/补偿金批次不扣社保。 ### 5. 个税计算 - **常规/离职/补偿金**：累计预扣法，查询当年所有已归档批次累计计算。 - **年终奖**：单独计税，按月均奖金查税率表。 ### 6. 批次操作 - **创建**：选择类型和初始化模式，自动拉入员工并计算。 - **编辑**：可修改各金额项，保存后自动重算社保/个税/实发。 - **添加/删除员工**：支持手动添加或移除批次中的员工。 - **归档**：锁定批次不可编辑，归档后可生成工资条。 - **取消归档**：只能取消最后一个归档批次，自动更新工资条。 - **生成工资条**：汇总当月所有归档批次，按员工合并生成一张工资条。 ### 7. 薪税管理入口 - 左侧菜单「薪税管理」→「发薪批次」Tab，可管理所有批次。 - 支持按月份、状态、类型筛选批次列表。 ### 8. 工资表批量导入 - 在批次详情中支持上传 Excel 工资表，批量更新批次条目的薪酬输入项（基本工资、加班费、津贴、扣款、奖金）。 - 导入后自动重算社保/个税/实发工资。 ### 9. 修复批次创建失败 - 修复创建发薪批次总提示创建失败的问题。 - 根因：`calcBatchEntry` 查询社保/公积金配置时缺少 `city` 过滤，可能取到错误城市配置。 - 修复：查询配置时加入员工城市过滤；单员工计算失败时 try-catch 跳过并记录，不阻塞整批；返回 `failedEmployees` 详情。 ### 10. 修复个税计算为零 - 修复使用「本月空白」模式创建批次后个税为零的问题。 - 根因：空白模式下 `baseSalary = 0`，导致 `totalPay = 0` → 个税 = 0。 - 修复：空白模式下从员工档案获取基本工资，避免薪资为零。 ### 11. 单人发薪入口 - 花名册员工操作列新增「发薪」按钮（钱包图标），点击后跳转薪税管理页面。 - 无需全员生成再删除，可直接在批次中添加单个员工发薪。 ### 12. 加班费倍率自定义 - 加班费计算从硬编码 1.5/2.0/3.0 改为读取 `OvertimeConfig` 配置。 - 支持自定义工作日/周末/法定节假日加班倍率、月计薪天数、日工时。 - 未配置时 fallback 到法定标准 1.5/2.0/3.0。 --- ## 五、批量导入 ### 1. 员工批量导入 - 花名册页面点击「批量导入」按钮，上传 Excel 文件。 - **预览功能**：上传后先预览数据，确认无误再正式导入。 - **支持导入字段**：姓名、身份证号、手机号、部门、岗位、入职日期、基本工资、合同信息等。 - **错误处理**：导入失败行会生成错误日志 Excel 供下载，身份证号重复自动跳过。 - **模板下载**：支持下载标准导入模板。 ### 2. 月度数据导入 - 支持按月份批量导入：考勤记录、加班记录、薪资调整、社保变更、公积金变更。 - 一个月度 Excel 文件可包含多个 Sheet，一次导入多类数据。 - 支持下载月度导入模板。 ### 3. 工资表导入 - 在发薪批次详情页，上传 Excel 工资表批量更新条目金额。 - 导入后自动调用计算引擎重算社保、个税、实发。 ### 4. 批量续签/批量解聘 - 花名册支持勾选多名员工后批量续签合同或批量解聘。 - 批量续签支持预检合规性（如应签无固定期限提示）。 --- ## 六、证据链 ### 1. 证据链查看修复 - 修复员工档案中证据链 Tab 无法查看的问题。 - 根因：`TAB_GROUPS` 中缺少证据链 Tab 定义。 - 修复：添加证据链 Tab，渲染 `EvidenceChain` 组件。 ### 2. 空数据友好提示 - 新员工无合同/工资条/考勤等关联数据时，显示「暂无证据记录，员工产生合同/工资/考勤等数据后自动生成」。 - 证据链包含：劳动关系、薪酬发放、考勤记录、违纪处理、培训签收、绩效考核、解聘记录。 - 自动风险检测：未签合同、合同到期、工资异常、无考勤记录等。 --- ## 七、文档模板 ### 1. 新增「员工主动离职」解除协议模板 - 新增 `tpl_termination_agreement_employee` 模板（员工主动提出离职版）。 - 包含条款：员工主动辞职、无经济补偿金、工作交接、社保公积金截止月份、竞业限制延续等。 - 变量：公司名称、员工姓名、身份证号、离职日期、最后工作日、社保截止月、公积金截止月、离职原因。 - 原有「协商解除协议」模板描述更新为「用人单位提出」。 --- ## 八、员工门户 ### 1. UI 全面优化 - 新增 PortalLayout 布局组件和 Logo 组件，门户页面风格统一。 ### 2. QR 扫码登录 - 新增二维码扫码登录功能，员工可通过手机扫码快速登录门户。 ### 3. 合同与政策页面重构 - 员工门户中的「我的合同」和「公司政策」页面重新设计，信息展示更清晰。 ### 4. 工资条页面优化 - 工资条页面重构，展示更直观。 --- ## 九、帮助系统 ### 1. RAG 智能帮助 - 集成 RAG（检索增强生成）帮助系统，点击帮助按钮可智能问答，获取系统使用指导。 ### 2. 网页图标 - 添加网站 favicon，浏览器标签页显示品牌图标。 --- ## 测试建议 | 功能 | 测试路径 | 预期结果 | |------|---------|---------| | 社保 AI 建议 | 社保管理 → 选择城市 → 点击 AI 建议 | 自动填充社保参数 | | 专项附加扣除复制 | 社保管理 → 专项附加扣除 → 复制上月 | 批量填充上月数据 | | 合同多附件上传 | 员工档案 → 劳动合同 → 新增合同 → 上传附件 | 可选多个文件，显示文件列表 | | 附件预览 | 点击合同附件文件名 | 弹窗预览图片/PDF，其他格式提示下载 | | 删除合同 | 点击合同卡片右侧删除按钮 | 确认后删除合同 | | 社保上下限拆分 | 社保管理 → 新建版本 → 填写医保独立基数 | 三险和医保使用不同基数计算 | | 附加险种配置 | 社保管理 → 新建版本 → 添加附加险种 | 支持按比例/固定金额方式 | | 公积金试算 | 社保管理 → 公积金试算 | 显示企业/个人缴纳金额，不报错 | | 专项附加扣除按月录入 | 社保管理 → 专项附加扣除 → 按月编辑 | 五项分项录入，自动合计 | | 合同保存 | 员工档案 → 劳动合同 → 新增合同 → 保存 | 保存成功，不再报日期格式错误 | | 证据链查看 | 员工档案 → 证据链 Tab | 显示证据列表和风险提醒 | | 单人发薪 | 花名册 → 员工操作列 → 发薪按钮 | 跳转薪税管理页面 | | 加班费倍率 | 薪税管理 → 加班费计算 → 配置倍率 | 使用自定义倍率计算 | | 解除协议模板 | 离职管理 → 生成文档 → 选择模板 | 包含员工主动离职版解除协议 | | 薪资批次创建 | 薪税管理 → 发薪批次 → 创建发薪批次 | 选择类型和模式后自动拉入员工并计算 | | 批次编辑重算 | 进入批次详情 → 修改金额 → 保存 | 自动重算社保/个税/实发 | | 批次归档 | 批次详情 → 归档 | 批次锁定不可编辑 | | 生成工资条 | 归档后 → 工资条管理 → 生成 | 汇总当月所有归档批次生成工资条 | | 员工批量导入 | 花名册 → 批量导入 → 上传Excel → 预览 → 确认导入 | 导入成功，重复身份证自动跳过 | | 月度数据导入 | 设置 → 月度导入 → 上传Excel | 考勤/加班/调薪/社保/公积金批量导入 | | 工资表导入 | 发薪批次详情 → 导入工资表 → 上传Excel | 批量更新条目金额并自动重算 | | 批量续签 | 花名册 → 勾选员工 → 批量续签 | 预检合规后批量续签合同 | | 批量解聘 | 花名册 → 勾选员工 → 批量解聘 | 批量创建解聘记录 | | 员工门户 QR 登录 | 员工门户登录页 | 显示二维码可扫码登录 | | 规章制度 | 员工门户 → 规章制度 | 显示已公示制度列表，可签收确认 | | 帮助系统 | 点击右上角帮助按钮 | 弹出智能问答窗口 |