# 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. 测试完成后请在测试结果记录表勾选通过项，未通过项请描述具体问题