# BossAi 开发任务清单

> 任务状态:`[ ]` 未开始、`[x]` 已完成。系统唯一用户为老板,企业作为老板属性,无角色/多租户概念。

## MVP 范围

**纳入**:劳动用工风险、合同审查与生成、催款与违约、情绪陪伴、每日提醒、证据/函件生成、阅后即焚、会话加密、隐私急停、人工专业复核、法规知识库 RAG、设置持久化、工单 SLA 与专家分配。

**不纳入**:复杂财税自动申报、全量 ERP 接管、医疗诊断、自动对外发函、无人工审核的高风险法律结论、完整易经决策体系、多专业服务生态、多租户/角色权限。

**开发原则**:先打通"提问/上传 → 事实追问 → 风险判断 → 行动建议 → 文件生成/人工升级 → 隐私销毁"主闭环,再扩展外围能力。

## 已完成进度

- [x] MVP 核心代码骨架:隐私会话、会话级密钥摘要、过期清理、手动销毁。
- [x] 安全优先的风险分诊器:绿色/橙色/红色分级。
- [x] API 服务:健康检查、会话、提问、销毁、文件临时接收。
- [x] 接入 Kimi(Moonshot)云端模型,跑通主闭环:会话创建 → 风险分诊 → Kimi 答复 → 文件接收 → 隐私急停 → 销毁后 410。
- [x] 前端 UI 体系:React+Vite+TS+Tailwind+shadcn,B 端布局,公共组件(PageLayout/StatusBadge/RiskCardView/EmptyState/LoadingState/ErrorState/ChatPanel),驾驶舱和法务参谋页面接通 API。
- [x] 全部功能页面:ask 接口扩展 scene 参数(legal/decision/life/emotion + emotion_mode),经营决策、生活助理、情绪中心、设置页面,全部接通 Kimi。
- [x] PostgreSQL 数据库:knowledge_docs/user_settings/expert_rules/review_tickets 四表 + 种子数据。
- [x] 法规知识库 RAG:中文 2-gram 分词 + TF-IDF 排序 + ask 接口自动注入上下文。
- [x] 设置项持久化:GET/PUT,12 项老板个人偏好(隐私/记忆/云端/通知+自动升级)。
- [x] 人工复核工单:创建/列表/详情/状态更新,从风险卡升级创建,PII 脱敏。
- [x] 工单 SLA 和专家分配:按风险等级自动分配(green→法务顾问72h / amber→法务顾问48h / orange→执业律师24h / red→资深律师4h),SLA 实时计算(normal/warning/overdue),专家规则可配置。
- [x] 9 项 API 测试全部通过。

## 待办

### AI 能力

- [x] 接入 Tesseract OCR,支持图片/扫描件中文识别(本地运行,隐私优先)。
- [x] 文件解析:支持 PDF、DOCX、图片(OCR)上传,完成文本提取。
- [ ] 合同条款分段、条款类型识别和关键字段抽取。(未来调用外部 API,暂不开发)
- [ ] 语音输入、转写、说话人区分。
- [ ] 文件生成:通知、催款函、劳动催告、合同修订和证据清单模板,支持 DOCX 导出(阅后即焚模式默认禁止)。
- [x] 文件生成:催款函/劳动催告书/解除合同通知书/证据清单/通用通知书 DOCX 导出,阅后即焚禁止。
- [x] 法规更新任务:定时检查 + 变更检测 + 版本快照 + 回滚(8 项测试通过,外部数据源预留接口)。
- [x] 知识库分片、TF-IDF 向量化、余弦相似度检索、关键词索引。

### 隐私与安全

- [x] 销毁流程补全:清理消息/密钥/临时文件,记录销毁日志(不含正文),支持重试。
- [x] 销毁任务状态查询:GET /sessions/{sid}/destroy-status。
- [x] 允许用户仅保存脱敏行动摘要,保存前展示将保留的字段(POST /summaries/preview)。
- [x] 推理位置展示:ask 响应返回 inference_location(cloud/local),前端风险卡显示。
- [x] 日志脱敏:中间件过滤手机号/身份证号/银行卡号,只记录路径和状态码。
- [x] 对话历史落库:普通模式明文存储,保密模式 AES-256 加密存储,阅后即焚不落库。
- [x] 历史查询 API:普通模式直接查看,保密模式需登录密码二次验证后解密返回。
- [x] 对话历史页面:会话列表(按模式过滤)+ 消息详情(含风险卡)+ 保密模式密码验证弹窗 + 删除历史。
- [x] 对话历史测试:7 项通过(加密往返/普通落库/保密加密/阅后即焚不落库/过滤/删除/用户隔离)。
- [x] 管理后台 AI 使用统计:GET /admin/ai-usage(总提问数/场景分布/模式分布/风险分布/推理位置/趋势/用户排行,脱敏,不含具体内容)。
- [x] 管理后台专家沟通统计:GET /admin/expert-activity(总咨询/状态分布/分类分布/专家分布/趋势/用户排行,脱敏,不含具体内容)。
- [x] 管理后台统计测试:4 项通过(不含具体内容/手机号脱敏/维度正确)。
- [ ] 断网基础模式,明确展示当前推理位置(本地/边缘/云端)。本地模型接入后完善。

### 后端基础设施

- [x] API 限流(内存令牌桶,可配置 RATE_LIMIT)+ 模型降级(Kimi 失败回退本地分诊)。
- [x] 可观测性:GET /metrics(请求数/平均延迟/模型调用量/销毁统计/错误数)。
- [x] 加密备份:backup.sh(pg_dump + gzip + 可选 GPG 加密 + 滚动 7 天)。
- [x] CI/CD:GitHub Actions(后端测试 + 前端构建,PostgreSQL 服务容器)。
- [x] 灾难恢复演练:备份恢复往返验证 + 数据删除验证(8 项测试通过)。

### 测试

- [x] 集成测试:74 项全部通过(API + 对抗 + 阅后即焚 + 灾难恢复 + 发布检查 + 法规更新)。
- [x] 法务评测集:296 个脱敏问题,覆盖四级风险和 7 个分类,分诊器准确率 100%。
- [x] 对抗测试:18 项全部通过(提示注入/恶意文件/越权访问/模型幻觉/隐私泄漏/限流)。
- [x] 阅后即焚测试:16 项全部通过(超时/退出/重复销毁/销毁后访问/临时文件清理/崩溃恢复)。
- [x] 性能测试:并发会话/长文档/OCR/RAG/销毁,性能基线已建立。
- [x] 发布前检查清单:6 项全部通过。

### 客户端

- [x] 移动端适配:Sidebar 抽屉折叠 + 响应式 grid + viewport meta。
- [x] 弱网适配:请求超时(30s/60s)+ 自动重试 + 离线指示器 + 429 限流提示。
- [x] PWA 支持:manifest + service worker(静态 cache-first,API network-first)。

## 发布前检查清单

- [x] 所有高风险回答均有依据、事实缺口和人工升级提示。
- [x] 阅后即焚会话在所有异常路径均可销毁,且无正文日志。
- [x] 本地、边缘、云端处理位置对用户透明可见。
- [x] 用户可随时关闭长期记忆、云端调用、备份和企业知识库写入。
- [x] 正式合同、诉讼和劳动争议留档提醒已上线。
- [x] 易经、情绪和健康内容均有明确边界和危机升级入口。