# 企业用工专家 — 20260729 用户反馈优化需求梳理

> 来源：用户测试反馈
> 整理日期：2026-07-29
> 优先级标注：🔴 高 / 🟡 中 / 🟢 低

---

## 需求 1：花名册导入模板优化 🔴

**问题描述**
- 导入模板中必填项没有标注，用户不清楚哪些字段必须填写
- 示例数据放在第一行，删除后看不到格式参考，来回测试麻烦

**优化方案**
1. 模板表头添加必填标注：必填字段列名加 `*` 号或红色标注（如 `姓名*`、`身份证号*`、`入职日期*`）
2. 示例行使用浅灰色背景并标注「示例数据（导入时请删除本行）」
3. 或在导入页面展示「字段说明」折叠面板，列出每个字段的必填/选填、格式要求

**涉及模块**
- 后端：`backend/src/routes/import.routes.ts` — 模板生成逻辑
- 前端：`frontend/src/pages/Settings.tsx` — 数据导入 Tab

**完成方式** ✅
- 模板表头必填字段加 `*` 号标注（`姓名*`、`身份证号*`、`入职日期*`、`月工资*`）
- 新增 `getField()` 工具函数，兼容带 `*` 后缀列名和模糊匹配
- 性别列标注「选填，留空自动识别」，导入时从身份证号第 17 位自动提取

---

## 需求 2：工资专项附加扣除批量导入 🟡

**问题描述**
- 专项附加扣除信息在员工入职时可能尚未采集到
- 当前只能在薪税管理中逐月手动录入，没有单独的批量导入功能

**优化方案**
1. 在「薪税管理 → 专项附加扣除」Tab 新增「批量导入」按钮
2. 提供专项附加扣除导入模板（员工姓名/身份证号 + 各项扣除金额）
3. 支持「复制上月」基础上批量修改后导入

**涉及模块**
- 前端：`frontend/src/pages/Money.tsx` — 专项附加扣除 Tab
- 后端：`backend/src/routes/import.routes.ts` — 新增导入接口

**完成方式** ✅
- 后端新增 `GET /import/special-deduction/template` 端点，下载专项附加扣除导入模板（含姓名、身份证号、5 项扣除金额列）
- 后端新增 `POST /import/special-deduction` 端点，支持 Excel 批量导入并按月 upsert
- 前端 `SocialInsurance.tsx` 专项附加扣除 Tab 工具栏新增「批量导入」按钮
- 导入弹窗包含：模板下载、文件上传、导入结果反馈（成功/跳过/错误明细）
- 身份证号优先匹配，未填时用姓名匹配

---

## 需求 3：导入结果反馈不明确 🔴

**问题描述**
- 导入后不显示成功提示，用户不知道是否已导入
- 显示了行错误但实际数据已导入，导致重复导入

**优化方案**
1. 导入完成后弹出结果摘要：`成功导入 N 条，失败 M 条，跳过 K 条`
2. 成功时 toast 提示「导入成功，共 N 条记录」
3. 部分成功时明确提示「部分成功：N 条成功，M 条失败」
4. 失败行可下载错误日志（已有），但需在页面显示失败汇总

**涉及模块**
- 前端：`frontend/src/pages/Settings.tsx` — 导入结果展示
- 后端：`backend/src/routes/import.routes.ts` — 返回导入统计

**完成方式** ✅
- 后端返回 `skipped`（跳过）、`duplicates`（重复）、`details`（逐行明细）字段
- 前端显示分类汇总：成功 N 条、跳过 M 条、重复 K 条
- 新增「导出错误日志」按钮，下载 Excel 格式的逐行错误明细

---

## 需求 4：证据链导出格式优化（TXT → Excel）🔴

**问题描述**
- 证据链导出为 TXT 格式，排版混乱，无法直接使用
- 需要导出后二次加工，体验差

**优化方案**
1. 证据链导出改为 Excel（.xlsx）格式
2. 按证据类型分 Sheet 或分列展示：证据名称、类型、日期、内容摘要、附件链接
3. 支持导出为 Word 文档（可选），带格式排版

**涉及模块**
- 后端：`backend/src/routes/export.routes.ts` — 证据链导出逻辑
- 前端：`frontend/src/pages/Evidence.tsx` — 导出按钮

**完成方式** ✅
- 后端新增 `GET /:id/evidence-chain/export` 端点，使用 ExcelJS 生成 `.xlsx` 文件
- Excel 包含 3 个 Sheet：员工信息、证据清单（含合同/工资条/加班/考勤/违纪/培训/绩效/解聘）、风险提醒
- 前端 `EvidenceChain.tsx` 导出按钮改为调用新端点下载 Excel

---

## 需求 5：花名册身份证后四位搜索不可用 🔴

**问题描述**
- 搜索框提示「搜索姓名、部门或身份证后4位」，但用后四位搜索显示无结果

