wsb1224
67b2dac23f
迁移系统加固 — 加 advisory lock 防并发，失败回滚并中止启动（原来是 catch-and-continue） 安全漏洞 — Settings/History API 权限收紧，API key 返回掩码值，海报 case 所有权校验 依赖缺失 — requirements.txt 补齐 python-pptx/openai/Pillow，Dockerfile 改为统一安装 海报鉴权下载 — 前端全部改用 authenticated blob，不再 window.open 无 token URL LLM 配置分离 — 海报文案读取 poster_llm_*（不再复用 ppt_llm_*），支持 config namespace 图片生成器 — 兼容 b64_json 和 URL 两种响应格式，追踪 generation_mode/provider/model 种子数据 — 新环境自动获得 2 个海报模板 + 2 个文案模板
181 lines
7.8 KiB
Markdown
181 lines
7.8 KiB
Markdown
# 保险智能客服系统 — 文档索引
|
||
|
||
> **最后更新**：2026-07-27
|
||
> **项目状态**：后端框架完成 + 核心功能完成 64%，产品推荐功能待实现
|
||
|
||
---
|
||
|
||
## 文档总览
|
||
|
||
### 核心规范文档
|
||
|
||
| 文档 | 内容摘要 |
|
||
|------|---------|
|
||
| [保险智能客服系统_需求文档.md](保险智能客服系统_需求文档.md) | 完整需求：137 项功能 + 5 角色 + 数据库设计 |
|
||
| [保险智能客服系统_API接口文档.md](保险智能客服系统_API接口文档.md) | 45 个接口完整设计 |
|
||
| [保险智能客服系统_编码规范.md](保险智能客服系统_编码规范.md) | 命名规范 + 项目结构 + BaoDan 集成规范 |
|
||
| [保险智能客服系统_测试用例.md](保险智能客服系统_测试用例.md) | 347 个功能测试 + 边界测试 + 上线 Checklist |
|
||
| [保险智能客服系统_文档规范.md](保险智能客服系统_文档规范.md) | 文档编写标准和模板 |
|
||
|
||
### 开发计划与任务
|
||
|
||
| 文档 | 内容摘要 |
|
||
|------|---------|
|
||
| [后续开发计划.md](后续开发计划.md) | 当前项目状态（64%）、未完成功能、开发时间表 |
|
||
| [开发任务清单.md](开发任务清单.md) | 412 项可勾选任务（已完成 182 项） |
|
||
| [后端开发文档.md](后端开发文档.md) | 后端项目结构、待开发功能、API 接口清单 |
|
||
| [前端开发计划.md](前端开发计划.md) | 前端组件代码、页面结构、开发规范 |
|
||
|
||
### 部署与运维
|
||
|
||
| 文档 | 内容摘要 |
|
||
|------|---------|
|
||
| [快速启动指南.md](快速启动指南.md) | 本地开发一键启动 + Docker 环境 |
|
||
| [部署指南.md](部署指南.md) | BaoDan 源码集成指南（修改 main.py） |
|
||
| [部署文档_完整版.md](部署文档_完整版.md) | 完整部署文档 + 架构图 + 环境变量配置 |
|
||
| [宝塔面板部署指南.md](宝塔面板部署指南.md) | 宝塔面板 Docker 部署详解 |
|
||
| [前端移动端适配指南.md](前端移动端适配指南.md) | 移动端响应式适配审计（68% 未适配） |
|
||
|
||
### 企微与集成
|
||
|
||
| 文档 | 内容摘要 |
|
||
|------|---------|
|
||
| [企业微信接入指南.md](企业微信接入指南.md) | 自建应用 + 机器人消息 + OAuth 登录 + 回调排查 |
|
||
| [Dify_Workflow配置指南.md](Dify_Workflow配置指南.md) | 产品推荐 Workflow 配置步骤 |
|
||
|
||
### PPT 与海报功能
|
||
|
||
| 文档 | 内容摘要 |
|
||
|------|---------|
|
||
| [PPT与海报功能问题整改计划.md](PPT与海报功能问题整改计划.md) | 当前问题审计、根因、文件级修复方案、测试、发布与回滚计划 |
|
||
| [PPT与海报功能完整解决方案.md](PPT与海报功能完整解决方案.md) | PPT 增强 + 海报新模块：数据库设计、API、前端、AI 生图方案（已确认） |
|
||
| [PPT与海报功能开发任务清单.md](PPT与海报功能开发任务清单.md) | 120 项可勾选任务，分 7 个 Phase，预估 11.5 天 |
|
||
| [baodanppt集成计划.md](baodanppt集成计划.md) | baodanppt 原始集成计划 |
|
||
| [baodanppt融合同步计划书.md](baodanppt融合同步计划书.md) | baodanppt 与 baodanagent 融合同步方案 |
|
||
|
||
### 参考与交付
|
||
|
||
| 文档 | 内容摘要 |
|
||
|------|---------|
|
||
| [API_curl示例.md](API_curl示例.md) | 接口调试 curl 示例（可直接复制） |
|
||
| [保险智能客服系统_客户验收单.md](保险智能客服系统_客户验收单.md) | 项目验收/交付清单 |
|
||
|
||
---
|
||
|
||
## 按用途快速索引
|
||
|
||
### 开始开发前必读
|
||
|
||
1. **[需求文档](保险智能客服系统_需求文档.md)** — 需求细节（特别是数据库设计、BaoDan 集成、数据流转图）
|
||
2. **[后续开发计划.md](后续开发计划.md)** — 哪些已完成、哪些待开发
|
||
3. **[开发任务清单](开发任务清单.md)** — 每天干什么、完成后打勾
|
||
|
||
### 写代码时参考
|
||
|
||
4. **[编码规范](保险智能客服系统_编码规范.md)** — 命名、注释、格式化、错误处理、日志、Git 规范
|
||
5. **[API 接口文档](保险智能客服系统_API接口文档.md)** — 接口设计的权威来源
|
||
6. **[API curl 示例](API_curl示例.md)** — 调试接口时直接复制
|
||
|
||
### 前端开发
|
||
|
||
7. **[前端开发计划](前端开发计划.md)** — 完整组件代码（可以直接参考/复制）
|
||
8. **[前端移动端适配指南](前端移动端适配指南.md)** — 移动端适配现状和修复方案
|
||
|
||
### 测试验收
|
||
|
||
9. **[测试用例](保险智能客服系统_测试用例.md)** — 347 个测试用例 + 上线 Checklist
|
||
10. **[客户验收单](保险智能客服系统_客户验收单.md)** — 项目交付验收
|
||
|
||
### 部署上线
|
||
|
||
11. **[快速启动指南](快速启动指南.md)** — 本地开发一键启动
|
||
12. **[部署指南](部署指南.md)** — BaoDan 源码集成步骤
|
||
13. **[部署文档_完整版](部署文档_完整版.md)** — 生产环境完整部署
|
||
14. **[宝塔面板部署](宝塔面板部署指南.md)** — 宝塔面板部署
|
||
|
||
### 企微对接
|
||
|
||
15. **[企业微信接入指南](企业微信接入指南.md)** — 完整接入流程 + 故障排查
|
||
|
||
---
|
||
|
||
## 关键决策记录
|
||
|
||
### 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 | 同步日志 |
|
||
|
||
---
|
||
|
||
## 环境变量清单
|
||
|
||
```bash
|
||
# .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（可选）
|
||
```
|