C9 Platform — 商戶接入指南

目標讀者：商戶（白牌客戶）、商務對接人員、營運主管
版本：v1.0
最後更新：2026-03-01
文件性質：本文件為 C9 白牌娛樂城平台的商戶接入與營運操作指南，涵蓋站點開通、後台操作、模組配置、日常營運等完整流程。

第 1 章：白牌平台簡介
第 2 章：站點開通流程
第 3 章：後台操作手冊
第 4 章：遊戲管理
第 5 章：金流管理
第 6 章：VIP 系統配置
第 7 章：活動管理
第 8 章：代理推廣系統
第 9 章：客服配置
第 10 章：風控管理
第 11 章：報表使用
第 12 章：前台佈局配置
第 13 章：雲端儲存
第 14 章：常見問題 FAQ
第 15 章：術語對照表

第 1 章：白牌平台簡介

1.1 什麼是白牌平台

白牌平台（White-Label Platform）是一種成熟的商業模式，指由技術提供商（即 C9 平台方）負責開發、維護、營運底層基礎設施，而商戶（即您）則在此基礎上建立自有品牌的線上娛樂城。

簡而言之，您無需從零開始開發任何技術系統。C9 平台提供：

完整的前台網站：面向您的用戶的遊戲平台，支援電腦版和行動版
專業的後台管理系統：功能完善的管理介面，讓您輕鬆管理所有業務
穩定的後端服務：處理所有商業邏輯、資料庫、排程任務

您只需要提供：

品牌名稱與標識：您的娛樂城名稱、Logo、品牌色彩
營運域名：您希望用戶訪問的網址
營運決策：開啟哪些遊戲、設定哪些活動、如何配置 VIP 制度等

1.2 商戶獲得什麼

當您成為 C9 白牌商戶，您將獲得以下完整配備：

1.2.1 自有品牌的前台網站

項目	說明
自有域名	使用您自己的網址，如 `www.lucky88.com`
品牌標識	自訂 Logo（大圖、小圖）、Favicon、吉祥物
品牌色彩	自訂主色調、強調色、表面色等完整色彩體系
多語系支援	最多支援 5 種語系：繁體中文、英文、簡體中文、泰文、越南文
響應式設計	自動適配桌面版和行動版
佈局配置	可自訂底部導航列、頁尾、「了解更多」區塊

1.2.2 獨立的業務配置

項目	說明
遊戲配置	獨立選擇開啟哪些遊戲商和遊戲分類
VIP 制度	獨立的 VIP 等級體系，不限等級數量
返水規則	獨立配置 VIP 等級 x 8 種遊戲類型的返水比例
金流通道	獨立的金流群組和通道配置
代理系統	獨立的代理推廣體系、佣金費率、代理等級
活動系統	獨立的優惠活動管理
風控規則	獨立的 IP 黑白名單、遊戲黑名單
客服管道	獨立配置多達 8 種客服聯繫方式

1.2.3 專業的後台管理系統

項目	說明
管理員體系	支援多角色、多群組的管理員權限系統
16 大權限模組	精細的權限控制，可針對每個功能設定讀/寫權限
2FA 安全認證	Google Authenticator 雙重認證，保障帳號安全
多站點管理	若您擁有多個站點，可在同一後台切換管理
即時報表	7 大報表類型，支援 CSV 匯出
操作紀錄	所有管理操作均有完整日誌追蹤

1.2.4 豐富的遊戲生態

遊戲類型	編號	說明
體育 (SPORTS)	1	體育賽事投注
老虎機 (SLOT)	2	經典及視頻老虎機
真人 (LIVE)	3	真人荷官遊戲
彩票 (LOTTERY)	4	各類彩票遊戲
棋牌 (CHESS)	5	撲克、麻將等桌遊
電競 (ESPORTS)	8	電子競技投注
加密 (CRYPTO)	9	加密貨幣相關遊戲
捕魚 (FISH)	10	捕魚達人類遊戲

1.3 共享基礎設施

以下基礎設施由 C9 平台方統一維護，所有商戶共享：

項目	說明
後端伺服器	NestJS v11 高效能伺服器，自動擴展
資料庫	MySQL 主從架構，資料隔離安全
快取層	Redis 高速快取，提升用戶體驗
遊戲商整合	BetSolutions、RSG 等遊戲供應商 API 對接
金流整合	萬通金流（ATM/信用卡）、USDT 加密貨幣
雲端儲存	Cloudflare R2 物件儲存
即時匯率	台灣銀行即時匯率自動轉換
排程引擎	自動化的反水結算、保級檢查、佣金結算
安全防護	JWT 認證、裝置指紋辨識、IP 風控
持續更新	平台功能持續迭代，您無需負擔開發成本

1.4 商戶的核心優勢

1.4.1 零開發成本

不需要技術團隊
不需要伺服器維護
不需要安全防護知識
所有技術問題由平台方處理

1.4.2 快速上線

提供品牌素材後，最快 1-3 個工作天即可完成站點開通
使用「帶入模板」功能，一鍵套用預設配置
使用「同預設站點」功能，從範本站快速複製所有設定

1.4.3 專業管理介面

68 個管理頁面，涵蓋所有營運需求
直覺化操作介面，無需技術背景
支援繁中、英文、簡中、泰文、越南文等多語系介面
響應式設計，平板與桌面皆可操作

1.4.4 持續升級

平台功能持續迭代更新
新增遊戲商或金流商時，商戶無需做任何前端改動
安全漏洞即時修補
效能持續優化

1.5 系統架構簡圖

                        ┌─────────────────────┐
                        │   您的品牌域名        │
                        │  www.lucky88.com     │
                        └──────────┬──────────┘
                                   │
                        ┌──────────▼──────────┐
                        │   C9 前台 (Nuxt 4)  │
                        │   您的品牌色彩/Logo   │
                        │   您的域名配置        │
                        └──────────┬──────────┘
                                   │
                ┌──────────────────┼──────────────────┐
                │                  │                   │
    ┌───────────▼──────┐  ┌───────▼────────┐  ┌──────▼───────────┐
    │   遊戲供應商      │  │  金流供應商     │  │  C9 後端 (NestJS) │
    │  BetSolutions    │  │  萬通金流       │  │  業務邏輯/排程     │
    │  RSG             │  │  USDT          │  │  MySQL / Redis    │
    └──────────────────┘  └────────────────┘  └──────────────────┘
                                                       │
                                              ┌────────▼────────┐
                                              │  C9 後台 (Next)  │
                                              │  您的管理介面     │
                                              └─────────────────┘

1.6 資料隔離與安全

C9 平台採用嚴格的多站點資料隔離機制：

安全措施	說明
站點代碼隔離	每個商戶有唯一的 `siteCode`，所有資料均綁定此代碼
資料庫層級隔離	所有資料表的查詢均包含 `siteCode` 條件
API 層級隔離	後端 API 自動注入站點代碼，防止跨站存取
認證隔離	前台用戶和後台管理員使用獨立的 JWT 認證策略
權限隔離	後台管理員依群組權限控制可操作的功能範圍
金流隔離	每個站點有獨立的金流群組和通道配置
遊戲配置隔離	每個站點可獨立開啟/關閉遊戲商和遊戲分類
風控隔離	IP 黑白名單、遊戲黑名單均按站點獨立配置

1.7 幣別與精度規範

C9 平台對金額處理有嚴格的精度規範：

用途	型別	精度	說明
金額	decimal(18,6)	小數 6 位	所有餘額、存提款金額
匯率	decimal(18,10)	小數 10 位	台灣銀行即時匯率
百分比	decimal(5,2)	小數 2 位	返水比例、佣金費率
倍率	decimal(10,2)	小數 2 位	活動打碼倍率

重要：系統內部所有金額一律使用 USD（美元） 計價。用戶入金時，系統自動透過台灣銀行即時匯率將當地幣別轉換為 USD。USD 金額採用無條件捨去（Math.floor(value * 1e6) / 1e6）。

1.8 支援語系

C9 平台支援以下 5 種語系，商戶可選擇啟用其中任意組合：

語系代碼	語言	說明
`zh-TW`	繁體中文	預設語系
`en-US`	English	英文
`zh-CN`	简体中文	簡體中文
`th-TH`	ภาษาไทย	泰文
`vi-VN`	Tiếng Việt	越南文

前台和後台均支援以上語系，切換方式為 Cookie 記錄（URL 不會顯示語系前綴）。

第 2 章：站點開通流程

本章詳細說明從零開始建立一個全新白牌站點的完整流程。整個過程分為 8 個步驟，建議按順序依次完成。

2.1 流程總覽

步驟 1：提供基本資訊       ← 商戶準備
步驟 2：後台建立站點       ← 管理員操作
步驟 3：配置主題色彩       ← 管理員操作
步驟 4：設定域名與 DNS     ← 管理員 + 技術人員
步驟 5：配置遊戲商         ← 管理員操作
步驟 6：配置金流商         ← 管理員操作
步驟 7：配置客服管道       ← 管理員操作
步驟 8：上傳品牌素材       ← 管理員操作

預計總耗時：1-3 個工作天（視素材準備程度而定）

2.2 步驟 1：提供基本資訊

在開通站點之前，商戶需要準備並提供以下基本資訊：

2.2.1 必填資訊

項目	格式	範例	說明
站點代碼	大寫英文+數字，最多 30 字元	`LUCKY88`	系統內部唯一識別碼，建立後不可更改
白牌前綴	小寫英文+數字，最多 30 字元	`lucky88`	對應 R2 檔案路徑與後台站點 ID
站點名稱	多語系 JSON 格式	見下方範例	每種語系一個名稱
營運域名	完整域名	`www.lucky88.com`	用戶訪問的網址
品牌主色	色彩值（HEX 或色名）	`#10B981`（翡翠綠）	網站主要色彩
支援語系	語系代碼清單	`["zh-TW", "en-US"]`	要啟用的語系

2.2.2 站點名稱格式範例

站點名稱需提供多語系版本，格式如下：

json

{
  "zh-TW": "Lucky88 娛樂城",
  "en-US": "Lucky88 Casino",
  "zh-CN": "Lucky88 娱乐城",
  "th-TH": "Lucky88 คาสิโน",
  "vi-VN": "Lucky88 Casino"
}

注意：即使您只開啟 2 種語系，仍建議提供全部 5 種語系的翻譯，以便未來擴展。

2.2.3 站點介紹格式範例

站點介紹也需要多語系版本：

json

{
  "zh-TW": "Lucky88 提供最豐富的線上娛樂體驗，包含真人、老虎機、體育投注等多種遊戲。",
  "en-US": "Lucky88 offers the richest online entertainment experience with live dealers, slots, sports betting and more.",
  "zh-CN": "Lucky88 提供最丰富的在线娱乐体验，包含真人、老虎机、体育投注等多种游戏。",
  "th-TH": "Lucky88 มอบประสบการณ์ความบันเทิงออนไลน์ที่สมบูรณ์ที่สุด",
  "vi-VN": "Lucky88 mang đến trải nghiệm giải trí trực tuyến phong phú nhất."
}

2.2.4 品牌素材清單

素材	建議尺寸	格式	用途
Logo（小）	200 x 60 px	PNG（透明背景）	導航列、頁首
Logo（大）	400 x 120 px	PNG（透明背景）	登入頁、載入畫面
Favicon	32 x 32 px 或 64 x 64 px	ICO / PNG	瀏覽器標籤圖示
吉祥物	自訂	PNG（透明背景）	用戶頭像選項（可多個）
活動橫幅	PC 版 + 行動版各一	PNG / JPG	前台活動展示

2.2.5 品牌色彩參考

C9 平台內建 6 組主題預設，您可以直接選用或自訂：

主題名稱	主色調	風格描述
Emerald（翡翠綠）	`oklch(72% 0.19 160)`	清新自然，適合經典娛樂城
Amber（琥珀金）	`oklch(79% 0.17 75)`	尊貴大氣，適合 VIP 導向
Sky（天空藍）	`oklch(75% 0.15 230)`	清爽專業，適合體育博彩
Violet（紫羅蘭）	`oklch(65% 0.25 300)`	神秘高雅，適合真人娛樂
Rose（玫瑰紅）	`oklch(70% 0.20 15)`	熱情奔放，適合年輕族群
Cyan（青色）	`oklch(78% 0.15 195)`	科技感強，適合電競主題

建議：如果您不確定色彩搭配，直接選擇內建預設是最快的方式。

2.2.6 商戶資訊提交範本

為加速開通流程，請按以下範本填寫並提交：

【站點基本資訊】
站點代碼 (siteCode)：LUCKY88
白牌前綴 (prefix)：lucky88
前台模板 (layout)：a1（使用預設即可）

【站點名稱（多語系）】
繁體中文：Lucky88 娛樂城
English：Lucky88 Casino
簡體中文：Lucky88 娱乐城
ภาษาไทย：Lucky88 คาสิโน
Tiếng Việt：Lucky88 Casino

【站點介紹（多語系）】
繁體中文：Lucky88 提供最豐富的線上娛樂體驗
English：Lucky88 offers the richest online entertainment
簡體中文：Lucky88 提供最丰富的在线娱乐体验
ภาษาไทย：Lucky88 มอบประสบการณ์ความบันเทิงที่สมบูรณ์
Tiếng Việt：Lucky88 mang đến trải nghiệm giải trí phong phú

【語系設定】
啟用語系：zh-TW, en-US

【域名設定】
主域名：www.lucky88.com
備用域名：lucky88.net（如有）

【品牌色彩】
方案 A：使用內建預設 → Emerald（翡翠綠）
方案 B：自訂主色 → #10B981

【品牌素材】
Logo（小）：已附檔 logo-sm.png
Logo（大）：已附檔 logo-lg.png
Favicon：已附檔 favicon.ico
吉祥物：已附檔 mascot-01.png, mascot-02.png

2.3 步驟 2：後台建立站點

收到商戶提供的基本資訊後，管理員在後台建立站點。

2.3.1 操作路徑

後台管理系統 → 系統管理 → 站點基本設定

2.3.2 建立站點操作流程

進入站點基本設定頁面
在後台左側導航列，展開「系統管理」群組，點選「站點基本設定」。
點擊「新增站點」按鈕
頁面右上方有「新增站點」按鈕，點擊後開啟新增表單。

填寫站點資訊

欄位	必填	說明	範例
站點代碼 (siteCode)	是	唯一識別碼，建立後不可更改	`LUCKY88`
白牌前綴 (prefix)	是	唯一前綴，對應 R2 路徑	`lucky88`
前台模板 (layout)	否	預設 `a1`	`a1`
站點名稱 (siteName)	是	多語系 JSON	`{"zh-TW":"Lucky88 娛樂城","en-US":"Lucky88 Casino"}`
站點介紹 (siteDescription)	否	多語系 JSON	`{"zh-TW":"最佳線上娛樂平台","en-US":"Best Online Platform"}`
支援語系 (supportedLocales)	否	語系清單	`["zh-TW", "en-US"]`

確認並儲存
檢查所有欄位後，點擊「儲存」按鈕。系統將在 site-config 資料表中建立一筆新記錄。

2.3.3 站點建立後的初始狀態

站點建立完成後，初始狀態如下：

項目	初始狀態
主題	無（需另行建立）
域名	無（需另行設定）
遊戲商	無（需另行配置）
金流通道	無（需另行配置）
客服管道	無（需另行配置）
代理系統	使用平台預設（可調整）
VIP 制度	使用平台預設（可調整）
品牌素材	無（需另行上傳）
存款通路	預設全開 `{ fiat: true, credit: true, crypto: true }`
下導列	預設開啟
啟用狀態	啟用

2.3.4 站點代碼命名建議

建議	說明
簡短好記	2-10 個字元為佳，如 `LUCKY88`、`KING`、`VIP99`
大寫英數	僅使用大寫英文字母和數字
避免特殊字元	不要使用空格、底線、連字號等
確保唯一	不可與其他站點重複

2.3.5 常見錯誤與解決

錯誤訊息	原因	解決方式
siteCode 重複	該站點代碼已被使用	更換一個唯一的代碼
prefix 重複	該前綴已被使用	更換一個唯一的前綴
siteName 格式錯誤	JSON 格式不正確	確認 JSON 語法正確

2.4 步驟 3：配置主題色彩

站點建立後，需要為其配置色彩主題，讓前台網站呈現商戶的品牌風格。

2.4.1 操作路徑

系統管理 → 站點基本設定 → 選擇站點 → 主題管理

2.4.2 主題色彩體系

C9 平台的主題系統採用 OKLCH 色彩空間，包含 5 大色彩類別：

1. 主色系 (Primary)

子項	用途	說明
base	主要按鈕、連結、重點元素	品牌最核心的色彩
dark	按鈕 hover 狀態、深色場景	比 base 深一階
light	淺色背景、標籤	比 base 淺一階
glow	發光效果、焦點指示器	帶透明度的發光色

2. 強調色 (Accent)

子項	用途	說明
gold	VIP、獎勵、特殊標記	金色系
info	資訊提示、引導	藍色系
violet	特殊功能、裝飾	紫色系
cyan	即時數據、狀態	青色系
error	錯誤、警告、刪除	紅色系

3. 表面色 (Surface)

子項	用途	說明
page	頁面底色	最底層的背景色
navbar	導航列背景	頂部/側邊導航
card	卡片背景	內容區塊的底色
modal	彈窗背景	對話框、下拉選單
sidebar	側邊欄背景	左側導航欄

4. 文字色 (Text)

子項	用途	說明
primary	主要文字	標題、正文
secondary	次要文字	副標題、描述
muted	淡化文字	提示、佔位符
hint	極淡文字	輔助說明

5. 邊框色 (Border)

子項	用途	說明
subtle	極淡邊框	分隔線
default	標準邊框	輸入框、卡片邊框
strong	強調邊框	焦點狀態

2.4.3 使用內建預設

如果商戶選擇使用內建主題預設，操作步驟如下：

在主題管理頁面，點擊「新增主題」
選擇預設方案（Emerald / Amber / Sky / Violet / Rose / Cyan）
系統自動填入所有色彩值
確認後儲存
回到站點設定，將此主題設為「啟用主題」

2.4.4 自訂主題色彩

如果商戶希望使用自訂色彩：

在主題管理頁面，點擊「新增主題」
填寫主題名稱（多語系）
逐項填入 5 大類別的色彩值（OKLCH 格式或 HEX）
預覽效果
確認後儲存
設為啟用主題

2.4.5 主題生效機制

主題儲存到 site-theme 資料表
前台透過 API 取得當前站點的 activeThemeId 對應的主題
前台 themeInjector 元件將色彩值注入為 CSS 變數
所有 UI 元件自動套用新色彩
支援 Light / Dark 雙模式

2.4.6 主題修改注意事項

注意事項	說明
即時生效	修改主題色彩後，用戶刷新頁面即可看到變更
建議先預覽	大幅度修改色彩前，建議先在測試域名預覽效果
色彩對比	確保文字色與背景色有足夠對比度，保障可讀性
多裝置測試	不同螢幕可能呈現略有差異，建議多裝置確認

2.5 步驟 4：設定域名與 DNS

2.5.1 操作路徑

系統管理 → 域名設置

2.5.2 域名配置欄位

每個域名需填寫以下資訊：

欄位	必填	說明	範例
hostname	是	完整域名	`www.lucky88.com`
browserTitle	是	瀏覽器標題	`Lucky88 娛樂城 - 最佳線上娛樂平台`
browserDescription	是	瀏覽器描述（SEO）	`Lucky88 提供豐富的遊戲體驗...`
logoSmall	否	小 Logo URL	上傳後自動填入
logoBig	否	大 Logo URL	上傳後自動填入
favicon	否	Favicon URL	上傳後自動填入
supportedLocales	否	該域名支援的語系	`["zh-TW", "en-US"]`

2.5.3 上傳域名素材

在域名設置頁面，可直接上傳 Logo 和 Favicon：

點擊域名旁的「上傳」按鈕
選擇素材類型：logoSmall / logoBig / favicon
選擇檔案上傳
系統自動上傳至 R2 並填入 URL

API 端點：POST /site-config/admin/:id/domain-asset

2.5.4 DNS 設定

域名配置完成後，需要進行 DNS 設定：