**优化方案**
1. 后端搜索逻辑支持身份证号后四位模糊匹配（`LIKE '%XXXX'`）
2. 前端搜索时自动识别纯数字输入，走身份证后四位匹配逻辑
3. 测试验证：输入身份证后四位能正确匹配到对应员工

**涉及模块**
- 后端：`backend/src/routes/roster.routes.ts` — 搜索查询逻辑

**完成方式** ✅
- 搜索正则改为支持 2+ 位纯数字输入识别为身份证号搜索
- 后端解密完整身份证号后与搜索词做后缀匹配

---

## 需求 6：用工文本模板库功能不明确 🟡

**问题描述**
- 用户不清楚文本模板库的使用方式
- 想另存或下载劳动合同模板，没找到操作入口

**优化方案**
1. 模板列表页新增「下载 Word」按钮，可直接下载模板文件
2. 新增「复制为新模板」按钮，基于现有模板创建副本后编辑
3. 页面顶部添加使用说明：「选择模板 → 点击使用 →填充变量 → 生成文档 → 下载」
4. 模板预览支持在线查看完整内容

**涉及模块**
- 前端：`frontend/src/pages/Templates.tsx`
- 后端：`backend/src/routes/template.routes.ts`（如有）

**完成方式** ✅
- 后端新增 `GET /templates/:id/download` 端点，返回模板内容为 Word（.doc）文件
- 前端 `Templates.tsx` 新增「下载 Word」按钮，可直接下载模板为 .doc 文件
- 新增「复制为新模板」按钮，将渲染结果复制到剪贴板，可粘贴到 Word 中编辑
- 页面顶部新增「使用说明」可折叠面板，引导用户完成模板选择→变量填充→渲染→下载流程
- 模板原文和渲染结果区域均支持下载 Word

---

## 需求 7：用工体检诊断评分标准说明 🟡

**问题描述**
- 用工体检只显示分数，没有评分标准和满分说明
- 用户不知道分数含义和计算规则

**优化方案**
1. 体检结果页面顶部展示评分说明卡片：
   - 满分 100 分
   - 分数等级：90-100 优秀（绿色）、75-89 良好（蓝色）、60-74 合格（黄色）、<60 风险（红色）
   - 评分维度及权重说明
2. 每个扣分项展示扣分原因和对应的法规依据
3. 结果下方展示「改善建议」清单

**涉及模块**
- 前端：`frontend/src/pages/tools/HealthCheck.tsx`

**完成方式** ✅
- 前端 `HealthCheck.tsx` 新增评分标准说明卡片，展示 3 级评分等级：85+ 健康（绿）、60-84 中等风险（黄）、<60 高风险（红）
- 卡片底部展示 6 维度评分构成说明：合同管理、薪酬社保、考勤加班、规章制度、解聘合规、证据链
- 每个维度列出具体评分要素（如合同签订率、社保覆盖率等）

---

## 需求 8：试用期员工区分与转正提醒 🔴

**问题描述**
- 导入员工时无法区分试用期和正式员工
- 系统没有试用期到期转正提醒

**优化方案**
1. 花名册导入模板新增「员工状态」列（试用期/正式），默认试用期
2. 花名册列表新增「员工状态」列和筛选
3. 试用期员工显示试用期到期日期，到期前 30/15/7 天自动提醒
4. 工作日历自动显示试用期到期事件
5. 总览待办事项中新增「试用期即将到期」提醒

**涉及模块**
- 后端：`backend/prisma/schema.prisma` — Employee 模型新增 status/probationEndDate 字段
- 后端：`backend/src/routes/roster.routes.ts` — 导入和查询支持
- 前端：`frontend/src/pages/Roster.tsx` — 列表展示和筛选
- 前端：`frontend/src/pages/Dashboard.tsx` — 待办提醒

**完成方式** ✅
- 后端 `roster.routes.ts` 返回 `probationInfo` 对象：含 `isProbation`、`probationMonths`、`probationEndDate`、`daysToConfirmation`、`isExpiringSoon`
- 试用期状态从合同 `probationMonths` + `hireDate` 动态计算，无需新增 schema 字段
- 前端花名册列表试用期员工显示橙色标签（试用期 X 个月 · 剩余 Y 天）
- 前端状态筛选新增「试用期」选项，发送 `ACTIVE` 到后端后本地过滤 `probationInfo.isProbation`

---

## 需求 9：考勤页面增加导入入口 🟡

**问题描述**
- 考勤数据导入入口在「设置 → 数据导入」中，用户在考勤页面找不到导入功能

**优化方案**
1. 在「考勤管理」页面工具栏新增「导入考勤」按钮
2. 点击后弹出导入弹窗，包含：模板下载 + 文件上传 + 导入结果反馈
3. 各功能模块的导入入口就近放置（薪税管理也同步处理）

**涉及模块**
- 前端：`frontend/src/pages/Attendance.tsx` — 新增导入按钮和弹窗
- 后端：`backend/src/routes/import.routes.ts` — 考勤导入接口

