# 遊戲API（OKAPI）專案功能定義

# 目錄
[toc]

## OKAPI 平台帳戶定義
**Admin**

- admin 《維護系統及管理員賬戶權限》
- admin 助手《員工賬號》協助管理平台賬戶，分成，遊戲商結算

**Agent**

    - OKAPI客戶《現金網》每個使用現金網平台接入主賬號
    - OKAPI自動完成匹配對應遊戲商

**Player** 【待開發】

    - 所有現金網創建用戶都需要通過OKAPI創建並記錄《第一版是直接轉發API到遊戲平台創建用戶》
    - OKAPI自動完成匹配對應每個遊戲商playerID，減少市場/運營維護查詢成本90%以上

## 遊戲API/SDK描述

| 遊戲商 | 描述 |開發進度|SDK支持|
| -------- | -------- | -------- |-------- |
| Joker | 綜合平台，電子遊戲 |
| GW88 | 綜合平台，電子遊戲 |
|XE | 綜合平台，電子遊戲 |
| PPSS888 |綜合平台，電子遊戲 APP模式 |
| 3WIN8 | 綜合平台，電子遊戲 |
| WWBET | 體育遊戲，無代理模式。 |

## 黑名單權限表《待開發》

**admin**

| 角色 | 對象 | 功能 |
|:-----:|:-------------:|:-----------------:|
| Admin | Agent | 關閉/暫停/活躍 |
| Admin | Player | 關閉/暫停/活躍 |
| Agent | Player | 關閉/暫停/活躍 |

----

## 核心功能


### **平台遊戲商管理**

#### 1. 建立遊戲商賬號

- ###### 功能：Admin 對應每個接入遊戲商總代賬號與secretkey

- 在遊戲商創建總代號（人工客服，市場/運營責任）
- 在遊戲商申請總代號（人工客服，市場/運營責任）secretkey
- Admin後台管理遊戲商總代號和secretkey

#### 2.開關遊戲商支持

- OKAPI後台對每個遊戲商進行開關

#### 3.遊戲商賬目管理《待開發》

- OKAPI記錄並計算針對每個遊戲商的輸贏和總賬管理
- 已結算，編輯總賬功能？？？？？《待確定》

### **平台代理 Agent創建**

#### 1. 建立賬號

- ###### 功能：現金網通過商務在OKAPI上創建代理賬號（Agent）

- 創建專屬賬號
- OKAPI市場/運營聯繫各個遊戲商創建然後手動對應到平台代理賬號。手動維護secretkey
- OKAPI自動匹配賬號對應所有遊戲商（待開發）
  a.各個遊戲商創建單一總賬號
  b.平台代理hub（組件）將所有平台代理對應到同一個遊戲商賬號
  c.平台代理hub將遊戲商代理賬分配到OKAPI各個平台代理下

#### 2.開關遊戲商支持

- OKAPI後台對每個平台代理進行開關

#### 3.OKAPI 代理佔成

- OKAPI幫助每個代理（Agent）設定佔成數

### **平台玩家Player創建**

#### 1.OKAPI只能使用API創建遊戲玩家

- OKAPI每個平台代理secretkey以及遊戲玩家管理API（文檔）
- 每個創建遊戲玩家自動出現在OKAPI代理名單下級
- 新建遊戲玩家ID（OKAPI平台ID）會對應到每個遊戲商下的玩家ID。

| OKAPI代理用戶 | OKAPI ID | 遊戲商 |ID|
|:-----:|:-------------:|:-----------------:|-------|
| example | OK000001 | JOKER |JO000001|
| | |GW88 |GW000001|
| | |BETWIN |BW000001|

### 平台代理** Admin/Agent** 員工賬號創建

#### 1. Admin和Agent都可創建員工賬號管理業務《待開發》
a. admin和agent員工賬號可從對應網址登入
b. admin和agent可設定員工賬號權限和管理內容
c. 員工賬號不可管理主賬號
d. 員工賬號必須單一登入
e. 登入/登出和操作 log記錄

### 公告《待完善》

#### 1. Admin負責管理公告

a. admin新增公告：緊急公告，平台公告，遊戲公告
b. admin管理公告開關和編輯功能
#### 2. 公告顯示為跑馬燈（Agent頁面）《待開發》
a. 跑馬燈顯示為最新一則公告（無視分類）按照時間排序

### 平台公式定義