Files
TurboHR/20260816-用户测试说明.md
T
selfrelease 83b4b37de0 docs: 新增20260816用户测试说明
包含14个测试项,覆盖花名册合规校验、工作台待办跳转、薪税管理、
提成奖金新模块、员工端登录、待签合同催办等15项优化功能。

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
2026-08-16 13:09:14 +08:00

260 lines
8.8 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.
# 20260816 用户测试说明
> 本次更新共完成 **15 项优化**,覆盖花名册合规校验、工作台待办跳转、薪税管理、提成奖金新模块等。
> 测试地址:https://on.hr8ai.top/
> 测试前请先**强制刷新浏览器**Mac: Cmd+Shift+R / Windows: Ctrl+Shift+R)清除缓存。
---
## 一、花名册 · 添加雇员(问题 4-8)
### 测试 1:证件号码有效性校验(问题 6)
**操作步骤**
1. 花名册 → 添加雇员
2. 证件类型选"身份证",输入以下测试用例:
- `11010119900101123X`(校验位错误)→ 应提示"身份证校验位错误",阻断保存
- `110101199013011234`(月份 13 非法)→ 应提示"出生日期不合法"
- `110101199002301234`(2 月 30 日不存在)→ 应提示"出生日期不合法"
- `110101209901011234`(出生日期在未来)→ 应提示"出生日期不合法"
- `110101199003075476`(正确身份证)→ 应通过校验
**预期**:非法身份证无法保存,页面显示具体错误原因。
---
### 测试 2:超龄人员合同类型限制(问题 7)
**操作步骤**
1. 花名册 → 添加雇员
2. 输入一位超龄人员信息:
- 男,出生日期选 1960-01-01(≥60 岁)
- 查看合同类型下拉
3. 再输入一位非超龄人员:
- 男,出生日期选 1990-01-01
- 查看合同类型下拉
**预期**
- 超龄人员:合同类型下拉**无**"固定期限劳动合同""无固定期限劳动合同",仅有"劳务协议""实习协议""未签合同"
- 非超龄人员:所有合同类型可选
---
### 测试 3:劳务协议社保联动(问题 8)
**操作步骤**
1. 花名册 → 添加雇员
2. 合同类型选"劳务协议"
3. 查看社保公积金区域
**预期**
- 社保缴费基数、公积金缴费基数自动置 0 且**不可编辑**(灰色禁用)
- 社保开始年月清空且禁用
- 显示提示"劳务协议/实习协议人员不缴纳社保公积金"
4. 切回"固定期限劳动合同"
**预期**:社保公积金区域恢复可编辑。
---
### 测试 4:合同状态"待签署"(问题 4
**操作步骤**
1. 花名册 → 添加雇员,填写合同信息但**不登记签署日期**,保存
2. 查看花名册列表中该员工的合同状态列
**预期**
- 合同状态显示"待签署"标签(黄色/橙色样式)
- 登记签署日期后,状态变为"正常"(绿色)
---
### 测试 5:社保状态"待办理"(问题 5
**操作步骤**
1. 花名册 → 添加一位劳动合同类型员工,不填写社保基数
2. 查看花名册列表中该员工的社保状态列
**预期**
- 社保状态显示"待办理"标签
- 劳务协议员工社保状态显示"—"(不缴社保)
---
## 二、工作台 · 待办与风险提醒(问题 9-10)
### 测试 6:待办跳转精准化(问题 9 + 月度待办优化)
**操作步骤**
1. 工作台 → 待办事项 Tab
2. 查看月度待办(缴纳社保、缴纳公积金、发放工资、申报个税)
3. 点击各待办的"立刻办理 →"
**预期**
- 缴纳社保 → 跳转到**社保公积金**页面,自动定位到"月度办理"Tab
- 缴纳公积金 → 跳转到**社保公积金**页面,自动定位到"月度办理"Tab
- 发放工资 → 跳转到**薪税管理**页面,自动定位到"发薪批次"Tab
- 申报个税 → 跳转到**薪税管理**页面,自动定位到"发薪批次"Tab
- 无 actionUrl 的待办 → 不显示"立刻办理"链接,仅展示文字
---
### 测试 7:风险提醒反向引导修正(问题 10A)
**操作步骤**
1. 找一位标记为"孕期/哺乳期"或"医疗期"或"工伤"的员工
2. 工作台 → 风险提醒 Tab,查看对应提醒
3. 点击"立刻办理 →"
**预期**
- 跳转到**特殊员工**页面(`/special-status`),而非解聘页面
- 文案包含"此为合规提示,请勿发起解聘"
---
### 测试 8:合同到期分级预警(问题 10B)
**操作步骤**
1. 找一位合同 45 天后到期的员工
2. 工作台 → 风险提醒 Tab
**预期**
- 31-60 天到期:显示"中"优先级预警(MEDIUM,黄色)
- ≤30 天到期:显示"高"优先级预警(HIGH,红色)
- 待办列表按优先级排序:高优先级置顶
---
## 三、薪税管理(问题 11、13)
### 测试 9:试用期工资自动判定(问题 11)
**操作步骤**
1. 确保有一位试用期员工(合同 startDate + probationMonths > 当前日期)和一位已转正员工
2. 薪税管理 → 发薪批次 → 创建当月批次(或复制上月)
3. 查看两位员工的"基本工资"
**预期**
- 试用期员工:基本工资 = 合同的 `probationSalary`
- 已转正员工:基本工资 = 员工的 `monthlySalary`
- `probationSalary` 为 0 的试用期员工:回退用 `monthlySalary`
---
### 测试 10:获取提成奖金(问题 13)
**前提**:先在"提成奖金"模块录入当月数据(见测试 11)。
**操作步骤**
1. 薪税管理 → 发薪批次 → 进入某未归档批次详情
2. 编辑薪资步骤,找到"获取提成奖金"按钮(在"导入加班费"旁)
3. 点击该按钮
**预期**
- 提示"已填充 X 人提成奖金,合计 ¥Y"
- 对应员工的"奖金"字段自动填充
- 已归档批次该按钮禁用
---
## 四、提成奖金新模块(问题 12)
### 测试 11:提成奖金完整功能
**操作步骤**
1. 左侧菜单 → 团队 → **提成奖金**DollarSign 图标)
2. **月份切换**:选择 2026-08,查看列表和汇总卡片
3. **新增单条**:点击"新增" → 选员工 → 输入金额(如 5000)→ 保存
4. **新增扣款**:再新增一条,金额输入负数(如 -200)→ 保存
5. **编辑**:点击列表行的编辑图标 → 修改金额 → 保存
6. **删除**:点击列表行的删除图标 → 确认删除
7. **搜索**:在搜索框输入员工姓名 → 验证过滤
8. **下载模板**:点击"模板"按钮 → 下载 Excel 模板
9. **批量导入**:在模板中填入数据 → 点击"批量导入"上传 → 验证导入结果
10. **汇总验证**:检查汇总卡片(记录数/总奖金/总扣款/净额)是否正确
**预期**
- 菜单显示"提成奖金"入口
- 列表显示员工/部门/金额/备注
- 金额正数显示绿色(奖金),负数显示红色(扣款)
- 汇总卡片:总奖金 = 所有正数之和,总扣款 = 所有负数绝对值之和,净额 = 总奖金 - 总扣款
- 导入成功后提示"新增 X,更新 Y,跳过 Z"
- 同员工同月重复新增自动覆盖(upsert)
---
## 五、员工端密码登录(已完成 1-3)
### 测试 12:员工端登录
**操作步骤**
1. 员工端登录页 → 密码登录
2. 输入手机号 + 密码(默认密码 = 手机号后 6 位)
3. 登录成功后 → 导航栏 → 修改密码
4. 输入旧密码 + 新密码(≥6 位)→ 确认
**预期**
- 默认密码可登录
- 修改密码后用新密码可登录,旧密码不可用
- 无手机号员工默认密码为 `123456`
---
### 测试 13:管理员重置密码
**操作步骤**
1. 花名册 → 某员工详情 → "重置密码"按钮
2. 确认重置
**预期**:密码重置为手机号后 6 位,员工可用新密码登录。
---
## 六、待签合同 + 催办(已完成 4)
### 测试 14:待签合同按员工聚合 + 催办
**操作步骤**
1. 左侧菜单 → **待签合同**
2. 查看"待签合同"Tab:按员工聚合,每行一个员工,显示待签数
3. 点击某员工行展开 → 查看该员工名下待签文件列表
4. 点击"催办" → 弹窗显示二维码 + 可复制链接
5. 切换到"签署记录"Tab → 查看全部签署记录
**预期**
- 待签合同按员工聚合展示
- 催办弹窗显示二维码和链接(24 小时有效)
- 签署记录 Tab 显示历史记录,支持状态/场景筛选
---
## 测试结果记录
| 编号 | 测试项 | 通过 | 备注 |
|------|--------|------|------|
| 1 | 证件号码校验 | ☐ | |
| 2 | 超龄合同限制 | ☐ | |
| 3 | 劳务协议社保联动 | ☐ | |
| 4 | 合同待签署状态 | ☐ | |
| 5 | 社保待办理状态 | ☐ | |
| 6 | 待办跳转精准化 | ☐ | |
| 7 | 风险提醒反向引导修正 | ☐ | |
| 8 | 合同到期分级预警 | ☐ | |
| 9 | 试用期工资判定 | ☐ | |
| 10 | 获取提成奖金 | ☐ | |
| 11 | 提成奖金模块 | ☐ | |
| 12 | 员工端登录 | ☐ | |
| 13 | 管理员重置密码 | ☐ | |
| 14 | 待签合同+催办 | ☐ | |
---
## 注意事项
1. 测试前务必**强制刷新浏览器**清除缓存(Cmd+Shift+R
2. 测试 9-11 需要有测试员工数据,建议先用花名册添加 2-3 名测试员工
3. 测试 10 依赖测试 11 先录入提成奖金数据
4. 如发现菜单未显示"提成奖金",请清除浏览器缓存后重试
5. 测试完成后请在测试结果记录表勾选通过项,未通过项请描述具体问题