taiyi/baodan
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
75 Commits 1 Branch 0 Tags 78 MiB
Python 65.3%
JavaScript 16.2%
TypeScript 12.6%
Vue 4.3%
HTML 0.8%
Other 0.7%
d57bd59acd
Go to file
wsb1224 d57bd59acd 主要改动： 
PPT 表格现在按槽位解析，正确保留 —、空列和单空格表格，不再发生金额左移。[regex_extractor.py (line 470)](D:/work/code/python/coding/baodanagent/api/insurance/ppt/regex_extractor.py:470)
补齐年龄、累计保费、非保证现金价值、非保证身故赔偿等别名。
IUL 使用专属 LLM 提取结构，并加强年度、年龄、账户价值完整性校验。[extraction.py (line 741)](D:/work/code/python/coding/baodanagent/api/insurance/ppt/extraction.py:741)
PPT 缓存升级到 v6，旧错误缓存会自动失效。
提领方案不再与普通退保价值混淆，相关提示语已统一。
海报摘要年度金额与收益图表改为同一数据源；缺少部分里程碑时会从原始真实年度补足，不会隐藏图表。[content_builder.py (line 51)](D:/work/code/python/coding/baodanagent/api/insurance/poster/content_builder.py:51)
系统计算、利益表派生、人工修改增加来源标记。
增加“重新解析”功能，旧海报计划书无需重新上传。[routes.py (line 266)](D:/work/code/python/coding/baodanagent/api/insurance/poster/routes.py:266)
ECharts 导出增加双帧就绪检测和事件竞态保护，不再依赖不存在的 .once()。
PPT 手机端改为可编辑数据卡片，320px 操作栏自动纵向排列；补齐按钮语义、键盘焦点及 44px 触控区域。[PptDataReview.vue (line 195)](D:/work/code/python/coding/baodanagent/frontend/src/pages/components/ppt/PptDataReview.vue:195)
验证结果：
核心专项测试：145 passed
除既有聊天日志测试外的测试集：236 passed
前端生产构建：通过
Python 语法检查：通过
git diff --check：通过
Impeccable 前端检测：无发现
全量测试仅剩一个与本次无关的既有失败：test_chat_logs_query 缺少 Flask application context
2026-08-01 01:22:07 +08:00
.agents/skills/impeccable 上线阻断问题全部修复 2026-07-27 13:52:09 +08:00
.cache 0727 PPT加海报功能01版本修复-修复一个版本 2026-07-27 10:36:13 +08:00
.codex 上线阻断问题全部修复 2026-07-27 13:52:09 +08:00
.impeccable/critique 优化海报前端逻辑页面 2026-07-30 16:07:57 +08:00
api 主要改动： 2026-08-01 01:22:07 +08:00
dify-main 07-29 修复一版问题 2026-07-29 12:19:26 +08:00
docs 更新一版海报和PPT生成优化 2026-07-31 20:05:34 +08:00
frontend 主要改动： 2026-08-01 01:22:07 +08:00
plugin_files/langgenius 第一次提交。可以使用企微群消息 2026-07-02 23:13:23 +08:00
scripts 0723 PPT加海报功能01版本修复 2026-07-23 17:40:12 +08:00
tests 主要改动： 2026-08-01 01:22:07 +08:00
.env.example 更新小册子功能，优化页面的布局 2026-07-31 12:11:03 +08:00
.gitignore input_revision 正确记录 ✅ 2026-07-30 13:54:44 +08:00
AGENTS.md 上线阻断问题全部修复 2026-07-27 13:52:09 +08:00
CLAUDE.md 0723 代码整理 2026-07-23 08:52:59 +08:00
nginx-frontend.conf 第一次提交。可以使用企微群消息 2026-07-02 23:13:23 +08:00
nginx.conf 0712 修复一个版本 2026-07-12 14:17:18 +08:00
README.md 0723 整理文件 2026-07-23 08:38:11 +08:00
serve.py input_revision 正确记录 ✅ 2026-07-30 13:54:44 +08:00
保险智能客服系统_功能清单_无建议书版.xlsx 第一次提交。可以使用企微群消息 2026-07-02 23:13:23 +08:00

README.md

保险智能客服系统

基于 BaoDan 源码的保险行业智能客服系统。直接在 BaoDan 源码上开发，自研代码放在 api/insurance/ 目录下，与 BaoDan 代码物理隔离。

系统架构

用户浏览器 / 企微 H5
    │
    ▼