**完成方式** ✅
- 前端 `Attendance.tsx` 考勤确认 Tab 工具栏新增「导入考勤」按钮
- 点击弹出导入弹窗，包含：模板下载、文件上传、导入结果反馈（考勤记录/加班/员工/合同条数）
- 复用已有 `POST /import/excel` 端点，支持考勤记录 Sheet 导入
- 导入后自动刷新考勤列表和统计数据

---

## 需求 10：花名册导入体验优化 🔴

**问题描述**
- 模板繁琐，没有标注必填项
- 性别需要手动填写，但可从身份证号自动识别

**优化方案**
1. 同需求 1：模板标注必填项
2. 性别字段改为选填，后端导入时根据身份证号自动识别性别（身份证第 17 位奇数=男，偶数=女）
3. 若用户手动填写了性别且与身份证识别不一致，以身份证为准并提示
4. 导入模板中性别列标注「选填，留空自动识别」

**涉及模块**
- 后端：`backend/src/routes/import.routes.ts` — 导入逻辑
- 后端：`backend/src/services/` — 身份证解析工具函数

**完成方式** ✅（与需求 1 合并实现）
- 模板必填字段加 `*` 号标注
- 性别字段改为选填，导入时从身份证号第 17 位自动识别（奇数=男，偶数=女）
- 若用户未填性别则自动识别，若已填则以用户填写为准

---

## 需求 11：薪税发薪批次创建流程优化 🔴

**问题描述**
- 上一批次未归档就无法创建新批次，不便于处理多笔发薪
- 创建发薪只能选全部人员或空白创建后逐个勾选，效率低

**优化方案**
1. **允许多个未归档批次并存**：移除「上一批次未归档不能创建新批次」的限制
2. **创建发薪时支持先选人再创建**：
   - 新增「选择发薪人员」步骤：可按部门筛选、多选员工、搜索勾选
   - 确认人员后点击「创建发薪批次」，仅包含选中员工
3. 保留「全部人员」快捷选项，同时支持「自定义选择」模式

**涉及模块**
- 前端：`frontend/src/pages/Money.tsx` — 发薪批次创建流程
- 后端：`backend/src/routes/payroll2.routes.ts` — 批次创建接口支持指定员工列表
- 后端：`backend/src/services/payroll.service.ts` — 批次创建逻辑

**完成方式** ✅
- 后端移除「当月存在未归档批次则拒绝创建」的限制，允许多个未归档批次并存
- `createBatchSchema` 新增 `mode: 'custom'` 和 `employeeIds: string[]` 可选参数
- 后端新增 `custom` 模式分支：仅拉入 `employeeIds` 指定的员工创建批次
- 前端创建批次弹窗新增「自定义选择员工」选项
- 新增 `CustomEmployeeSelector` 组件：支持按部门筛选、姓名搜索、全选/取消全选、勾选指定员工
- 前端移除创建按钮上的未归档批次拦截逻辑
- **归档时强制重算**：批次归档前遍历所有条目调用 `calcBatchEntry` 重算个税和社保，确保累计预扣计算包含先前已归档批次的数据，解决多批次并存时累计个税不准的问题
  - `calcBatchEntry` 内部仍只查询 `status: 'ARCHIVED'` 的批次做累计计算
  - DRAFT 批次创建时基于已归档历史数据预计算（可能不包含同月其他 DRAFT 批次）
  - 归档时重算确保最终值准确：批次A先归档 → 批次B归档时重算会包含A的累计数据
  - 手动覆盖的社保值通过 `overrideSocial` 参数保留
  - 重算后更新批次汇总金额，返回重算条目数和错误信息

---

## 优先级汇总

| 优先级 | 需求编号 | 需求名称 | 状态 |
|--------|----------|----------|------|
| 🔴 高 | 1 | 花名册导入模板标注必填项 | ✅ 已完成 |
| 🔴 高 | 3 | 导入结果反馈不明确 | ✅ 已完成 |
| 🔴 高 | 4 | 证据链导出改为 Excel | ✅ 已完成 |
| 🔴 高 | 5 | 身份证后四位搜索修复 | ✅ 已完成 |
| 🔴 高 | 8 | 试用期员工区分与转正提醒 | ✅ 已完成 |
| 🔴 高 | 10 | 导入性别自动识别 | ✅ 已完成 |
| 🔴 高 | 11 | 薪税发薪批次流程优化 | ✅ 已完成 |
| 🟡 中 | 2 | 专项附加扣除批量导入 | ✅ 已完成 |
| 🟡 中 | 6 | 文本模板库功能完善 | ✅ 已完成 |
| 🟡 中 | 7 | 用工体检评分标准说明 | ✅ 已完成 |
| 🟡 中 | 9 | 考勤页面增加导入入口 | ✅ 已完成 |

---

*以上需求按用户反馈整理，🔴 高优先级和 🟡 中优先级需求已全部完成（2026-07-29）。*