取得平台 IP 或 CNAME
聯繫平台方取得伺服器的 IP 位址或 CNAME 記錄。
在域名註冊商設定 DNS
記錄類型主機名值說明
A www 平台 IP 指向平台伺服器
CNAME www 平台 CNAME 或使用 CNAME
等待 DNS 生效
DNS 變更通常需要 10 分鐘到 48 小時生效。
驗證域名
DNS 生效後，在瀏覽器輸入域名確認是否能正確載入您的站點。

記錄類型	主機名	值	說明
A	`www`	`平台 IP`	指向平台伺服器
CNAME	`www`	`平台 CNAME`	或使用 CNAME

2.5.5 多域名支援

一個站點可以綁定多個域名。常見用途：

域名類型	範例	用途
主域名	`www.lucky88.com`	主要訪問入口
備用域名	`lucky88.net`	備用入口
推廣域名	`promo.lucky88.com`	活動推廣專用

每個域名可以有獨立的 Logo、Favicon 和支援語系設定。

2.5.6 域名運作機制

用戶訪問 www.lucky88.com
  → 前台 domainConfig 比對 hostname
    → 找到對應的 siteCode: "LUCKY88"
      → HTTP header 注入 site-name: "lucky88"
        → 後端依 site-name 返回對應站點資料

2.6 步驟 5：配置遊戲商

2.6.1 操作路徑

系統管理 → 遊戲商配置

2.6.2 遊戲供應商列表

目前平台支援的遊戲供應商：

供應商	代碼	支援遊戲類型	說明
BetSolutions	`betsolutions`	老虎機、真人、棋牌	歐洲老牌供應商
RSG	`rsg`	老虎機、捕魚、棋牌	亞洲主流供應商
API-Football	`liveSports`	體育（即時賽事）	賽事數據供應商

2.6.3 配置遊戲供應商

每個遊戲供應商需要填入 API 憑證：

BetSolutions 配置：

欄位	說明
apiUrl	API 基礎網址
authUrl	認證網址
merchantId	商戶 ID
privateKey	私鑰

RSG 配置：

欄位	說明
apiUrl	API 基礎網址
clientId	客戶端 ID
clientSecret	客戶端密鑰
desKey	DES 加密金鑰
desIv	DES 初始向量
systemCode	系統代碼
webId	網站 ID

LiveSports 配置：

欄位	說明
apiKey	API-Football 的 API 金鑰

2.6.4 快速配置：同預設站點

如果您的遊戲商配置與預設站點相同，可以使用「同預設站點」功能一鍵複製：

在遊戲商配置頁面，切換到您的站點 Tab
點擊「同預設站點」按鈕
系統自動深拷貝預設站點的配置
檢查並修改需要調整的欄位
點擊「儲存」完成

注意：此操作為前端狀態拷貝，需手動點擊「儲存」才會寫入資料庫。

2.7 步驟 6：配置金流商

2.7.1 操作路徑

財務管理 → 存款設置

2.7.2 金流群組

金流群組是按語系/幣別分類的金流配置單位：

群組名稱	對應幣別	說明
台幣群組	TWD	台灣地區用戶
美元群組	USD	國際用戶
人民幣群組	CNY	大陸地區用戶
泰銖群組	THB	泰國用戶
越南盾群組	VND	越南用戶

用戶註冊時，系統依語系自動分配至對應的金流群組。

2.7.3 金流通道

每個金流群組下可設定多個金流通道：

通道類型	說明	支援幣別
ATM 轉帳	銀行 ATM / 網路銀行轉帳	TWD, CNY, THB, VND
信用卡	Visa / MasterCard	TWD, USD
USDT	加密貨幣（USDT-TRC20 / ERC20）	全幣別

2.7.4 金流通道配置欄位

欄位	說明	範例
通道名稱	顯示在前台的名稱	`銀行轉帳`
通道類型	ATM / CREDIT / USDT	`ATM`
最小存款	單筆最低金額	`100` (TWD)
最大存款	單筆最高金額	`50000` (TWD)
是否啟用	開關	`true`

2.7.5 配置流程

建立金流群組
- 點擊「新增群組」
- 填寫群組名稱、對應幣別
- 儲存
新增金流通道
- 在群組下點擊「新增通道」
- 選擇通道類型
- 填寫通道資訊
- 設定金額限制
- 儲存
關聯群組與通道
- 將通道關聯至群組
- 可一個通道關聯多個群組
- 調整排序
設定金流商憑證
- 填入金流商的 API 金鑰和密鑰
- 測試連線是否正常

2.8 步驟 7：配置客服管道

2.8.1 操作路徑

系統管理 → 客服配置

2.8.2 支援的客服管道

C9 平台支援 8 種客服聯繫管道：

管道	類型代碼	說明
Line	`line`	Line 官方帳號
Telegram	`telegram`	Telegram 群組/機器人
WeChat	`wechat`	微信客服
Facebook	`facebook`	Facebook 粉絲專頁
Instagram	`instagram`	Instagram 帳號
Twitter	`twitter`	Twitter / X 帳號
Discord	`discord`	Discord 伺服器
自訂	`custom`	自訂連結（如官網聯繫表單）

2.8.3 客服管道配置欄位

每個管道的配置包含：

欄位	說明	範例
類型 (type)	管道類型	`line`
標籤 (label)	多語系顯示名稱	`{"zh-TW":"Line 客服","en-US":"Line Support"}`
圖示 (icon)	管道圖示 URL	可上傳自訂圖示
連結 (link)	管道連結	`https://line.me/R/ti/p/@lucky88`
排序 (sortOrder)	顯示順序（數字越小越前）	`1`
啟用 (enabled)	是否顯示	`true`

2.8.4 LiveChat 嵌入

除了靜態客服連結外，還支援 LiveChat 即時聊天功能：

欄位	說明
liveChatEnabled	是否啟用 LiveChat
liveChatScript	LiveChat 嵌入腳本（HTML/JS）

啟用後，前台網站右下角會出現即時聊天浮動按鈕。

2.8.5 快速配置：同預設站點

同遊戲商配置，客服配置也支援「同預設站點」功能：

切換到您的站點 Tab
點擊「同預設站點」按鈕
系統深拷貝預設站點的客服配置
修改連結為您的客服管道
儲存

2.9 步驟 8：上傳品牌素材

2.9.1 操作路徑

系統管理 → 雲端儲存

2.9.2 R2 檔案目錄結構

每個站點在 R2 中有獨立的檔案目錄：

{prefix}/
├── logos/
│   ├── logo-sm.png
│   ├── logo-lg.png
│   └── favicon.ico
├── games/
│   ├── zh-TW/
│   ├── en-US/
│   └── ...
├── promos/
│   ├── banner-pc.png
│   └── banner-mobile.png
├── mascots/
│   ├── mascot-01.png
│   └── mascot-02.png
└── misc/

2.9.3 上傳品牌素材步驟

上傳 Logo 和 Favicon
前往「系統管理 → 域名設置」，使用域名素材上傳功能直接上傳。或前往「雲端儲存」頁面手動上傳至 {prefix}/logos/ 目錄。
上傳吉祥物
前往「站點基本設定 → 吉祥物設定」。新增吉祥物項目，每個項目包含：
- ID：唯一識別碼
- 標籤：顯示名稱
- URL：圖片 URL（可先上傳到雲端儲存取得 URL）
上傳遊戲封面圖
前往「雲端儲存」，在 {prefix}/games/ 目錄下依語系建立子目錄並上傳。
上傳活動橫幅
前往「雲端儲存」，在 {prefix}/promos/ 目錄下上傳。建議同時上傳 PC 版和行動版。

2.9.4 客服圖示上傳

客服管道的自訂圖示有專用的上傳端點：

系統管理 → 客服配置 → 選擇管道 → 上傳圖示

API 端點：POST /site-config/admin/:id/customer-service-icon

2.9.5 素材規格建議

素材類型	建議尺寸	格式	最大大小	注意事項
Logo（小）	200 x 60 px	PNG	200KB	透明背景
Logo（大）	400 x 120 px	PNG	500KB	透明背景
Favicon	32x32 或 64x64 px	ICO/PNG	50KB	正方形
吉祥物	不限	PNG	1MB	透明背景佳
遊戲封面	依遊戲商規格	PNG/JPG	500KB	-
活動橫幅（PC）	1200 x 400 px	PNG/JPG	1MB	16:9 或 3:1
活動橫幅（手機）	750 x 400 px	PNG/JPG	500KB	略正方
客服圖示	48 x 48 px	PNG	100KB	透明背景

2.10 站點開通檢查清單

完成上述 8 個步驟後，請依以下清單逐項確認：

序號	檢查項目	狀態
1	站點已建立，siteCode 和 prefix 正確	[ ]
2	主題色彩已配置並設為啟用	[ ]
3	域名已設定，DNS 已生效	[ ]
4	域名素材（Logo/Favicon）已上傳	[ ]
5	遊戲供應商已配置 API 憑證	[ ]
6	至少一個金流群組已建立	[ ]
7	至少一個金流通道已啟用	[ ]
8	至少一個客服管道已設定	[ ]
9	吉祥物圖片已上傳（可選）	[ ]
10	使用域名訪問前台，確認顯示正確	[ ]
11	註冊測試帳號，確認流程正常	[ ]
12	試玩遊戲，確認遊戲可正常啟動	[ ]
13	測試存款流程（小額）	[ ]
14	測試提款流程	[ ]
15	確認客服連結正確可用	[ ]

第 3 章：後台操作手冊

3.1 登入後台

3.1.1 訪問後台

後台管理系統的訪問方式：

URL：https://[後台域名]/login
預設端口：3011（開發環境）
支援瀏覽器：Chrome、Firefox、Safari、Edge（建議使用最新版）

3.1.2 登入流程

輸入電子郵件
輸入密碼
如已啟用 2FA，輸入 6 位 Google Authenticator 驗證碼
點擊「登入」

3.1.3 登入認證機制

項目	說明
認證方式	AdminJWT（後台專用 JWT 策略）
Token 類型	Bearer Token
JWT Payload	包含 `role: 'admin'`、管理員 ID、群組權限
自動刷新	Session 過期前自動續期
401 處理	Token 失效時自動導向登入頁

3.1.4 登入失敗處理

情境	錯誤訊息	建議處理
帳號不存在	帳號或密碼錯誤	確認 email 正確
密碼錯誤	帳號或密碼錯誤	確認密碼正確
2FA 驗證碼錯誤	驗證碼不正確	確認手機時間同步
帳號停用	帳號已被停用	聯繫上級管理員

3.2 站點切換

3.2.1 SiteSelector（站點選擇器）

在後台頁面頂部（Header），有一個站點選擇下拉選單：

┌──────────────────────────┐
│ 站點選擇: [全部站點 ▼]    │
│                          │
│   ○ 全部站點              │
│   ● C9 娛樂城 (C9)       │
│   ○ Lucky88 (LUCKY88)    │
│   ○ King Casino (KING)   │
└──────────────────────────┘

3.2.2 兩種檢視模式

模式	Header 選擇	頁面行為	資料範圍
全部站點	選擇「全部站點」	顯示 SiteTabs（多站點標籤）	依切換的 Tab 顯示對應站點資料
單一站點	選擇特定站點	SiteTabs 僅顯示一個站點	只顯示該站點的資料

3.2.3 切換行為

當切換站點時，系統會執行以下操作：

更新 siteFilterStore 中的 selectedSiteCode
清除 TanStack Query 快取（確保資料重新載入）
AdminContentWrapper 以 key={selectedSiteCode} 強制重新掛載
所有子頁面重新載入對應站點的資料

3.2.4 SiteTabs（多站點標籤）

在「全部站點」模式下，大多數列表頁面頂部會出現 SiteTabs：

┌─────────────────────────────────────────────────┐
│ [C9 娛樂城 (C9/a1) 預設] [Lucky88 (LUCKY88/...)] │
│                                                  │
│ （此處顯示對應站點的資料表格）                      │
└─────────────────────────────────────────────────┘

第一個 Tab 為預設站點，標有「預設」徽章
切換 Tab 時自動重置分頁到第 1 頁
非預設站點 Tab 上可能出現「同預設站點」複製按鈕

3.2.5 不顯示 SiteSelector 的頁面

以下頁面因屬於全站共用設定，不顯示 SiteSelector：

頁面	原因
管理員列表	管理員為全站共用
群組管理	群組為全站共用
操作紀錄	顯示所有站點的操作紀錄

3.3 管理員管理

3.3.1 新增管理員

操作路徑：系統管理 → 管理員管理

新增管理員時需填寫以下資訊：

欄位	必填	說明
電子郵件	是	登入帳號（唯一）
姓名	是	管理員顯示名稱
密碼	是	登入密碼
所屬群組	是	指定權限群組
是否啟用	是	帳號啟用/停用

3.3.2 群組管理

操作路徑：系統管理 → 群組管理

C9 平台提供 4 種群組類型：

群組類型	中文名稱	權限範圍	說明
`root`	超級管理者	全部權限	平台方最高權限，不可刪除
`super_admin`	進階管理員	除 site-config 外全部	高級管理權限
`general_admin`	一般管理員	所有模組唯讀	只能檢視不能修改
`custom`	自訂群組	自行勾選	依需求配置權限

3.3.3 權限模組一覽

C9 後台共有 16 個權限模組，每個模組有「讀取」和「寫入」兩個動作：

模組	權限代碼	功能範圍
管理員管理	`admin:read` / `admin:write`	管理員 CRUD
群組管理	`admin-group:read` / `admin-group:write`	群組 CRUD
操作紀錄	`admin-log:read` / `admin-log:write`	查看/匯出操作紀錄
用戶管理	`user:read` / `user:write`	前台用戶管理
存款管理	`deposit:read` / `deposit:write`	存款訂單審核
提款管理	`withdrawal:read` / `withdrawal:write`	提款訂單審核
活動管理	`promo:read` / `promo:write`	優惠活動 CRUD
活動標籤	`promo-tag:read` / `promo-tag:write`	活動標籤 CRUD
代理管理	`affiliate:read` / `affiliate:write`	代理系統管理
VIP 管理	`vip:read` / `vip:write`	VIP 等級/返水設定
遊戲管理	`game:read` / `game:write`	遊戲供應商/分類
風控管理	`risk:read` / `risk:write`	IP 規則/遊戲黑名單
報表	`report:read` / `report:write`	各類報表查詢/匯出
金流商管理	`vendor:read` / `vendor:write`	金流群組/通道
財務管理	`finance:read` / `finance:write`	手動調帳/錢包審核
站點設定	`site-config:read` / `site-config:write`	站點/主題/域名配置

3.3.4 建立自訂群組

前往「群組管理」頁面
點擊「新增群組」
填寫群組名稱
選擇群組類型為 custom
勾選需要的權限模組和動作
儲存

範例：客服主管群組

勾選的權限：
✅ user:read（查看用戶資料）
✅ deposit:read（查看存款訂單）
✅ withdrawal:read（查看提款訂單）
✅ finance:read（查看財務資料）
❌ 其餘全部取消

範例：活動管理員群組

勾選的權限：
✅ promo:read / promo:write（活動完整管理）
✅ promo-tag:read / promo-tag:write（標籤完整管理）
✅ report:read（查看報表）
❌ 其餘全部取消

3.3.5 管理員操作建議

建議	說明
最少權限原則	只給予必要的權限，避免過度授權
獨立帳號	每位操作人員使用獨立帳號，便於追蹤
定期檢查	定期檢視管理員清單，停用離職人員帳號
強制 2FA	建議所有管理員啟用 Google Authenticator

3.4 2FA 雙重認證設定

3.4.1 什麼是 2FA

2FA（Two-Factor Authentication，雙重認證）是在密碼之外增加一層安全驗證。 C9 後台使用 Google Authenticator 的 TOTP（Time-based One-Time Password）機制。

3.4.2 啟用 2FA

操作路徑：個人資料 → Google Authenticator

啟用步驟：

進入個人資料頁面
找到「Google Authenticator」區塊
點擊「啟用」按鈕
系統生成 QR Code 和 Secret Key
使用手機 Google Authenticator App 掃描 QR Code
App 開始顯示 6 位數驗證碼（每 30 秒更新）
在後台輸入當前顯示的 6 位數驗證碼
點擊「確認」完成啟用

3.4.3 停用 2FA

如需停用（例如更換手機）：

進入個人資料頁面
找到「Google Authenticator」區塊
點擊「停用」按鈕
輸入當前的 6 位數驗證碼
點擊「確認」完成停用

3.4.4 2FA 注意事項

注意事項	說明
備份 Secret Key	啟用時務必記下 Secret Key，以備手機遺失時恢復
時間同步	確保手機時間準確，偏差過大會導致驗證碼無效
更換手機	先停用 2FA → 在新手機設定 → 重新啟用
遺失手機	若無法停用，需聯繫 root 管理員重置

3.4.5 2FA 狀態流程

idle（未啟用）
  → 點擊「啟用」
    → qr（顯示 QR Code）
      → 掃描並輸入驗證碼
        → verify（驗證中）
          → 成功 → enabled（已啟用）
          → 失敗 → 重新輸入

3.5 操作紀錄

3.5.1 操作路徑

系統管理 → 操作紀錄

3.5.2 紀錄內容

所有後台管理操作均會自動記錄，包含：

欄位	說明
時間	操作發生的時間
管理員	執行操作的管理員帳號
操作類型	CREATE / UPDATE / DELETE 等
模組	涉及的功能模組
詳細內容	操作的具體內容（JSON）
IP 位址	操作者的 IP

3.5.3 紀錄用途

安全審計：追蹤異常操作
責任歸屬：確認操作者身份
問題排查：回溯設定變更歷史
合規要求：滿足監管稽核需求

第 4 章：遊戲管理

4.1 遊戲管理概述

遊戲管理是 C9 平台的核心功能之一，讓商戶自主控制在前台展示哪些遊戲、如何分類和排序。遊戲管理分為兩大區塊：

遊戲供應商管理：管理遊戲商（provider）及其底下的遊戲
遊戲分類配置：管理遊戲類型（如老虎機、真人、體育等）的顯示設定

4.2 遊戲供應商管理

4.2.1 操作路徑

遊戲管理 → 遊戲供應商

4.2.2 頁面結構

頁面頂部有 SiteTabs，可切換不同站點的遊戲供應商配置。主體為資料表格，顯示該站點已配置的遊戲供應商。

4.2.3 遊戲供應商欄位

欄位	型別	必填	說明
gameCode	string	是	遊戲代碼（唯一識別）
providerCode	string	是	供應商代碼（betsolutions / rsg）
gameType	number	是	遊戲類型 ID（1-10）
name	JSON	是	遊戲名稱（多語系）
isHot	boolean	否	是否為熱門遊戲
displayOrder	number	否	顯示排序（越小越前）
enabled	boolean	是	是否啟用
siteCode	string	自動	所屬站點代碼

4.2.4 新增遊戲供應商

在 SiteTabs 選擇目標站點
點擊「新增」按鈕
填寫遊戲資訊
為每種語系填寫遊戲名稱
設定排序和啟用狀態
儲存

4.2.5 編輯遊戲供應商

在列表中找到目標遊戲
點擊「編輯」按鈕
修改需要的欄位
儲存

4.2.6 刪除遊戲供應商

在列表中找到目標遊戲
點擊「刪除」按鈕
確認刪除對話框
確認

注意：刪除遊戲供應商後，該遊戲將不再顯示在前台。如果用戶正在遊玩該遊戲，需確保資金結算完畢。

4.3 遊戲分類配置

4.3.1 操作路徑

遊戲管理 → 遊戲類型設定

4.3.2 遊戲分類欄位

欄位	型別	必填	說明
gameType	number	是	遊戲類型 ID
name	JSON	是	類型名稱（多語系）
displayOrder	number	否	顯示排序
enabled	boolean	是	是否啟用
siteCode	string	自動	所屬站點代碼

4.3.3 遊戲類型對照表

類型 ID	英文名	中文名	說明
1	SPORTS	體育	體育賽事投注，包含足球、籃球、棒球等
2	SLOT	老虎機	經典老虎機和視頻老虎機
3	LIVE	真人	真人荷官遊戲，百家樂、輪盤、骰寶等
4	LOTTERY	彩票	各類彩票遊戲
5	CHESS	棋牌	撲克牌、麻將、象棋等桌上遊戲
8	ESPORTS	電競	電子競技賽事投注
9	CRYPTO	加密	加密貨幣相關遊戲
10	FISH	捕魚	捕魚達人類休閒遊戲

