157 lines
4.2 KiB
Markdown
157 lines
4.2 KiB
Markdown
# 系统设置板块配置项说明
|
|
|
|
## 概述
|
|
|
|
系统设置板块已经完成开发，支持以下三个核心配置项的在线管理：
|
|
|
|
## 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 秒
|
|
|
|
## 访问路径
|
|
|
|
### 前端访问
|
|
1. 登录系统 (需要管理员权限)
|
|
2. 访问: `http://your-domain/admin`
|
|
3. 点击"系统设置"标签页
|
|
|
|
### API 访问
|
|
```
|
|
GET /api/system/configs # 获取所有配置
|
|
PUT /api/system/configs/{key} # 更新配置
|
|
GET /api/system/public/configs # 获取公开配置
|
|
```
|
|
|
|
## 操作指南
|
|
|
|
### 在线编辑配置
|
|
1. 在系统设置页面找到目标配置项
|
|
2. 点击配置值列的"编辑"按钮
|
|
3. 输入新值
|
|
4. 点击"✓"保存或按 Enter 键
|
|
5. 点击"✕"取消编辑或按 Esc 键
|
|
|
|
### 添加新配置
|
|
1. 在"添加新配置"表单中填写:
|
|
- 配置键: 例如 `GAME_NEW_CONFIG`
|
|
- 配置值: 例如 `100`
|
|
- 类型: STRING/NUMBER/BOOLEAN/JSON
|
|
- 描述: 配置项说明
|
|
2. 点击"创建配置"按钮
|
|
|
|
### 删除配置
|
|
1. 点击配置项操作列的"删除"按钮
|
|
2. 确认删除操作
|
|
|
|
## 配置分类
|
|
|
|
所有配置项按业务领域分为四类:
|
|
|
|
### 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 取消)
|
|
- 权限控制 (仅管理员)
|
|
|
|
## 最佳实践
|
|
|
|
1. **修改前备份**: 重要配置修改前建议先记录原值
|
|
2. **测试环境验证**: 生产环境修改前先在测试环境验证
|
|
3. **及时生效**: 配置修改后无需重启服务，立即生效
|
|
4. **合理范围**: 确保修改的值在业务逻辑允许范围内
|
|
5. **协同沟通**: 涉及经济相关配置修改时需与运营团队沟通
|
|
|
|
## 注意事项
|
|
|
|
1. ⚠️ 配置修改后立即生效，请谨慎操作
|
|
2. ⚠️ 删除配置项可能导致系统异常，请确保了解影响
|
|
3. ⚠️ 部分配置项可能已被业务逻辑缓存，更新后可能需要一定时间同步
|
|
4. ✅ 建议定期审查配置项，确保符合当前业务需求
|
|
|
|
## 扩展建议
|
|
|
|
未来可考虑的增强功能:
|
|
1. 配置变更历史记录
|
|
2. 配置版本回滚
|
|
3. 配置修改审批流程
|
|
4. 配置修改通知推送
|
|
5. 配置项分组管理
|
|
6. 配置导入导出功能
|
|
7. 配置依赖关系检查
|