diff --git a/docs/20260729-测试指导.md b/docs/20260729-测试指导.md new file mode 100644 index 0000000..f2d062a --- /dev/null +++ b/docs/20260729-测试指导.md @@ -0,0 +1,246 @@ +# 企业用工专家 — 20260729 优化需求测试指导 + +> 测试环境:https://on.hr8ai.top/ +> 测试日期:2026-07-29 +> 对应需求文档:20260729-优化需求梳理-1.md + +--- + +## 需求 1 + 10:花名册导入模板优化 + 性别自动识别 + +### 测试步骤 + +1. 进入「设置 → 数据导入」页面 +2. 点击「下载模板」,打开下载的 Excel 文件 +3. 检查模板表头: + - 员工信息 Sheet:`姓名*`、`入职日期*`、`月工资*` 带星号标注 + - 性别列显示「性别(选填,留空自动识别)」 + - 劳动合同 Sheet:`姓名*`、`合同开始日期*` 带星号 + - 加班记录 Sheet:`姓名*`、`日期*` 带星号 + - 违纪记录 Sheet:`姓名*`、`日期*` 带星号 + - 考勤记录 Sheet:`姓名*`、`日期*` 带星号 +4. 每个 Sheet 第一行应有示例数据(如张三、110101199001011234) +5. 填入测试数据(性别留空,填入身份证号),上传导入 +6. 在花名册中查看导入的员工,性别应自动从身份证号识别(第17位奇数=男,偶数=女) + +### 验证点 + +- [ ] 模板必填字段有 `*` 标注 +- [ ] 每个 Sheet 含一行示例数据 +- [ ] 性别留空时自动识别正确 +- [ ] 性别手动填写时以填写值为准 + +--- + +## 需求 2:专项附加扣除批量导入 + +### 测试步骤 + +1. 进入「薪税管理 → 专项附加扣除」Tab +2. 点击工具栏「批量导入」按钮,弹出导入弹窗 +3. 点击「下载模板」,打开 Excel 检查: + - 表头含 `姓名*`、身份证号、子女教育、赡养老人、住房、继续教育、婴幼儿照护、备注 + - 两行示例数据 +4. 填入测试数据(姓名对应花名册中已有员工),上传导入 +5. 查看导入结果反馈:成功 N 条、跳过 M 条、错误明细 + +### 验证点 + +- [ ] 模板下载正常,表头有 `*` 标注 +- [ ] 导入后显示成功/跳过/错误汇总 +- [ ] 身份证号优先匹配,未填时用姓名匹配 +- [ ] 导入后专项附加扣除列表数据刷新 + +--- + +## 需求 3:导入结果反馈不明确 + +### 测试步骤 + +1. 在「设置 → 数据导入」上传一个含部分错误数据的 Excel +2. 观察导入完成后的结果反馈 + +### 验证点 + +- [ ] 显示分类汇总:成功 N 条、跳过 M 条、重复 K 条 +- [ ] 有「导出错误日志」按钮,下载 Excel 格式的逐行错误明细 +- [ ] 错误日志含 Sheet 名、行号、员工姓名、错误类型 + +--- + +## 需求 4:证据链导出改为 Excel + +### 测试步骤 + +1. 进入花名册,点击某员工「证据链」 +2. 在证据链页面点击「导出」按钮 +3. 下载并打开 Excel 文件 + +### 验证点 + +- [ ] 下载文件为 `.xlsx` 格式(非 TXT) +- [ ] Excel 包含 3 个 Sheet:员工信息、证据清单、风险提醒 +- [ ] 证据清单含合同/工资条/加班/考勤/违纪/培训/绩效/解聘记录 +- [ ] 排版整齐,可直接使用 + +--- + +## 需求 5:身份证后四位搜索修复 + +### 测试步骤 + +1. 在花名册列表搜索框输入某员工身份证号后 4 位(纯数字) +2. 查看搜索结果 +3. 也测试输入后 2 位、后 6 位 + +### 验证点 + +- [ ] 输入身份证后 4 位能匹配到对应员工 +- [ ] 输入 2+ 位纯数字自动识别为身份证号搜索 +- [ ] 输入姓名/部门仍正常搜索 + +--- + +## 需求 6:文本模板库功能完善 + +### 测试步骤 + +1. 进入「文本模板库」页面 +2. 查看页面顶部是否有「使用说明」可折叠面板 +3. 展开后查看操作指引:选择模板 → 填充变量 → 生成文档 → 下载 +4. 选择一个模板,填充变量后点击「渲染」 +5. 点击「下载 Word」按钮,下载 `.doc` 文件 +6. 点击「复制为新模板」按钮,粘贴到 Word 中验证内容 + +### 验证点 + +- [ ] 使用说明面板存在且可折叠 +- [ ] 下载 Word 按钮正常下载 `.doc` 文件 +- [ ] 复制为新模板将内容复制到剪贴板 +- [ ] 模板原文和渲染结果区域均有下载按钮 + +--- + +## 需求 7:用工体检评分标准说明 + +### 测试步骤 + +1. 进入「用工体检」工具页面 +2. 查看评分标准说明卡片 + +### 验证点 + +- [ ] 卡片展示 3 级评分等级: + - 85+ 健康(绿色) + - 60-84 中等风险(黄色) + - <60 高风险(红色) +- [ ] 卡片展示 6 维度评分构成:合同管理、薪酬社保、考勤加班、规章制度、解聘合规、证据链 +- [ ] 每个维度列出具体评分要素 + +--- + +## 需求 8:试用期员工区分与转正提醒 + +### 测试步骤 + +1. 在花名册中导入/查看有试用期月数的员工(合同中 `probationMonths > 0`) +2. 查看花名册列表 + +### 验证点 + +- [ ] 试用期员工显示橙色标签(试用期 X 个月 · 剩余 Y 天) +- [ ] 状态筛选下拉新增「试用期」选项 +- [ ] 选择「试用期」后只显示试用期员工 +- [ ] 试用期信息从合同 `probationMonths` + `hireDate` 动态计算 + +--- + +## 需求 9:考勤页面增加导入入口 + +### 测试步骤 + +1. 进入「考勤管理」页面 +2. 切换到「考勤确认」Tab +3. 点击工具栏「导入考勤」按钮 +4. 在弹窗中点击「下载模板」,获取 Excel 模板 +5. 填入考勤数据,上传导入 +6. 查看导入结果反馈 + +### 验证点 + +- [ ] 考勤确认 Tab 工具栏有「导入考勤」按钮 +- [ ] 弹窗含模板下载、文件上传、结果反馈 +- [ ] 导入后考勤列表和统计数据自动刷新 +- [ ] 导入结果显示考勤记录/加班/员工/合同条数 + +--- + +## 需求 11:薪税发薪批次创建流程优化 + +### 测试步骤 + +### 11.1 多批次并存 + +1. 进入「薪税管理」页面 +2. 当月已有未归档批次时,点击「创建批次」 +3. 验证不再提示「上一批次未归档」 + +### 11.2 自定义选择员工 + +1. 创建批次弹窗中选择「自定义选择员工」模式 +2. 测试按部门筛选、姓名搜索、全选/取消全选 +3. 勾选部分员工后创建批次 +4. 验证批次仅包含选中员工 + +### 11.3 归档时重算个税 + +1. 当月创建两个批次 A 和 B(同一员工在两个批次中) +2. 先归档批次 A +3. 再归档批次 B +4. 检查批次 B 归档后该员工的个税是否包含批次 A 的累计数据 + +### 验证点 + +- [ ] 多个未归档批次可并存 +- [ ] 自定义选择员工模式正常工作 +- [ ] `CustomEmployeeSelector` 支持部门筛选、姓名搜索、全选 +- [ ] 批次 A 先归档后,批次 B 归档时重算包含 A 的累计 +- [ ] 归档返回重算条目数 +- [ ] 手动覆盖的社保值在重算后保留 + +--- + +## 全部模板必填项标注验证 + +### 测试步骤 + +1. 下载所有导入模板: + - 员工导入模板(设置 → 数据导入 → 下载模板) + - 工资表导入模板(薪税管理 → 批次 → 工资表导入 → 下载模板) + - 专项附加扣除导入模板(薪税管理 → 专项附加扣除 → 批量导入 → 下载模板) +2. 逐个打开检查表头 + +### 验证点 + +| 模板 | Sheet | 必填字段(应有 `*`) | +|------|-------|---------------------| +| 员工导入模板 | 员工信息 | 姓名*、入职日期*、月工资* | +| | 劳动合同 | 姓名*、合同开始日期* | +| | 加班记录 | 姓名*、日期* | +| | 违纪记录 | 姓名*、日期* | +| | 考勤记录 | 姓名*、日期* | +| 工资表模板 | 工资表 | 姓名*、身份证号* | +| 专项附加扣除模板 | 专项附加扣除 | 姓名* | + +- [ ] 所有模板必填字段有 `*` 标注 +- [ ] 所有模板含至少一行示例数据 +- [ ] 导入时兼容带 `*` 和不带 `*` 的列名(`getField` 模糊匹配) + +--- + +## 部署信息 + +- **访问地址**:https://on.hr8ai.top/ +- **后端 API**:https://on.hr8ai.top/api/v1/ +- **Git 提交**:`0372cbe` — feat: 完成全部11项优化需求 + 模板必填项标注 + 归档重算个税 +- **部署时间**:2026-07-29