注意：類型 ID 6 和 7 為保留號碼，目前未使用。

4.3.4 啟用/停用遊戲類型

某些遊戲類型可能不適合特定站點的市場定位，可以選擇停用：

在 SiteTabs 選擇目標站點
找到要停用的遊戲類型
將「啟用」切換為「停用」
儲存

停用後，該類型的遊戲不會出現在前台的遊戲分類導航中。

4.4 帶入模板

4.4.1 什麼是帶入模板

「帶入模板」功能讓您一鍵匯入平台預設的遊戲配置，無需逐一手動設定。這是新站點最快速的遊戲配置方式。

4.4.2 操作流程

預覽模板
點擊「帶入模板」按鈕，系統會顯示預設配置的預覽：
- 遊戲供應商列表（含所有預設遊戲）
- 遊戲類型配置（含所有預設分類）
在預覽中編輯
模板預覽對話框允許您在套用前進行修改：
- 刪除不需要的遊戲
- 修改排序
- 調整啟用/停用狀態
確認套用
確認後，系統以原子操作（Atomic Transaction）寫入：
- 先清除當前站點的所有配置
- 再寫入模板配置
- 全部成功或全部回滾

4.4.3 重要注意事項

注意事項	說明
僅影響當前站點	不會影響其他站點的配置
覆蓋現有配置	會清除並替換當前站點的所有配置
可先預覽修改	在確認前可以自由調整
事務安全	使用 DB Transaction，保證資料一致性

4.4.4 API 端點

功能	端點	說明
預覽模板	`GET /game/admin/preview-template`	回傳預設 typeConfigs + providers
帶入模板	`POST /game/admin/load-template`	`@AdminSiteCode()` 決定寫入站點

4.5 跨站複製（同預設站點）

4.5.1 什麼是跨站複製

「同預設站點」（又稱跨站複製）功能可以將預設站點的遊戲配置完整複製到目標站點。與「帶入模板」不同，此功能是從現有站點複製，而非從模板匯入。

4.5.2 操作流程

在 SiteTabs 切換到非預設的目標站點
點擊 Tab 右側的「同預設站點」按鈕
確認對話框顯示：預設站點 → 目標站點
確認後，後端以 Transaction 執行：
- 刪除目標站點的現有配置
- 從預設站點複製所有配置
- 新配置的 siteCode 替換為目標站點代碼

4.5.3 支援的複製類型

類型	API 參數	說明
遊戲供應商	`type: 'providers'`	複製所有 game-provider 記錄
遊戲分類	`type: 'typeConfigs'`	複製所有 game-type-config 記錄

4.5.4 API 端點

POST /game/admin/copy-site-data
Body: {
  sourceSiteCode: "C9",        // 來源站點（預設站）
  targetSiteCode: "LUCKY88",   // 目標站點
  type: "providers"            // 或 "typeConfigs"
}

4.5.5 帶入模板 vs 跨站複製比較

比較項目	帶入模板	跨站複製
資料來源	系統內建模板	預設站點的現有配置
可預覽編輯	是，可在預覽中修改	否，直接複製
操作位置	模板按鈕	SiteTabs 上的複製按鈕
適用場景	全新站點初始設定	已有預設站點，快速複製
影響範圍	僅當前站點	僅目標站點

4.6 遊戲啟動與風控

4.6.1 遊戲啟動流程

當前台用戶點擊遊戲時，系統執行以下流程：

用戶點擊遊戲
  → 檢查用戶登入狀態
    → 檢查遊戲黑名單（風控）
      → 通過 → 呼叫遊戲商 API 取得遊戲 URL
        → 開啟遊戲
      → 不通過 → 顯示錯誤（錯誤碼 5010）

4.6.2 遊戲黑名單攔截

如果用戶被加入遊戲黑名單，會根據黑名單類型進行攔截：

黑名單類型	說明	效果
全封鎖	禁止所有遊戲	所有遊戲無法啟動
類型封鎖	禁止特定遊戲類型	如禁止老虎機
遊戲封鎖	禁止特定遊戲	如禁止特定老虎機

4.6.3 錢包模式

C9 平台使用「轉帳錢包」模式：

用戶啟動遊戲時，餘額轉入遊戲商
遊戲中的下注/派彩透過 S2S 回調即時更新
離開遊戲時，餘額轉回平台錢包

4.6.4 投注連動

用戶在遊戲中投注後，系統自動觸發以下連動：

連動	說明
VIP 等級重算	累計有效投注達到升級門檻時自動升級
活動打碼量	累計投注計入活動流水要求
任務進度	更新每日/週/月投注任務進度
代理佣金	投注金額計入代理佣金統計

第 5 章：金流管理

5.1 金流管理概述

金流管理是娛樂城營運的核心環節，涵蓋用戶的存款、提款、錢包審核及手動調帳等操作。 C9 平台提供完整的金流管理功能，讓商戶能高效處理所有資金相關業務。

5.1.1 金流管理模組一覽

模組	路由	功能	多站點支援
存款設置	`/finance/deposit-settings`	金流群組與通道配置	是
存款審核	`/finance/deposit-review`	存款訂單審核	是
提款管理	`/finance/withdrawals`	提款訂單審核	是
銀行卡管理	`/finance/bank-cards`	銀行卡審核	是
信用卡管理	`/finance/credit-cards`	信用卡審核	是
虛擬錢包	`/finance/crypto-addresses`	加密錢包地址審核	是
手動調帳	`/finance/adjust-balance`	人工調整用戶餘額	是

5.1.2 幣別與匯率

系統內部幣別：所有金額統一使用 USD（美元）
入金匯率轉換：用戶以當地幣別入金時，後端自動透過台灣銀行即時匯率轉換為 USD
精度：金額使用 decimal(18,6)，匯率使用 decimal(18,10)
截斷規則：USD 金額採用無條件捨去 Math.floor(value * 1e6) / 1e6

5.2 金流群組

5.2.1 什麼是金流群組

金流群組是按語系/地區劃分的金流配置單位。用戶註冊時，系統依其語系自動分配至對應的金流群組，從而決定該用戶可使用哪些存款通道。

5.2.2 群組規劃建議

群組名稱	對應語系	對應幣別	建議通道
台灣群組	zh-TW	TWD	ATM 轉帳、信用卡
國際群組	en-US	USD	信用卡、USDT
大陸群組	zh-CN	CNY	銀行轉帳
泰國群組	th-TH	THB	銀行轉帳、PromptPay
越南群組	vi-VN	VND	銀行轉帳
通用 USDT	全語系	USDT	USDT-TRC20、USDT-ERC20

5.2.3 建立金流群組

操作路徑：財務管理 → 存款設置

點擊「新增群組」
填寫群組名稱（多語系）
選擇對應幣別/語系
儲存

5.2.4 管理金流群組

編輯群組：修改名稱、排序、啟用狀態
刪除群組：需先移除群組下所有通道
排序：調整群組在前台的顯示順序

5.3 金流通道

5.3.1 通道類型

C9 平台支援以下金流通道類型：

通道類型	代碼	說明	支援幣別
ATM 轉帳	`ATM`	銀行 ATM 或網路銀行轉帳	TWD, CNY, THB, VND
信用卡	`CREDIT`	Visa / MasterCard 線上刷卡	TWD, USD
USDT	`USDT`	加密貨幣 USDT（TRC20/ERC20）	等值全幣別

5.3.2 通道配置欄位

欄位	必填	說明
通道名稱	是	顯示在前台的名稱（多語系）
通道類型	是	ATM / CREDIT / USDT
金流商	是	選擇金流供應商
最小存款	是	單筆最低存款金額
最大存款	是	單筆最高存款金額
手續費率	否	手續費百分比
排序	否	顯示排序
是否啟用	是	開關

5.3.3 新增金流通道

在金流群組下點擊「新增通道」
選擇通道類型
填寫通道資訊
設定金額限制
儲存

5.3.4 關聯群組與通道

一個金流通道可以關聯到多個群組，也可以從群組中移除。關聯關係透過 vendor-group-channel 中間表管理。

5.4 存款設定

5.4.1 操作路徑

財務管理 → 存款設置

5.4.2 存款通路開關

每個站點可獨立控制前台顯示哪些存款方式：

json

{
  "fiat": true,     // 法幣存款（ATM 轉帳）
  "credit": true,   // 信用卡存款
  "crypto": true    // 加密貨幣存款
}

在「站點基本設定」中的 depositMethods 欄位可控制。

5.4.3 存款流程

用戶選擇存款方式
  → 選擇金流通道
    → 填寫存款金額
      → 系統呼叫金流商 API
        → 取得支付資訊（收款帳號/QR Code/跳轉連結）
          → 用戶完成支付
            → 金流商回調通知
              → 後端確認入帳
                → 用戶餘額增加（USD 計價）

5.5 存款審核

5.5.1 操作路徑

財務管理 → 存款審核

5.5.2 篩選功能

存款審核頁面支援豐富的篩選條件：

篩選欄位	類型	說明
訂單 ID	文字	精確搜尋訂單號
用戶 ID	文字	搜尋特定用戶
關鍵字	文字	模糊搜尋
支付方式	下拉選單	ATM / CREDIT / USDT
訂單狀態	下拉選單	待處理 / 已建立 / 已支付 / 失敗
開始日期	日期選擇器	篩選範圍起始
結束日期	日期選擇器	篩選範圍結束

5.5.3 訂單狀態流程

pending（待處理）
  → created（已建立）：金流商已建立支付訂單
    → paid（已支付）：用戶已完成支付，金額已入帳
    → failed（失敗）：支付失敗或逾時

5.5.4 審核操作

對於需要人工審核的訂單：

在列表中找到目標訂單
查看訂單詳情（金額、支付方式、用戶資訊）
確認支付證明
選擇「通過」或「拒絕」
通過後，系統自動將金額（轉換為 USD）加入用戶餘額

5.5.5 存款到帳後的連動

存款確認到帳後，系統自動觸發：

連動	說明
餘額更新	用戶餘額增加（USD 計價）
活動檢查	檢查是否符合首存優惠等活動條件
任務進度	更新每日/週/月存款任務進度
VIP 累積	存款金額計入 VIP 升級統計

5.6 提款審核

5.6.1 操作路徑

財務管理 → 提款管理

5.6.2 篩選功能

篩選欄位	類型	說明
訂單 ID	文字	精確搜尋
狀態	下拉選單	待審核 / 已核准 / 已拒絕 / 已完成
用戶 ID	文字	搜尋特定用戶
關鍵字	文字	模糊搜尋
網路	下拉選單	提款通道（如 TRC20）
開始日期	日期選擇器	-
結束日期	日期選擇器	-

5.6.3 提款狀態流程

提款採用三階段流程：

pending（待審核）
  → approved（已核准）：管理員審核通過
    → completed（已完成）：已完成匯款，上傳憑證
  → rejected（已拒絕）：管理員審核拒絕
    → 凍結金額退回用戶餘額

5.6.4 提款審核操作

第一步：審核提款申請

在列表中找到「待審核」的提款訂單
查看提款詳情：金額、收款帳戶、用戶資訊
確認用戶的提款帳戶資訊正確
選擇「核准」或「拒絕」

第二步：上傳支付憑證

核准後，進行實際匯款操作
回到訂單，點擊「上傳憑證」
上傳匯款截圖或交易編號

第三步：標記完成

確認匯款成功到帳
點擊「完成」標記訂單已完成

5.6.5 拒絕提款

當拒絕提款時：

凍結的金額將自動退回用戶的可用餘額
系統記錄拒絕原因
通知用戶提款被拒（如站點已啟用通知功能）

5.6.6 提款注意事項

注意事項	說明
核實收款資訊	仔細核對收款帳號，避免匯款到錯誤帳戶
大額提款	大額提款建議增加驗證步驟
異常提款	短時間多筆提款可能為風險信號
首次提款	用戶首次提款建議核實身份

5.7 錢包審核

5.7.1 銀行卡管理

操作路徑：財務管理 → 銀行卡管理

用戶綁定銀行卡後需經過管理員審核才能用於提款。

篩選欄位：

關鍵字、用戶 ID、狀態、銀行代碼、持卡人、日期範圍

審核流程：

pending（待審核）
  → approved（已核准）：可用於提款
  → rejected（已拒絕）：不可使用

審核重點：

確認持卡人姓名與用戶實名一致
確認銀行帳號格式正確
檢查是否有重複卡號

5.7.2 信用卡管理

操作路徑：財務管理 → 信用卡管理

篩選欄位：

關鍵字、用戶 ID、狀態、持卡人、日期範圍

流程與銀行卡相同。

審核重點：

確認信用卡資訊完整
確認持卡人與用戶一致
注意信用卡有效期

5.7.3 虛擬錢包地址管理

操作路徑：財務管理 → 虛擬錢包地址

用戶綁定加密貨幣錢包地址用於 USDT 提款。

篩選欄位：

關鍵字、用戶 ID、狀態、網路（TRC20/ERC20）、幣種、日期範圍

審核重點：

確認錢包地址格式正確（TRC20 以 T 開頭，ERC20 以 0x 開頭）
確認網路類型與地址匹配
注意是否有重複地址

5.8 手動調帳

5.8.1 操作路徑

財務管理 → 人工調節金額

5.8.2 使用場景

手動調帳用於以下場景：

場景	操作	說明
入金補償	正數調帳	入金系統異常，手動補入
活動贈送	正數調帳	手動發放活動獎勵
錯誤修正	負數調帳	修正錯誤的入帳
扣款處理	負數調帳	處理異常資金

5.8.3 操作步驟

在搜尋框輸入用戶帳號或 ID
找到目標用戶（帶 siteCode 篩選）
輸入調帳金額（正數=增加，負數=減少）
填寫調帳原因（必填）
確認提交
系統記錄操作日誌

5.8.4 調帳注意事項

注意事項	說明
必填原因	每筆調帳都必須填寫原因，便於日後稽核
操作紀錄	所有調帳操作均記錄在操作日誌中
金額精度	遵守 decimal(18,6) 精度，USD 計價
負數限制	扣款不能超過用戶可用餘額

5.9 用戶金流群組管理

5.9.1 用途

管理員可手動調整特定用戶的金流群組歸屬。

5.9.2 API 端點

PUT /admin/users/:userId/vendor-group

5.9.3 使用場景

用戶語系變更後，需調整至對應幣別群組
VIP 用戶需要使用專屬金流通道
特殊幣別需求的手動調整

第 6 章：VIP 系統配置

6.1 VIP 系統概述

C9 平台的 VIP 系統是提升用戶留存和忠誠度的核心機制。每個站點擁有完全獨立的 VIP 配置，包括等級數量、升級條件、返水比例、保級規則等，均可自由調整。

6.1.1 VIP 系統核心特色

特色	說明
每站獨立	每個站點的 VIP 等級體系完全獨立
等級自由擴充	不限定等級數量，可自由新增
8 類遊戲返水	每個等級可針對 8 種遊戲類型設定不同返水比例
自動升級	用戶投注累積達標後自動升級
自動返水	每日凌晨自動結算並發放返水
月度保級	每月自動檢查保級條件
模板/複製	支援「帶入模板」和「同預設站點」快速配置

6.1.2 VIP 管理模組一覽

模組	路由	功能
VIP 等級	`/vip/levels`	等級 CRUD + 模板 + 複製
返水設定	`/vip/rebates`	返水比例矩陣編輯
VIP 玩家	`/vip/players`	查看 VIP 用戶列表
VIP 里程碑	`/vip/milestones`	等級達標獎勵配置

6.2 VIP 等級設定

6.2.1 操作路徑

VIP → VIP 等級

6.2.2 等級欄位說明

欄位	型別	必填	說明
level	number	是	等級編號（0 起始，數字越大等級越高）
name	JSON	是	等級名稱（多語系），如 `{"zh-TW":"銅牌會員","en-US":"Bronze"}`
tier	string	是	等級代碼，如 `bronze`、`silver`、`gold`
minChip	decimal	是	升級門檻（累計有效投注達到此值即升級）
relegationChip	decimal	是	保級門檻（月度保級檢查使用）
rewards	JSON	否	等級專屬獎勵配置
enabled	boolean	是	是否啟用此等級
siteCode	string	自動	所屬站點代碼

6.2.3 等級規劃範例

以下為常見的 VIP 等級規劃範例：

等級	名稱	Tier	升級門檻 (USD)	保級門檻 (USD)
0	新手	starter	0	0
1	銅牌	bronze	1,000	500
2	銀牌	silver	5,000	2,500
3	金牌	gold	20,000	10,000
4	白金	platinum	50,000	25,000
5	鑽石	diamond	100,000	50,000
6	至尊	supreme	500,000	250,000
7	傳奇	legend	1,000,000	500,000

提示：等級數量不限，您可以根據市場策略自由增減。

6.2.4 新增 VIP 等級

在 SiteTabs 選擇目標站點
點擊「新增等級」
填寫等級資訊
為每種語系填寫等級名稱
設定升級門檻和保級門檻
儲存

6.2.5 使用帶入模板

快速建立 VIP 等級的最佳方式：

點擊「帶入模板」按鈕
系統顯示預設等級結構的預覽
可在預覽中修改等級名稱、門檻等
確認後以原子操作寫入
僅影響當前站點

6.2.6 使用同預設站點

從預設站點複製 VIP 等級：

切換到非預設站點的 Tab
點擊「同預設站點」按鈕
確認複製操作
後端呼叫 POST /vip/admin/copy-site-data { type: 'levels' }
原子操作：先刪後插

6.3 返水規則設定

6.3.1 操作路徑

VIP → 返水設定

6.3.2 返水矩陣

返水規則是一個「VIP 等級 x 遊戲類型」的二維矩陣。每個交叉點定義一個返水比例（%）。

矩陣示意（以 8 級 x 8 種遊戲類型為例）：

VIP 等級	體育	老虎機	真人	彩票	棋牌	電競	加密	捕魚
Lv.0 新手	0.10%	0.20%	0.10%	0.10%	0.10%	0.10%	0.10%	0.20%
Lv.1 銅牌	0.20%	0.40%	0.20%	0.20%	0.20%	0.20%	0.20%	0.40%
Lv.2 銀牌	0.30%	0.60%	0.30%	0.30%	0.30%	0.30%	0.30%	0.60%
Lv.3 金牌	0.40%	0.80%	0.40%	0.40%	0.40%	0.40%	0.40%	0.80%
Lv.4 白金	0.50%	1.00%	0.50%	0.50%	0.50%	0.50%	0.50%	1.00%
Lv.5 鑽石	0.60%	1.20%	0.60%	0.60%	0.60%	0.60%	0.60%	1.20%
Lv.6 至尊	0.70%	1.40%	0.70%	0.70%	0.70%	0.70%	0.70%	1.40%
Lv.7 傳奇	0.80%	1.60%	0.80%	0.80%	0.80%	0.80%	0.80%	1.60%

6.3.3 返水編輯方式

頁面以 8 個遊戲類型 Tab 呈現，每個 Tab 顯示所有等級的返水比例：

[體育] [老虎機] [真人] [彩票] [棋牌] [電競] [加密] [捕魚]

┌──────────────────────────────┐
│ VIP 等級 │ 返水比例 (%)        │
│──────────│────────────────────│
│ Lv.0    │ [0.10]              │  ← 行內編輯
│ Lv.1    │ [0.20]  ★ 已修改    │  ← 琥珀色標記
│ Lv.2    │ [0.30]              │
│ ...     │ ...                 │
└──────────────────────────────┘
                    [全部儲存]

6.3.4 編輯操作

在 SiteTabs 選擇目標站點
選擇遊戲類型 Tab（如「老虎機」）
直接在表格中行內編輯返水比例
修改過的行會以琥珀色標記
點擊「全部儲存」進行批次更新（Bulk Upsert）

6.3.5 返水比例建議

遊戲類型	建議範圍	說明
老虎機	0.2% - 1.6%	老虎機反水通常最高
捕魚	0.2% - 1.6%	與老虎機類似
體育	0.1% - 0.8%	體育投注反水較低
真人	0.1% - 0.8%	真人遊戲反水中等
棋牌	0.1% - 0.8%	棋牌遊戲反水中等
彩票	0.1% - 0.8%	彩票反水中等
電競	0.1% - 0.8%	電競反水中等
加密	0.1% - 0.8%	加密遊戲反水中等

