# 保险智能客服系统 — 快速启动指南

## 一、环境要求

| 依赖 | 版本 | 说明 |
|------|------|------|
| Docker Desktop | 最新 | 启动后等待引擎就绪 |
| Python | 3.12 | 用于运行配置脚本 |

## 二、启动步骤

### 1. 启动 Docker Desktop

双击 Docker Desktop 图标，等待右下角图标变绿。

### 2. 启动所有服务

```bash
cd d:/work/code/python/coding/baodanagent
docker compose -f docker-compose.baodan.yml up -d
```

等待约 2 分钟，首次启动需要拉取镜像。

### 3. 访问系统

| 服务 | 地址 | 说明 |
|------|------|------|
| **BaoDan 管理后台** | http://localhost:3000 | 首次访问需设置管理员账号 |
| **Vue 前端** | http://localhost:8080 | 需先 `cd frontend && pnpm dev` |
| **BaoDan API** | http://localhost:5001 | 含保险模块接口 |

### 4. 首次登录 BaoDan

1. 打开 http://localhost:3000
2. 设置管理员邮箱和密码
3. 进入后台

### 5. 配置 LLM 模型

1. BaoDan 后台 → 设置 → 模型供应商
2. 添加模型（如 OpenAI / DeepSeek / 通义千问）
3. 填入 API Key

### 6. 创建对话应用

1. BaoDan 后台 → 创建应用 → 聊天助手
2. 名称：`保险智能问答`
3. 配置 Prompt（保险行业知识问答）
4. 关联知识库（上传保险产品文档）
5. 发布 → 获取 API Key

### 7. 创建 Workflow 应用（产品推荐）

详见 [BaoDan_Workflow配置指南.md](BaoDan_Workflow配置指南.md)

### 8. 配置 API Key

```bash
python scripts/setup_baodan_api_keys.py
```

按提示输入对话应用和 Workflow 应用的 API Key。

### 9. 重启服务

```bash
docker compose -f docker-compose.baodan.yml restart baodan-api baodan-worker
```

### 10. 启动前端（可选）

```bash
cd frontend
pnpm dev
```

打开 http://localhost:8080

---

## 三、日常使用

### 启停命令

```bash
# 启动
docker compose -f docker-compose.baodan.yml up -d

# 停止
docker compose -f docker-compose.baodan.yml down

# 查看日志
docker logs baodanagent-baodan-api-1 -f

# 重启 API（代码更新后）
docker compose -f docker-compose.baodan.yml restart baodan-api
```

### 修改代码后

保险模块代码在 `api/insurance/` 目录。修改后需要：

1. 重新构建镜像：
```bash
docker compose -f docker-compose.baodan.yml build baodan-api
docker compose -f docker-compose.baodan.yml up -d baodan-api
```

2. 或者挂载模式（开发时推荐）：在 docker-compose.baodan.yml 的 baodan-api 服务中添加：
```yaml
volumes:
  - ./api/insurance:/app/api/insurance
```

---

## 四、端口说明

| 端口 | 服务 | 说明 |
|------|------|------|
| 3000 | BaoDan Web | 管理后台 + 对话界面 |
| 5001 | BaoDan API | 含保险模块接口 |
| 8080 | Vue 前端 | 保险客服前端 |
| 5433 | PostgreSQL | Docker 内数据库 |
| 6380 | Redis | Docker 内缓存 |

---

## 五、常见问题

**Q: 容器启动失败？**
A: 检查端口是否被占用：`netstat -ano | grep :5001`

**Q: 数据库连接失败？**
A: 确认 PostgreSQL 容器在运行：`docker ps | grep db`

**Q: API 返回 401？**
A: 检查 JWT_SECRET 是否配置正确

**Q: 产品推荐报错？**
A: 确认已创建 Workflow 应用并配置了 API Key