平台使用说明书

文档版本	1.0
发布日期
使用对象	平台内部人员

文档概述

文档为GameFunsion系统使用的补充说明，具体的操作说明请参考对应的操作说明书。

系统介绍

GameFunsion旨在整合各个游戏厂商，为游戏运营商提供统一的接入入口和方式，简化运营商的接入流程，减少接入时间，能够一次接入，多家厂商游戏畅玩。

GameFunsion分为两部分，后台管理系统和接口。

后台管理系统

后台管理系统为基础数据的管理、配置、数据查询统计等功能。后台管理系统内置三个角色：超级管理员、平台系统运营和运营商管理员。
不同角色有不同的权限和功能：

超级管理员

超级管理员拥有后台的所有功能，包括菜单权限配置，字典管理，系统参数配置等功能，以及SnailJob控制台，代码生成等开发使用的权限，权限级别最高，建议尽量不要使用超级管理员操作，有些系统级别的配置，修改后会影响系统的正常运行。

平台系统运营

平台系统运营为我司平台运营人员，拥有GameFunsion平台的所有数据权限。

在达成商务合作后，为运营商开户，登记运营商信息（注意运营商需要提供ip，用于后台和开放接口调用的加白），并创建运营商管理员账号（当前系统集成，运营商开户的同时，可自动创建运营商管理员账号）。创建运营商后，需要记录运营商API对接参数。

根据运营商需求，给运营商钱包充值操作和运营商所需供应商游戏进行授权。

如果需要使用单一钱包模式对接，需要录入运营商开放接口路径信息，可由平台系统运营录入，也可运营商管理员自行录入。

运营商需提供信息：

名称	货币	告警邮箱	API服务器IP	后台访问IP

平台系统运营管理员也可以创建不同的角色、管理员用户，从而实现不同运营人员的操作和权限划分。

运营商管理员

运营商管理员为运营商运营人员，可登录后台，查询对接的游戏供应商、游戏信息，玩家信息等，也可操作子运营商。

运营商管理员也可以创建自己的运营商的用户和角色，方便对不同的运营人员的权限进行管理。

接口

接口部分，主要为运营商开发人员以编码形式对接系统提供数据交互。
对接前，平台方提供调用域名，平台系统运营/运营商管理员对接入服务器ip加白，运营商管理员提供接入所需的鉴权参数。单一钱包模式需要录入运营商向GameFushion开放的各接口访问路径。
根据钱包模式不同，提供两种类型的接入方式：转账钱包和免转钱包。

转账钱包

运营商开发人员获取接入鉴权参数，通过接口获取游戏列表查询对接的游戏参数信息。
调用获取游戏url接口取得玩家进入游戏的URL，获取进入游戏URL。
玩家进入游戏时，调用上分接口，将运营商钱包金额带入游戏供应商平台，玩家跳转进入游戏的URL。进入游戏后，则可使用上分的金额进行游戏。
玩家游戏结束返回运营商时，运营商请求玩家退出游戏接口，防止玩家游戏状态不一致，导致下分失败。
调用获取玩家余额接口查询余额，根据玩家余额，调用下分接口，将上分带到游戏供应商平台的金额提取回运营商平台。
玩家游戏过程中，游戏结束后，可调用同步玩家注单记录接口，查询和记录玩家在游戏供应商游戏的注单数据。

对接流程图：

玩家进入游戏流程图：

免转钱包

运营商开发人员获取接入鉴权参数，通过接口获取游戏列表查询对接的游戏参数信息。
调用获取游戏url接口取得玩家进入游戏的URL，获取进入游戏URL。
玩家进入游戏后游玩，投注、派彩都会通过接口通知运营商，运营商需要判断玩家余额和状态，响应结果。
玩家游戏结束返回运营商时，请求运营商玩家退出游戏接口。
玩家游戏过程中，游戏结束后，可调用同步玩家注单记录接口，查询和记录玩家在游戏供应商游戏的注单数据。

对接流程图：

玩家游戏流程图：

告警

对于影响系统正常运行的一些情况，GameFusion通过监控数据和指标来检查系统情况。当存在异常情况时，会触发告警并发送通知，需要用户及时关注，保证系统正常运行。
告警主要通过三种方式通知：站内信、邮件、telegram消息（设计、开发中）
当前系统告警主要分为以下几部分：

余额告警

运营商钱包余额，在玩家进入游戏游玩时，会实时变化。当运营商钱包余额不足时，系统拒绝引起余额变化对应接口的请求，故而会影响玩家游玩。
当前系统对运营商余额设计为运营/运营商可对钱包每个货币余额设置红黄橙三级告警金额，当金额低于设定告警金额时，触发余额告警。
余额告警主要为以下几个方式通知：
1、运营商管理员登录时，如果存在告警，以站内信方式通知，体现在系统右上角的系统通知。
2、系统首页，余额告警列表，展示存在触发告警的钱包、货币和余额信息。
3、玩家游玩触发余额告警，运营商管理员在线时，以站内信方式通知，体现在系统右上角的系统通知。
4、玩家游玩触发余额告警，发送邮件到运营商提供的告警邮箱。
5、玩家游玩触发余额告警，发送告警信息到telegram群组（设计、开发中）。

运营商服务器异常告警

运营商使用免转钱包方式接入，在运营商接口管理录入“健康检查路径”后，GameFusion会通过该接口监控运营商服务器状态。
健康检查为一分钟一次，当连续三次请求未收到正常响应，则触发告警。

账号安全

后台系统安全有三层防护：
1、IP白名单，未加白的IP无法登录后台系统。
2、谷歌令牌，后台管理员账号绑定谷歌令牌后，每次登录都需要录入谷歌动态码验证，验证通过方可进行登录。
3、手机短信验证，手机短信机制属于可选验证，开启后，用户需要绑定手机号。

平台使用说明书

文档概述#

系统介绍#

后台管理系统#

超级管理员#

平台系统运营#

运营商管理员#

接口#

转账钱包#

免转钱包#

告警#

余额告警#

运营商服务器异常告警#

账号安全#