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

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

---

## 更新内容概览

| 序号 | 模块 | 更新类型 | 说明 |
|------|------|----------|------|
| 1 | 工作日历 | 新增 | 独立日历页面，支持月历视图、事件管理 |
| 2 | 考勤管理 | 重构 | 新增班次管理、排班、每日出勤、月度报表、休假记录 5 个 Tab |
| 3 | AI 顾问 | 新增 | 新增「人力报告」Tab，AI 自动生成结构化人力分析报告并支持 Word 导出 |
| 4 | 工作台总览 | 优化 | 新增员工分布统计（性别/年龄/学历/司龄），部门成本拆分，移除日历卡片 |
| 5 | 花名册 | 优化 | 新增部门筛选、合同状态筛选 |
| 6 | 合同管理 | 优化 | 新增部门筛选、合同状态筛选 |
| 7 | 解聘补偿 | 优化 | 新增状态筛选、部门筛选、关键词搜索 |
| 8 | 薪税管理 | 优化 | 新增工资表导入模板下载、银行代发文件 CSV 导出 |
| 9 | 社保公积金 | 优化 | 支持多公积金账户类型（基本/补充）显示 |
| 10 | 数据导出 | 优化 | 新增花名册导出、解聘记录导出，中文文件名编码修复 |
| 11 | 数据导入 | 优化 | 导入模板下载（员工/月度增减员/工资表），错误日志导出 |

---

## 一、工作日历（新增页面）

### 入口位置
- **侧边栏 → 工作台 → 工作日历**（路径：`/calendar`）

### 功能说明
独立的月历页面，展示合同到期、试用期到期、离职解聘、入职周年等关键日期，支持自定义事件（会议、团建、培训、面试）。

### 测试步骤

| 步骤 | 操作 | 预期结果 |
|------|------|----------|
| 1 | 点击侧边栏「工作日历」 | 进入日历页面，显示当月月历网格 |
| 2 | 查看月历网格 | 日期格内显示当日事件标签（如"合同到期"），高优先级红色圆点 |
| 3 | 点击「←」/「→」按钮 | 切换上/下个月 |
| 4 | 点击「今天」按钮 | 回到当前月份 |
| 5 | 点击类型筛选标签（如"合同到期"） | 仅显示该类型事件 |
| 6 | 点击日历中某一天 | 弹出新建事件弹窗，日期已自动填入 |
| 7 | 填写标题、类型、优先级，点击「创建」 | 事件创建成功，日历刷新显示新事件 |
| 8 | 查看右侧事件列表 | 按日期排序列出本月所有事件 |
| 9 | 鼠标悬停自定义事件，点击删除图标 | 事件删除成功 |

---

## 二、考勤管理（重构升级）

### 入口位置
- **侧边栏 → 员工管理 → 考勤确认**（路径：`/attendance`）

### 功能说明
原考勤确认页面升级为完整考勤管理模块，新增 5 个 Tab：班次管理、排班、每日出勤、月度报表、休假记录。

### 测试步骤

| 步骤 | 操作 | 预期结果 |
|------|------|----------|
| 1 | 进入「考勤确认」页面 | 显示 6 个 Tab：考勤确认、班次管理、排班、每日出勤、月度报表、休假记录 |
| 2 | **考勤确认 Tab** — 选择月份，查看列表 | 显示员工考勤确认状态（待确认/已确认/有异议），支持按部门筛选 |
| 3 | 点击「确认」按钮 | 员工考勤状态变为已确认 |
| 4 | **班次管理 Tab** — 点击「新增班次」 | 弹出表单，可设置班次名称、上下班时间 |
| 5 | 创建班次后查看列表 | 新班次出现在列表中 |
| 6 | 编辑班次时间 | 班次信息更新成功 |
| 7 | 删除班次 | 班次从列表移除 |
| 8 | **排班 Tab** — 选择日期和员工，分配班次 | 排班记录创建成功 |
| 9 | **每日出勤 Tab** — 选择日期查询 | 显示当日所有员工出勤状态（正常/迟到/早退/缺勤/请假/出差） |
| 10 | **月度报表 Tab** — 选择月份 | 显示月度出勤统计汇总 |
| 11 | **休假记录 Tab** — 点击「新增休假」 | 弹出表单，可选择员工、休假类型（病假/事假/年假/产假/其他）、日期范围 |
| 12 | 创建休假记录后查看列表 | 休假记录显示在列表中，可删除 |

