# 全局配置独立化迁移说明

## 📋 概述

将全局策略配置从依赖 `account_id=1` 改为独立的配置系统，使用独立的 `global_strategy_config` 表和 Redis 缓存。

## 🎯 目标

1. ✅ 全局配置不再依赖任何账户（account_id）
2. ✅ 独立的数据库表 `global_strategy_config`
3. ✅ 独立的 Redis 缓存键 `global_strategy_config`
4. ✅ 只有管理员可以查看和修改全局配置
5. ✅ 所有账户自动使用全局配置（通过 `config_manager.py` 读取）

---

## 📦 数据库变更

### 1. 创建新表

执行迁移脚本：
```bash
mysql -u your_user -p auto_trade_sys < backend/database/add_global_strategy_config.sql
```

**新表结构**：
```sql
CREATE TABLE `global_strategy_config` (
  `id` INT PRIMARY KEY AUTO_INCREMENT,
  `config_key` VARCHAR(100) NOT NULL,
  `config_value` TEXT NOT NULL,
  `config_type` VARCHAR(50) NOT NULL,
  `category` VARCHAR(50) NOT NULL,
  `description` TEXT,
  `updated_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
  `updated_by` VARCHAR(50),
  UNIQUE KEY `uk_config_key` (`config_key`)
)
```

### 2. 数据迁移

迁移脚本会自动将 `account_id=1` 的核心策略配置迁移到 `global_strategy_config` 表。

**迁移规则**：
- 只迁移非风险旋钮的配置
- 风险旋钮（`MIN_MARGIN_USDT`, `MAX_POSITION_PERCENT` 等）不迁移
- API密钥（`BINANCE_API_KEY`, `BINANCE_API_SECRET`）不迁移

---

## 🔧 代码变更

### 1. 数据库模型 (`backend/database/models.py`)

**新增**：`GlobalStrategyConfig` 类
- `get_all()` - 获取所有全局配置
- `get(key)` - 获取单个配置
- `set(key, value, ...)` - 设置配置
- `get_value(key, default)` - 获取配置值（自动转换类型）
- `delete(key)` - 删除配置

### 2. 配置管理器 (`backend/config_manager.py`)

**新增**：`GlobalStrategyConfigManager` 类
- 独立的 Redis 缓存键：`global_strategy_config`
- 独立的数据库表：`global_strategy_config`
- 单例模式，确保全局唯一

**修改**：`ConfigManager.get_trading_config()`
- 从 `GlobalStrategyConfigManager` 读取全局配置
- 不再依赖 `account_id=1`
- 风险旋钮仍从当前账户读取

### 3. API 路由 (`backend/api/routes/config.py`)

**新增端点**：
- `GET /api/config/global` - 获取全局配置（仅管理员）
- `PUT /api/config/global/{key}` - 更新单个全局配置（仅管理员）
- `POST /api/config/global/batch` - 批量更新全局配置（仅管理员）

**修改端点**：
- `GET /api/config/meta` - 移除 `global_strategy_account_id` 字段

**权限控制**：
- 所有全局配置端点都检查管理员权限
- 非管理员访问返回 403 错误

### 4. 前端 API 服务 (`frontend/src/services/api.js`)

**修改**：
- `getGlobalConfigs()` - 不再需要 `globalAccountId` 参数
- `updateGlobalConfigsBatch()` - 不再需要 `globalAccountId` 参数

### 5. 前端组件 (`frontend/src/components/GlobalConfig.jsx`)

**移除**：
- 所有对 `configMeta.global_strategy_account_id` 的引用
- 所有对 `globalAccountId` 的计算和使用

**简化**：
- `loadConfigs()` - 直接调用 `api.getGlobalConfigs()`，无需 account_id
- `handleApplyPreset()` - 直接调用 `api.updateGlobalConfigsBatch()`，无需 account_id
- `buildConfigSnapshot()` - 直接调用 `api.getGlobalConfigs()`，无需 account_id

---

## 🔄 迁移步骤

### 步骤1：执行数据库迁移

```bash
cd /path/to/auto_trade_sys
mysql -u your_user -p auto_trade_sys < backend/database/add_global_strategy_config.sql
```

### 步骤2：重启后端服务

```bash
# 重启 FastAPI 后端
systemctl restart your-backend-service
# 或
supervisorctl restart backend
```

### 步骤3：重启交易系统

```bash
# 重启所有交易进程，使新配置生效
supervisorctl restart all
```

### 步骤4：验证

1. **管理员登录**，进入"全局配置"页面
2. **检查配置项**：应该能看到所有核心策略配置
3. **修改配置**：尝试修改一个配置项，确认保存成功
4. **检查数据库**：确认 `global_strategy_config` 表中有数据
5. **检查 Redis**：确认 `global_strategy_config` 键中有缓存

---

## ⚠️ 注意事项

### 1. 向后兼容

- 如果 `global_strategy_config` 表不存在，系统会回退到从 `account_id=1` 读取（兼容旧系统）
- 迁移脚本会自动迁移现有配置，不会丢失数据

### 2. Redis 缓存

- 全局配置使用独立的 Redis 键：`global_strategy_config`
- 账户配置仍使用：`trading_config:{account_id}`
- 修改全局配置后，会自动更新 Redis 缓存

### 3. 权限控制

- **管理员**：可以查看和修改全局配置
- **普通用户**：无法访问全局配置 API（返回 403）
- 普通用户只能修改自己账户的风险旋钮

### 4. 配置读取优先级

1. **风险旋钮**：从当前账户的 `trading_config` 表读取
2. **核心策略参数**：从 `global_strategy_config` 表读取
3. **API密钥**：从 `accounts` 表读取（每个账户独立）

---

## 📊 配置分类

### 全局配置（管理员专用）
- `ATR_STOP_LOSS_MULTIPLIER`
- `ATR_TAKE_PROFIT_MULTIPLIER`
- `RISK_REWARD_RATIO`
- `USE_FIXED_RISK_SIZING`
- `FIXED_RISK_PERCENT`
- `USE_DYNAMIC_ATR_MULTIPLIER`
- `MIN_SIGNAL_STRENGTH`
- `SCAN_INTERVAL`
- `TOP_N_SYMBOLS`
- ... 等等所有非风险旋钮的配置

### 账户配置（每个账户独立）
- `MIN_MARGIN_USDT`
- `MIN_POSITION_PERCENT`
- `MAX_POSITION_PERCENT`
- `MAX_TOTAL_POSITION_PERCENT`
- `AUTO_TRADE_ENABLED`
- `MAX_OPEN_POSITIONS`
- `MAX_DAILY_ENTRIES`

### 账号私有配置（每个账户独立）
- `BINANCE_API_KEY`
- `BINANCE_API_SECRET`
- `USE_TESTNET`

---

## 🐛 故障排查

### 问题1：全局配置无法加载

**检查**：
1. 确认 `global_strategy_config` 表已创建
2. 确认表中有数据（执行迁移脚本）
3. 检查后端日志，查看是否有错误

**解决**：
```sql
-- 检查表是否存在
SHOW TABLES LIKE 'global_strategy_config';

