6.0 KiB
6.0 KiB
配置值格式统一方案(简化版)
🎯 统一原则
核心原则:前端和后端使用相同的值(比例形式),只在显示时转换
数据格式
- 数据库存储:比例形式(0.30表示30%)
- 前端显示:百分比形式(30%,用户看到)
- 前端存储:比例形式(0.30,直接存储,不做转换)
- 后端使用:比例形式(0.30,直接使用,不做转换)
🔧 当前前端逻辑分析
ConfigPanel.jsx
显示逻辑(getInitialDisplayValue):
// 从数据库读取0.30,显示为30%
const percent = numVal <= 1 ? numVal * 100 : numVal
return formatPercent(percent) // 显示30
存储逻辑(handleSave):
// 用户输入30,转换为0.30存储
if (processedValue < 0 || processedValue > 100) {
return
}
processedValue = processedValue / 100 // 30 -> 0.30
onUpdate(processedValue) // 存储0.30
问题:
- ✅ 显示逻辑:正确(0.30 -> 30%)
- ✅ 存储逻辑:正确(30 -> 0.30)
- ⚠️ 但代码中有
numVal <= 1 ? numVal * 100 : numVal的逻辑,如果数据库中有旧数据(30),会显示为30而不是3000
✅ 简化方案
方案:统一为比例形式,前端只做显示转换
原则:
- 数据库统一存储比例形式(0.30表示30%)
- 前端显示时转换(0.30 -> 30%,用户看到30%)
- 前端输入时转换(用户输入30 -> 0.30存储)
- 后端直接使用(0.30,不需要转换)
优势:
- ✅ 数据格式统一(数据库、前端、后端都是0.30)
- ✅ 代码逻辑简单(不需要到处做格式转换)
- ✅ 减少出错(避免格式不一致)
🔧 需要修改的地方
1. 前端显示逻辑(保持不变)
当前逻辑:
// 从数据库读取0.30,显示为30%
const percent = numVal <= 1 ? numVal * 100 : numVal
return formatPercent(percent)
说明:
- ✅ 如果数据库存储0.30,显示为30%(正确)
- ⚠️ 如果数据库存储30(旧数据),显示为30(需要数据迁移)
2. 前端存储逻辑(保持不变)
当前逻辑:
// 用户输入30,转换为0.30存储
if (processedValue < 0 || processedValue > 100) {
return
}
processedValue = processedValue / 100 // 30 -> 0.30
onUpdate(processedValue) // 存储0.30
说明:
- ✅ 用户输入30,转换为0.30存储(正确)
- ✅ 后端验证:只接受0-1之间的值(正确)
3. 后端代码(移除格式转换)
当前代码(backend/config_manager.py:735-758):
# ⚠️ 关键修复:百分比配置值格式转换
if isinstance(value, (int, float)) and value is not None:
if key in percent_keys:
if value > 1:
value = value / 100.0 # 格式转换
建议:
- 数据迁移完成后,可以移除格式转换逻辑
- 或者保留作为兼容性处理(标记为临时方案)
4. 数据迁移(必须执行)
目的:将数据库中的百分比形式(30)转换为比例形式(0.30)
脚本:backend/database/migrate_percent_configs_to_ratio.sql
执行后:
- 数据库统一存储比例形式(0.30)
- 前端显示为30%(用户看到)
- 前端存储为0.30(直接存储)
- 后端使用0.30(直接使用)
📊 数据流
当前流程(有格式转换)
用户输入30
↓
前端转换:30 -> 0.30
↓
存储到数据库:0.30
↓
后端读取:0.30
↓
代码中格式转换:0.30 -> 0.30(如果>1才转换)
↓
使用:0.30
统一后流程(无格式转换)
用户输入30
↓
前端转换:30 -> 0.30(仅前端输入时转换)
↓
存储到数据库:0.30
↓
后端读取:0.30
↓
直接使用:0.30(不需要转换)
✅ 实施步骤
步骤1:执行数据迁移
# 执行SQL迁移脚本
mysql -u username -p database_name < backend/database/migrate_percent_configs_to_ratio.sql
步骤2:清除Redis缓存
# 清除Redis缓存,让系统重新加载配置
redis-cli DEL "config:trading_config:*"
redis-cli DEL "config:global_strategy_config:*"
步骤3:验证数据格式
-- 验证:所有百分比配置项应该在0-1之间
SELECT config_key, config_value
FROM trading_config
WHERE config_key IN (
'TRAILING_STOP_ACTIVATION',
'TRAILING_STOP_PROTECT',
'MIN_VOLATILITY',
'TAKE_PROFIT_PERCENT',
'STOP_LOSS_PERCENT'
)
AND config_type = 'number'
AND (CAST(config_value AS DECIMAL(10, 4)) < 0 OR CAST(config_value AS DECIMAL(10, 4)) > 1);
-- 应该返回0行
步骤4:保留格式转换作为兼容性处理(可选)
建议:数据迁移完成后,保留格式转换逻辑作为兼容性处理,但标记为临时方案
代码:
# ⚠️ 临时兼容性处理:如果数据库中有旧数据(百分比形式),自动转换
# 数据迁移完成后,可以移除此逻辑
if isinstance(value, (int, float)) and value is not None:
if key in percent_keys:
if value > 1:
value = value / 100.0
logger.warning(f"配置值格式转换(临时兼容): {key} = {value*100:.2f}% (从百分比形式转换为比例形式)")
📝 总结
统一方案
- 数据库存储:比例形式(0.30表示30%)
- 前端显示:百分比形式(30%,用户看到)
- 前端存储:比例形式(0.30,直接存储)
- 后端使用:比例形式(0.30,直接使用)
优势
- ✅ 数据格式统一:数据库、前端、后端都是0.30
- ✅ 代码逻辑简单:不需要到处做格式转换
- ✅ 减少出错:避免格式不一致导致的bug
- ✅ 易于维护:统一的格式,更容易理解和维护
实施建议
- 立即执行数据迁移:统一数据格式
- 保留格式转换作为兼容性处理:标记为临时方案
- 后续可以移除格式转换:数据格式统一后,可以移除