---

## 三、AI 人力报告（新增 Tab）

### 入口位置
- **侧边栏 → AI 辅助 → AI 顾问**（路径：`/ai-assistant`），切换到「人力报告」Tab

### 功能说明
AI 基于企业当前数据（员工人数、部门分布、薪资成本、合同状态等）自动生成结构化人力分析报告，支持导出为 Word 文档。

### 测试步骤

| 步骤 | 操作 | 预期结果 |
|------|------|----------|
| 1 | 进入 AI 顾问页面，点击「人力报告」Tab | 显示人力报告生成界面 |
| 2 | 点击「生成报告」按钮 | 流式输出 AI 生成的人力分析报告（Markdown 格式） |
| 3 | 等待报告生成完成 | 报告包含：人员概况、部门分析、成本分析、风险提示等结构化内容 |
| 4 | 点击「导出 Word」按钮 | 浏览器下载 `人力分析报告_YYYY-MM-DD.docx` 文件 |
| 5 | 打开下载的 Word 文件 | 内容包含标题、段落、表格、列表，格式正确 |

---

## 四、工作台总览优化

### 入口位置
- **侧边栏 → 工作台 → 总览**（路径：`/`）

### 测试步骤

| 步骤 | 操作 | 预期结果 |
|------|------|----------|
| 1 | 进入总览页面 | 显示概览 Tab 内容 |
| 2 | 查看人力成本分析区域 | 显示环比/同比数据，下方新增**部门成本拆分**进度条（按部门展示工资/社保/公积金/人均） |
| 3 | 查看员工分布统计区域 | 显示 4 个饼图卡片：性别分布、年龄段分布、学历分布、司龄分布 |
| 4 | 检查性别分布饼图 | 显示男/女人数及图例 |
| 5 | 检查年龄段分布饼图 | 按年龄段（如 20-25、26-30、31-35 等）展示人数 |
| 6 | 检查学历分布饼图 | 按学历（如大专、本科、硕士等）展示人数 |
| 7 | 检查司龄分布饼图 | 按司龄段（如 <1年、1-3年、3-5年 等）展示人数 |
| 8 | 确认原"本月关键日期"日历卡片 | **已移除**，不再显示 |

---

## 五、花名册 / 合同管理 — 筛选优化

### 入口位置
- **侧边栏 → 员工管理 → 花名册**（路径：`/roster`）
- 合同管理在花名册详情中

### 测试步骤

| 步骤 | 操作 | 预期结果 |
|------|------|----------|
| 1 | 进入花名册页面 | 搜索栏右侧新增「全部部门」和「全部状态」下拉筛选 |
| 2 | 选择某个部门筛选 | 列表仅显示该部门员工 |
| 3 | 选择合同状态筛选（如"在职"） | 列表仅显示对应合同状态的员工 |
| 4 | 同时使用搜索 + 部门 + 状态筛选 | 三种筛选条件叠加生效 |
| 5 | 点击清除筛选条件 | 恢复显示全部员工 |

---

## 六、解聘补偿 — 筛选优化

### 入口位置
- **侧边栏 → 员工管理 → 解聘补偿**（路径：`/termination`）

### 测试步骤

| 步骤 | 操作 | 预期结果 |
|------|------|----------|
| 1 | 进入解聘补偿页面 | 新增状态筛选、部门筛选、搜索框 |
| 2 | 按状态筛选（如"草稿"/"待审批"/"已执行"） | 列表仅显示对应状态的记录 |
| 3 | 按部门筛选 | 列表仅显示该部门的解聘记录 |
| 4 | 在搜索框输入员工姓名 | 列表过滤显示匹配的记录 |

