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