# 企业用工专家 — 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`），确保加载最新前端代码。

---

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