---

## 七、薪税管理 — 导出功能增强

### 入口位置
- **侧边栏 → 薪税社保 → 薪税管理**（路径：`/money`）

### 测试步骤

| 步骤 | 操作 | 预期结果 |
|------|------|----------|
| 1 | 进入薪税管理页面 | 工具栏新增「下载模板」和「银行代发文件」按钮 |
| 2 | 点击「下载模板」 | 浏览器下载 `工资表导入模板.xlsx` |
| 3 | 打开模板文件 | 包含姓名、部门、月工资等列标题 |
| 4 | 选择某批次，点击「银行代发文件」 | 浏览器下载 `银行代发文件-YYYY-MM-批次N.csv` |
| 5 | 打开 CSV 文件 | 包含银行账号、姓名、金额等代发信息 |

---

## 八、社保公积金 — 多账户支持

### 入口位置
- **侧边栏 → 薪税社保 → 社保公积金**（路径：`/social`）

### 测试步骤

| 步骤 | 操作 | 预期结果 |
|------|------|----------|
| 1 | 进入社保公积金页面，选择某城市 | 公积金配置区域显示当前生效的账户类型标签 |
| 2 | 查看多账户情况 | 若有基本公积金 + 补充公积金，分别显示蓝色/紫色标签及各自比例 |
| 3 | 查看单账户情况 | 仅显示基本公积金标签 |

---

## 九、数据导出 — 新增导出类型

### 入口位置
- **侧边栏 → 系统 → 设置 → 数据导出 Tab**

### 测试步骤

| 步骤 | 操作 | 预期结果 |
|------|------|----------|
| 1 | 进入设置页面，切换到「数据导出」Tab | 导出选项中新增花名册导出、解聘记录导出 |
| 2 | 勾选「花名册」，点击导出 | 下载 Excel 文件，包含员工基本信息 |
| 3 | 勾选「解聘记录」，点击导出 | 下载 Excel 文件，包含解聘记录详情 |
| 4 | 检查导出文件名 | 中文文件名正常显示，无乱码 |

---

## 十、数据导入 — 模板下载与错误日志

### 入口位置
- **侧边栏 → 系统 → 设置 → 数据导入 Tab**

### 测试步骤

| 步骤 | 操作 | 预期结果 |
|------|------|----------|
| 1 | 进入数据导入页面 | 显示可下载的模板类型 |
| 2 | 下载「员工导入模板」 | 下载 `员工导入模板.xlsx`，包含姓名/部门/身份证号/入职日期等列 |
| 3 | 下载「月度增减员导入模板」 | 下载 `月度增减员导入模板.xlsx` |
| 4 | 下载「工资表导入模板」 | 下载 `工资表导入模板.xlsx` |
| 5 | 上传含错误数据的文件 | 导入完成后提示错误，可下载错误日志 Excel |

---

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

| 功能 | 菜单路径 | 备注 |
|------|----------|------|
| 工作日历 | 工作台 → 工作日历 | 新增页面 |
| 考勤管理 | 员工管理 → 考勤确认 | 重构，新增 5 个 Tab |
| AI 人力报告 | AI 辅助 → AI 顾问 → 人力报告 Tab | 新增 Tab |
| 员工分布统计 | 工作台 → 总览 | 新增 4 个分布图表 |
| 花名册筛选 | 员工管理 → 花名册 | 新增筛选下拉 |
| 解聘补偿筛选 | 员工管理 → 解聘补偿 | 新增筛选和搜索 |
| 薪税导出 | 薪税社保 → 薪税管理 | 新增模板下载和银行代发 |
| 社保多账户 | 薪税社保 → 社保公积金 | 显示多公积金账户 |
| 数据导出 | 系统 → 设置 → 数据导出 | 新增导出类型 |
| 数据导入 | 系统 → 设置 → 数据导入 | 新增模板下载 |

---

## 浏览器缓存提示

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

---

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