# 系统设置板块配置项说明

## 概述

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

## 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. 配置依赖关系检查