diff --git a/20260816-用户测试说明.md b/20260816-用户测试说明.md new file mode 100644 index 0000000..7bee6ba --- /dev/null +++ b/20260816-用户测试说明.md @@ -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. 测试完成后请在测试结果记录表勾选通过项,未通过项请描述具体问题