TurboHR/20260723-优化-2.md

劳动用工合规助手 — 待实现功能清单

文档编号: 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 语音输入	小