taiyi/baodan
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
54808e4e90
baodan/docs
History
wsb1224 0b53c5a26d 优化海报前端逻辑页0731
2026-07-31 09:00:39 +08:00
..
0728修复文件.md 07-27 PDF提取优化 2026-07-28 16:45:14 +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
PDF实时解析提速与精准抽取方案.md 07-27 PDF提取优化 2026-07-28 16:45:14 +08:00
PPT_PDF解析与数据核对页面问题修复报告_20260730.md 优化海报前端逻辑页面 2026-07-30 16:07:57 +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
PPT多文件上传比对功能_详细修复计划书.md 优化海报程程页面和PPT生成页面 2026-07-30 10:08:26 +08:00
README.md 优化海报前端逻辑页0731 2026-07-31 09:00:39 +08:00
workspace-implementation-log.md 07-27 阶段 状态 进度 2026-07-28 17:53:14 +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-30 14:21:06 +08:00
海报生成工作台完整重构修复计划.md 所有阶段 3-5 的任务全部完成。最终盘点： 2026-07-29 22:14:02 +08:00
用户上传产品小册子解析与留存实施计划.md 优化海报前端逻辑页0731 2026-07-31 09:00:39 +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 海报制作中用户私有小册子的上传、解析、留存、复用与公共库审核路径

部署与运维

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

企微与集成

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

PPT 与海报功能

文档 内容摘要
海报可编辑与参考图上传专项改造计划.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. 开发任务清单 — 每天干什么、完成后打勾

写代码时参考

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