Files
TurboHR/docs/20260729-更新测试指导.md
T
freedakgmail fb36b10402 feat: 工作日历/考勤管理重构/AI人力报告/工作台员工分布/筛选优化/导入导出增强
- 新增工作日历页面(月历视图、事件管理、自定义事件)
- 考勤管理重构为6 Tab模块(班次/排班/每日出勤/月度报表/休假记录)
- AI顾问新增人力报告Tab,支持流式生成+Word导出
- 工作台总览新增员工分布统计(性别/年龄/学历/司龄饼图)+部门成本拆分
- 花名册/合同/解聘补偿新增部门和状态筛选
- 薪税管理新增工资表导入模板下载、银行代发CSV导出
- 社保公积金支持多公积金账户类型显示
- 数据导出新增花名册/解聘记录导出,中文文件名编码修复
- 数据导入新增模板下载(员工/增减员/工资表)+错误日志导出
- 移除工作台日历卡片(已迁移至独立工作日历页面)
- 新增20260728/20260729更新测试指导文档
2026-07-29 08:35:29 +08:00

240 lines
11 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 企业用工专家 — 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`),确保加载最新前端代码。
---
*如有问题或反馈,请联系开发团队。*