6.3.6 使用帶入模板/同預設站點

返水規則同樣支援「帶入模板」和「同預設站點」功能：

帶入模板：匯入預設返水矩陣，可在預覽中調整
同預設站點：複製預設站點的返水矩陣到目標站點
- API：POST /vip/admin/copy-site-data { type: 'rebates' }

6.3.7 返水唯一鍵

每條返水記錄的唯一鍵為：siteCode + level + gameType

這確保每個站點、每個等級、每種遊戲類型只有一條返水規則。

6.4 VIP 玩家列表

6.4.1 操作路徑

VIP → VIP 玩家

6.4.2 頁面功能

VIP 玩家頁面顯示所有已有 VIP 等級的用戶：

欄位	說明
帳號	用戶帳號
VIP 等級	當前 VIP 等級
累計有效投注	歷史累計有效投注金額
可用餘額	當前可用餘額

6.4.3 篩選功能

關鍵字搜尋（帳號、姓名）
VIP 等級篩選（下拉選單，動態取得等級列表）
支援多站點 SiteTabs

6.5 VIP 自動化機制

6.5.1 自動升級

觸發條件：用戶投注結算後（S2S 回調），系統自動檢查：

if (user.totalEffectiveBet >= nextLevel.minChip) {
  // 自動升級
  user.vipLevel = nextLevel.level;
}

重要規則：

只升不降：投注達標時自動升級，但日常投注不會觸發降級
即時生效：升級後立即享受新等級的返水比例
跳級支援：如果投注金額跳過中間等級，可以直接升多級

6.5.2 每日反水結算

項目	說明
排程時間	每日 00:05
結算範圍	前一天的所有有效投注
計算公式	`反水金額 = 有效投注 × 返水比例(%)`
結算維度	每用戶 × 每遊戲類型 × VIP 等級
發放方式	直接加入用戶可用餘額
精度	USD decimal(18,6)，無條件捨去

反水計算範例：

假設用戶 VIP Lv.3（金牌），昨日投注如下：

遊戲類型	有效投注 (USD)	返水比例	返水金額 (USD)
老虎機	500.000000	0.80%	4.000000
真人	200.000000	0.40%	0.800000
體育	100.000000	0.40%	0.400000
合計	800.000000	-	5.200000

6.5.3 月度保級檢查

項目	說明
排程時間	每月 1 號 01:00
檢查規則	上月有效投注是否 >= 保級門檻 (relegationChip)
達標處理	重置 relegationMissCount 為 0
未達標處理	relegationMissCount + 1
降級條件	relegationMissCount >= 2（連續 2 月未達標）
降級幅度	降低 1 個等級
VIP 鎖定	若 vipHold = 1，跳過降級（特殊保護）

保級檢查流程圖：

每月 1 號 01:00 開始保級檢查
  │
  ├── 用戶 A：上月投注 30,000 >= 保級門檻 25,000
  │   → 達標！ relegationMissCount = 0
  │
  ├── 用戶 B：上月投注 10,000 < 保級門檻 25,000
  │   → 未達標！ relegationMissCount = 1 (第 1 次)
  │   → 不降級（寬限一次）
  │
  ├── 用戶 C：上月投注 5,000 < 保級門檻 25,000
  │   → 未達標！ relegationMissCount = 2 (連續第 2 次)
  │   → 降級！ VIP Lv.5 → Lv.4
  │
  └── 用戶 D：vipHold = 1
      → 跳過降級檢查（VIP 鎖定保護）

6.5.4 VIP 系統排程總覽

排程	時間	說明
每日反水結算	每日 00:05	計算並發放前一日返水
月度保級檢查	每月 1 號 01:00	檢查保級條件，處理降級

第 7 章：活動管理

7.1 活動管理概述

活動管理模組讓商戶建立和管理各類優惠活動，吸引用戶存款和遊玩。活動系統支援多種條件觸發和打碼量（流水）要求。

7.1.1 活動管理模組

模組	路由	功能
優惠活動	`/activity/promos`	活動 CRUD
活動標籤	`/activity/tags`	活動分類標籤

7.2 建立優惠活動

7.2.1 操作路徑

活動管理 → 優惠活動 → 新增活動

7.2.2 活動欄位說明

欄位	型別	必填	說明
title	JSON	是	活動標題（多語系）
content	HTML	是	活動內容（富文本，使用 Tiptap 編輯器）
coverImagePc	string	否	PC 版封面圖 URL
coverImageMobile	string	否	手機版封面圖 URL
startTime	datetime	是	活動開始時間
endTime	datetime	是	活動結束時間
conditionType	string	否	觸發條件類型
turnoverMultiplier	decimal	否	打碼倍率
tags	array	否	關聯的活動標籤
enabled	boolean	是	是否啟用
siteCode	string	自動	所屬站點代碼

7.2.3 活動條件類型

條件類型	代碼	說明
存款門檻	`deposit_threshold`	單筆存款達到指定金額即可領取
VIP 等級	`vip_level`	達到指定 VIP 等級即可領取
首次存款	`first_deposit`	首次存款用戶專屬

7.2.4 打碼倍率（流水要求）

打碼倍率決定了用戶領取活動獎勵後需要完成多少投注量才能提款：

需完成流水 = 獎勵金額 × 打碼倍率

範例：

存款 1,000 USD，獲得 100 USD 紅利
打碼倍率 = 5x
需完成流水 = 100 × 5 = 500 USD
用戶需累計投注 500 USD 後方可提款

7.2.5 活動內容編輯

活動內容使用 Tiptap 富文本編輯器，支援：

功能	說明
文字格式	粗體、斜體、底線、刪除線
標題	H1-H6 標題
列表	有序列表、無序列表
圖片	插入圖片（URL）
連結	插入超連結
表格	建立表格
引用	區塊引用
程式碼	行內程式碼
對齊	左、中、右對齊

7.2.6 建立活動步驟

前往「優惠活動」頁面
點擊「新增活動」
填寫活動標題（每種語系各填一個）
使用 Tiptap 編輯器撰寫活動內容
上傳 PC 版和手機版封面圖
設定活動起迄時間
選擇觸發條件類型
設定打碼倍率
關聯活動標籤
設定啟用狀態
儲存

7.3 活動標籤

7.3.1 操作路徑

活動管理 → 活動標籤

7.3.2 標籤用途

活動標籤用於在前台對活動進行分類展示：

範例標籤	說明
新手優惠	針對新註冊用戶
每日活動	每日循環活動
VIP 專屬	VIP 會員專屬
限時優惠	限時活動
節日活動	節慶期間特殊活動

7.3.3 標籤管理

新增標籤：設定標籤名稱（多語系）、排序、啟用狀態
編輯標籤：修改名稱或狀態
刪除標籤：移除不需要的標籤

7.4 活動報表

7.4.1 操作路徑

報表 → 活動報表

7.4.2 報表內容

活動報表顯示各活動的領取統計：

欄位	說明
活動名稱	活動標題
領取人數	已領取的用戶數量
發放金額	總發放金額
完成流水	已完成打碼量的人數

7.4.3 篩選功能

開始日期
結束日期

第 8 章：代理推廣系統

8.1 代理推廣概述

C9 平台內建完整的代理推廣系統，支援三層代理結構、自動佣金結算、風控檢測等功能。代理系統是用戶拓展的重要管道，透過推薦碼機制讓現有用戶邀請新用戶。

8.1.1 代理系統核心架構

代理（上線）
  ├── 一級下線（直推用戶）
  │     ├── 二級下線
  │     │     └── 三級下線（最深三層）
  │     └── 二級下線
  └── 一級下線
        └── 二級下線

8.1.2 代理管理模組一覽

模組	路由	功能
代理列表	`/affiliate/agents`	代理帳號管理
佣金費率	`/affiliate/commission-rates`	費率矩陣配置
代理等級	`/affiliate/agent-tiers`	等級定義管理
佣金結算	`/affiliate/settlements`	結算記錄審核
代理提款	`/affiliate/aff-withdrawals`	提款記錄審核
綁定紀錄	`/affiliate/bind-logs`	上下線綁定歷史
VIP 里程碑	`/affiliate/vip-milestones`	下線 VIP 達標獎勵
代理導覽	`/affiliate/agent-tour`	新代理引導配置

8.2 代理開通

8.2.1 操作路徑

代理中心 → 代理列表

8.2.2 新增代理

在 SiteTabs 選擇目標站點
點擊「新增代理」
搜尋並選擇要設為代理的用戶
可選：設定自訂代理碼
確認建立

API 端點：POST /affiliate/admin/create-agent

8.2.3 代理身份取得方式

方式	說明
後台指定	管理員在後台手動指定用戶為代理
自動晉升	用戶達到特定條件後自動成為代理（如有設定）

8.2.4 代理推薦碼

每個代理可擁有最多 10 個推薦碼（聯盟推廣碼）：

欄位	說明
推薦碼	唯一代碼，用於邀請連結
主代理碼	關聯的主代理代碼
點擊統計	推薦連結的點擊次數
註冊統計	透過此推薦碼註冊的用戶數

隱私保護：代理視角下，下線帳號顯示為遮罩格式（maskAccount()），中間字元以 * 替代。

8.3 佣金費率配置

8.3.1 操作路徑

代理中心 → 佣金費率

8.3.2 佣金費率矩陣

佣金費率是一個三維矩陣：代理等級 × 代理層級 × 遊戲類型

維度	值	說明
代理等級 (Tier)	4 種	bronze / silver / gold / platinum
代理層級 (Level)	3 層	1（直推）/ 2（二級）/ 3（三級）
遊戲類型 (GameType)	8 種	體育/老虎機/真人/彩票/棋牌/電競/加密/捕魚

總組合數：4 × 3 × 8 = 96 筆費率記錄

8.3.3 佣金費率範例

Bronze（銅牌代理）費率表：

遊戲類型	Level 1 (直推)	Level 2	Level 3
體育	5.00%	2.00%	1.00%
老虎機	5.00%	2.00%	1.00%
真人	5.00%	2.00%	1.00%
彩票	5.00%	2.00%	1.00%
棋牌	5.00%	2.00%	1.00%
電競	5.00%	2.00%	1.00%
加密	5.00%	2.00%	1.00%
捕魚	5.00%	2.00%	1.00%

Gold（金牌代理）費率表：

遊戲類型	Level 1 (直推)	Level 2	Level 3
體育	8.00%	3.00%	1.50%
老虎機	8.00%	3.00%	1.50%
真人	8.00%	3.00%	1.50%
彩票	8.00%	3.00%	1.50%
棋牌	8.00%	3.00%	1.50%
電競	8.00%	3.00%	1.50%
加密	8.00%	3.00%	1.50%
捕魚	8.00%	3.00%	1.50%

8.3.4 費率編輯

在 SiteTabs 選擇目標站點
使用 Tab 切換不同代理等級
在矩陣中編輯各遊戲類型 × 層級的費率
儲存

8.3.5 使用帶入模板

快速建立佣金費率配置：

點擊「帶入模板」
預覽包含 4 等級 × 3 層級 × 8 遊戲類型 = 96 筆費率
可在預覽中調整
確認後以原子操作寫入當前站點

8.4 代理等級設定

8.4.1 操作路徑

代理中心 → 代理等級

8.4.2 預設代理等級

等級	英文名	中文名	說明
bronze	Bronze	銅牌代理	初始等級
silver	Silver	銀牌代理	進階等級
gold	Gold	金牌代理	高級等級
platinum	Platinum	白金代理	最高等級

8.4.3 等級管理

新增等級：設定等級代碼、名稱（多語系）、晉升條件
編輯等級：修改等級資訊
刪除等級：移除不需要的等級
手動指定：管理員可手動調整代理等級

手動指定 API：POST /affiliate/admin/set-agent-tier

8.5 佣金結算

8.5.1 操作路徑

代理中心 → 佣金結算

8.5.2 結算排程

結算類型	排程時間	說明
週結	每週一 03:00	彙整上週的佣金
日結	每日 03:30	彙整前一天的佣金

8.5.3 佣金計算邏輯

代理佣金 = Σ(下線有效投注 × 對應費率)

計算維度：
  - 遍歷所有下線（1-3 層）
  - 依下線遊戲類型查對應費率
  - 依代理等級查對應費率
  - 依代理層級（1/2/3）查對應費率
  - 累加所有佣金

8.5.4 結算狀態流程

pending（待審核）
  → approved（已核准）：管理員審核通過
  → rejected（已拒絕）：管理員審核拒絕

8.5.5 風控檢測

結算時系統自動進行風控檢測，標記異常模式：

風控規則	說明
異常投注量	下線投注量突然暴增
異常註冊	短時間大量新下線註冊
交叉投注	上下線之間的投注模式異常

查看風控紀錄：

在結算詳情中可查看該筆結算的風控檢測結果：

API：GET /affiliate/admin/settlements/:id/risk-logs

8.5.6 審核結算

在 SiteTabs 選擇站點
使用篩選條件（狀態、日期範圍）
點擊結算記錄查看詳情
檢查風控紀錄
選擇「核准」或「拒絕」

8.5.7 手動觸發結算

用於測試或特殊情況：

API 端點	說明
`POST /affiliate/admin/trigger-settlement`	手動觸發週結
`POST /affiliate/admin/trigger-daily-settlement`	手動觸發日結

8.6 代理提款

8.6.1 操作路徑

代理中心 → 代理提款

8.6.2 提款流程

代理的佣金餘額儲存在獨立的代理錢包中，提款流程：

代理在前台申請提款
  → pending（待審核）
    → approved（已核准）：管理員審核通過
      → completed（已完成）：匯款完成
    → rejected（已拒絕）：退回代理錢包

8.6.3 審核操作

與一般提款審核類似，分三步：

審核：檢查提款資訊，核准或拒絕
匯款：核准後進行實際匯款
完成：標記為已完成

API 端點：

審核：POST /affiliate/admin/withdrawals/:id/review
完成：POST /affiliate/admin/withdrawals/:id/complete

8.6.4 篩選功能

狀態篩選（待審核/已核准/已拒絕/已完成）
提款方式篩選
日期範圍

8.7 綁定紀錄

8.7.1 操作路徑

代理中心 → 綁定紀錄

8.7.2 紀錄內容

紀錄所有代理-用戶的綁定操作歷史：

欄位	說明
操作類型	綁定 / 解除綁定
代理帳號	上線代理資訊
用戶帳號	下線用戶資訊
推薦碼	使用的推薦碼
時間	操作時間

8.7.3 篩選功能

操作類型（action）
推薦碼（refCode）
日期範圍

8.7.4 手動綁定

管理員可手動綁定上下線關係：

API 端點：POST /affiliate/admin/bind

8.8 VIP 里程碑

8.8.1 操作路徑

代理中心 → VIP 里程碑

8.8.2 功能說明

VIP 里程碑是代理系統的額外獎勵機制：當代理的下線用戶 VIP 等級達到特定門檻時，自動發放獎勵給代理。

8.8.3 配置範例

下線 VIP 等級	獎勵金額 (USD)	說明
Lv.3 金牌	50.00	下線升至金牌時獎勵代理
Lv.5 鑽石	200.00	下線升至鑽石時獎勵代理
Lv.7 傳奇	1,000.00	下線升至傳奇時獎勵代理

8.8.4 觸發機制

VIP 里程碑由 VipService 自動觸發：

用戶投注 → VIP 等級提升
  → VipService 檢查是否有對應里程碑
    → 有 → 查找上線代理
      → 發放獎勵至代理錢包
      → 記錄里程碑日誌

8.8.5 管理操作

新增里程碑：設定 VIP 等級門檻和獎勵金額
編輯里程碑：修改獎勵配置
刪除里程碑：移除不需要的里程碑

8.9 代理導覽

8.9.1 操作路徑

代理中心 → 代理導覽

8.9.2 功能說明

代理導覽是為新代理用戶提供的引導功能，幫助他們了解代理系統的操作方式。

8.9.3 配置項目

欄位	說明
agentTourEnabled	是否啟用代理導覽（0=關 1=開）
agentTourIntervalSec	重新提醒間隔（秒），預設 604800（7 天）

8.9.4 操作模式

代理導覽採用「模式 B（設定頁）」模式，每個站點獨立配置。

8.10 聯盟系統 (Alliance)

8.10.1 概述

聯盟系統是代理系統的延伸，提供更完整的代理推廣功能：

功能	說明
推廣碼管理	每人最多 10 個聯盟推廣碼
代理等級體系	bronze / silver / gold / platinum
佣金費率矩陣	等級 × 層級 × 遊戲類型
VIP 里程碑	下線 VIP 達標自動獎勵

8.10.2 公開端點（前台代理面板用）

端點	說明
`GET /affiliate/alliance-info`	代理個人資訊
`GET /affiliate/tier-info`	代理等級資訊
`GET /affiliate/vip-milestones`	VIP 里程碑資訊
`GET /affiliate/referral-codes`	推薦碼管理

第 9 章：客服配置

9.1 客服系統概述

客服系統是商戶與用戶溝通的重要橋樑。C9 平台支援 8 種客服管道配置，每個站點可獨立設定，確保用戶能透過最方便的方式聯繫客服。

9.1.1 客服配置位置

系統管理 → 客服配置

9.1.2 客服配置架構

客服設定儲存在站點配置的 customerServiceConfig 欄位中，包含：

json

{
  "channels": [
    {
      "type": "line",
      "label": { "zh-TW": "Line 客服", "en-US": "Line Support" },
      "icon": "https://r2.example.com/icons/line.png",
      "link": "https://line.me/R/ti/p/@lucky88",
      "sortOrder": 1,
      "enabled": true
    },
    // ... 更多管道
  ],
  "liveChatScript": "<script>...<\/script>",
  "liveChatEnabled": true
}

9.2 客服管道詳解

9.2.1 Line

欄位	說明	範例
type	`line`	-
label	顯示名稱（多語系）	`{"zh-TW":"Line 客服","en-US":"Line Support"}`
icon	圖示 URL	可使用預設或自訂
link	Line 官方帳號連結	`https://line.me/R/ti/p/@lucky88`
sortOrder	顯示排序	`1`
enabled	是否啟用	`true`

Line 連結格式：

官方帳號：https://line.me/R/ti/p/@{帳號ID}
群組：https://line.me/R/ti/g/{群組ID}

9.2.2 Telegram

欄位	說明	範例
type	`telegram`	-
label	顯示名稱（多語系）	`{"zh-TW":"Telegram 客服","en-US":"Telegram"}`
icon	圖示 URL	-
link	Telegram 連結	`https://t.me/lucky88_support`
sortOrder	顯示排序	`2`
enabled	是否啟用	`true`

Telegram 連結格式：

個人/機器人：https://t.me/{username}
群組：https://t.me/joinchat/{邀請碼}

9.2.3 WeChat

欄位	說明	範例
type	`wechat`	-
label	顯示名稱（多語系）	`{"zh-TW":"微信客服","en-US":"WeChat"}`
icon	圖示 URL	-
link	微信 ID 或 QR Code URL	`lucky88_wechat`
sortOrder	顯示排序	`3`
enabled	是否啟用	`true`

9.2.4 Facebook

欄位	說明	範例
type	`facebook`	-
label	顯示名稱（多語系）	`{"zh-TW":"Facebook 粉絲頁","en-US":"Facebook"}`
icon	圖示 URL	-
link	Facebook 頁面連結	`https://www.facebook.com/lucky88casino`
sortOrder	顯示排序	`4`
enabled	是否啟用	`true`

9.2.5 Instagram

欄位	說明	範例
type	`instagram`	-
label	顯示名稱（多語系）	`{"zh-TW":"Instagram","en-US":"Instagram"}`
icon	圖示 URL	-
link	Instagram 個人檔案	`https://www.instagram.com/lucky88casino`
sortOrder	顯示排序	`5`
enabled	是否啟用	`true`

9.2.6 Twitter (X)

欄位	說明	範例
type	`twitter`	-
label	顯示名稱（多語系）	`{"zh-TW":"Twitter / X","en-US":"Twitter / X"}`
icon	圖示 URL	-
link	Twitter 個人檔案	`https://twitter.com/lucky88casino`
sortOrder	顯示排序	`6`
enabled	是否啟用	`true`

