# BaoDan 源码集成指南

## 一、BaoDan 版本要求

- BaoDan 版本：>= 1.0.0（社区版）
- Python 版本：3.12
- 数据库：PostgreSQL 15+
- Redis：7+

## 二、目录结构

```
项目根目录/
├── baodan-main/          # BaoDan 源码（git clone）
│   ├── api/
│   │   ├── main.py     # ★ 你需要改的文件（加 5 行）
│   │   ├── core/       # BaoDan 核心（不改）
│   │   └── ...
│   └── web/
│       └── .env.local  # ★ 你需要改的文件（加 1 行）
├── api/
│   └── insurance/      # ★ 你的全部自研代码
├── frontend/           # ★ 你的 Vue 前端
└── docker-compose.yml
```

## 三、修改 BaoDan main.py（仅 5 行）

在 `baodan-main/api/main.py` 文件末尾添加：

```python
# ======== 保险智能客服系统 - 路由注册 ========
try:
    from insurance.routes import register_insurance_routes
    register_insurance_routes(app)
except ImportError as e:
    import logging
    logging.warning(f"Insurance module not loaded: {e}")
# ======== END 保险智能客服系统 ========
```

## 四、修改 BaoDan web/.env.local（仅 1 行）

在 `baodan-main/web/.env.local` 中添加：

```
NEXT_PUBLIC_ALLOW_EMBED=true
```

如果需要允许 iframe 嵌入到你的域名：

```
NEXT_PUBLIC_ALLOW_EMBED=true
NEXT_PUBLIC_APP_URL=https://your-domain.com
```

## 五、自研代码挂载方式

### 方式一：Docker Volume 挂载（推荐）

在 `docker-compose.yml` 中：

```yaml
baodan-api:
  image: langgenius/baodan-api:latest
  volumes:
    - ./api/insurance:/app/api/insurance  # 挂载自研代码
```

### 方式二：开发模式直接复制

```bash
# 开发时，将 insurance 目录复制到 BaoDan api 目录下
cp -r api/insurance/ baodan-main/api/insurance/
```

## 六、验证集成

```bash
# 1. 启动 BaoDan
cd baodan-main && docker compose up -d

# 2. 检查 insurance 模块是否加载
curl http://localhost:5001/api/health
# 预期：{"status": "ok"}

# 3. 测试认证接口
curl -X POST http://localhost:5001/api/auth/password-login \
  -H "Content-Type: application/json" \
  -d '{"username": "admin", "password": "test123"}'

# 4. 测试企微回调
curl http://localhost:5001/api/wecom/callback
```

## 七、BaoDan Python 模块 Import 路径

以下 import 路径需要根据实际 BaoDan 版本验证：

```python
# 数据库连接
from extensions.ext_database import db

# Redis 连接
from extensions.ext_redis import redis_client

# BaoDan 模型（用于 LLM 调用）
# from core.model_runtime.model_manager import ModelManager

# BaoDan Workflow
# from core.workflow.workflow_engine import WorkflowEngine

# BaoDan RAG 检索
# from core.rag.retrieval.dataset_retrieval import DatasetRetrieval
```

> 注意：直接 import BaoDan 内部模块有版本耦合风险。建议优先通过 BaoDan HTTP API（/v1/chat-messages 等）调用，
> 仅在性能关键路径上使用 Python 直接调用。

## 八、BaoDan API Key 获取

在 BaoDan 后台 → 应用设置 → API 访问中获取：

| Key 类型 | 用途 | 存放环境变量 |
|---------|------|-------------|
| App API Key | 对话接口 | `BAODAN_CHAT_APP_API_KEY` |
| Workflow API Key | 推荐方案 | `BAODAN_WORKFLOW_APP_API_KEY` |
| Dataset API Key | 知识库管理 | `BAODAN_DATASET_API_KEY` |