docs: 更新使用帮助近期更新为28项优化说明

This commit is contained in:
freedakgmail
2026-08-09 12:04:30 +08:00
parent a2e9ba55c2
commit de7f1830a7
+145 -32
View File
@@ -31,52 +31,165 @@ const categories: HelpCategory[] = [
icon: Sparkles,
articles: [
{
id: 'update-idcard-clipboard',
question: '修复:花名册身份证号复制乱码',
answer: '修复花名册列表和员工详情页点击身份证号复制后粘贴为乱码的问题:\n• 新增统一的 clipboard 工具函数,优先使用 navigator.clipboard API\n• 当 clipboard API 不可用时(非 HTTPS 或浏览器不兼容),自动降级为 execCommand("copy") + 隐藏 textarea 方案\n• 复制失败时提示「复制失败,请手动复制」',
tip: '路径:花名册列表点击身份证号 / 员工详情点击复制图标',
id: 'update-2026-batch-overview',
question: '2026年8月批量优化:28项问题一次性修复',
answer: '本次更新覆盖员工福利、离职管理、考勤管理、证据链、规章制度、文本模板、花名册、用工办理、证明开具、培训记录、绩效考核等全部模块,共修复28项问题(P0紧急6项 + P1重要16项 + P2优化6项)。\n以下为各模块主要改进:',
},
{
id: 'update-payroll-date-filter',
question: '优化:薪税管理筛选支持创建日期范围',
answer: '薪税管理批次列表新增「创建日期」范围筛选器:\n• 在原有月份筛选基础上,增加 dateFrom / dateTo 日期选择器\n• 可按批次创建时间精确筛选某天或某段日期的工资批次\n• 批次列表默认按创建时间倒序排列\n• 列表新增「创建时间」列,显示 YYYY-MM-DD HH:mm 格式\n• 方便同月多笔工资批次的区分和查找',
tip: '路径:薪税管理 → 批次列表 → 创建日期筛选',
id: 'update-benefit-enroll',
question: '修复:福利方案创建后无法添加享受人员',
answer: '修复福利方案批量参保功能:\n• 商业保险和员工福利模块均支持批量参保\n• 可选择多名员工一次性加入福利方案\n• 参保时自动记录生效日期和缴费金额',
tip: '路径:员工福利 → 福利方案 → 批量参保',
},
{
id: 'update-social-insurance-fix',
question: '修复:社保公积金无法创建新政策版本',
answer: '修复社保公积金页面创建新版本政策比例时保存失败的问题:\n• 后端将旧版本标记为失效时增加城市过滤条件,避免误将其他城市的当前版本标记失效\n• 前端创建版本失败时显示后端返回的具体错误信息,方便排查\n• 社保和公积金均修复此问题',
tip: '路径:社保公积金 → 新建版本',
id: 'update-termination-cert',
question: '修复:离职证明下载内容为乱码',
answer: '修复离职证明下载后打开为乱码的问题:\n• 使用 Word HTML 格式生成 .doc 文件,设置 charset=utf-8\n• 指定 SimSun(宋体)字体,确保中文正常显示\n• 离职证明内容包含:员工姓名、身份证号、入职日期、离职日期、企业名称等',
tip: '路径:离职管理 → 已完成解聘 → 下载离职证明',
},
{
id: 'update-evidence-export',
question: '修复:证据链导出失败',
answer: '修复员工档案中证据链导出提示「导出失败」的问题:\n• 后端 ExcelJS 生成方式从流式写入改为 writeBuffer + res.send,避免流写入异常\n• 增加错误日志输出,方便排查具体失败原因\n• 前端导出请求携带认证 token',
tip: '路径:员工档案 → 证据链 → 导出证据链',
id: 'update-attendance-template',
question: '优化:考勤导入模板合并Sheet,减少重复录入',
answer: '考勤月度导入模板从多个Sheet合并为单Sheet:\n• 考勤记录和加班记录合并为「考勤与加班」一个Sheet\n• 不再需要分别填写考勤Sheet和加班Sheet\n• 导入时自动识别合并Sheet或独立Sheet,兼容旧模板\n• 减少重复录入姓名和身份证号',
tip: '路径:考勤管理 → 考勤确认 → 导入考勤 → 下载模板',
},
{
id: 'update-disciplinary-certificate',
question: '新增:违纪记录签字后可下载确认证明',
answer: '员工在员工端签字确认违纪记录后,企业端可下载违纪确认证明文件:\n• 后端新增 GET /roster/:employeeId/disciplinary/:recordId/certificate 接口\n• 证明内容包含:企业名称、员工姓名、身份证号、违纪事实、处理结果、签字确认状态、确认日期、见证人\n• 前端在已签字的违纪记录上显示下载按钮',
tip: '路径:团队 → 违纪记录 → 已签字记录点击下载按钮',
id: 'update-attendance-makeup',
question: '修复:补卡无法修改未打卡状态',
answer: '修复每日出勤中补卡功能:\n• 补卡弹窗支持修改签到时间、签退时间、考勤状态\n• 可手动修正迟到、早退、缺勤等异常状态\n• 补卡操作记录备注信息,方便后续审计',
tip: '路径:考勤管理 → 每日出勤 → 补卡按钮',
},
{
id: 'update-medical-period-policy',
question: '新增:医疗期计算器支持自定义地区政策',
answer: '医疗期计算器从硬编码改为数据驱动,支持动态添加地区政策:\n• 系统设置新增「医疗期政策」管理页面,可增删改各地区政策\n• 每个地区政策包含:地区名称、法律依据、工龄分档规则(工龄上限 → 医疗期月数 → 累计周期月数)\n• 预置全国通用、上海、石家庄、唐山四个地区政策\n• 医疗期计算器从 API 动态加载政策列表,选择地区后自动应用对应规则',
tip: '路径:设置 → 医疗期政策 / 工具 → 医疗期计算器',
id: 'update-attachment-view',
question: '新增:合同附件支持在线查看和删除',
answer: '员工档案附件管理新增在线查看和删除功能:\n• 点击眼睛图标可在线预览附件(PDF、图片等)\n• 点击下载图标可下载附件文件\n• 点击删除图标可删除传错的附件\n• 支持身份证、银行卡、学历证书、合同扫描件等多种类型',
tip: '路径:员工档案 → 附件管理',
},
{
id: 'update-performance-type-grade',
question: '优化:绩效考核区分月度/季度/年度,得分自动关联等级',
answer: '绩效考核新增考核类型字段,得分与等级自动联动:\n• 新增 periodType 字段:月度考核(MONTHLY)、季度考核(QUARTERLY)、年度考核(YEARLY)\n• 根据考核类型动态切换周期输入方式:月度→月份选择器,季度→Q1/Q2/Q3/Q4,年度→年份输入\n• 得分自动计算等级和结果:90-100→A(优秀),80-89→B(合格),60-79→C(需改进),0-59→D(不胜任)\n• 等级和结果字段由得分自动填充,也可手动覆盖',
tip: '路径:团队 → 绩效考核 → 新增 / 员工档案 → 绩效考核',
id: 'update-page-size',
question: '修复:花名册每页条数选择无反应',
answer: '修复花名册列表切换每页显示条数后不生效的问题:\n• 分页组件改为使用本地 pageSize 状态而非服务端返回值\n• 切换条数后立即重置到第一页并重新加载数据',
tip: '路径:花名册列表底部 → 每页条数下拉框',
},
{
id: 'update-contract-download-void',
question: '修复:劳动合同附件下载 + 禁止删除改为作废',
answer: '修复员工花名册中劳动合同附件无法下载的问题,并将删除改为作废:\n• 下载修复:附件下载改为程序化创建 <a> 元素并触发点击,避免 data URL 在部分浏览器下下载无效\n• 新增补充上传功能:已有附件的合同可追加上传更多附件\n• 禁止物理删除:删除按钮改为「作废合同」,设置结束日期为当前时间,保留记录但不再生效\n• 作废操作记录审计日志',
tip: '路径:员工档案 → 劳动合同 → 附件下载 / 作废按钮',
id: 'update-termination-export',
question: '优化:离职管理导出支持筛选条件',
answer: '离职管理导出数据新增筛选条件:\n• 支持按状态、部门、关键词筛选\n• 新增日期范围筛选(开始日期至结束日期)\n• 导出时携带当前筛选条件,只导出符合条件的数据',
tip: '路径:离职管理 → 筛选条件 → 导出按钮',
},
{
id: 'update-termination-cancel',
question: '新增:已提交离职数据可撤回,无用数据可删除',
answer: '离职管理新增撤回和删除功能:\n• 已提交的离职草稿可撤销(非已完成状态均可撤回)\n• 草稿状态和已撤销状态的记录可删除\n• 撤回和删除操作均记录审计日志',
tip: '路径:离职管理 → 草稿列表 → 撤销/删除按钮',
},
{
id: 'update-overtime-calc',
question: '优化:加班费自动计算,无需重复导入',
answer: '考勤导入时自动计算加班费,薪税模块直接读取:\n• 导入考勤数据时根据加班倍率配置自动计算加班费\n• 月度考勤报表自动汇总加班时长和加班费\n• 薪税管理发放工资时自动读取已计算的加班费\n• 不再需要在薪税模块重复导入加班数据',
tip: '路径:考勤管理 → 导入考勤(自动计算加班费)→ 薪税管理(自动读取)',
},
{
id: 'update-overtime-summary',
question: '修复:个人考勤记录添加后加班汇总不显示',
answer: '修复添加个人考勤记录后月度报表加班汇总不更新的问题:\n• 月度报表从 overtimeRecord 表读取加班汇总数据\n• 个人考勤记录中的加班时长自动累计到月度汇总',
tip: '路径:考勤管理 → 月度报表',
},
{
id: 'update-evidence-verify',
question: '优化:证据链验证显示异常项详情',
answer: '证据链「验证全部完整性」功能增强:\n• 验证结果新增异常项详情列表\n• 每条异常项显示:证据类型、关联ID、描述、创建时间\n• 方便快速定位被篡改的证据链记录',
tip: '路径:证据链管理 → 验证全部完整性',
},
{
id: 'update-policy-remind',
question: '新增:规章制度签收催办和未签收人员查看',
answer: '规章制度签收管理新增催办和未签收人员列表:\n• 签收统计中显示已签收和未签收人数\n• 可展开查看未签收人员明细列表\n• 一键催办功能:向所有未签收员工发送系统内通知提醒\n• 催办通知记录在通知管理中可查看',
tip: '路径:规章制度 → 点击制度 → 阅读统计 → 一键催办',
},
{
id: 'update-template-import',
question: '新增:模板支持导入 Word 文档',
answer: '文本模板编辑新增导入 Word 文档功能:\n• 支持 .docx 格式 Word 文档导入\n• 使用 mammoth 库自动将 Word 内容转为 HTML\n• 导入后可在编辑器中继续修改变量占位符\n• 保留原有格式(标题、段落、列表等)',
tip: '路径:文本模板 → 新建/编辑模板 → 导入 Word 文档按钮',
},
{
id: 'update-social-cap',
question: '修复:选择参保地后社保基数自动封上下限',
answer: '花名册添加员工时选择参保城市后自动封顶/保底社保基数:\n• 选择参保城市后自动调用社保计算接口\n• 社保基数超过上限自动封顶,低于下限自动保底\n• 公积金基数同样自动封顶/保底\n• 显示封顶/保底提示信息',
tip: '路径:花名册 → 添加员工 → 选择参保城市',
},
{
id: 'update-validation-detail',
question: '优化:录入校验失败显示具体字段和错误原因',
answer: '员工信息录入校验失败时显示字段级错误信息:\n• 后端 Zod 校验返回具体字段名和错误原因\n• 前端解析错误详情,逐条列出校验失败的字段\n• 添加员工弹窗和编辑表单均支持详细错误提示',
tip: '路径:花名册 → 添加/编辑员工 → 校验失败时显示',
},
{
id: 'update-position-field',
question: '修复:花名册录入时新增职务/岗位字段',
answer: '添加员工表单新增「职务/岗位」输入框:\n• 在姓名和部门旁边新增职务字段\n• 录入时可直接填写岗位信息\n• 与花名册列表中的职务列对应',
tip: '路径:花名册 → 添加员工 → 职务/岗位',
},
{
id: 'update-social-detail',
question: '新增:花名册员工详情显示社保费用分险种明细',
answer: '员工详情薪税信息中新增社保费用分险种明细展示:\n• 按养老、医疗、失业、工伤、生育分别显示企业和个人缴费金额及比例\n• 显示社保基数是否已封顶/保底\n• 医保基数与养老基数不同时单独提示\n• 与社保模块计算结果保持一致',
tip: '路径:员工档案 → 薪税信息 → 社保费用明细',
},
{
id: 'update-modal-noclose',
question: '优化:录入弹窗防止误关闭丢失已填信息',
answer: '添加员工等录入弹窗防止误操作关闭:\n• Modal 组件新增 closeOnOverlayClick 属性\n• 添加员工弹窗设置为点击遮罩层不关闭\n• 防止误点击弹窗外部导致已填信息丢失',
tip: '路径:花名册 → 添加员工弹窗',
},
{
id: 'update-idcard-dedup',
question: '新增:用工办理按身份证号查重',
answer: '创建员工时自动按身份证号查重:\n• 后端创建员工前先检查身份证号是否已存在\n• 如果已存在,返回已有员工姓名、部门、在职状态\n• 前端显示明确的重复提示信息,避免重复录入',
tip: '路径:用工办理 → 入职办理 / 花名册 → 添加员工',
},
{
id: 'update-income-cert-select',
question: '优化:收入证明支持员工下拉选择并自动填充',
answer: '用工办理中收入证明和离职证明支持员工下拉选择:\n• 员工字段从手动输入改为下拉搜索选择\n• 选择员工后自动填充:姓名、身份证号、职务、月收入、入职日期、部门、手机号\n• 减少手动输入,避免信息不一致',
tip: '路径:用工办理 → 收入证明/离职证明 → 选择员工',
},
{
id: 'update-training-batch',
question: '新增:培训记录支持批量选择员工',
answer: '培训记录新增批量选择模式:\n• 支持切换单选/批量模式\n• 批量模式下可搜索姓名/部门并勾选多名员工\n• 一次为多名员工添加相同培训记录\n• 显示已选择员工数量',
tip: '路径:团队 → 培训记录 → 新增 → 切换为批量',
},
{
id: 'update-workprocess-dedup',
question: '优化:用工办理中离职/解聘流程统一归入离职管理',
answer: '用工办理模块与离职管理模块功能去重:\n• 用工办理中保留入职、转正、调岗、合同相关流程\n• 离职、解聘相关流程统一在「离职管理」模块处理\n• 清理用工办理中已废弃的流程类型定义',
tip: '路径:用工办理(入职类流程)→ 离职管理(离职类流程)',
},
{
id: 'update-social-input',
question: '优化:社保基数输入框支持直接覆盖',
answer: '社保和公积金基数输入框优化:\n• 自动填充的默认值改为 placeholder 显示,不再回填\n• 点击输入框时自动全选当前值,方便直接覆盖\n• 清空输入框后不再回退到月工资默认值\n• 添加员工和重新雇佣弹窗均已优化',
tip: '路径:花名册 → 添加员工 → 社保/公积金基数输入框',
},
{
id: 'update-payslip-entry',
question: '优化:花名册员工详情薪税入口改名为「查看薪资历史」',
answer: '员工详情中薪税模块入口按钮优化:\n• 按钮名称从「薪税模块」改为「查看薪资历史」,语义更明确\n• 跳转时携带员工ID和tab参数,直接定位到该员工的工资条\n• 与员工个人薪资关联,不再跳转到薪税批次列表',
tip: '路径:员工档案 → 薪酬社保 → 查看薪资历史',
},
{
id: 'update-roster-guide',
question: '优化:花名册添加员工后引导前往用工办理',
answer: '花名册添加员工成功后增加引导提示:\n• 添加成功后 toast 提示「员工已添加」\n• 提供「前往用工办理」快捷操作按钮\n• 引导用户使用用工办理完成完整入职流程(合同签署等)\n• 花名册保留快速添加入口,用工办理提供完整流程',
tip: '路径:花名册 → 添加员工 → 成功提示 → 前往用工办理',
},
{
id: 'update-performance-template',
question: '新增:绩效考核支持自定义模板和维度评分',
answer: '绩效考核模块新增绩效模板管理:\n• 支持定义自定义考核维度(如工作能力、态度、业绩等)\n• 每个维度可设置权重和满分分值\n• 考核时按模板填写各维度得分,系统按权重自动计算总分\n• 保留简单评分模式作为默认,自定义模板作为高级功能\n• 绩效模板支持增删改查,可设置默认模板',
tip: '路径:员工档案 → 绩效考核 → 新增 → 选择绩效模板',
},
],
},