baodan/CONFIG_COMPLETE.md

# ✅ 配置完成总结

## 已完成的配置

### 1. 环境变量配置 ✅

- [x] 创建 `.env` 文件
- [x] 生成安全的 JWT_SECRET
- [x] 配置数据库连接
- [x] 配置 Redis 连接
- [x] 配置 Dify/BaoDan API Key
- [x] 配置前端参数

### 2. 部署脚本 ✅

- [x] 创建 `deploy.sh` (Linux/Mac)
- [x] 创建 `deploy.bat` (Windows)
- [x] 创建 `check-env.sh` (环境检查)
- [x] 添加执行权限

### 3. 文档 ✅

- [x] 创建 `DEPLOY_README.md` (部署指南)
- [x] 创建 `CONFIG_COMPLETE.md` (本文件)

### 4. 项目结构 ✅

- [x] `api/insurance/` - 自研后端代码
- [x] `frontend/dist/` - 前端构建产物
- [x] `deploy/sql/` - 数据库初始化脚本
- [x] `scripts/` - 部署辅助脚本
- [x] `Dockerfile.dify-custom` - API 镜像
- [x] `Dockerfile.web-custom` - Web 镜像
- [x] `docker-compose.dify.yml` - Docker Compose 配置

## 配置文件说明

### .env 文件

```bash
# 数据库配置
DATABASE_URL=postgresql://postgres:taiyi1224@db:5432/baodan

# Redis 配置
REDIS_URL=redis://redis:6379/0

# JWT 认证（已生成安全密钥）
JWT_SECRET=c9ffb3f03f617d3d6eabd41da8305510badeb5762a4018c8b0d37e4131308fa5

# Dify/BaoDan API Key
DIFY_CHAT_APP_API_KEY=app-Q7f84VH2lopTya4CCvBGNrgk
DIFY_WORKFLOW_APP_API_KEY=app-GeFitFFzFNqxTfqmbTvQsyNA
```

### docker-compose.dify.yml 服务

| 服务 | 端口 | 说明 |
|------|------|------|
| baodan-api | 5001 | API 服务 + Insurance 模块 |
| baodan-web | 3000 | Web 管理后台 |
| baodan-worker | - | Celery 异步任务 |
| db | 5433 | PostgreSQL 数据库 |
| redis | 6380 | Redis 缓存 |
| plugin_daemon | 5002 | 插件守护进程 |
| sandbox | 8194 | 代码执行沙箱 |

## 快速启动

### Windows

```cmd
deploy.bat
```

### Linux/Mac

```bash
./deploy.sh
```

### 手动启动

```bash
# 1. 检查环境
./check-env.sh

# 2. 构建镜像
docker build -t baodanagent-dify-api:latest -f Dockerfile.dify-custom .
docker build -t baodanagent-dify-web:latest -f Dockerfile.web-custom .

# 3. 启动服务
docker compose -f docker-compose.dify.yml up -d

# 4. 查看日志
docker compose -f docker-compose.dify.yml logs -f
```

## 访问地址

| 服务 | 地址 | 说明 |
|------|------|------|
| 前端应用 | http://localhost:8080 | Vue 3 前端 |
| 管理后台 | http://localhost:3000 | BaoDan 后台 |
| API 服务 | http://localhost:5001 | 后端 API |

## 默认管理员账号

- **邮箱**: taiyi@baodan.com
- **密码**: taiyi1224

## 待办事项（可选）

### 1. 企微配置（如需对接企业微信）

编辑 `.env` 文件，填入企微配置：

```bash
WECOM_CORP_ID=your_corp_id
WECOM_SECRET=your_app_secret
WECOM_TOKEN=your_callback_token
WECOM_AES_KEY=your_aes_encoding_key
```

### 2. 修改默认密码（生产环境）

```bash
# 编辑 docker-compose.dify.yml
ADMIN_PASSWORD=your_strong_password
JWT_SECRET=your_jwt_secret
```

### 3. 配置 HTTPS（生产环境）

使用 Nginx 反向代理，参考 `deploy/nginx.conf`

### 4. 配置域名（生产环境）

修改 `docker-compose.dify.yml` 中的 URL 配置：

```yaml
CONSOLE_API_URL: https://your-domain.com
CONSOLE_WEB_URL: https://your-domain.com
```

## 故障排查

### 1. 端口冲突

```bash
# 检查端口占用
netstat -tulpn | grep -E ':(5001|3000|5433|6380)'

# 修改 docker-compose.dify.yml 中的端口映射
ports:
  - "5002:5001"  # 将 5001 改为 5002
```

### 2. 数据库连接失败

```bash
# 检查 PostgreSQL 状态
docker compose -f docker-compose.dify.yml exec db pg_isready -U postgres

# 查看数据库日志
docker compose -f docker-compose.dify.yml logs db
```

### 3. 服务启动失败

```bash
# 查看详细日志
docker compose -f docker-compose.dify.yml logs baodan-api

# 重启服务
docker compose -f docker-compose.dify.yml restart
```

## 文件清单

```
baodanagent/
├── .env                    # ✅ 环境变量配置
├── .env.example            # 环境变量模板
├── .gitignore              # Git 忽略规则
├── deploy.sh               # ✅ Linux/Mac 部署脚本
├── deploy.bat              # ✅ Windows 部署脚本
├── check-env.sh            # ✅ 环境检查脚本
├── DEPLOY_README.md        # ✅ 部署指南
├── CONFIG_COMPLETE.md      # ✅ 配置完成总结（本文件）
├── docker-compose.dify.yml # Docker Compose 配置
├── Dockerfile.dify-custom  # API 镜像
├── Dockerfile.web-custom   # Web 镜像
├── api/insurance/          # 自研后端代码
├── frontend/dist/          # 前端构建产物
├── deploy/sql/             # SQL 初始化脚本
└── scripts/                # 部署辅助脚本
```

## 下一步

1. **运行部署脚本**：`./deploy.sh` 或 `deploy.bat`
2. **访问系统**：http://localhost:8080
3. **登录管理后台**：http://localhost:3000
4. **配置模型**：在管理后台配置 LLM API Key
5. **创建知识库**：上传保险相关文档
6. **测试对话**：验证系统功能

## 技术支持

- 项目文档：[docs/README.md](docs/README.md)
- API 文档：[docs/保险智能客服系统_API接口文档.md](docs/保险智能客服系统_API接口文档.md)
- 故障排查：[DEPLOY_README.md](DEPLOY_README.md)

---

**配置完成时间**: 2026-06-19
**配置状态**: ✅ 就绪