baodan/docs

保险智能客服系统 — 文档索引

最后更新：2026-08-02 项目状态：后端框架完成 + 核心功能完成 64%，产品推荐功能待实现

---

文档总览

核心规范文档

文档	内容摘要
保险智能客服系统_需求文档.md	完整需求：137 项功能 + 5 角色 + 数据库设计
保险智能客服系统_API接口文档.md	45 个接口完整设计
保险智能客服系统_编码规范.md	命名规范 + 项目结构 + BaoDan 集成规范
保险智能客服系统_测试用例.md	347 个功能测试 + 边界测试 + 上线 Checklist
保险智能客服系统_文档规范.md	文档编写标准和模板

开发计划与任务

文档	内容摘要
后续开发计划.md	当前项目状态（64%）、未完成功能、开发时间表
开发任务清单.md	412 项可勾选任务（已完成 182 项）
后端开发文档.md	后端项目结构、待开发功能、API 接口清单
前端开发计划.md	前端组件代码、页面结构、开发规范
用户上传产品小册子解析与留存实施计划.md	海报制作中用户私有小册子的上传、解析、留存、复用与公共库审核路径

部署与运维

文档	内容摘要
快速启动指南.md	本地开发一键启动 + Docker 环境
部署指南.md	BaoDan 源码集成指南（修改 main.py）
部署文档_完整版.md	完整部署文档 + 架构图 + 环境变量配置
宝塔面板部署指南.md	宝塔面板 Docker 部署详解
前端移动端适配指南.md	移动端响应式适配审计（68% 未适配）

企微与集成

文档	内容摘要
企业微信接入指南.md	自建应用 + 机器人消息 + OAuth 登录 + 回调排查
Dify_Workflow配置指南.md	产品推荐 Workflow 配置步骤

PPT 与海报功能

文档	内容摘要
PDF计划书解析后续演进详细计划_20260802.md	完整可复用解析流程：后台可编辑画像、金标测试、纠错审核、版本发布/回滚和新保司接入
海报可编辑与参考图上传专项改造计划.md	精简方案：单图/长图 HTML 海报、文字直接修改、完整计划数据复用、参考图上传和 PNG 导出
海报生成工作台完整重构修复计划.md	海报二期重构执行基线：自由上传、来源校验、AI 视觉候选、可编辑画布、多格式导出、后台同步、测试与上线
PPT与海报功能问题整改计划.md	当前问题审计、根因、文件级修复方案、测试、发布与回滚计划
PPT与海报功能完整解决方案.md	PPT 增强 + 海报新模块：数据库设计、API、前端、AI 生图方案（已确认）
PPT与海报功能开发任务清单.md	120 项可勾选任务，分 7 个 Phase，预估 11.5 天
baodanppt集成计划.md	baodanppt 原始集成计划
baodanppt融合同步计划书.md	baodanppt 与 baodanagent 融合同步方案

参考与交付

文档	内容摘要
API_curl示例.md	接口调试 curl 示例（可直接复制）
保险智能客服系统_客户验收单.md	项目验收/交付清单

---

按用途快速索引

开始开发前必读

1. 需求文档 — 需求细节（特别是数据库设计、BaoDan 集成、数据流转图）
2. 后续开发计划.md — 哪些已完成、哪些待开发
3. 开发任务清单 — 每天干什么、完成后打勾

写代码时参考

4. 编码规范 — 命名、注释、格式化、错误处理、日志、Git 规范
5. API 接口文档 — 接口设计的权威来源
6. API curl 示例 — 调试接口时直接复制

前端开发

7. 前端开发计划 — 完整组件代码（可以直接参考/复制）
8. 前端移动端适配指南 — 移动端适配现状和修复方案

测试验收

9. 测试用例 — 347 个测试用例 + 上线 Checklist
10. 客户验收单 — 项目交付验收

部署上线

11. 快速启动指南 — 本地开发一键启动
12. 部署指南 — BaoDan 源码集成步骤
13. 部署文档_完整版 — 生产环境完整部署
14. 宝塔面板部署 — 宝塔面板部署

企微对接

15. 企业微信接入指南 — 完整接入流程 + 故障排查

---

关键决策记录

BaoDan 复用决策（不再重复造轮子）

以下功能 直接用 BaoDan 后台，不写后端接口、不写前端页面：

功能	BaoDan 提供	对应需求
LLM 模型配置 CRUD	ModelProviderCredentialApi	6.1
Prompt 编辑/版本/测试	App 配置 + Annotation	6.2
对话日志查看/筛选	BaoDan /logs 页面	4.1.1-4.1.2
负反馈管理	FeedbackExportApi	4.1.4
点赞/点踩	BaoDan WebApp 内置	1.4.1
推荐追问	SuggestedQuestionApi	1.2.4
来源引用	RAG 自动返回	1.2.3
会话标题命名	BaoDan 自动命名	1.1.5
知识库 hit testing	HitTestingApi	3.4.1
FAQ 管理	Annotation Reply	3.4.3
文档上传/删除/重试	BaoDan /datasets 后台	3.1-3.2
Markdown 渲染	BaoDan WebApp	1.2.1

后端自研接口（25+4 个）

模块	接口数	说明
认证 A1	4	企微登录 + 账密登录 + 刷新 + 退出
对话 A2	5+2	发消息 SSE + 会话 CRUD + 反馈 + 检索
推荐 A3	4	生成 + 轮询 + 导出 + 分享
知识库 A4	6+4	文档增强 + 数据源 CRUD + 同步
权限 A5	3	用户 CRUD + 批量导入 + 角色
日志 A7	1	系统操作日志
统计 A8	3	概览 + 趋势 + KB 健康度
企微 WB	4	回调 + 消息 + OAuth 入口 + 回调

前端页面（11 个）

类型	页面	说明
用户端	LoginPage / ChatPage / RecommendPage / RecommendHistory / RecommendDetail	5 个
管理端	DashboardPage / UsersPage / PermissionsPage / StatsPage / KBManagePage / DataSourcePage	6 个

---

数据库表（6 张）

Phase 0-5（已有建表 SQL）

表名	用途
wecom_user_mapping	企微用户 ↔ BaoDan 用户映射
recommendation_records	推荐方案记录
system_operation_logs	系统操作审计日志

Phase 7（需追加）

表名	用途
document_metadata	文档编号/标签/险种/保司
datasource_configs	保司 API 数据源配置
datasource_sync_logs	同步日志

---

环境变量清单

# .env（BaoDan + 自研共用）
JWT_SECRET=your-secret-key-here          # JWT 签名密钥
WECOM_CORP_ID=ww1234567890              # 企微企业 ID
WECOM_AGENT_ID=1000002                   # 企微应用 AgentID
WECOM_AGENT_SECRET=your-secret           # 企微应用密钥
WECOM_TOKEN=your-callback-token          # 回调消息验证 Token
WECOM_AES_KEY=your-43-char-key           # 消息加密密钥
WECOM_WEBHOOK_URL=https://...            # 告警通知 Webhook（可选）

BAODAN_CHAT_APP_API_KEY=app-xxxxxxxx       # BaoDan 对话应用 API Key
BAODAN_WORKFLOW_APP_API_KEY=app-yyyyyyyy   # BaoDan Workflow 应用 API Key
BAODAN_DATASET_API_KEY=dataset-xxx         # BaoDan 知识库 API Key（可选）