# OG Live Gaming - Admin 总后台使用说明

## 目录

1. [系统概述](#1-系统概述)
2. [登录与退出](#2-登录与退出)
3. [角色权限说明](#3-角色权限说明)
4. [功能模块详解](#4-功能模块详解)
   - [代理管理](#41-代理管理)
   - [会员管理](#42-会员管理)
   - [财务管理](#43-财务管理)
   - [游戏管理](#44-游戏管理)
   - [系统管理](#45-系统管理)
   - [数据报表](#46-数据报表)
5. [核心业务流程](#5-核心业务流程)
6. [常见问题](#6-常见问题)

---

## 1. 系统概述

Admin 总后台是 OG Live Gaming 平台的最高管理系统，用于：

- 管理所有总代理及其下级代理/会员
- 进行资金上下分操作（充值/提现）
- 查看游戏记录和数据报表
- 配置游戏参数和系统设置
- 审批充值提现申请

### 访问地址

```
https://bkk.g7g7.top/
```

### 技术架构

- 后端：ThinkPHP 5.x
- 前端：Layui + jQuery
- 数据库：MySQL 5.7

---

## 2. 登录与退出

### 2.1 登录

1. 访问 Admin 后台地址
2. 输入管理员账号、密码
3. 输入图形验证码
4. 点击【登录】

### 2.2 退出

点击右上角的【退出】按钮安全退出系统。

### 2.3 修改密码

1. 点击右上角【个人信息】
2. 选择【修改密码】
3. 输入原密码和新密码
4. 点击【确认修改】

---

## 3. 角色权限说明

系统支持多种管理员角色，权限各不相同：

| 角色 | role值 | 权限范围 |
|------|--------|----------|
| **超级管理员** | 0 | 所有功能，包括代理管理、会员管理、财务、游戏配置、系统设置等 |
| **监控员** | 1 | 在线玩家查看、游戏记录查看、路单修改、公告管理、操作日志 |
| **代理管理员** | 2 | 代理管理、上下分查询、洗码查询 |
| **财务** | 4 | 代理管理、上下分、洗码管理、充值提现审批 |

---

## 4. 功能模块详解

### 4.1 代理管理

#### 4.1.1 代理列表

**路径**：代理管理 → 代理管理

**功能**：
- 查看所有总代理列表（agent_parent_id = 0 的代理）
- 搜索代理（按用户名）
- 查看代理详情（余额、码率、占成等）
- 点击【查看下级】可逐层查看下级代理

**列表字段说明**：

| 字段 | 说明 |
|------|------|
| 用户名 | 代理登录账号 |
| 联系人 | 代理昵称 |
| 上级代理 | 所属上级代理（总代显示"-"） |
| 投注方式 | 1=现金 2=信用 3=其他 |
| 最近上分 | 最后一次上分金额 |
| 商户余额 | 当前账户余额（分值） |
| 码率(%) | 百家乐/龙虎/牛牛/三卡 洗码率 |
| 占成(%) | 代理占股比例 |
| 日赢上限 | 每日最大盈利限制 |

**操作**：
- 【修改】- 编辑代理信息
- 【删除】- 软删除代理（会同时删除所有下级）
- 【查看下级】- 查看该代理的下级代理列表

#### 4.1.2 添加代理

**路径**：代理管理 → 代理管理 → 添加代理

**必填字段**：
- 账号（唯一，不可重复）
- 昵称
- 密码（至少6位）
- 确认密码

**可选配置**：
- 手机号
- 投注方式（现金/信用）
- 限红设置（最低/最高下注额）
- 洗码率（百家乐、龙虎、牛牛、三卡）
- 占成比例
- 返水率
- 备注

**重要规则**：
- 下级代理的洗码率不能超过上级
- 下级代理的占成不能超过上级
- 账号一旦创建不可修改

#### 4.1.3 上下分操作

**路径**：代理管理 → 上下分查询 → 代理上下分添加

**这是 Admin 后台的核心功能，用于给代理增加/扣减余额。**

**操作步骤**：
1. 点击【选择账号】，从代理列表中选择目标代理
2. 系统自动显示该代理当前余额
3. 输入操作金额
4. 选择操作类型：
   - **上分**：增加余额（相当于充值）
   - **下分**：扣减余额（相当于提现）
5. 填写备注说明
6. 点击【提交】

**注意事项**：
- 下分金额不能超过当前余额
- 所有操作都会记录在上下分记录中
- 操作人信息会自动记录

#### 4.1.4 上下分查询

**路径**：代理管理 → 上下分查询

**功能**：
- 查看所有代理的上下分记录
- 支持按账号、时间范围筛选
- 可导出 Excel

**记录字段**：

| 字段 | 说明 |
|------|------|
| 账号 | 被操作的代理账号 |
| 操作类型 | 上分/下分 + 类型（手动/洗码/占股/抽水） |
| 操作金额 | 本次操作金额 |
| 操作人 | 执行操作的管理员或代理 |
| 操作前余额 | 操作前的余额 |
| 余额 | 操作后的余额 |
| 创建日期 | 操作时间 |

#### 4.1.5 洗码查询

**路径**：代理管理 → 洗码查询

查看代理的洗码记录，包括洗码量、洗码费等。

#### 4.1.6 占股查询

**路径**：代理管理 → 占股查询

查看代理的占股结算记录。

#### 4.1.7 收益查询

**路径**：代理管理 → 收益查询

按代理层级查看收益汇总，包括：
- 洗码收益
- 占股收益
- 抽水收益

---

### 4.2 会员管理

#### 4.2.1 会员列表

**路径**：会员管理 → 会员管理

**功能**：
- 查看所有会员列表
- 按用户名、上级代理、状态筛选
- 按注册时间范围筛选

**列表字段**：

| 字段 | 说明 |
|------|------|
| 用户名 | 会员登录账号 |
| 联系人 | 会员昵称 |
| 上级代理 | 所属代理 |
| 投注方式 | 1=现金 2=信用 3=其他 |
| 商户余额 | 当前余额 |
| 码率(%) | 洗码率 |
| 总下注 | 累计下注金额 |
| 总赢 | 累计盈亏 |
| 码量 | 累计洗码量 |
| 状态 | 启用/禁用 |

**操作**：
- 【修改】- 编辑会员信息
- 【删除】- 软删除会员
- 【上下分】- 给会员充值/提现

#### 4.2.2 会员上下分

**路径**：会员管理 → 上下分查询 → 会员上下分添加

操作方式与代理上下分相同。

#### 4.2.3 在线玩家

**路径**：会员管理 → 在线玩家

实时查看当前在线的玩家列表，包括最后活动时间。

---

### 4.3 财务管理

#### 4.3.1 充值管理

**路径**：财务管理 → 充值管理

管理收款方式配置：
- 银行卡收款
- USDT 收款
- 其他支付渠道

#### 4.3.2 充值记录

**路径**：财务管理 → 充值记录

查看玩家的充值申请记录，可进行审批操作：
- 【通过】- 确认充值到账
- 【拒绝】- 拒绝充值申请（需填写原因）

#### 4.3.3 提现管理

**路径**：财务管理 → 提现管理

管理提现配置和手续费设置。

#### 4.3.4 提现记录

**路径**：财务管理 → 提现记录

查看玩家的提现申请记录，可进行审批操作：
- 【通过】- 确认提现完成（金额会加到总代余额）
- 【拒绝】- 拒绝提现申请（金额退回玩家账户）

---

### 4.4 游戏管理

#### 4.4.1 游戏记录

**路径**：游戏管理 → 百家乐/龙虎/牛牛 游戏记录管理

查看各游戏的注单记录，包括：
- 玩家信息
- 下注详情
- 开奖结果
- 输赢金额

支持导出 Excel。

#### 4.4.2 路单修改

**路径**：游戏管理 → 百家乐/龙虎路单修改

用于修正错误的开牌结果（仅限特殊情况使用）。

#### 4.4.3 吧台配置

**路径**：配置管理 → 吧台配置

管理游戏桌台：
- 添加/编辑桌台
- 设置桌台状态
- 配置限红
- 关联扫描器

---

### 4.5 系统管理

#### 4.5.1 公告管理

**路径**：系统管理 → 公告管理

发布和管理系统公告：
- 添加公告
- 编辑公告内容
- 设置公告状态
- 删除公告

#### 4.5.2 管理员管理

**路径**：系统管理 → 扫描用户管理 / 接口用户管理

管理扫描器用户和 API 接口用户。

#### 4.5.3 操作日志

**路径**：系统管理 → 操作日志

查看管理员的操作记录：
- 登录/退出记录
- 上下分操作记录
- 代理/会员管理记录
- 配置修改记录

#### 4.5.4 代理操作日志

**路径**：系统管理 → 代理操作日志

查看代理端的操作记录。

#### 4.5.5 用户登录日志

**路径**：系统管理 → 用户登录日志

查看所有用户（代理+会员）的登录记录。

---

### 4.6 数据报表

#### 4.6.1 充值提现查询

**路径**：代理管理 → 充值提现查询

汇总查看充值和提现数据。

#### 4.6.2 收益报表

**路径**：代理管理 → 收益查询

按代理层级查看收益数据：
- 选择代理
- 选择时间范围
- 查看洗码/占股/抽水收益

---

## 5. 核心业务流程

### 5.1 资金流向图

```
┌─────────────────────────────────────────────────────────────┐
│                      Admin 总后台                            │
│                    （资金源头，无余额概念）                    │
└─────────────────────┬───────────────────────────────────────┘
                      │ 上分操作
                      ▼
┌─────────────────────────────────────────────────────────────┐
│                      总代理 (agent_level=1)                  │
│                    余额 (money) 增加                         │
└─────────────────────┬───────────────────────────────────────┘
                      │ 给下级上分
                      ▼
┌─────────────────────────────────────────────────────────────┐
│                    一级代理 (agent_level=2)                  │
│                    余额 (money) 增加                         │
└─────────────────────┬───────────────────────────────────────┘
                      │ 给下级上分
                      ▼
┌─────────────────────────────────────────────────────────────┐
│              二级代理 / 会员 (agent_level=3 / agent=0)       │
│                    余额 (money) 增加                         │
└─────────────────────────────────────────────────────────────┘
                      │
                      ▼
                  游戏下注/提现
```

### 5.2 上分操作流程

```
1. Admin 登录后台
       ↓
2. 进入"代理管理 → 上下分查询 → 代理上下分添加"
       ↓
3. 选择目标代理账号
       ↓
4. 输入上分金额
       ↓
5. 选择"上分"类型
       ↓
6. 填写备注
       ↓
7. 提交
       ↓
8. 系统自动：
   - 写入 recharge 表（上分记录）
   - 更新 user 表 money 字段
   - 记录操作日志
```

### 5.3 提现审批流程

```
1. 玩家在前端发起提现申请
       ↓
2. Admin 在"财务管理 → 提现记录"看到待审批记录
       ↓
3. 审核提现信息（金额、银行卡等）
       ↓
4a. 【通过】
    - 玩家余额已扣减（申请时扣）
    - 提现金额加到所属总代余额
    - 总代线下完成打款
       ↓
4b. 【拒绝】
    - 填写拒绝原因
    - 金额退回玩家账户
```

---

## 6. 常见问题

### Q1: Admin 账号本身有余额吗？

**没有。** Admin 是管理员账号，存在 `cg_admin` 表中，没有 money 字段。Admin 的作用是"造钱"——可以凭空给总代理上分。

### Q2: 为什么我看不到某些菜单？

不同角色有不同权限。请确认你的账号角色：
- role=0：超级管理员，可见所有菜单
- role=1：监控员，只能看游戏相关
- role=2：代理管理员，只能看代理相关
- role=4：财务，可以看代理和财务相关

### Q3: 上分和充值有什么区别？

| 操作 | 发起方 | 作用 |
|------|--------|------|
| **上分** | Admin/代理主动操作 | 直接增加目标账户余额 |
| **充值** | 玩家发起申请 | 需要审批后才能到账 |

### Q4: 删除代理会怎样？

- 软删除（is_delete=1），数据不会真正删除
- 该代理的所有下级代理和会员也会被删除
- 已删除的代理可以在"已删除代理"页面查看

### Q5: 如何查看某个代理的所有下级？

1. 在代理列表中找到目标代理
2. 点击【查看下级】
3. 可以逐层点击查看更深层级的代理

### Q6: 洗码率和占成的区别？

| 概念 | 说明 | 示例 |
|------|------|------|
| **洗码率** | 玩家下注后按比例返还的码费 | 玩家下注10000，洗码率0.5%，得50洗码费 |
| **占成** | 代理参与盈亏分成的比例 | 占成20%，玩家输10000，代理分得2000 |

### Q7: 操作记录在哪里查看？

- Admin 操作日志：系统管理 → 操作日志
- 代理操作日志：系统管理 → 代理操作日志
- 上下分记录：代理管理 → 上下分查询

---

## 附录

### A. 数据库核心表

| 表名 | 说明 |
|------|------|
| cg_admin | 管理员账号 |
| cg_user | 代理和会员账号 |
| cg_recharge | 上下分记录 |
| cg_bet | 下注记录 |
| cg_xima | 洗码记录 |
| cg_cs | 占股记录 |
| cg_table | 游戏桌台 |
| cg_boot | 靴（一副牌） |
| cg_number_tab | 铺（一局） |

### B. 用户类型标识

| 字段 | 值 | 说明 |
|------|-----|------|
| agent | 1 | 代理 |
| agent | 0 | 会员 |
| agent_parent_id | 0 | 总代理 |
| agent_level | 1 | 总代 |
| agent_level | 2 | 一级代理 |
| agent_level | 3 | 二级代理 |

### C. 操作类型代码

| type | 说明 |
|------|------|
| 1 | 手动上分/下分 |
| 2 | 洗码结算 |
| 3 | 占股结算 |
| 4 | 代理抽水 |
| 5 | 提现相关 |

| mode | 说明 |
|------|------|
| 1 | 上分（加钱） |
| 2 | 下分（扣钱） |

---

*文档版本：1.0*
*最后更新：2025年1月*