feat: idCardHash匹配、Roster分页过滤、社保基数调整修复、Modal size支持、Termination版本对比、UI优化

20260723-优化-2.md

@@ -0,0 +1,111 @@
+# 劳动用工合规助手 — 待实现功能清单
+
+> **文档编号**: 20260723-优化-2.md
+> **日期**: 2026-07-23
+> **来源**: 对照 `0-req.md` 需求规格说明书完整扫描后得出
+
+---
+
+## 一、部分实现（需完善）
+
+### 1. AI 流式输出
+- **现状**: `ai.service.ts` 使用同步 `chat.completions.create`，一次性返回完整回复
+- **需求**: DashScope SSE 流式返回，前端打字机效果
+- **涉及文件**: `backend/src/services/ai.service.ts`、`backend/src/routes/ai.routes.ts`、`frontend/src/pages/AIAssistant.tsx`
+- **方案**: 后端改用 `stream: true` + SSE 响应；前端用 `EventSource` 或 `fetch + ReadableStream` 逐字渲染
+
+### 2. RAG 知识库
+- **现状**: 未实现向量数据库集成
+- **需求**: 劳动法/劳动合同法/司法解释/地方条例向量化存储，Supabase pgvector + DashScope text-embedding-v2
+- **涉及文件**: 新建 `backend/src/services/rag.service.ts`、schema 新增向量表
+- **方案**: 文档分块 → DashScope embedding → 存入 pgvector → 问答时向量检索 → 注入 context
+
+### 3. AI 使用限制
+- **现状**: 未实现套餐次数限制
+- **需求**: free 10次问答/3次审查/3次案例；pro 100/20/20；enterprise 无限
+- **涉及文件**: `backend/src/routes/ai.routes.ts`、`backend/src/services/ai.service.ts`
+- **方案**: 每次调用前查询当月已用次数（按 orgId + 类型），超限返回 403
+
+### 4. 顶部导航风险角标
+- **现状**: `TopNav.tsx:44` 有角标代码但 `hidden` 固定不显示
+- **需求**: 红色角标显示待处理风险总数，点击跳转首页
+- **涉及文件**: `frontend/src/components/layout/TopNav.tsx`
+- **方案**: 查询 pending 风险数量，动态显示角标数字
+
+### 5. 审计日志写入
+- **现状**: `AuditLog` 模型存在于 schema，但无实际写入代码
+- **需求**: 关键操作（解聘/合同变更/工资调整）记录审计日志
+- **涉及文件**: `backend/src/services/contract.service.ts`、`termination.service.ts`、`roster.routes.ts` 等
+- **方案**: 在关键操作后 `prisma.auditLog.create({ orgId, userId, action, target, detail, ipAddress })`
+
+### 6. 数据导出
+- **现状**: 仅社保月度有 CSV 导出
+- **需求**: 支持导出全部数据为 JSON/Excel
+- **涉及文件**: 新建 `backend/src/routes/export.routes.ts`、前端设置页增加导出按钮
+- **方案**: 后端打包全量数据为 Excel（exceljs），前端下载
+
+### 7. 二维码生成
+- **现状**: 入职填报/合同确认有 token 链接，但无前端二维码图片
+- **需求**: HR 端生成二维码图片，可保存通过微信发给员工
+- **涉及文件**: `frontend/src/pages/Contracts.tsx` 或 `Roster.tsx`
+- **方案**: 前端引入 `qrcode.react`，生成二维码图片，支持下载
+
+### 8. 批量续签
+- **现状**: 需确认花名册列表是否有全选→批量续签功能
+- **需求**: 合同列表支持全选 → 批量续签
+- **涉及文件**: `frontend/src/pages/Roster.tsx`
+- **方案**: 列表增加 checkbox 全选，批量调用续签 API
+
+---
+
+## 二、未实现（需新建）
+
+### 9. 忘记密码 — 手机验证码重置
+- **现状**: `/forgot-password` 路由存在，但功能不完整
+- **需求**: 手机号 + 验证码 → 设置新密码
+- **涉及文件**: `frontend/src/pages/auth/ForgotPassword.tsx`、`backend/src/routes/auth.routes.ts`
+- **方案**: 复用 portal 的验证码逻辑，验证后允许重置密码
+
+### 10. AI 顾问语音输入（移动端）
+- **现状**: 未实现
+- **需求**: 移动端支持语音输入问题
+- **涉及文件**: `frontend/src/pages/AIAssistant.tsx`
+- **方案**: 使用 Web Speech API `SpeechRecognition`，语音转文字后发送
+
+### 11. 解聘记录 PDF 导出
+- **现状**: 未实现
+- **需求**: 支持导出单条解聘记录为 PDF
+- **涉及文件**: `frontend/src/pages/Termination.tsx`
+- **方案**: 前端使用 `jspdf` + `html2canvas` 生成 PDF，或后端用 `puppeteer` 生成
+
+### 12. 登录接口速率限制
+- **现状**: 未实现
+- **需求**: 登录接口限流 5次/分钟，防止暴力破解；密码错误5次锁定30分钟
+- **涉及文件**: `backend/src/routes/auth.routes.ts`、`backend/src/routes/portal.routes.ts`
+- **方案**: 使用 `express-rate-limit` 中间件，或基于 Map 的简易限流
+
+### 13. 套餐人数上限校验
+- **现状**: 未实现
+- **需求**: free 限20人，pro 限200人，enterprise 无限制；添加员工时校验
+- **涉及文件**: `backend/src/services/contract.service.ts`（createEmployee）
+- **方案**: 创建员工前查询当前员工数 + 套餐上限，超限返回 403
+
+---
+
+## 三、优先级排序
+
+| 优先级 | 编号 | 功能 | 工作量 |
+|--------|------|------|--------|
+| P0 | 4 | 顶部导航风险角标 | 小 |
+| P0 | 12 | 登录接口速率限制 | 小 |
+| P0 | 13 | 套餐人数上限校验 | 小 |
+| P1 | 5 | 审计日志写入 | 中 |
+| P1 | 1 | AI 流式输出 | 中 |
+| P1 | 9 | 忘记密码重置 | 中 |
+| P1 | 7 | 二维码生成 | 小 |
+| P2 | 3 | AI 使用限制 | 中 |
+| P2 | 8 | 批量续签 | 中 |
+| P2 | 6 | 数据导出 | 中 |
+| P3 | 2 | RAG 知识库 | 大 |
+| P3 | 11 | 解聘记录 PDF 导出 | 中 |
+| P3 | 10 | AI 语音输入 | 小 |