agent_9art/.planning/REQUIREMENTS.md
jiao 31a395be5e feat(01): Phase 1 - 基础设施 + 数据库 + 公共模块
- 创建10个微服务目录结构和Maven多模块配置
- 完成15张MySQL 5.7表设计和初始化数据(40意图+8话术分类+管理员)
- 实现common模块:Result、PageResult、异常处理、MyBatisPlus/Redis/RabbitMQ/跨域配置
- 实现BaseEntity、AutoFillHandler、JsonUtils、JsonTypeHandler
- 配置API Gateway路由和全部服务的application.yml
- 添加docker-compose.yml(MySQL+Redis+RabbitMQ)
2026-05-12 17:55:11 +08:00

2.2 KiB
Raw Permalink Blame History

需求文档

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 - 操作日志表