TurboHR/docs/20260728-更新测试指导.md

企业用工专家 — 2026年7月28日更新测试指导

部署地址：https://on.hr8ai.top/ 更新日期：2026-07-28

---

一、功能调查问卷（新增）

功能说明

系统新增「功能调查问卷」模块，覆盖 41 个页面、218 项功能，用户可对每项功能进行打分（1-5 星）、标注有用性、填写备注。问卷支持搜索、分组折叠、暂存恢复。

入口位置

• 顶部导航栏右侧 — 点击 📋（剪贴板图标）打开问卷弹窗

测试步骤

步骤	操作	预期结果
1	登录系统，点击顶部导航栏 📋 图标	弹出功能调查问卷弹窗，显示分组列表
2	查看分组结构	按页面分组（如"设置页面"、"花名册"等），每组显示功能数量
3	展开某一分组	显示该页面下所有功能项，每项有名称、描述、星级评分、有用性选择、备注框
4	为某项功能打 4 星评分	星星高亮显示，评分即时记录
5	选择有用性为"有用"	选项被选中记录
6	在备注框输入文字	文字正常输入
7	在搜索框输入关键词（如"合同"）	列表过滤显示包含关键词的功能项
8	点击「暂存」按钮	提示"暂存成功"，显示保存时间
9	关闭弹窗后重新打开	自动恢复上次填写的评分、有用性、备注
10	点击「提交」按钮	问卷结果提交，提示成功
11	点击「重置」按钮	清空所有填写内容

重点关注

• 暂存数据存储在浏览器 localStorage，关闭浏览器不会丢失
• 每项功能显示了所属菜单路径（如"系统 > 设置"），方便定位功能位置

---

二、审计日志优化（改进）

功能说明

操作日志页面优化：补充关键操作详情字段，前端以中文可读格式展示，不再显示原始 JSON。

入口位置

• 侧边栏 → 系统 → 操作日志（路径：/audit）

测试步骤

步骤	操作	预期结果
1	进入「操作日志」页面	显示日志列表，顶部有操作类型分布统计
2	查看日志条目	每条日志显示：操作名称（中文）、实体类型（中文标签）、操作详情（可读格式）、时间、IP
3	执行一次操作（如编辑员工、生成工资条等）	返回操作日志页面，新日志出现在列表顶部
4	查看新日志的详情字段	显示如"员工: 张三 | 部门: 技术部 | 补偿金: ¥5000"，而非原始 JSON
5	使用筛选功能 — 按操作类型筛选	列表仅显示对应类型的日志
6	使用筛选功能 — 按实体类型筛选	列表仅显示对应实体的日志
7	使用筛选功能 — 按日期范围筛选	列表仅显示指定时间段的日志
8	点击「清除筛选」	恢复显示全部日志

重点关注

• 解聘相关操作详情是否完整（离职日期、补偿金、离职原因等）
• 日期字段显示为 YYYY-MM-DD 格式，非时间戳
• 补偿金字段显示 ¥ 符号前缀

---

三、问卷结果导出（新增）

功能说明

在设置页面的「数据导出」区域新增问卷结果分析导出功能，将功能调查问卷的填写结果导出为 Markdown 文档。

入口位置

• 侧边栏 → 系统 → 设置 → 数据导出 Tab

测试步骤

步骤	操作	预期结果
1	先填写部分问卷内容并暂存（见第一节）	问卷数据保存到浏览器
2	进入「设置」页面，切换到「数据导出」Tab	页面底部显示"问卷结果分析导出"区域
3	点击「导出问卷结果（MD）」按钮	浏览器下载 survey-results-YYYY-MM-DD.md 文件
4	打开下载的 MD 文件	内容包含：每项功能的评分、有用性、备注，按页面分组展示
5	未填写问卷时点击导出	提示"暂无问卷数据"

重点关注

• 导出文件为 Markdown 格式，可直接用编辑器或 Typora 打开
• 导出内容包含所有已填写的功能项，未填写的不包含

---

四、问卷菜单路径与 Tab 信息（改进）

功能说明

问卷中每项功能新增了菜单路径和 Tab 信息，方便用户在系统中定位对应功能。

测试步骤

步骤	操作	预期结果
1	打开功能调查问卷	展开任一分组
2	查看功能项描述	每项功能下方显示菜单路径，如"菜单：员工管理 > 花名册"，部分还显示 Tab 信息
3	按菜单路径在系统中导航	能找到对应的功能页面和 Tab

---

本次更新涉及的菜单入口汇总

功能	菜单路径	备注
功能调查问卷	顶部导航栏 📋 图标	全局可用
操作日志	侧边栏 → 系统 → 操作日志	已有功能，本次优化展示
问卷结果导出	设置 → 数据导出 Tab	新增导出按钮

---

浏览器缓存提示

更新后首次访问请 强制刷新（Mac: Cmd + Shift + R，Windows: Ctrl + Shift + R），确保加载最新前端代码。

---

如有问题或反馈，请联系开发团队。