┌─ BaoDan 服务（BaoDan + 你的代码，同一进程）─────────────┐
│  BaoDan WebApp（对话界面，iframe 嵌入）                  │
│  BaoDan 管理后台（知识库/Prompt/模型/日志）               │
│  你的 Extensions（api/insurance/）：                   │
│    · 企微机器人 + OAuth                                │
│    · 产品推荐                                         │
│    · 角色权限                                         │
│    · 数据统计                                         │
└───────────────────────┬──────────────────────────────┘
                        │
        ┌───────────────▼───────────────┐
        │  你的前端（Vue 3，独立项目）     │
        │  对话页 / 推荐页 / 管理页       │
        └───────────────────────────────┘

技术栈

层级 技术 说明
基础平台 BaoDan 1.14.2（源码） Flask 后端 + Next.js 前端
自研后端 Python + Flask Blueprint 放在 api/insurance/，复用 BaoDan 基础设施
自研前端 Vue 3 + TypeScript + Vite + Element Plus 对话 iframe + 推荐页 + 管理页
数据库 PostgreSQL 15 复用 BaoDan 的 DB，新增 3 张自研表
向量库 BaoDan 内置 知识库检索
缓存 Redis 6 复用 BaoDan 的 Redis

项目结构

baodan-main/
├── api/
│   ├── insurance/              # ★ 你的代码（新建目录）
│   │   ├── wecom/              #   企微机器人 + OAuth
│   │   ├── recommend/          #   产品推荐
│   │   ├── permissions/        #   角色权限
│   │   ├── stats/              #   数据统计
│   │   └── db/                 #   自研数据表
│   ├── core/                   # BaoDan 核心（不动）
│   ├── controllers/            # BaoDan API（不动）
│   ├── models/                 # BaoDan 模型（不动）
│   └── main.py                 # ★ 只改这里：注册路由
│
├── web/
│   └── .env.local              # ★ 只改这里：开启 iframe
│
├── dev/                        # 开发脚本（BaoDan 自带）
└── docker/                     # Docker 部署（BaoDan 自带）

frontend/                       # 你的前端（Vue 3）
├── src/
├── package.json
└── 前端开发计划.md

deploy/
├── sql/init.sql                # 自研表建表脚本
└── nginx.conf                  # Nginx 反向代理

修改 BaoDan 文件清单

文件 改动 改动量
api/main.py 注册 insurance Blueprint ~5 行
web/.env.local 开启 iframe 嵌入 1 行
合计 只改 2 个 BaoDan 文件 ~6 行

快速开始

前置条件

  • Python 3.12 + uv
  • Node.js 22 + pnpm
  • PostgreSQL 15 + Redis 6
  • DeepSeek API Key

启动步骤

# 1. 克隆 BaoDan 源码
git clone https://github.com/langgenius/baodan.git
cd baodan

# 2. 安装依赖
./dev/setup

# 3. 配置环境变量
# 编辑 api/.env 和 web/.env.local（详见开发文档）

# 4. 启动服务（4 个终端）
./dev/start-api          # 终端1：后端（含你的 insurance 模块）
./dev/start-worker       # 终端2：Celery Worker
./dev/start-web          # 终端3：BaoDan 前端
./dev/start-beat         # 终端4：定时任务（可选）

# 5. 启动你的 Vue 前端
cd ../frontend && pnpm install && pnpm dev

# 6. 验证
curl http://localhost:5001/api/health

BaoDan 功能 vs 自研功能

功能 来源 你做什么
对话界面 BaoDan WebApp iframe 嵌入
知识库管理 BaoDan 后台 不写代码
Prompt 编辑 BaoDan 后台 不写代码
模型配置 BaoDan 后台 不写代码
对话日志 BaoDan 后台 不写代码
产品推荐 自研 api/insurance/recommend/
企微机器人 自研 api/insurance/wecom/
企微 OAuth 自研 api/insurance/wecom/
角色权限 自研 api/insurance/permissions/
数据统计 自研 api/insurance/stats/

开发文档

所有文档在 docs/ 目录，完整索引见 docs/README.md。

文档 说明
需求文档 137 项功能 + 数据库设计 + 数据流转
API 接口文档 45 个接口完整设计
后续开发计划 项目状态（64%）+ 未完成功能 + 时间表
开发任务清单 412 项可勾选任务
编码规范 编码标准 + BaoDan 集成规范
测试用例 功能/边界/异常测试 + 上线 Checklist
前端开发计划 Vue 3 前端完整组件代码
API curl 示例 接口调试 curl 示例
部署指南 完整部署文档 + 架构图

BaoDan 升级流程

cd baodan
git stash                    # 暂存你的改动
git pull origin main         # 拉取 BaoDan 新版本
git stash pop                # 恢复你的改动
# main.py 冲突 → 手动合并（只合并注册路由的 5 行）
# .env.local 冲突 → 重新加那一行
# api/insurance/ 目录永远不会冲突

许可证

BaoDan 部分：Apache 2.0 你的自研部分：MIT