9.2.7 Discord

欄位	說明	範例
type	`discord`	-
label	顯示名稱（多語系）	`{"zh-TW":"Discord 社群","en-US":"Discord"}`
icon	圖示 URL	-
link	Discord 邀請連結	`https://discord.gg/lucky88`
sortOrder	顯示排序	`7`
enabled	是否啟用	`true`

9.2.8 自訂 (Custom)

欄位	說明	範例
type	`custom`	-
label	顯示名稱（多語系）	`{"zh-TW":"聯繫我們","en-US":"Contact Us"}`
icon	圖示 URL	自訂圖示
link	自訂連結	`https://lucky88.com/contact`
sortOrder	顯示排序	`8`
enabled	是否啟用	`true`

9.3 LiveChat 即時聊天

9.3.1 什麼是 LiveChat

LiveChat 是嵌入在前台網站中的即時聊天小工具，通常在頁面右下角以浮動按鈕呈現。用戶點擊後可直接與客服人員進行即時文字對話。

9.3.2 配置方式

在第三方 LiveChat 服務商（如 Tidio、LiveChat、Crisp 等）註冊帳號
取得嵌入腳本代碼
前往「系統管理 → 客服配置」
啟用 LiveChat 開關
將腳本代碼貼入 liveChatScript 欄位
儲存

9.3.3 LiveChat 與管道的區別

比較項目	客服管道	LiveChat
互動方式	跳轉至外部連結	在站內即時對話
人力需求	被動接收訊息	需要即時值班
用戶體驗	需離開網站	不離開網站
獨立開關	每個管道獨立	LiveChat 獨立開關

9.4 同預設站點

9.4.1 複製方式

客服配置使用「前端狀態拷貝」模式：

在 SiteTabs 切換到非預設站點
點擊「同預設站點」按鈕
系統深拷貝預設站點的 editMap + liveChatMap
修改各管道的 link 為您自己的客服連結
點擊「儲存」

9.4.2 複製後必須修改的項目

必須修改	原因
各管道的 link	連結應指向您的客服帳號，而非預設站的
LiveChat 腳本	腳本應為您的 LiveChat 帳號
管道圖示（如有自訂）	確保品牌一致

9.4.3 可保留的項目

可保留	原因
sortOrder 排序	排列順序通常不需變更
enabled 狀態	可沿用預設站的啟用/停用設定
label 名稱	如果名稱通用（如「Line 客服」）可沿用

9.5 客服配置建議

9.5.1 管道選擇建議

市場	建議管道	說明
台灣	Line, Facebook, LiveChat	Line 在台灣市佔率最高
東南亞	Telegram, Facebook, LiveChat	Telegram 在東南亞很普及
大陸	WeChat, Custom	微信為主要通訊工具
國際	Telegram, Discord, LiveChat	國際用戶偏好

9.5.2 管道排序建議

將最常用的管道排在前面（sortOrder 數字越小越前），建議：

即時通訊（Line / Telegram / WeChat）
社群媒體（Facebook / Instagram）
社群聊天（Discord）
其他（Twitter / Custom）

第 10 章：風控管理

10.1 風控管理概述

風控管理是確保平台安全運營的重要功能。C9 平台提供三大風控工具，每個站點可獨立配置，有效防範欺詐、多開帳號、異常行為等風險。

10.1.1 風控管理模組一覽

模組	路由	功能	多站點
IP 黑白名單	`/risk-control/ip-rules`	IP 封鎖/放行管理	是
遊戲黑名單	`/risk-control/game-blacklist`	禁止特定用戶遊玩	是
IP/裝置指紋查詢	`/risk-control/ip-check`	反查可疑帳號	是

10.2 IP 黑白名單

10.2.1 操作路徑

風控管理 → IP 黑白名單

10.2.2 名單類型

類型	說明	效果
黑名單 (blacklist)	封鎖特定 IP	該 IP 無法訪問平台
白名單 (whitelist)	放行特定 IP	該 IP 不受其他限制影響

10.2.3 新增 IP 規則

在 SiteTabs 選擇站點
點擊「新增規則」
填寫以下資訊：

欄位	說明	範例
IP 位址	要管控的 IP	`203.0.113.100`
類型	黑名單或白名單	`blacklist`
備註	加入原因	`多開帳號嫌疑`
過期時間	何時自動解除（可選）	`2026-12-31`

10.2.4 篩選功能

篩選欄位	類型	說明
類型	下拉選單	黑名單/白名單
IP 關鍵字	文字	模糊搜尋 IP
開始日期	日期選擇器	建立時間範圍
結束日期	日期選擇器	建立時間範圍

10.2.5 IP 黑名單使用場景

場景	建議操作
檢測到攻擊行為	加入黑名單，永久封鎖
已知的 VPN/代理 IP	加入黑名單
多開帳號的 IP	加入黑名單
管理員固定 IP	加入白名單，確保不被誤封
合作夥伴 IP	加入白名單

10.3 遊戲黑名單

10.3.1 操作路徑

風控管理 → 遊戲黑名單

10.3.2 封鎖類型

遊戲黑名單支援三種封鎖粒度：

封鎖類型	說明	範例
全封鎖	禁止用戶遊玩所有遊戲	永久/暫時封禁
類型封鎖	禁止特定遊戲類型	禁止玩老虎機
遊戲封鎖	禁止特定遊戲	禁止玩某個特定老虎機

10.3.3 新增遊戲黑名單

在 SiteTabs 選擇站點
點擊「新增黑名單」
搜尋並選擇用戶
選擇封鎖類型
若為類型封鎖，選擇遊戲類型
若為遊戲封鎖，選擇特定遊戲
填寫封鎖原因
儲存

10.3.4 篩選功能

篩選欄位	類型	說明
用戶 ID	文字	搜尋特定用戶
用戶帳號	文字	搜尋帳號
遊戲類型	下拉選單	篩選特定遊戲類型
開始日期	日期選擇器	-
結束日期	日期選擇器	-

10.3.5 遊戲黑名單效果

當用戶被加入遊戲黑名單後，啟動遊戲時：

用戶嘗試啟動遊戲
  → 系統檢查遊戲黑名單
    → 符合封鎖條件
      → 返回錯誤碼 5010
      → 前台顯示「您已被禁止遊玩此遊戲」

10.4 IP/裝置指紋查詢

10.4.1 操作路徑

風控管理 → IP/裝置指紋查詢

10.4.2 查詢方式

此功能用於反查可疑帳號，支援多種查詢條件：

查詢條件	說明	用途
IP 位址	輸入 IP 查找使用該 IP 的所有用戶	檢測多開帳號
裝置指紋	輸入 FingerprintJS 指紋 ID	檢測同裝置多帳號
帳號	輸入帳號反查 IP 和指紋	查看用戶登入歷史
姓名	輸入真實姓名搜尋	查找特定用戶
Email	輸入 Email 搜尋	查找特定用戶
手機號碼	輸入手機號搜尋	查找特定用戶

10.4.3 查詢結果

查詢結果顯示匹配的用戶列表，包含：

欄位	說明
用戶帳號	匹配的帳號
IP 位址	登入使用的 IP
裝置指紋	FingerprintJS 指紋 ID
登入時間	最近登入時間
站點	所屬站點

10.4.4 常見風控場景

場景	操作步驟
懷疑多開帳號	1. 用 IP 查詢 → 2. 發現多個帳號 → 3. 用指紋確認 → 4. 加入黑名單
異常登入地點	1. 查看用戶登入 IP → 2. 確認 IP 地理位置異常 → 3. 聯繫用戶確認
可疑存提款	1. 查看用戶 IP → 2. 比對銀行卡持有人資訊 → 3. 加入風控觀察

10.5 登入失敗紀錄

10.5.1 操作路徑

玩家管理 → 登入失敗紀錄

10.5.2 紀錄內容

欄位	說明
帳號/Email	嘗試登入的帳號
IP 位址	登入來源 IP
失敗原因	密碼錯誤、帳號不存在等
時間	失敗時間

10.5.3 用途

偵測暴力破解攻擊
追蹤帳號被盜嘗試
協助用戶排查登入問題

第 11 章：報表使用

11.1 報表系統概述

C9 平台提供 7 大報表類型，涵蓋營運所需的各項數據分析。所有報表均支援多站點 SiteTabs 和 CSV 匯出。

11.1.1 報表模組一覽

報表	路由	功能	多站點
總覽報表	`/reports/overview`	整體營運數據	是
玩家報表	`/reports/players`	玩家指標	是
玩家簡表	`/reports/player-summary`	玩家摘要	是
遊戲報表	`/reports/games`	遊戲表現	是
投注紀錄	`/reports/bet-records`	個別投注	是
損益報表	`/reports/profit-loss`	損益分析	是
活動報表	`/reports/promos`	活動統計	待實作

11.2 總覽報表

11.2.1 操作路徑

報表 → 總覽

11.2.2 篩選條件

欄位	類型	說明
開始日期	日期選擇器	-
結束日期	日期選擇器	-

11.2.3 報表內容

統計卡片（頂部摘要）：

指標	說明
總存款	期間總存款金額 (USD)
總提款	期間總提款金額 (USD)
淨收入	總存款 - 總提款
新註冊	新註冊用戶數
活躍用戶	期間有登入的用戶數
投注量	期間總投注量 (USD)

每日摘要表格：

欄位	說明
日期	每日一行
存款	當日存款金額
提款	當日提款金額
投注量	當日投注量
盈虧	當日平台盈虧
活躍用戶	當日活躍用戶數

11.3 玩家報表

11.3.1 操作路徑

報表 → 玩家報表

11.3.2 篩選條件

欄位	類型	說明
關鍵字	文字	搜尋帳號/姓名
VIP 等級	下拉選單	動態取得等級列表
開始日期	日期選擇器	-
結束日期	日期選擇器	-

11.3.3 報表欄位

欄位	說明
帳號	用戶帳號
VIP 等級	當前 VIP 等級
存款總額	期間存款金額
提款總額	期間提款金額
投注量	期間投注量
盈虧	用戶盈虧
反水	獲得的反水金額
活動獎勵	領取的活動獎勵

11.4 玩家簡表

11.4.1 操作路徑

報表 → 玩家簡表

11.4.2 篩選條件

欄位	類型	說明
關鍵字	文字	搜尋帳號/姓名
VIP 等級	下拉選單	動態等級列表
排序方式	下拉選單	按投注量/存款/盈虧排序
排序方向	下拉選單	升序/降序
開始日期	日期選擇器	-
結束日期	日期選擇器	-

11.4.3 用途

玩家簡表適合快速瀏覽各用戶的概況，可依不同排序方式找出：

投注量最高的用戶
存款量最高的用戶
盈虧最大的用戶

11.5 遊戲報表

11.5.1 操作路徑

報表 → 遊戲報表

11.5.2 篩選條件

欄位	類型	說明
遊戲類型	下拉選單	8 種遊戲類型
遊戲平台	下拉選單	遊戲供應商
開始日期	日期選擇器	-
結束日期	日期選擇器	-

11.5.3 報表欄位

欄位	說明
遊戲名稱	遊戲名稱
遊戲類型	遊戲分類
供應商	遊戲供應商
投注次數	期間投注次數
投注量	期間總投注量
派彩量	期間總派彩量
平台盈虧	投注量 - 派彩量

11.6 投注紀錄

11.6.1 操作路徑

報表 → 投注紀錄

11.6.2 篩選條件

欄位	類型	說明
關鍵字	文字	搜尋帳號/訂單號
遊戲類型	下拉選單	8 種遊戲類型
遊戲平台	下拉選單	遊戲供應商
狀態	下拉選單	進行中/已結算/已取消
開始日期	日期選擇器	-
結束日期	日期選擇器	-

11.6.3 報表欄位

欄位	說明
訂單號	投注訂單編號
帳號	用戶帳號
遊戲名稱	遊戲名稱
遊戲類型	遊戲分類
投注金額	單筆投注金額
派彩金額	單筆派彩金額
盈虧	投注 - 派彩
狀態	進行中/已結算/已取消
時間	投注時間

11.7 損益報表

11.7.1 操作路徑

報表 → 損益報表

11.7.2 篩選條件

欄位	類型	說明
分組方式	下拉選單	日 / 週 / 月
遊戲類型	下拉選單	8 種遊戲類型
開始日期	日期選擇器	-
結束日期	日期選擇器	-

11.7.3 報表欄位

欄位	說明
時段	日期/週次/月份
投注量	期間總投注量
派彩量	期間總派彩量
平台盈虧	投注量 - 派彩量
反水支出	發放的反水金額
活動支出	發放的活動獎勵
淨盈虧	平台盈虧 - 反水 - 活動

11.7.4 分組方式說明

分組	說明
日	每天一筆，適合短期分析
週	每週一筆，適合中期趨勢
月	每月一筆，適合長期趨勢

11.8 活動報表

11.8.1 操作路徑

報表 → 活動報表

11.8.2 篩選條件

開始日期
結束日期

11.8.3 報表欄位

欄位	說明
活動名稱	活動標題
領取人數	已領取用戶數
發放金額	總發放金額
平均金額	平均每人發放金額

11.9 報表匯出

11.9.1 CSV 匯出

所有報表頁面均提供 CSV 匯出按鈕（ExportButton）：

設定篩選條件
確認資料正確
點擊「匯出 CSV」按鈕
瀏覽器下載 CSV 檔案

11.9.2 匯出注意事項

注意事項	說明
資料量	大量資料匯出可能需要較長時間
編碼	CSV 採用 UTF-8 編碼，Excel 開啟可能需要轉碼
精度	金額保留 6 位小數
日期	使用 ISO 8601 格式

第 12 章：前台佈局配置

12.1 佈局配置概述

C9 平台的前台佈局可透過後台進行動態配置，無需修改程式碼。目前支援 3 個可配置的佈局區塊：

區塊	路由	說明	配置模式
底部導航列	`/system/layout-bottom-bar`	行動版底部 Tab	模式 B（設定頁）
頁尾	`/system/layout-footer`	頁面底部連結	模式 B（設定頁）
了解更多	`/system/layout-learn-more`	FAQ / 介紹內容	模式 B（設定頁）

所有佈局配置頁面均為「模式 B」，即每個站點獨立配置，支援「同預設站點」複製。

12.2 底部導航列

12.2.1 操作路徑

系統管理 → 底部導航列

12.2.2 功能說明

底部導航列是行動版前台網站底部的固定 Tab 列，讓用戶快速切換主要功能頁面。

12.2.3 配置結構

底部導航列分為行動版和桌面版兩組配置：

json

{
  "mobile": [
    {
      "icon": "home",
      "label": { "zh-TW": "首頁", "en-US": "Home" },
      "link": "/",
      "sortOrder": 1,
      "enabled": true
    },
    {
      "icon": "games",
      "label": { "zh-TW": "遊戲", "en-US": "Games" },
      "link": "/games",
      "sortOrder": 2,
      "enabled": true
    }
    // ... 更多項目
  ],
  "desktop": [ /* 桌面版配置 */ ]
}

12.2.4 配置欄位

每個導航項目的配置：

欄位	說明
icon	圖示名稱
label	顯示文字（多語系）
link	點擊後導向的路徑
sortOrder	顯示排序
enabled	是否啟用

12.2.5 開關控制

每個站點可獨立控制是否顯示底部導航列：

站點基本設定 → bottomBarEnabled: 0（關）/ 1（開）

12.2.6 常見導航項目

項目	圖示	連結	說明
首頁	home	`/`	平台首頁
遊戲	games	`/games`	遊戲大廳
存款	deposit	`/deposit`	存款頁面
活動	promo	`/promos`	優惠活動
我的	user	`/profile`	個人中心

12.3 頁尾配置

12.3.1 操作路徑

系統管理 → 頁尾

12.3.2 功能說明

12.3.3 配置結構

頁尾以「分組」方式組織，每個分組包含多個連結：

json

[
  {
    "title": { "zh-TW": "快速連結", "en-US": "Quick Links" },
    "icon": "link",
    "sortOrder": 1,
    "enabled": true,
    "links": [
      {
        "label": { "zh-TW": "首頁", "en-US": "Home" },
        "link": "/",
        "icon": "home",
        "sortOrder": 1
      },
      {
        "label": { "zh-TW": "優惠活動", "en-US": "Promotions" },
        "link": "/promos",
        "icon": "gift",
        "sortOrder": 2
      }
    ]
  },
  {
    "title": { "zh-TW": "關於我們", "en-US": "About Us" },
    "icon": "info",
    "sortOrder": 2,
    "enabled": true,
    "links": [
      {
        "label": { "zh-TW": "使用條款", "en-US": "Terms of Service" },
        "link": "/terms",
        "icon": "file",
        "sortOrder": 1
      }
    ]
  }
]

12.3.4 配置欄位

分組欄位：

欄位	說明
title	分組標題（多語系）
icon	分組圖示
sortOrder	分組排序
enabled	是否顯示此分組
links	分組下的連結清單

連結欄位：

欄位	說明
label	連結文字（多語系）
link	連結 URL
icon	連結圖示
sortOrder	連結排序

12.3.5 頁尾規劃建議

分組	建議連結
快速連結	首頁、遊戲、活動、VIP
幫助中心	常見問題、聯繫客服、使用教學
關於我們	使用條款、隱私政策、負責任博彩
下載	Android APK、iOS 連結（如有）

12.4 了解更多

12.4.1 操作路徑

系統管理 → 了解更多

12.4.2 功能說明

「了解更多」區塊是前台的 FAQ / 平台介紹區域，以問答形式呈現。

12.4.3 配置結構

json

[
  {
    "question": { "zh-TW": "如何註冊帳號？", "en-US": "How to register?" },
    "answer": { "zh-TW": "點擊右上角的「註冊」按鈕...", "en-US": "Click the 'Register' button..." },
    "sortOrder": 1,
    "enabled": true
  },
  {
    "question": { "zh-TW": "如何存款？", "en-US": "How to deposit?" },
    "answer": { "zh-TW": "登入後前往「存款」頁面...", "en-US": "After login, go to 'Deposit' page..." },
    "sortOrder": 2,
    "enabled": true
  }
]

12.4.4 配置欄位

欄位	說明
question	問題（多語系）
answer	答案（多語系）
sortOrder	顯示排序
enabled	是否啟用

12.4.5 建議 FAQ 內容

問題	分類
如何註冊帳號？	帳號
忘記密碼怎麼辦？	帳號
如何存款？	金流
支援哪些存款方式？	金流
如何提款？	金流
提款需要多長時間？	金流
什麼是 VIP 等級？	VIP
如何升級 VIP？	VIP
返水如何計算？	VIP
如何成為代理？	代理
代理佣金如何結算？	代理
如何聯繫客服？	客服

12.5 佈局配置通用操作

12.5.1 同預設站點

所有三個佈局配置頁面均支援「同預設站點」功能：

在 SiteTabs 切換到非預設站點
點擊「同預設站點」
系統深拷貝預設站點的配置
根據需要修改內容（如連結文字、URL）
點擊「儲存」

12.5.2 多語系配置

所有文字欄位（label、title、question、answer）均支援多語系：

需為站點支援的每種語系提供翻譯
建議提供全部 5 種語系的翻譯
前台會根據用戶當前語系自動顯示對應文字

12.5.3 排序說明

所有項目都有 sortOrder 欄位：

數字越小，顯示越靠前
建議以 10 為間距（10, 20, 30...），方便日後插入新項目

第 13 章：雲端儲存

13.1 雲端儲存概述

C9 平台使用 Cloudflare R2 作為雲端物件儲存服務，用於管理所有站點的圖片、檔案等靜態資源。後台提供完整的檔案管理介面，讓商戶輕鬆上傳和組織品牌素材。

13.1.1 雲端儲存模組

模組	路由	功能	多站點
R2 檔案管理	`/system/cloud-storage`	檔案瀏覽/上傳/管理	是
操作紀錄	`/system/cloud-storage-logs`	R2 操作歷史	是

13.1.2 R2 服務配置

每個站點的 R2 服務配置儲存在站點設定的 serviceProviders.r2 欄位中：

欄位	說明
bucketName	R2 Bucket 名稱
endpoint	R2 API 端點
accessKeyId	存取金鑰 ID
secretAccessKey	存取密鑰
publicUrl	公開存取 URL

