# 蜀道安全管理系统 - 部署指南

## 1. 环境准备

### 1.1 配置文件
本项目使用 `conf/app.conf` 进行配置管理。该文件未包含在版本控制中，部署时需要手动创建。

**步骤:**
1. 进入项目根目录 `shudao-go-backend`。
2. 复制配置模板:
   ```bash
   cp conf/app.conf.example conf/app.conf
   ```
3. 编辑 `conf/app.conf`，根据当前环境（本地/测试/生产）修改配置项。

### 1.2 关键配置项说明
- **base_url**: 系统基础URL，用于生成OSS代理链接等。
- **mysql_***: 数据库连接信息。
- **oss_***: 对象存储配置（MinIO/S3）。
- **deepseek_api_key**: AI模型API密钥。
- **yolo_base_url**: 隐患识别服务地址。

## 2. 部署流程

### 2.1 本地开发 (Local Development)
支持热重载，适合开发调试。

```bash
# 确保已安装 bee 工具
go install github.com/beego/bee/v2@latest

# 启动服务
cd shudao-go-backend
bee run
```

### 2.2 测试/生产环境部署 (Production Deployment)

**编译:**
```bash
cd shudao-go-backend
go build -o shudao-chat-go main.go
```

**运行:**
```bash
# 赋予执行权限
chmod +x shudao-chat-go

# 启动服务 (建议使用 nohup 或 supervisor 管理进程)
nohup ./shudao-chat-go &
```

## 3. 验证部署

1. **检查日志**: 查看 `nohup.out` 或控制台输出，确认没有配置加载错误。
2. **健康检查**: 访问 `/api/health` (如果已实现) 或尝试调用基础接口。
3. **功能验证**:
   - 上传一张图片，验证OSS配置是否正确。
   - 发起一次AI对话，验证模型服务配置。

## 4. 常见问题

**Q: 启动时报错 "配置项 xxx 未设置或为空"**
A: 检查 `conf/app.conf` 是否包含该配置项，且值不为空。

**Q: 数据库连接失败**
A: 检查 `mysql_urls` 和 `mysql_port` 是否正确，以及防火墙是否允许连接。

**Q: 图片无法预览**
A: 检查 `base_url` 是否配置为当前环境的可访问地址（如 `https://aqai.shudaodsj.com:22000`）。