544 lines
14 KiB
Markdown
544 lines
14 KiB
Markdown
# 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月*
|