13.2 R2 檔案管理

13.2.1 操作路徑

系統管理 → 雲端儲存

13.2.2 檔案瀏覽

檔案管理頁面提供類似檔案總管的瀏覽介面：

目錄導航：點擊資料夾進入子目錄
麵包屑路徑：顯示當前所在路徑，可點擊返回上層
搜尋：在當前目錄搜尋檔案名稱
檢視模式：列表模式 / 網格模式

13.2.3 檔案上傳

上傳方式：

點擊「上傳」按鈕
選擇一個或多個檔案
或直接拖放檔案到上傳區域
等待上傳完成

支援的檔案類型：

類型	格式	說明
圖片	PNG, JPG, JPEG, GIF, SVG, WebP	品牌素材、遊戲封面
圖示	ICO	Favicon
文件	PDF	活動說明文件

13.2.4 目錄管理

操作	說明
建立資料夾	在當前目錄建立新的子資料夾
刪除資料夾	刪除空的資料夾
移動檔案	將檔案移動到指定目錄

13.2.5 檔案操作

操作	說明
預覽	預覽圖片檔案
複製 URL	複製檔案的公開存取 URL
下載	下載檔案到本地
刪除	刪除單個檔案
批次刪除	選擇多個檔案一起刪除

13.2.6 API 端點

功能	端點	說明
列出檔案	`GET /admin/r2/list`	列出目錄下的檔案
上傳檔案	`POST /admin/r2/upload`	上傳檔案至指定路徑
刪除檔案	`DELETE /admin/r2/delete`	刪除指定檔案
移動檔案	`POST /admin/r2/move`	移動檔案至新路徑
建立資料夾	`POST /admin/r2/create-folder`	建立新資料夾
刪除資料夾	`DELETE /admin/r2/delete-folder`	刪除空資料夾

13.3 圖片上傳規範

13.3.1 Logo 規範

素材	建議尺寸	格式	最大大小	注意事項
Logo（小）	200 x 60 px	PNG	200KB	透明背景，用於導航列
Logo（大）	400 x 120 px	PNG	500KB	透明背景，用於登入頁/載入畫面
Favicon	32x32 或 64x64 px	ICO / PNG	50KB	正方形，清晰可辨

13.3.2 遊戲封面規範

素材	建議尺寸	格式	說明
遊戲縮圖	依遊戲商規格	PNG / JPG	每個遊戲一張
遊戲橫幅	1200 x 400 px	PNG / JPG	遊戲類別頁橫幅

目錄組織建議：

{prefix}/games/
├── zh-TW/
│   ├── slot-001.png
│   ├── slot-002.png
│   └── ...
├── en-US/
│   ├── slot-001.png
│   └── ...
└── default/          ← 無語系版本時使用
    ├── slot-001.png
    └── ...

13.3.3 活動素材規範

素材	建議尺寸	格式	說明
PC 版封面	1200 x 400 px	PNG / JPG	桌面版活動頁顯示
手機版封面	750 x 400 px	PNG / JPG	行動版活動頁顯示
活動內文圖	寬度不超過 800 px	PNG / JPG	活動內容中的配圖

目錄組織建議：

{prefix}/promos/
├── welcome-bonus-pc.png
├── welcome-bonus-mobile.png
├── daily-reward-pc.png
├── daily-reward-mobile.png
└── ...

13.3.4 吉祥物/頭像規範

素材	建議尺寸	格式	說明
吉祥物	200 x 200 px 以上	PNG	透明背景，正方形
用戶頭像選項	100 x 100 px	PNG	供用戶選擇的頭像

目錄組織建議：

{prefix}/mascots/
├── mascot-default.png
├── mascot-vip.png
├── mascot-event.png
└── ...

13.3.5 客服圖示規範

素材	建議尺寸	格式	說明
管道圖示	48 x 48 px	PNG	透明背景，各管道圖示

13.3.6 圖片優化建議

建議	說明
壓縮圖片	使用 TinyPNG 等工具壓縮，減少載入時間
使用 WebP	可能的話使用 WebP 格式，體積更小
適當尺寸	不要上傳過大的圖片，按實際顯示尺寸準備
命名規範	使用有意義的英文檔名，避免中文或特殊字元
統一風格	同系列素材保持統一的視覺風格

13.4 操作紀錄

13.4.1 操作路徑

系統管理 → 雲端儲存日誌

13.4.2 紀錄內容

所有 R2 檔案操作均會自動記錄：

欄位	說明
操作類型	上傳 / 刪除 / 移動 / 建立資料夾
檔案路徑	操作的檔案或目錄路徑
操作者	執行操作的管理員
MIME Type	檔案類型（如 image/png）
檔案大小	檔案大小
時間	操作時間
OS	操作系統（從 User-Agent 解析）
瀏覽器	瀏覽器類型和版本（從 User-Agent 解析）

13.4.3 詳情對話框

點擊紀錄可開啟詳情對話框，顯示完整的操作資訊，包含：

完整檔案路徑
MIME Type
檔案大小
完整 User-Agent 字串
解析後的 OS 和瀏覽器資訊
操作時間戳

13.4.4 篩選功能

關鍵字搜尋（檔案路徑、操作者）
操作類型篩選
日期範圍篩選
多站點 SiteTabs 切換

第 14 章：常見問題 FAQ

以下整理了商戶在接入和營運過程中最常遇到的問題及解答。

14.1 站點建立與設定相關

Q1：如何新增一個站點？

答：

前往「系統管理 → 站點基本設定」
點擊「新增站點」
填寫 siteCode（站點代碼）、prefix（白牌前綴）、siteName（站點名稱，多語系 JSON）
可選填 siteDescription（站點介紹）和 supportedLocales（支援語系）
儲存後即完成建立

詳細步驟請參考第 2 章第 2.3 節。

Q2：如何更換主題色彩？

答：

前往「系統管理 → 站點基本設定」
找到您的站點
進入主題管理
編輯現有主題的色彩值，或新增一個主題
將新主題設為「啟用主題」
用戶刷新頁面即可看到新色彩

您可以直接使用 6 組內建預設（Emerald / Amber / Sky / Violet / Rose / Cyan），也可以完全自訂 OKLCH 色彩值。

Q3：如何新增一個遊戲供應商？

答：

C9 平台的遊戲供應商整合在後端統一管理。如需新增新的遊戲供應商（如接入新遊戲商 API），需由平台方在後端新增對應的 Module，前端無需任何改動。

如果是在現有供應商下新增遊戲：

前往「遊戲管理 → 遊戲供應商」
點擊「新增」
填寫遊戲代碼、供應商代碼、遊戲類型、名稱等
儲存

Q4：如何配置 VIP 等級？

答：

前往「VIP → VIP 等級」
在 SiteTabs 選擇您的站點
可使用「帶入模板」快速匯入預設等級結構
或使用「同預設站點」從預設站複製
也可手動逐一新增等級
每個等級需設定：名稱、升級門檻（minChip）、保級門檻（relegationChip）

等級數量不限，您可以根據市場策略自由設定。

Q5：如何設定代理推廣系統？

答：

代理系統配置分幾個步驟：

設定代理等級：前往「代理中心 → 代理等級」，定義等級結構（預設為 bronze/silver/gold/platinum）
設定佣金費率：前往「代理中心 → 佣金費率」，配置各等級 × 各層級 × 各遊戲類型的費率
設定 VIP 里程碑（可選）：前往「代理中心 → VIP 里程碑」，配置下線 VIP 達標獎勵
開通代理帳號：前往「代理中心 → 代理列表」，將用戶設為代理

所有配置均可使用「帶入模板」快速套用預設值。

14.2 金流與財務相關

Q6：存款審核流程是什麼？

答：

存款訂單的狀態流程為：

pending → created → paid（成功）或 failed（失敗）

大多數存款由金流商自動回調確認，不需要人工審核。僅在自動回調失敗或金額需要確認時才需要手動處理。

手動審核步驟：

前往「財務管理 → 存款審核」
篩選出需要審核的訂單
查看訂單詳情和支付證明
選擇「通過」或「拒絕」

Q7：提款審核流程是什麼？

答：

提款採用三階段流程：

審核階段：用戶申請提款後，管理員審核（核准或拒絕）
匯款階段：核准後，由財務人員進行實際匯款操作
完成階段：匯款完成後，上傳憑證並標記訂單為「已完成」

若拒絕提款，凍結金額會自動退回用戶可用餘額。

Q8：VIP 等級變動時會發生什麼？

答：

升級時：

即時生效，用戶立即享受新等級的返水比例
觸發 VIP 里程碑檢查（如有代理上線，可能發放獎勵）

降級時（月度保級未通過）：

僅在每月 1 號 01:00 的保級檢查時觸發
連續 2 個月未達保級門檻才會降級
降級幅度為降低 1 個等級
設有 vipHold 保護的用戶不會被降級

Q9：返水是如何計算的？

答：

返水計算由系統每日自動執行（凌晨 00:05）：

返水金額 = 前一日有效投注 × 對應返水比例

其中：
- 有效投注：按遊戲類型分別統計
- 返水比例：依用戶 VIP 等級 × 遊戲類型查表
- 金額精度：USD decimal(18,6)，無條件捨去

返水直接加入用戶可用餘額，記錄在 vip-rebate-log 表中。

14.3 報表與數據相關

Q10：如何查看報表？

答：

前往「報表」選單，選擇所需報表類型
在 SiteTabs 選擇站點
使用篩選條件縮小範圍（日期、關鍵字等）
查看表格數據
如需匯出，點擊「匯出 CSV」按鈕

7 種報表類型：總覽、玩家、玩家簡表、遊戲、投注紀錄、損益、活動。

Q11：如何管理風控規則？

答：

C9 平台提供三大風控工具：

IP 黑白名單（風控管理 → IP 黑白名單）：封鎖或放行特定 IP
遊戲黑名單（風控管理 → 遊戲黑名單）：禁止特定用戶遊玩全部或特定遊戲
IP/裝置指紋查詢（風控管理 → IP/裝置指紋查詢）：反查可疑帳號

每個工具都支援多站點 SiteTabs，各站獨立配置。

Q12：如何設定客服管道？

答：

前往「系統管理 → 客服配置」
在 SiteTabs 選擇您的站點
新增或編輯客服管道（Line / Telegram / WeChat 等共 8 種）
填寫連結、多語系標籤、排序
啟用/停用管道
如需 LiveChat，啟用開關並貼入嵌入腳本
儲存

快捷方式：使用「同預設站點」複製預設配置，再修改連結為您自己的客服帳號。

Q13：支援哪些支付方式？

答：

目前支援以下支付方式：

方式	說明
ATM 轉帳	銀行 ATM 或網路銀行轉帳
信用卡	Visa / MasterCard 線上刷卡
USDT (TRC20)	TRON 網路 USDT 轉帳
USDT (ERC20)	以太坊網路 USDT 轉帳

每個站點可獨立配置啟用哪些通道，透過 depositMethods 控制前台顯示。

Q14：如何匯出資料？

答：

所有報表頁面和大部分列表頁面都提供 CSV 匯出功能：

設定好篩選條件
點擊頁面上的「匯出 CSV」按鈕
瀏覽器自動下載 CSV 檔案

匯出的 CSV 檔案：

使用 UTF-8 編碼
金額保留 6 位小數
日期使用 ISO 8601 格式

提示：若在 Excel 開啟出現亂碼，請使用「從文字匯入」功能並選擇 UTF-8 編碼。

14.4 管理與安全相關

Q15：如何管理管理員權限？

答：

前往「系統管理 → 群組管理」
建立群組並設定權限（可選 16 個模組 × 讀/寫）
前往「系統管理 → 管理員管理」
新增管理員並指定群組

4 種群組類型：

root：全權限（平台方使用）
super_admin：除站點設定外全權限
general_admin：全模組唯讀
custom：自訂勾選權限

Q16：如何啟用 2FA？

答：

登入後台
點擊右上角個人頭像 → 個人資料
找到「Google Authenticator」區塊
點擊「啟用」
用手機 Google Authenticator App 掃描 QR Code
在後台輸入 App 顯示的 6 位數驗證碼
確認即完成

重要：請務必備份 Secret Key，以防手機遺失時無法登入。

Q17：支援哪些語系？

答：

C9 平台支援 5 種語系：

語系代碼	語言
`zh-TW`	繁體中文（預設）
`en-US`	English
`zh-CN`	简体中文
`th-TH`	ภาษาไทย（泰文）
`vi-VN`	Tiếng Việt（越南文）

每個站點可自由選擇啟用哪些語系。前台和後台均支援語系切換。

Q18：多站點資料是如何隔離的？

答：

C9 平台採用 siteCode 進行資料隔離：

資料庫層：所有資料表的查詢都包含 siteCode 條件
API 層：後端 @AdminSiteCode() 裝飾器自動注入站點代碼
前端層：API Client 在 request header 自動帶入 x-site-code
遊戲配置：game-provider 和 game-type-config 均有 siteCode 欄位
VIP 配置：vip-level 和 vip-rebate 均有 siteCode 欄位
風控規則：IP 規則和遊戲黑名單均有 siteCode 欄位

您的站點資料不會與其他商戶混淆。

14.5 系統與進階功能相關

Q19：如何使用「帶入模板」和「同預設站點」？

答：

這是兩種不同的快速配置方式：

帶入模板：

來源：系統內建的預設模板
操作：點擊「帶入模板」→ 預覽 → 可編輯 → 確認套用
適用：全新站點的初始配置
效果：以原子操作覆蓋當前站點配置

同預設站點（跨站複製）：

來源：預設站點的現有配置
操作：在非預設站 Tab 點擊「同預設站點」→ 確認
適用：已有預設站點的配置，要複製給新站點
效果：直接複製（API 層面），或前端狀態拷貝（需手動儲存）

兩者都僅影響當前站點，不會影響其他站點。

Q20：系統有哪些自動排程任務？

答：

排程	執行時間	功能
每日反水結算	每日 00:05	計算並發放前一日的 VIP 返水
月度保級檢查	每月 1 號 01:00	檢查 VIP 保級條件，處理降級
代理佣金週結	每週一 03:00	彙整上週代理佣金 + 風控檢測
代理佣金日結	每日 03:30	彙整前一日代理佣金
即時賽事快取	每 30 分鐘	更新 API-Football 賽事數據

所有排程任務均為自動執行，無需人工干預。部分排程（如代理結算）也支援後台手動觸發，方便測試。

Q21：前台用戶的認證方式有哪些？

答：

前台用戶支援以下登入方式：

方式	說明
帳號密碼	傳統的帳號 + 密碼登入
Google OAuth	透過 Google 帳號快速登入
Telegram	透過 Telegram 帳號登入

所有方式都使用 JWT Bearer Token 認證，Token 有效期為 7 天。系統同時使用 FingerprintJS v5 進行裝置指紋辨識，增強安全性。

Q22：如何處理活動的打碼量要求？

答：

打碼量（流水要求）是防止薅羊毛的重要機制：

在建立活動時設定 turnoverMultiplier（打碼倍率，如 5x）
用戶領取活動獎勵後，系統記錄需完成的流水量
計算公式：需完成流水 = 獎勵金額 x 打碼倍率
用戶每次投注結算後，系統自動扣減剩餘流水
流水完成前，提款會受到限制
流水全部完成後，用戶可正常提款

Q23：如何查看某個用戶的詳細資訊？

答：

前往「玩家管理 → 全部玩家」
使用關鍵字搜尋找到目標用戶
點擊用戶帳號進入詳情頁（/users/[id]）
詳情頁顯示：基本資料、VIP 資訊、餘額、存提款紀錄、投注紀錄、綁定的錢包資訊等

Q24：如何配置前台底部導航列和頁尾？

答：

底部導航列、頁尾、了解更多區塊都在「系統管理」下方：

系統管理 → 底部導航列：配置行動版底部 Tab 項目
系統管理 → 頁尾：配置頁面底部連結群組
系統管理 → 了解更多：配置 FAQ 問答

每個區塊都是按站點獨立配置（模式 B），支援「同預設站點」複製。所有文字欄位支援多語系。

14.6 其他常見問題

Q25：站點建立後還可以修改 siteCode 嗎？

答：

不可以。siteCode 是站點的唯一識別碼，建立後不可更改。因為：

所有資料表的 siteCode 欄位已關聯此代碼
R2 檔案路徑已使用此代碼
域名配置已綁定此代碼

如果確實需要更改，唯一的方式是建立一個新站點，並手動遷移所有資料。因此建議在建立站點前仔細確認 siteCode 的命名。

Q26：如何處理用戶投訴存款未到帳？

答：

當用戶反映存款未到帳時，按以下步驟排查：

確認訂單狀態
- 前往「財務管理 → 存款審核」
- 用用戶 ID 或訂單 ID 搜尋
- 查看訂單狀態：
  - pending：金流商尚未回調，需等待或聯繫金流商確認
  - created：支付訂單已建立，但用戶可能尚未完成支付
  - failed：支付失敗，確認原因後引導用戶重新存款
  - paid：已到帳，引導用戶刷新頁面確認餘額
確認匯率轉換
- 系統以台灣銀行即時匯率將當地幣別轉為 USD
- 用戶看到的餘額是 USD 計價，可能與入金時的當地幣別數字不同
- 向用戶解釋匯率轉換機制
手動補帳
- 確認金流商已收到款項但系統回調失敗
- 前往「財務管理 → 人工調節金額」
- 搜尋用戶，輸入補帳金額（USD）
- 填寫原因（如「金流回調失敗，手動補帳」）
- 確認提交

Q27：前台支援哪些登入方式？OAuth 如何設定？

答：

前台支援 3 種登入方式：

登入方式	說明	設定位置
帳號密碼	預設方式，無需額外設定	-
Google	Google OAuth 2.0	系統管理 → 三方登入
Telegram	Telegram Login Widget	系統管理 → 三方登入

Google OAuth 設定步驟：

前往 Google Cloud Console（console.cloud.google.com）
建立專案 → 設定 OAuth 同意畫面
建立 OAuth 2.0 客戶端 ID（Web 應用程式類型）
設定授權重新導向 URI：https://您的域名/api/auth/callback/google
取得 Client ID 和 Client Secret
在後台「系統管理 → 三方登入」填入

Telegram 設定步驟：

透過 Telegram 聯繫 @BotFather
使用 /newbot 命令建立新 Bot
記錄 Bot Token 和 Username
使用 /setdomain 設定允許的域名
在後台「系統管理 → 三方登入」填入

Q28：站內信系統如何使用？

答：

站內信系統讓管理員可以向用戶發送通知訊息：

收件匣（站內信 → 收件匣）：

查看所有已發送的站內信
篩選：已讀/未讀狀態、日期範圍
支援多站點 SiteTabs

信件設定（站內信 → 信件設定）：

設定自動通知的範本內容
多語系範本

自動通知事件：

事件	說明
註冊歡迎	新用戶完成註冊後自動發送
存款成功	存款到帳後通知
提款核准	提款審核通過後通知
提款拒絕	提款被拒絕後通知
提款完成	提款匯款完成後通知

每個事件的開關可在站點基本設定的 notificationConfig 中控制。

Q29：如何設定任務系統？

答：

C9 平台的任務系統支援三種任務周期和兩種任務類型：

任務周期：

每日任務：每天重置
每週任務：每週重置
每月任務：每月重置

任務類型：

存款任務：用戶存款達到指定金額即完成
投注任務：用戶投注達到指定金額即完成

自動更新機制：

投注結算後（S2S 回調）自動更新投注任務進度
存款確認到帳後自動更新存款任務進度

Q30：如何查看和管理雲端儲存中的檔案？

答：

前往「系統管理 → 雲端儲存」
使用目錄導航瀏覽檔案
支援的操作：
- 上傳：點擊上傳按鈕或拖放檔案
- 建立資料夾：在當前目錄建立子資料夾
- 移動檔案：將檔案移至其他目錄
- 複製 URL：複製檔案的公開存取連結
- 刪除：單個或批次刪除
所有操作均記錄在「雲端儲存日誌」中

建議目錄結構：

{prefix}/
├── logos/          ← Logo 和 Favicon
├── games/          ← 遊戲封面圖（按語系分子目錄）
├── promos/         ← 活動橫幅
├── mascots/        ← 吉祥物
├── icons/          ← 客服管道圖示
└── misc/           ← 其他素材