-- 检查表中是否有数据
SELECT COUNT(*) FROM global_strategy_config;
```

### 问题2：管理员无法修改全局配置

**检查**：
1. 确认用户角色是 `admin`
2. 检查 API 返回的错误信息
3. 检查后端日志

**解决**：
```sql
-- 检查用户角色
SELECT id, username, role FROM users WHERE username = 'your_username';
```

### 问题3：交易系统仍使用旧配置

**检查**：
1. 确认 Redis 缓存已更新
2. 确认交易系统已重启
3. 检查 `config_manager.py` 是否正确读取全局配置

**解决**：
```bash
# 清除 Redis 缓存（可选）
redis-cli DEL global_strategy_config

# 重启交易系统
supervisorctl restart all
```

---

## ✅ 验证清单

- [ ] 数据库迁移脚本已执行
- [ ] `global_strategy_config` 表已创建
- [ ] 配置数据已迁移
- [ ] 后端服务已重启
- [ ] 交易系统已重启
- [ ] 管理员可以查看全局配置
- [ ] 管理员可以修改全局配置
- [ ] 普通用户无法访问全局配置
- [ ] 所有账户使用相同的全局配置
- [ ] Redis 缓存正常工作

---

## 📝 总结

全局配置已完全独立化，不再依赖任何账户。所有核心策略参数由管理员统一管理，存储在独立的 `global_strategy_config` 表中，使用独立的 Redis 缓存键。普通用户只能修改自己账户的风险旋钮，无法影响全局策略。