# 需求文档

## v1 需求

### R1. 数据接入层
- **R1-01**: 企微会话存档拉取（C SDK + JNA）
- **R1-02**: RSA解密 + 消息解析
- **R1-03**: 回调接收（msgaudit_notify，15秒间隔）
- **R1-04**: 消息去重与存储

### R2. AI分析引擎
- **R2-01**: 对话上下文管理（最近10轮滑动窗口）
- **R2-02**: 意图识别（40个场景多标签分类）
- **R2-03**: 学员画像构建（5维度标签体系：类型/基础/意向度/关注重点/决策阶段）
- **R2-04**: 话术召回（规则召回+向量召回+热门召回）
- **R2-05**: 话术排序（多因子加权+MMR多样性）
- **R2-06**: LLM动态话术生成（兜底策略）

### R3. 输出交互层
- **R3-01**: PC端侧边栏H5（360px，完整功能）
- **R3-02**: 手机端侧边栏H5（80%高度，精简操作）
- **R3-03**: 模板卡片消息推送（高优先级场景主动推送）
- **R3-04**: 一键发送（sendChatMessage）
- **R3-05**: WebSocket实时推送推荐结果

### R4. 管理后台
- **R4-01**: 话术库管理（CRUD+分类+导入导出）
- **R4-02**: 数据统计看板（使用数据+效果分析）
- **R4-03**: 系统配置（推送设置+免打扰）
- **R4-04**: 管理员登录与权限控制

### R5. 基础设施
- **R5-01**: 企微OAuth2认证 + JWT
- **R5-02**: API网关（路由/限流/鉴权）
- **R5-03**: MySQL 5.7 数据库（15张表）
- **R5-04**: Redis 缓存（会话/向量/Token）
- **R5-05**: RabbitMQ 消息队列（异步处理）
- **R5-06**: Docker Compose 部署

## v2 需求（后续迭代）

- 多企业租户支持
- 更复杂的反馈闭环和模型自优化
- 更丰富的数据分析维度
- 移动端App原生应用

## 数据库表清单

1. archive_messages - 企微会话存档消息
2. conversations - 会话表
3. conversation_turns - 对话轮次表
4. intent_categories - 意图分类表（40个）
5. intent_recognitions - 意图识别记录表
6. customer_profiles - 学员画像表
7. utterances - 话术库表
8. utterance_categories - 话术分类表（8个阶段）
9. utterance_performance - 话术效果表
10. recommendations - 推荐记录表
11. knowledge_documents - 知识库文档表
12. staffs - 员工表
13. customers - 客户表
14. admins - 管理员表
15. operation_logs - 操作日志表