第 15 章：術語對照表

本章整理 C9 平台常用的專業術語，提供中英文對照和簡要說明，按英文字母順序排列。商戶在閱讀本文件或操作後台時，若遇到不熟悉的術語，可在此查閱。

15.1 核心業務術語

序號	英文術語	中文術語	說明
1	Active Theme	啟用主題	站點目前使用中的色彩主題
2	Admin JWT	管理員 JWT	後台管理員專用的 JWT 認證策略
3	AdminSiteCode	管理站點代碼裝飾器	後端裝飾器，自動讀取站點代碼
4	Affiliate	代理/聯盟	代理推廣系統，用戶邀請機制
5	Agent Tier	代理等級	代理的等級分類（bronze/silver/gold/platinum）
6	Alliance	聯盟	代理推廣系統的延伸功能
7	Atomic Transaction	原子操作	資料庫事務，確保操作全部成功或全部回滾
8	Balance Adjustment	手動調帳	管理員手動調整用戶餘額
9	Bank Card	銀行卡	用戶綁定的銀行帳戶卡片
10	Bet Order	投注訂單	用戶在遊戲中的單筆投注記錄
11	Bind Log	綁定紀錄	代理與下線用戶的綁定操作歷史
12	Blacklist	黑名單	IP 黑名單或遊戲黑名單
13	Bottom Bar	底部導航列	行動版前台底部的快捷 Tab 列
14	Bulk Upsert	批次更新/新增	一次性更新或插入多筆記錄
15	CHESS	棋牌	遊戲類型之一（撲克、麻將等桌遊）
16	Commission Rate	佣金費率	代理從下線投注中獲得的佣金百分比
17	Copy From Default	同預設站點	從預設站點複製配置到目標站點的功能
18	Credit Card	信用卡	用戶綁定的信用卡
19	Cron	排程任務	系統自動定時執行的任務
20	Crypto Address	加密錢包地址	用戶綁定的加密貨幣錢包地址
21	CRYPTO	加密遊戲	遊戲類型之一（加密貨幣相關遊戲）
22	Customer Service	客服	客服管道配置系統
23	Decimal Precision	精度	金額 decimal(18,6)，匯率 decimal(18,10)
24	Deposit	存款	用戶向平台帳戶入金
25	Deposit Methods	存款通路	站點啟用的存款方式（法幣/信用卡/加密）
26	Domain Config	域名配置	域名與站點的對應關係設定
27	Effective Bet	有效投注	計入 VIP 升級和返水計算的投注金額
28	ESPORTS	電競	遊戲類型之一（電子競技投注）
29	Export CSV	匯出 CSV	將報表資料匯出為 CSV 檔案
30	Feature Flag	功能開關	控制功能模組顯示/隱藏的開關
31	Fingerprint	裝置指紋	FingerprintJS 產生的裝置唯一識別碼
32	FISH	捕魚	遊戲類型之一（捕魚達人類遊戲）
33	Footer	頁尾	前台頁面底部的連結和資訊區塊
34	Game Blacklist	遊戲黑名單	禁止特定用戶遊玩的限制名單
35	Game Provider	遊戲供應商	提供遊戲 API 的第三方（如 BetSolutions、RSG）
36	Game Type Config	遊戲分類配置	遊戲類型的顯示設定（排序、啟用等）
37	Group	群組	管理員權限群組
38	IP Rule	IP 規則	IP 黑名單或白名單規則
39	JWT	JSON Web Token	用於認證的加密令牌
40	Layout	佈局	前台的頁面佈局模板（如 a1）
41	Learn More	了解更多	前台的 FAQ / 平台介紹區塊
42	LIVE	真人	遊戲類型之一（真人荷官遊戲）
43	LiveChat	即時聊天	嵌入在前台的即時聊天小工具
44	Load Template	帶入模板	匯入預設模板配置的功能
45	Locale	語系	語言設定（如 zh-TW、en-US）
46	LOTTERY	彩票	遊戲類型之一
47	Mascot	吉祥物	站點品牌吉祥物圖片
48	minChip	升級門檻	VIP 等級升級所需的最低累計有效投注
49	Mission	任務	每日/週/月存款或投注任務
50	Multi-Tenant	多站點/多租戶	一套系統支援多個獨立站點的架構
51	OKLCH	OKLCH 色彩空間	用於主題色彩定義的色彩模型
52	Permission	權限	管理員可執行操作的授權
53	Prefix	白牌前綴	站點的唯一前綴，對應 R2 路徑
54	Promo	活動/優惠	優惠活動（促銷活動）
55	Promo Tag	活動標籤	用於分類活動的標籤
56	Provider Code	供應商代碼	遊戲供應商的唯一識別碼
57	R2	Cloudflare R2	Cloudflare 的物件儲存服務
58	RBAC	角色存取控制	Role-Based Access Control，依角色控制權限
59	Rebate	返水	VIP 用戶根據投注量獲得的回饋金
60	Referral Code	推薦碼	代理用於邀請新用戶的專屬代碼
61	relegationChip	保級門檻	VIP 月度保級所需的最低投注量
62	Risk Control	風控管理	平台安全和風險控制管理
63	S2S Callback	伺服器對伺服器回調	遊戲商向平台發送的即時通知
64	Settlement	結算	代理佣金的彙整和發放
65	Site Code	站點代碼	站點的唯一識別碼
66	Site Config	站點配置	站點的完整配置資訊
67	Site Theme	站點主題	站點的色彩主題配置
68	SiteTabs	多站點標籤	後台頁面的站點切換 Tab 元件
69	SLOT	老虎機	遊戲類型之一
70	SPORTS	體育	遊戲類型之一（體育賽事投注）
71	Template	模板	預設配置範本，可一鍵匯入
72	TOTP	基於時間的一次性密碼	Google Authenticator 使用的 2FA 技術
73	Truncate USD	USD 無條件捨去	`Math.floor(value * 1e6) / 1e6`
74	Turnover Multiplier	打碼倍率	活動獎勵的流水要求倍率
75	USD	美元	系統內部統一使用的幣別
76	Vendor Channel	金流通道	具體的支付方式（如 ATM、信用卡）
77	Vendor Group	金流群組	按語系/地區劃分的金流配置單位
78	VIP Hold	VIP 鎖定	特殊保護，跳過保級降級檢查
79	VIP Level	VIP 等級	用戶的 VIP 會員等級
80	VIP Milestone	VIP 里程碑	下線 VIP 達標時發放給代理的獎勵
81	VIP Rebate	VIP 返水	VIP 等級 × 遊戲類型的返水比例
82	Wallet	錢包	用戶的資金帳戶（銀行卡/信用卡/加密地址）
83	White-Label	白牌	商戶使用平台方技術，建立自有品牌的商業模式
84	Whitelist	白名單	IP 白名單，放行特定 IP
85	Withdrawal	提款	用戶從平台帳戶取出資金
86	x-site-code	站點代碼 Header	HTTP request header，攜帶站點代碼

15.2 技術相關術語

以下為 C9 平台涉及的技術相關術語，商戶通常不需要深入了解，但在與技術支援溝通時可能會用到：

序號	術語	中文	說明
87	API	應用程式介面	前後端之間的通訊介面
88	Bearer Token	持有者令牌	JWT 的傳遞方式，放在 HTTP Authorization header
89	Cache	快取	臨時儲存已查詢過的資料，加速後續存取
90	Cookie	Cookie	瀏覽器儲存的小型資料，用於記住語系等偏好
91	CSS Variable	CSS 變數	用於動態注入主題色彩的技術
92	DNS	域名系統	將域名轉換為 IP 位址的系統
93	Endpoint	端點	API 的單個操作位址
94	Header	請求標頭	HTTP 請求中的附加資訊
95	HTTPS	安全超文本傳輸協定	加密的網站通訊協定
96	i18n	國際化	多語系支援的技術術語
97	JSON	JavaScript 物件表示法	資料交換的標準格式
98	Middleware	中介層	處理 HTTP 請求的中間邏輯
99	MySQL	MySQL 資料庫	平台使用的關聯式資料庫
100	OAuth	開放授權	第三方登入的標準協定
101	QR Code	二維條碼	用於 2FA 設定和支付
102	Redis	Redis	記憶體快取資料庫，用於加速資料存取
103	Session	會話	使用者登入後的持續連線狀態
104	SSL/TLS	安全通訊層	網站加密通訊的安全協定
105	Transaction	資料庫交易	確保多個操作全部成功或全部回滾
106	URL	統一資源定位符	網頁地址
107	UUID	通用唯一識別碼	全域唯一的識別碼
108	Webhook	網頁回調	伺服器主動通知另一伺服器的機制

15.3 金流相關術語

序號	術語	中文	說明
109	ATM	自動櫃員機	銀行自動存提款機
110	ERC20	以太坊代幣標準	基於以太坊的代幣傳輸協定
111	Fiat	法幣	政府發行的法定貨幣（如 TWD、USD）
112	KYC	了解你的客戶	Know Your Customer，身份驗證流程
113	Payment Gateway	金流閘道	處理線上支付的第三方服務
114	TRC20	波場代幣標準	基於 TRON 的代幣傳輸協定
115	USDT	泰達幣	與美元 1:1 掛鉤的穩定幣

附錄

附錄 A：系統自動排程一覽

排程名稱	執行時間	功能說明	影響模組
每日反水結算	每日 00:05	計算前一日各用戶的 VIP 返水金額並發放	VIP
月度保級檢查	每月 1 號 01:00	檢查上月投注是否達保級門檻，處理降級	VIP
代理佣金週結	每週一 03:00	彙整上週代理佣金，包含風控檢測	代理
代理佣金日結	每日 03:30	彙整前一日代理佣金	代理
即時賽事快取	每 30 分鐘	更新 API-Football 體育賽事數據	遊戲

附錄 B：API 端點數量統計

分類	端點數量	說明
前台 API	142	面向前台用戶的 API
後台 Admin API	76	後台管理操作 API
遊戲 Admin API	11	遊戲管理專用 API
站點設定 Admin API	12	站點/主題/域名/客服 API
代理 Admin API	17	代理管理專用 API
合計	258+	-

附錄 C：資料表一覽（49 張）

分類	資料表名稱	說明
用戶	auth-user	前台用戶帳號
	auth-user-login-log	用戶登入紀錄
金流	vendor-group	金流群組
	vendor-channel	金流通道
	vendor-group-channel	群組-通道關聯
	deposit-order	存款訂單
錢包	bank-card	銀行卡
	credit-card	信用卡
	crypto-address	加密錢包地址
遊戲	game-provider	遊戲供應商（含 siteCode）
	game-type-config	遊戲分類配置（含 siteCode）
	game-transaction	遊戲交易紀錄
	game-play-log	遊戲遊玩紀錄
	bet-order	投注訂單
	bet-detail	投注明細
VIP	vip-level	VIP 等級（含 siteCode）
	vip-rebate	VIP 返水規則（含 siteCode）
	vip-rebate-log	返水發放紀錄
活動	promo	優惠活動
	promo-claim	活動領取紀錄
	promo-tag	活動標籤
排行	rank-list	排行榜
代理	affiliate-commission	代理佣金
	affiliate-settlement	佣金結算
	affiliate-balance	代理餘額
	affiliate-withdrawal	代理提款
	affiliate-click	推薦連結點擊
	affiliate-bind-log	綁定紀錄
	affiliate-risk-log	風控紀錄
聯盟	alliance-commission-rate	聯盟佣金費率
	alliance-agent-tier	代理等級
	alliance-vip-milestone	VIP 里程碑
	alliance-vip-milestone-log	里程碑紀錄
	alliance-referral-code	聯盟推薦碼
站內信	notification	通知
	notification-read	已讀紀錄
站點	site-config	站點配置
	site-theme	站點主題
提領	withdrawal-order	提款訂單
任務	mission	任務定義
	mission-progress	任務進度
	mission-claim	任務領取
風控	risk-ip-rule	IP 規則
	risk-game-blacklist	遊戲黑名單
後台	admin-user	管理員帳號
	admin-group	管理員群組
	admin-operation-log	操作紀錄
儲存	r2-operation-log	R2 操作紀錄

附錄 D：權限模組對照表

模組代碼	中文名稱	讀取權限	寫入權限	功能範圍
admin	管理員管理	admin:read	admin:write	管理員帳號 CRUD
admin-group	群組管理	admin-group:read	admin-group:write	權限群組 CRUD
admin-log	操作紀錄	admin-log:read	admin-log:write	操作日誌查詢/匯出
user	用戶管理	user:read	user:write	前台用戶管理
deposit	存款管理	deposit:read	deposit:write	存款訂單/審核
withdrawal	提款管理	withdrawal:read	withdrawal:write	提款訂單/審核
promo	活動管理	promo:read	promo:write	優惠活動 CRUD
promo-tag	活動標籤	promo-tag:read	promo-tag:write	活動標籤 CRUD
affiliate	代理管理	affiliate:read	affiliate:write	代理系統全功能
vip	VIP 管理	vip:read	vip:write	VIP 等級/返水
game	遊戲管理	game:read	game:write	遊戲供應商/分類
risk	風控管理	risk:read	risk:write	IP 規則/遊戲黑名單
report	報表	report:read	report:write	所有報表查詢/匯出
vendor	金流商管理	vendor:read	vendor:write	金流群組/通道
finance	財務管理	finance:read	finance:write	手動調帳/錢包審核
site-config	站點設定	site-config:read	site-config:write	站點/主題/域名/客服

附錄 E：遊戲類型 ID 對照表

類型 ID	英文名稱	中文名稱	說明
1	SPORTS	體育	足球、籃球、棒球等體育賽事投注
2	SLOT	老虎機	經典老虎機、視頻老虎機
3	LIVE	真人	真人荷官百家樂、輪盤、骰寶
4	LOTTERY	彩票	各類彩票遊戲
5	CHESS	棋牌	撲克、麻將、象棋等桌遊
6	(保留)	(保留)	尚未使用
7	(保留)	(保留)	尚未使用
8	ESPORTS	電競	電子競技賽事投注（LOL、DOTA2 等）
9	CRYPTO	加密	加密貨幣相關遊戲
10	FISH	捕魚	捕魚達人類休閒遊戲

附錄 F：站點開通快速檢查表

以下為完整的站點開通檢查流程，可列印為紙本使用：

═══════════════════════════════════════════
  C9 站點開通檢查表
  站點代碼：___________________
  站點名稱：___________________
  商戶名稱：___________________
  開通日期：___________________
═══════════════════════════════════════════

【一、基本資訊】
□ siteCode 確認（唯一、不可更改）
□ prefix 確認（唯一、不可更改）
□ siteName 多語系提供
□ siteDescription 多語系提供
□ supportedLocales 確認

【二、站點建立】
□ 站點已建立於 site-config 資料表
□ layout 設定（預設 a1）
□ enabled = 1

【三、主題色彩】
□ 主題已建立
□ primary 色系設定
□ accent 色系設定
□ surface 色系設定
□ text 色系設定
□ border 色系設定
□ 已設為 activeTheme

【四、域名設定】
□ hostname 已設定
□ browserTitle 已設定
□ DNS A/CNAME 記錄已設定
□ DNS 已生效（可訪問）
□ logoSmall 已上傳
□ logoBig 已上傳
□ favicon 已上傳

【五、遊戲配置】
□ 遊戲供應商 API 憑證已設定
□ 遊戲供應商已匯入/配置
□ 遊戲分類已匯入/配置
□ 測試遊戲啟動正常

【六、金流配置】
□ 至少一個金流群組已建立
□ 至少一個金流通道已建立
□ 金流通道已關聯群組
□ 金流商 API 憑證已設定
□ 測試存款流程正常

【七、客服配置】
□ 至少一個客服管道已設定
□ 客服連結正確可用
□ LiveChat（如啟用）正常運作

【八、品牌素材】
□ Logo（小）已上傳
□ Logo（大）已上傳
□ Favicon 已上傳
□ 吉祥物已設定（可選）

【九、功能驗證】
□ 前台可正常訪問
□ 用戶註冊流程正常
□ 用戶登入流程正常
□ 遊戲啟動正常
□ 存款流程正常
□ 提款流程正常
□ 客服連結正確

【十、後台驗證】
□ 管理員帳號已建立
□ 管理員群組/權限已設定
□ 建議啟用 2FA
□ 報表可正常查看

簽核：
開通人員：________________ 日期：________
確認主管：________________ 日期：________
═══════════════════════════════════════════

附錄 G：商戶營運最佳實踐

G.1 站點上線前的準備工作

在站點正式上線前，建議完成以下準備工作，確保用戶體驗和營運效率：

品牌一致性檢查：

檢查項目	說明	重要性
Logo 清晰度	在各種螢幕解析度下確認 Logo 不模糊	高
色彩一致性	確認主題色彩在桌面版和行動版表現一致	高
多語系校對	所有翻譯內容應由母語人士校對	高
Favicon 辨識度	在瀏覽器標籤中確認 Favicon 清晰可辨	中
吉祥物風格	確認吉祥物設計與品牌調性一致	中

功能測試清單：

測試項目	測試內容	預期結果
註冊流程	使用不同語系註冊帳號	成功註冊並自動分配金流群組
登入流程	帳密登入、Google OAuth、Telegram	成功登入並取得 JWT
遊戲啟動	每種遊戲類型至少測試一個	遊戲正常啟動並運行
存款流程	每種金流通道各測試一筆小額	成功入帳，餘額正確
提款流程	測試銀行卡/信用卡/加密提款	成功提交申請
語系切換	切換所有已啟用語系	頁面文字正確切換
行動版	使用手機瀏覽器測試	頁面正常顯示和操作
客服連結	點擊所有客服管道連結	正確跳轉至客服頁面
VIP 等級	在個人資料確認 VIP 等級顯示	顯示正確等級
活動頁面	查看活動列表和詳情	活動資訊正確顯示

後台準備：

準備項目	說明
建立管理員帳號	為每位營運人員建立獨立帳號
設定權限群組	依職責建立適當的權限群組
啟用 2FA	所有管理員啟用 Google Authenticator
設定活動	至少準備 2-3 個上線優惠活動
設定 VIP	確認 VIP 等級和返水比例已配置
設定代理	若使用代理系統，確認佣金費率已設定

G.2 日常營運建議

每日工作：

工作項目	時間建議	說明
檢查存款訂單	上午 / 下午各一次	確認有無異常或待處理訂單
審核提款申請	上午 / 下午各一次	及時處理，提升用戶體驗
查看反水紀錄	上午（00:05 後）	確認昨日反水正常發放
監控風控	隨時	檢查登入失敗紀錄和異常 IP
回覆客服	隨時	及時回覆用戶詢問

每週工作：

工作項目	時間建議	說明
審核代理結算	週一（03:00 後）	確認週結佣金正常，審核結算
查看損益報表	週一	了解上週營運狀況
更新活動	視情況	準備新一週的優惠活動
查看遊戲報表	週一	了解各遊戲的表現

每月工作：

工作項目	時間建議	說明
VIP 保級結果	1 號（01:00 後）	確認保級檢查正常執行
月度營運報表	月初	彙整上月營運數據
管理員帳號檢視	月初	停用離職人員帳號
活動效果評估	月初	分析上月活動的領取和轉化
風控規則檢視	月初	更新 IP 黑白名單

G.3 用戶增長策略

代理推廣：

策略	說明	操作
設立高佣金率	高佣金吸引優質代理	配置佣金費率矩陣
設立 VIP 里程碑	獎勵代理培養高等級下線	配置 VIP 里程碑獎勵
推廣碼追蹤	追蹤各推廣碼的轉化效果	在綁定紀錄中分析
定期晉升	表現好的代理手動升級	使用 set-agent-tier API

活動運營：

活動類型	目標	建議打碼倍率
首存優惠	吸引新用戶存款	3x - 5x
每日存款獎勵	鼓勵日常存款	5x - 10x
VIP 專屬	留住高價值用戶	3x - 5x
限時加碼	短期刺激活躍	5x - 8x
節日活動	節慶期間拉高參與	3x - 5x

VIP 制度設計：

