taiyi/baodan
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
5462433036
baodan/docs
History
wsb1224 e3479f0546 上线阻断问题全部修复 
#	问题	修复	文件
1	前端构建失败（引号错误）	size="small type=" → size="small" type="	PosterHistoryPage.vue
2	migrate_014 ORM vs 缺失列	全部改为原始 SQL，不再引用 ORM 模型	migrate_014.py
3	cleanup 字段名错误	output_path → ppt_path	cleanup.py
4	文案生成 case 越权	添加 case.user_id != user_id 校验	poster/service.py
5	存储路径未接通持久化卷	全部改用 get_storage_root()（默认 /app/api/storage/insurance）	config.py, ppt/routes.py, poster/service.py, poster/tasks.py
高风险问题修复
#	问题	修复	文件
6	migrate_019 rollback 撤销成功字段	每个 ALTER 后立即 commit，失败只回滚当前语句	migrate_019.py
7	迁移锁 Windows 不兼容 + 句柄未持久化	全局变量保存锁句柄，支持 Windows msvcrt	api/insurance/db/__init__.py
8	PDF 校验异常时放行	异常返回 False（文件损坏）	security.py
9	健康检查始终返回成功	缺少关键资源时返回 503 + missing 列表	poster/routes.py
10	短密钥掩码泄露原值	≤4 字符返回 ****	ppt_admin_service.py
11	设置无键名白名单	添加 _ALLOWED_SETTING_KEYS 白名单	ppt_admin_service.py
12	容器重启任务永久 stuck	添加 recover_stale_tasks() 启动恢复函数	poster/tasks.py, ppt/parse_worker.py
2026-07-27 13:52:09 +08:00
..
API_curl示例.md 第一次提交。可以使用企微群消息 2026-07-02 23:13:23 +08:00
baodanppt融合同步计划书.md 0723 PPT功能初步融合 2026-07-23 13:10:50 +08:00
baodanppt集成计划.md 0723 PPT功能初步融合 2026-07-23 13:10:50 +08:00
Dify_Workflow配置指南.md 第一次提交。可以使用企微群消息 2026-07-02 23:13:23 +08:00
PPT与海报功能完整解决方案.md 0723 PPT加海报功能初步完成 2026-07-23 15:04:16 +08:00
PPT与海报功能开发任务清单.md 0723 PPT加海报功能初步完成 2026-07-23 15:04:16 +08:00
PPT与海报功能问题整改计划.md 上线阻断问题全部修复 2026-07-27 13:52:09 +08:00
README.md slidesConfig 结构错误 — migrate_017 输出改为数组格式，migrate_019 修复历史数据 2026-07-27 13:21:34 +08:00
企业微信接入指南.md 0723 整理文件 2026-07-23 08:38:11 +08:00
保险智能客服系统_API接口文档.md 第一次提交。可以使用企微群消息 2026-07-02 23:13:23 +08:00
保险智能客服系统_客户验收单.md 0723 整理文件 2026-07-23 08:38:11 +08:00
保险智能客服系统_文档规范.md 0723 整理文件 2026-07-23 08:38:11 +08:00
保险智能客服系统_测试用例.md 第一次提交。可以使用企微群消息 2026-07-02 23:13:23 +08:00
保险智能客服系统_编码规范.md 第一次提交。可以使用企微群消息 2026-07-02 23:13:23 +08:00
保险智能客服系统_需求文档.md 第一次提交。可以使用企微群消息 2026-07-02 23:13:23 +08:00
前端开发计划.md 第一次提交。可以使用企微群消息 2026-07-02 23:13:23 +08:00
前端移动端适配指南.md 第一次提交。可以使用企微群消息 2026-07-02 23:13:23 +08:00
后端开发文档.md 第一次提交。可以使用企微群消息 2026-07-02 23:13:23 +08:00
后续开发计划.md 第一次提交。可以使用企微群消息 2026-07-02 23:13:23 +08:00
宝塔面板部署指南.md 第一次提交。可以使用企微群消息 2026-07-02 23:13:23 +08:00
开发任务清单.md 第一次提交。可以使用企微群消息 2026-07-02 23:13:23 +08:00
快速启动指南.md 第一次提交。可以使用企微群消息 2026-07-02 23:13:23 +08:00
部署指南.md 第一次提交。可以使用企微群消息 2026-07-02 23:13:23 +08:00
部署文档_完整版.md 第一次提交。可以使用企微群消息 2026-07-02 23:13:23 +08:00

README.md

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

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

文档总览

核心规范文档

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

开发计划与任务

文档 内容摘要
后续开发计划.md 当前项目状态（64%）、未完成功能、开发时间表
开发任务清单.md 412 项可勾选任务（已完成 182 项）
后端开发文档.md 后端项目结构、待开发功能、API 接口清单
前端开发计划.md 前端组件代码、页面结构、开发规范

部署与运维

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

企微与集成

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

PPT 与海报功能

文档 内容摘要
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. 开发任务清单 — 每天干什么、完成后打勾

写代码时参考

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

前端开发

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

测试验收

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

部署上线

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

企微对接

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

关键决策记录

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（可选）