taiyi/baoxiang

Fork 0

taiyi fd930ece79 第一次提交哦啊

2025-12-16 18:06:50 +08:00

4.2 KiB

Raw Blame History

系统设置板块配置项说明

概述

系统设置板块已经完成开发，支持以下三个核心配置项的在线管理：

1. 签到赠送喵币数量

配置键: GAME_DAILY_CHECKIN_REWARD 默认值: 1000 (分) 数据类型: 数字类型 (NUMBER) 分类: 游戏经济配置 (GAME_ECONOMY) 描述: 用户每日签到时奖励的喵币数量

使用方法:

管理员登录后台 → 系统设置 → 找到该配置项
点击"编辑"按钮
输入新的奖励数量
点击"✓"保存或按 Enter 键确认

2. 抽水设置

主播抽水

配置键: GAME_STREAMER_SHARE 默认值: 0.05 (5%) 数据类型: 数字类型 (NUMBER) 分类: 游戏经济配置 (GAME_ECONOMY) 描述: 主播从宝箱收益中的分成比例

平台抽水

配置键: GAME_PLATFORM_SHARE 默认值: 0.05 (5%) 数据类型: 数字类型 (NUMBER) 分类: 游戏经济配置 (GAME_ECONOMY) 描述: 平台从宝箱收益中的分成比例

注意: 总抽水比例由 GAME_HOUSE_EDGE 控制，默认值为 0.10 (10%)

总抽水 = 主播抽水 + 平台抽水
当前设置: 5% + 5% = 10%

3. 默认宝箱开启时间

配置键: GAME_DEFAULT_COUNTDOWN 默认值: 300 (秒) 数据类型: 数字类型 (NUMBER) 分类: 游戏逻辑配置 (GAME_LOGIC) 描述: 宝箱创建时的默认倒计时时间

相关配置:

最小倒计时: GAME_MIN_COUNTDOWN = 10 秒
最大倒计时: GAME_MAX_COUNTDOWN = 3600 秒

访问路径

前端访问

登录系统 (需要管理员权限)
访问: http://your-domain/admin
点击"系统设置"标签页

API 访问

GET /api/system/configs          # 获取所有配置
PUT /api/system/configs/{key}    # 更新配置
GET /api/system/public/configs   # 获取公开配置

操作指南

在线编辑配置

在系统设置页面找到目标配置项
点击配置值列的"编辑"按钮
输入新值
点击"✓"保存或按 Enter 键
点击"✕"取消编辑或按 Esc 键

添加新配置

在"添加新配置"表单中填写:
- 配置键: 例如 GAME_NEW_CONFIG
- 配置值: 例如 100
- 类型: STRING/NUMBER/BOOLEAN/JSON
- 描述: 配置项说明
点击"创建配置"按钮

删除配置

点击配置项操作列的"删除"按钮
确认删除操作

配置分类

所有配置项按业务领域分为四类:

1. 游戏经济配置 (GAME_ECONOMY)

新用户注册奖励
每日低保
低保门槛
总抽水比例
主播分润比例
平台分润比例
每日签到奖励 ⭐

2. 游戏逻辑配置 (GAME_LOGIC)

默认倒计时 ⭐
最小/最大倒计时
默认最大活跃宝箱数
主播抽成相关配置

3. 系统运维配置 (SYSTEM_OPERATIONS)

分页大小设置
WebSocket 相关配置

4. 界面显示配置 (UI_DISPLAY)

公告优先级设置

技术实现

后端

文件: backend/app/services/system_service.py
功能:
- initialize_default_configs(): 初始化默认配置
- get_config(): 获取单个配置
- update_config(): 更新配置
- get_all_configs(): 获取所有配置

前端

文件: frontend/src/pages/NewAdminPanel.tsx
功能:
- 在线编辑配置值
- 实时保存更新
- 键盘快捷键支持 (Enter 保存, Esc 取消)
- 权限控制 (仅管理员)

最佳实践

修改前备份: 重要配置修改前建议先记录原值
测试环境验证: 生产环境修改前先在测试环境验证
及时生效: 配置修改后无需重启服务，立即生效
合理范围: 确保修改的值在业务逻辑允许范围内
协同沟通: 涉及经济相关配置修改时需与运营团队沟通

注意事项

⚠️ 配置修改后立即生效，请谨慎操作
⚠️ 删除配置项可能导致系统异常，请确保了解影响
⚠️ 部分配置项可能已被业务逻辑缓存，更新后可能需要一定时间同步
✅ 建议定期审查配置项，确保符合当前业务需求

扩展建议

未来可考虑的增强功能:

配置变更历史记录
配置版本回滚
配置修改审批流程
配置修改通知推送
配置项分组管理
配置导入导出功能
配置依赖关系检查

4.2 KiB Raw Blame History