docs: 新增20260816用户测试说明
包含14个测试项，覆盖花名册合规校验、工作台待办跳转、薪税管理、 提成奖金新模块、员工端登录、待签合同催办等15项优化功能。 Generated with [Devin](https://devin.ai) Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
This commit is contained in:
selfrelease
@@ -0,0 +1,259 @@
|
||||
# 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. 测试完成后请在测试结果记录表勾选通过项，未通过项请描述具体问题
|
||||
Reference in New Issue
Block a user