設計原則	說明
梯度分明	各等級之間的升級門檻應有明顯差距
獎勵吸引	高等級應有明顯更好的返水和獎勵
可達成性	前幾個等級不要太難達到，給予新用戶信心
保級合理	保級門檻不要太高，避免用戶挫敗感
返水平衡	返水比例應在留住用戶和平台利潤之間取得平衡

G.4 風控注意事項

常見風險類型：

風險類型	識別方式	處理建議
多開帳號	IP/裝置指紋重複	加入遊戲黑名單，凍結帳號
套利行為	異常存提款模式	提高審核力度，限制提款
代理刷量	下線投注異常集中	結算時風控標記，人工審核
盜用帳號	登入 IP 異常變動	強制重設密碼，通知用戶
洗錢嫌疑	大額存款後立即提款	提高 KYC 要求，暫停提款
DDoS 攻擊	大量異常請求	IP 黑名單封鎖

風控最佳實踐：

實踐	說明
設定合理提款限額	單日/單筆提款上限
大額提款增強驗證	超過閾值的提款需人工確認
定期檢查多開帳號	利用 IP/裝置指紋查詢功能
監控代理結算	結算時仔細檢查風控紀錄
保持 IP 黑名單更新	定期添加已知的惡意 IP
新用戶觀察期	新帳號的首次提款建議人工審核

G.5 資料精度與計算注意事項

在營運過程中，以下與金額計算相關的注意事項需牢記：

項目	注意事項
所有金額為 USD	系統內部一律以美元計價，小數點後 6 位
入金自動轉換	用戶以當地幣別入金，系統自動以台灣銀行匯率轉為 USD
截斷規則	USD 金額採用無條件捨去，不是四捨五入
匯率精度	匯率保留 10 位小數
返水精度	返水比例為 decimal(5,2)，即最多 2 位小數的百分比
報表金額	報表中顯示的金額均為 USD
調帳限制	手動扣款不能超過用戶可用餘額

G.6 多語系運營提示

提示	說明
翻譯品質	所有面向用戶的文字應由母語人士翻譯和校對
語系一致	確保同一語系下，不同頁面的用詞一致
圖片語系	含文字的圖片需為每種語系分別製作
客服語系	確保客服人員能處理已啟用語系的用戶詢問
活動翻譯	每個活動的標題和內容都需提供多語系版本
通知翻譯	站內信和通知需多語系

附錄 H：後台頁面導航圖

以下為後台管理系統的完整頁面導航結構：

後台管理系統
│
├── 儀表板 (dashboard)
│
├── 玩家管理
│   ├── 全部玩家
│   ├── 新註冊玩家
│   ├── 線上玩家
│   ├── 登入失敗紀錄
│   ├── 遊戲重新註冊
│   ├── 玩家標籤
│   └── 玩家詳情 [id]
│
├── 財務管理
│   ├── 人工調節金額
│   ├── 存款設置
│   ├── 存款審核
│   ├── 提款管理
│   ├── 銀行卡管理
│   ├── 信用卡管理
│   └── 虛擬錢包地址
│
├── 遊戲管理
│   ├── 遊戲供應商
│   └── 遊戲類型設定
│
├── VIP
│   ├── VIP 等級
│   ├── 返水設定
│   ├── VIP 玩家
│   └── VIP 里程碑
│
├── 活動管理
│   ├── 優惠活動
│   │   ├── 活動列表
│   │   └── 新增/編輯活動 [id]
│   └── 活動標籤
│
├── 代理中心
│   ├── 代理列表
│   ├── 佣金費率
│   ├── 代理等級
│   ├── 佣金結算
│   ├── 代理提款
│   ├── 綁定紀錄
│   ├── VIP 里程碑
│   └── 代理導覽
│
├── 報表
│   ├── 總覽
│   ├── 玩家報表
│   ├── 玩家簡表
│   ├── 遊戲報表
│   ├── 投注紀錄
│   ├── 損益報表
│   └── 活動報表
│
├── 風控管理
│   ├── IP 黑白名單
│   ├── 遊戲黑名單
│   └── IP/裝置指紋查詢
│
├── 站內信
│   ├── 收件匣
│   └── 信件設定
│
├── 系統管理
│   ├── 管理員管理
│   ├── 群組管理
│   ├── 操作紀錄
│   ├── 站點基本設定
│   ├── 域名設置
│   ├── 遊戲商配置
│   ├── 服務商配置
│   ├── 三方登入配置
│   ├── 客服配置
│   ├── 底部導航列
│   ├── 頁尾
│   ├── 了解更多
│   ├── 雲端儲存
│   └── 雲端儲存日誌
│
└── 個人資料
    ├── 基本資料
    └── Google Authenticator (2FA)

附錄 I：主題預設色彩值參考

以下為 6 組內建主題預設的部分色彩值，供商戶參考選擇：

I.1 Emerald（翡翠綠）

色彩類別	子項	OKLCH 值	視覺效果
Primary	base	`oklch(72% 0.19 160)`	鮮明翡翠綠
Primary	dark	`oklch(60% 0.19 160)`	深翡翠綠
Primary	light	`oklch(85% 0.12 160)`	淺翡翠綠
Accent	gold	`oklch(80% 0.16 80)`	暖金色
Accent	error	`oklch(65% 0.22 25)`	警示紅

風格描述：清新自然的綠色調，適合經典娛樂城風格，給人專業且可信賴的感覺。

I.2 Amber（琥珀金）

色彩類別	子項	OKLCH 值	視覺效果
Primary	base	`oklch(79% 0.17 75)`	溫暖琥珀金
Primary	dark	`oklch(67% 0.17 75)`	深琥珀金
Primary	light	`oklch(90% 0.10 75)`	淺琥珀金
Accent	gold	`oklch(82% 0.18 70)`	亮金色
Accent	error	`oklch(65% 0.22 25)`	警示紅

風格描述：尊貴大氣的金色調，適合 VIP 導向的高端娛樂城，傳達奢華感。

I.3 Sky（天空藍）

色彩類別	子項	OKLCH 值	視覺效果
Primary	base	`oklch(75% 0.15 230)`	清爽天藍
Primary	dark	`oklch(63% 0.15 230)`	深天藍
Primary	light	`oklch(88% 0.08 230)`	淺天藍
Accent	gold	`oklch(80% 0.16 80)`	暖金色
Accent	error	`oklch(65% 0.22 25)`	警示紅

風格描述：清爽專業的藍色調，適合體育博彩主題，給人信任和專業感。

I.4 Violet（紫羅蘭）

色彩類別	子項	OKLCH 值	視覺效果
Primary	base	`oklch(65% 0.25 300)`	神秘紫羅蘭
Primary	dark	`oklch(53% 0.25 300)`	深紫羅蘭
Primary	light	`oklch(80% 0.15 300)`	淺紫羅蘭
Accent	gold	`oklch(80% 0.16 80)`	暖金色
Accent	error	`oklch(65% 0.22 25)`	警示紅

風格描述：神秘高雅的紫色調，適合真人娛樂主題，營造高級感和神秘氛圍。

I.5 Rose（玫瑰紅）

色彩類別	子項	OKLCH 值	視覺效果
Primary	base	`oklch(70% 0.20 15)`	熱情玫瑰紅
Primary	dark	`oklch(58% 0.20 15)`	深玫瑰紅
Primary	light	`oklch(85% 0.12 15)`	淺玫瑰紅
Accent	gold	`oklch(80% 0.16 80)`	暖金色
Accent	error	`oklch(65% 0.22 25)`	警示紅

風格描述：熱情奔放的紅色調，適合年輕族群和節慶主題，充滿活力與熱情。

I.6 Cyan（青色）

色彩類別	子項	OKLCH 值	視覺效果
Primary	base	`oklch(78% 0.15 195)`	科技青色
Primary	dark	`oklch(66% 0.15 195)`	深青色
Primary	light	`oklch(90% 0.08 195)`	淺青色
Accent	gold	`oklch(80% 0.16 80)`	暖金色
Accent	error	`oklch(65% 0.22 25)`	警示紅

風格描述：科技感強烈的青色調，適合電競和加密貨幣主題，現代感十足。

附錄 J：自動通知設定

每個站點可獨立配置自動站內信通知，控制哪些事件會自動發送通知給用戶：

通知類型	欄位名稱	說明	預設
註冊歡迎	welcomeRegistration	用戶完成註冊時自動發送歡迎訊息	開啟
存款成功	depositSuccess	存款確認入帳時通知用戶	開啟
提款核准	withdrawalApproved	提款審核通過時通知用戶	開啟
提款拒絕	withdrawalRejected	提款被拒絕時通知用戶	開啟
提款完成	withdrawalCompleted	提款匯款完成時通知用戶	開啟

配置方式：在站點基本設定的 notificationConfig 欄位中設定。

附錄 K：三方登入配置

每個站點可獨立配置第三方登入方式：

K.1 Google OAuth

欄位	說明
clientId	Google OAuth Client ID
clientSecret	Google OAuth Client Secret
redirectUri	回調 URL

設定步驟：

在 Google Cloud Console 建立 OAuth 2.0 憑證
設定授權的 JavaScript 來源和回調 URI
在後台「系統管理 → 三方登入」填入憑證

欄位	說明
botToken	Telegram Bot Token
botUsername	Telegram Bot Username

設定步驟：

透過 @BotFather 建立 Telegram Bot
取得 Bot Token 和 Username
在後台「系統管理 → 三方登入」填入資訊

K.3 域名白名單

欄位	說明
domainWhitelist	允許進行 OAuth 的域名清單

確保您的前台域名已加入白名單，否則 OAuth 回調將被拒絕。

附錄 L：錯誤代碼速查表

L.1 系統錯誤碼

C9 平台使用統一的錯誤碼體系，前端透過 /common/enums 取得完整錯誤碼對照表。以下為商戶營運中常見的錯誤碼：

通用錯誤碼：

錯誤碼	說明	商戶處理建議
200	操作成功	正常
401	未授權	Token 過期，請重新登入
403	權限不足	確認管理員群組權限
404	資源不存在	確認資源 ID 正確
500	伺服器錯誤	聯繫技術支援

遊戲相關錯誤碼：

錯誤碼	說明	商戶處理建議
5010	遊戲黑名單攔截	用戶已被加入遊戲黑名單
5020	遊戲供應商異常	確認遊戲商 API 憑證正確
5030	餘額不足	引導用戶存款

金流相關錯誤碼：

錯誤碼	說明	商戶處理建議
6010	存款金額超限	確認金流通道的金額限制設定
6020	金流商回調異常	聯繫金流商確認
6030	提款餘額不足	用戶可用餘額不足

認證相關錯誤碼：

錯誤碼	說明	商戶處理建議
1010	帳號或密碼錯誤	確認登入資訊
1020	2FA 驗證碼錯誤	確認手機時間同步
1030	帳號已停用	聯繫上級管理員

L.2 HTTP 狀態碼

HTTP 狀態碼	說明	C9 平台使用場景
200	成功	所有成功的請求（包含業務錯誤）
401	未授權	JWT Token 過期或無效
403	禁止	權限不足
404	未找到	路由不存在
500	伺服器錯誤	未預期的系統錯誤

重要：C9 平台的業務錯誤統一使用 HTTP 200 回傳，透過 response body 中的 code 欄位區分。只有認證失敗（401）會使用非 200 的 HTTP 狀態碼。

L.3 錯誤碼查看方式

後台啟動時自動呼叫 GET /common/enums 取得完整錯誤碼表
錯誤碼儲存在 enumStore 中
發生錯誤時，前端自動依 ERROR_CODES[path][code] 查表顯示多語系錯誤訊息
商戶不需要硬記錯誤碼，後台會自動顯示對應的中文/英文錯誤訊息

附錄 M：聯絡與支援

如在接入或營運過程中遇到問題，請透過以下方式聯繫平台方：

管道	用途	回應時間
商務對接人員	商務洽談、合約相關	1 個工作天
技術支援	技術問題排查、API 對接	4 小時內
營運支援	後台操作指導、功能諮詢	4 小時內
緊急聯絡	系統故障、安全事件	即時回應

問題回報格式建議：

【問題類型】：技術問題 / 營運問題 / 功能需求
【站點代碼】：LUCKY88
【問題描述】：詳細描述問題現象
【重現步驟】：如何重現此問題
【截圖/錄影】：附上相關截圖
【期望結果】：希望的解決方案
【聯絡方式】：聯絡人姓名和聯絡方式

附錄 N：版本更新紀錄

v1.0（2026-03-01）

初始發布

本文件為 C9 Platform 商戶接入指南的首個正式版本，涵蓋以下內容：

章節	內容
第 1 章	白牌平台簡介：平台架構、商戶權益、資料隔離
第 2 章	站點開通流程：8 個步驟完整指南
第 3 章	後台操作手冊：登入、站點切換、管理員、2FA
第 4 章	遊戲管理：供應商、分類、模板、跨站複製
第 5 章	金流管理：群組、通道、存提款審核、調帳
第 6 章	VIP 系統配置：等級、返水、自動化機制
第 7 章	活動管理：活動 CRUD、標籤、打碼量
第 8 章	代理推廣系統：代理、佣金、結算、里程碑
第 9 章	客服配置：8 種管道、LiveChat
第 10 章	風控管理：IP 規則、遊戲黑名單、反查
第 11 章	報表使用：7 種報表、CSV 匯出
第 12 章	前台佈局配置：導航列、頁尾、FAQ
第 13 章	雲端儲存：R2 檔案管理、圖片規範
第 14 章	常見問題 FAQ：30 題 Q&A
第 15 章	術語對照表：115+ 術語
附錄 A-N	排程、API 統計、資料表、權限、遊戲類型、檢查表、最佳實踐、導航圖、主題色彩、通知、三方登入、錯誤碼

平台規格摘要：

指標	數值
API 端點總數	258+
資料表總數	49 張
後台管理頁面	68 頁
前台頁面	20 頁
前台元件	77 個
後台元件	41 個
後端模組	23 個
權限模組	16 個
支援語系	5 種
遊戲類型	8 種
客服管道	8 種
主題預設	6 組

文件結束
C9 Platform 商戶接入指南 v1.0
涵蓋 15 章主體內容 + 14 份附錄
總計 258+ API 端點、49 張資料表、68 個後台頁面、115+ 術語
最後更新：2026-03-01
Copyright (c) 2026 C9 Platform. All rights reserved.

C9 Platform — 商戶接入指南 ​

目錄 ​

第 1 章：白牌平台簡介 ​

1.1 什麼是白牌平台 ​

1.2 商戶獲得什麼 ​

1.2.1 自有品牌的前台網站 ​

1.2.2 獨立的業務配置 ​

1.2.3 專業的後台管理系統 ​

1.2.4 豐富的遊戲生態 ​

1.3 共享基礎設施 ​

1.4 商戶的核心優勢 ​

1.4.1 零開發成本 ​

1.4.2 快速上線 ​

1.4.3 專業管理介面 ​

1.4.4 持續升級 ​

1.5 系統架構簡圖 ​

1.6 資料隔離與安全 ​

1.7 幣別與精度規範 ​

1.8 支援語系 ​

第 2 章：站點開通流程 ​

2.1 流程總覽 ​

2.2 步驟 1：提供基本資訊 ​

2.2.1 必填資訊 ​

2.2.2 站點名稱格式範例 ​

2.2.3 站點介紹格式範例 ​

2.2.4 品牌素材清單 ​

2.2.5 品牌色彩參考 ​

2.2.6 商戶資訊提交範本 ​

2.3 步驟 2：後台建立站點 ​

2.3.1 操作路徑 ​

2.3.2 建立站點操作流程 ​

2.3.3 站點建立後的初始狀態 ​

2.3.4 站點代碼命名建議 ​

2.3.5 常見錯誤與解決 ​

2.4 步驟 3：配置主題色彩 ​

2.4.1 操作路徑 ​

2.4.2 主題色彩體系 ​

1. 主色系 (Primary) ​

2. 強調色 (Accent) ​

3. 表面色 (Surface) ​

4. 文字色 (Text) ​

5. 邊框色 (Border) ​

2.4.3 使用內建預設 ​

2.4.4 自訂主題色彩 ​

2.4.5 主題生效機制 ​

2.4.6 主題修改注意事項 ​

2.5 步驟 4：設定域名與 DNS ​

2.5.1 操作路徑 ​

2.5.2 域名配置欄位 ​

2.5.3 上傳域名素材 ​

2.5.4 DNS 設定 ​

2.5.5 多域名支援 ​

2.5.6 域名運作機制 ​

2.6 步驟 5：配置遊戲商 ​

2.6.1 操作路徑 ​

2.6.2 遊戲供應商列表 ​

2.6.3 配置遊戲供應商 ​

2.6.4 快速配置：同預設站點 ​

2.7 步驟 6：配置金流商 ​

2.7.1 操作路徑 ​

2.7.2 金流群組 ​

2.7.3 金流通道 ​

2.7.4 金流通道配置欄位 ​

2.7.5 配置流程 ​

2.8 步驟 7：配置客服管道 ​

2.8.1 操作路徑 ​

2.8.2 支援的客服管道 ​

2.8.3 客服管道配置欄位 ​

2.8.4 LiveChat 嵌入 ​

2.8.5 快速配置：同預設站點 ​

2.9 步驟 8：上傳品牌素材 ​

2.9.1 操作路徑 ​

2.9.2 R2 檔案目錄結構 ​

2.9.3 上傳品牌素材步驟 ​

2.9.4 客服圖示上傳 ​

2.9.5 素材規格建議 ​

2.10 站點開通檢查清單 ​

第 3 章：後台操作手冊 ​

3.1 登入後台 ​

3.1.1 訪問後台 ​

C9 Platform — 商戶接入指南

目錄

第 1 章：白牌平台簡介

1.1 什麼是白牌平台

1.2 商戶獲得什麼

1.2.1 自有品牌的前台網站

1.2.2 獨立的業務配置

1.2.3 專業的後台管理系統

1.2.4 豐富的遊戲生態

1.3 共享基礎設施

1.4 商戶的核心優勢

1.4.1 零開發成本

1.4.2 快速上線

1.4.3 專業管理介面

1.4.4 持續升級

1.5 系統架構簡圖

1.6 資料隔離與安全

1.7 幣別與精度規範

1.8 支援語系

第 2 章：站點開通流程

2.1 流程總覽

2.2 步驟 1：提供基本資訊

2.2.1 必填資訊

2.2.2 站點名稱格式範例

2.2.3 站點介紹格式範例

2.2.4 品牌素材清單

2.2.5 品牌色彩參考

2.2.6 商戶資訊提交範本

2.3 步驟 2：後台建立站點

2.3.1 操作路徑

2.3.2 建立站點操作流程

2.3.3 站點建立後的初始狀態

2.3.4 站點代碼命名建議

2.3.5 常見錯誤與解決

2.4 步驟 3：配置主題色彩

2.4.1 操作路徑

2.4.2 主題色彩體系

1. 主色系 (Primary)

2. 強調色 (Accent)

3. 表面色 (Surface)

4. 文字色 (Text)

5. 邊框色 (Border)

2.4.3 使用內建預設

2.4.4 自訂主題色彩

2.4.5 主題生效機制

2.4.6 主題修改注意事項

2.5 步驟 4：設定域名與 DNS

2.5.1 操作路徑

2.5.2 域名配置欄位

2.5.3 上傳域名素材

2.5.4 DNS 設定

2.5.5 多域名支援

2.5.6 域名運作機制

2.6 步驟 5：配置遊戲商

2.6.1 操作路徑

2.6.2 遊戲供應商列表

2.6.3 配置遊戲供應商

2.6.4 快速配置：同預設站點

2.7 步驟 6：配置金流商

2.7.1 操作路徑

2.7.2 金流群組

2.7.3 金流通道

2.7.4 金流通道配置欄位

2.7.5 配置流程

2.8 步驟 7：配置客服管道

2.8.1 操作路徑

2.8.2 支援的客服管道

2.8.3 客服管道配置欄位

2.8.4 LiveChat 嵌入

2.8.5 快速配置：同預設站點

2.9 步驟 8：上傳品牌素材

2.9.1 操作路徑

2.9.2 R2 檔案目錄結構

2.9.3 上傳品牌素材步驟

2.9.4 客服圖示上傳

2.9.5 素材規格建議

2.10 站點開通檢查清單

第 3 章：後台操作手冊

3.1 登入後台

3.1.1 訪問後台