# 劳动用工合规 SaaS — 功能层面优化清单（续）

> **文档编号**: 20260723-优化-4.md
> **日期**: 2026-07-23
> **来源**: 对 Dashboard.tsx、AIAssistant.tsx 及相关后端服务深入研究后得出
> **注意**: Contracts.tsx 和 Compensation.tsx 已无路由引用（功能已整合到 Roster 和 Termination），涉及这两个页面的条目已移除

---

## 一、高优先级（核心业务缺陷）

### 1. ✅ AIAssistant — 会话历史保存（已完成）

**状态**: 已实现会话历史保存功能。后端新增 `AIConversation` 表，前端 ChatTab 支持「新建对话」「历史会话」列表加载/切换/删除，消息自动 debounce 保存。

---

### 2. ✅ Dashboard — 待办事项批量操作（已完成）

**状态**: 已实现批量操作功能。后端新增 `PATCH /dashboard/todos/batch-resolve` 和 `batch-ignore` 端点，前端待办列表增加全选复选框和批量操作按钮。

---

## 二、中优先级（高频操作体验）

### 3. ✅ AIAssistant — 分析结果关联员工档案（已完成）

**状态**: 已实现审查/分析结果保存到员工档案功能。后端新增 `AIReviewRecord` 表和 `/ai/review/save`、`/ai/review/employee/:employeeId` 端点，前端 ReviewTab 和 CaseTab 增加「保存到员工档案」按钮和员工选择弹窗。

---

### 4. ✅ Dashboard — 风险分布可下钻（已完成）

**状态**: 已实现风险分布下钻功能。后端 `getDashboardData` 返回 `topRisks` 字段（最近5条高风险项摘要），前端风险分布卡片改为可点击，点击后展开该类型风险明细列表并支持跳转。

---

### 5. ✅ AIAssistant — 风险预测上下文查询（已完成）

**状态**: 已实现风险预测上下文查询功能。后端 `/ai/predict` 支持 `scope`（all/department/employee）、`riskType`（all/contract/salary/termination）参数，前端 PredictTab 增加预测范围、风险类型、部门/员工筛选条件。

---

## 三、低优先级（功能补全）

### 6. ✅ Roster — 附件上传类型校验（已完成）

**状态**: 已在 `Roster.tsx` 的 `handleFileUpload` 中实现文件类型校验（PDF/JPG/PNG/HEIC）和大小限制（10MB）。

---

### 7. ✅ Dashboard — 刷新按钮 Tab 级联（已完成）

**状态**: 已实现刷新按钮 Tab 级联。刷新按钮在 `risk` 和 `task` tab 下半透明且禁用（这两个 tab 数据来自 dashboard 查询的子集），在 `overview` 和 `payroll` tab 下正常显示，按钮文案根据 tab 变化（「刷新概览」/「刷新薪税」）。

---

### 8. ✅ Dashboard — 薪税 tab 导出功能（已完成）

**状态**: 已实现薪税导出功能。后端新增 `GET /export/payroll` 端点，使用 `exceljs` 导出本月已归档批次的薪税明细为 Excel（含工资构成、扣减项、企业成本、合计行），前端薪税 tab 右上角增加「导出」按钮。

---

## 四、优先级总览

| 优先级 | 编号 | 功能 | 工作量 | 状态 |
|--------|------|------|--------|------|
| P0 | 1 | AI 会话历史保存 | 中 | ✅ 已完成 |
| P0 | 2 | 待办批量操作 | 小 | ✅ 已完成 |
| P1 | 3 | AI 结果关联员工档案 | 中 | ✅ 已完成 |
| P1 | 4 | 风险分布可下钻 | 中 | ✅ 已完成 |
| P1 | 5 | 风险预测上下文查询 | 中 | ✅ 已完成 |
| P2 | 6 | 附件上传类型校验 | 小 | ✅ 已完成 |
| P2 | 7 | 刷新按钮 Tab 级联 | 小 | ✅ 已完成 |
| P2 | 8 | 薪税数据导出 | 中 | ✅ 已完成 |