C9 Platform — 營運總覽

目標讀者：老闆、高層主管、投資人 文件版本：v1.0 最後更新：2026-03-01

第 1 章：平台概述
第 2 章：核心能力
第 3 章：功能全景圖
第 4 章：業務模組摘要
第 5 章：運營數據能力
第 6 章：安全性
第 7 章：擴展性
第 8 章：技術棧概覽
第 9 章：團隊配置建議
第 10 章：部署與維運
第 11 章：系統排程
第 12 章：競爭優勢總結
附錄 A：術語表
附錄 B：系統規格摘要表

第 1 章：平台概述

1.1 什麼是 C9 Platform？

C9 Platform 是一套完整的線上娛樂城白牌平台（White-Label Platform）。

所謂「白牌」，是指我們開發一套系統，可以讓**不同的商戶（品牌方）**使用同一套底層系統，但各自擁有獨立的品牌形象、域名、配色、Logo 與營運資料。對終端用戶而言，每個商戶看起來都是獨立的娛樂城網站；對我們而言，只需維護一套程式碼。

簡單來說：

開發一次，賣給無限多個商戶
每個商戶都有自己的品牌外觀和獨立資料
統一後台管理所有商戶
大幅降低開發與維護成本

1.2 平台三大組成

C9 Platform 由三個子系統組成，各司其職：

子系統	代號	角色	一句話說明
前台	c9-ec	玩家使用的網站	玩家看到的娛樂城——註冊、遊戲、儲值、提領、VIP、代理推廣等
後台	c9-ims	管理員使用的控制台	內部人員管理平台——審核訂單、管理玩家、查看報表、設定站點等
後端	c9-be	資料處理核心	所有業務邏輯的中心——處理金流、遊戲對接、資料儲存、排程等

1.3 系統架構圖

以下為系統整體架構，展示各角色如何與系統互動：

                          C9 Platform 系統架構
  ================================================================

                    +------------------+
                    |    終端玩家      |
                    |  (手機 / 電腦)   |
                    +--------+---------+
                             |
                             | HTTPS
                             v
                    +------------------+
                    |     c9-ec        |
                    |   前台網站       |
                    |  (Port 3010)     |
                    |                  |
                    |  20 頁功能頁面   |
                    |  77 個 UI 元件   |
                    +--------+---------+
                             |
                             | API 請求
                             v
                    +------------------+
                    |     c9-be        |
                    |   後端 API       |
                    |  (Port 8080)     |
                    |                  |
                    | 205+ 個 API 端點 |
                    |  23 個業務模組   |
                    +---+----------+---+
                        |          |
               +--------+          +--------+
               |                            |
               v                            v
        +------------+              +------------+
        |   MySQL    |              |   Redis    |
        |  資料庫    |              |   快取     |
        |            |              |            |
        | 49 張資料表|              | 效能加速   |
        +------------+              +------------+
                             ^
                             | API 請求
                             |
                    +------------------+
                    |     c9-ims       |
                    |   後台管理系統   |
                    |  (Port 3011)     |
                    |                  |
                    |  68 頁管理頁面   |
                    |  41 個 UI 元件   |
                    +--------+---------+
                             |
                             | HTTPS
                             v
                    +------------------+
                    |  內部管理人員    |
                    |  (營運 / 客服)   |
                    +------------------+

1.4 關鍵數字總覽

指標	數值	說明
前台頁面數	20 頁	玩家可使用的功能頁面
後台頁面數	68 頁	管理人員可操作的管理頁面
總頁面數	88 頁	前台 + 後台完整功能覆蓋
API 端點數	205+ 個	前後端溝通的介面數量
資料表數	49 張	資料庫中的資料結構數量
UI 元件數	118 個	前台 77 + 後台 41 個可重用介面元件
支援語系	5 種	繁中、英文、簡中、泰文、越南文
遊戲類型	8 種	體育、老虎機、真人、彩票、棋牌、電競、加密、捕魚
支援站點	無上限	一套系統可建立任意數量的品牌站點
後端模組	23 個	獨立的業務邏輯模組
後台權限模組	16 個	細粒度的權限控制模組
自動排程	5 個	每日/週/月自動執行的背景任務

1.5 商業模式

C9 Platform 的商業模式為 SaaS 白牌授權：

  營收模式
  ========

  +----------+     授權費用      +-----------+
  |  商戶 A  | <--------------> |           |
  | (品牌 A) |   (月費/年費)     |           |
  +----------+                   |           |
                                 |  C9       |
  +----------+     授權費用      |  Platform  |
  |  商戶 B  | <--------------> |           |
  | (品牌 B) |   (月費/年費)     |  (我們)    |
  +----------+                   |           |
                                 |           |
  +----------+     授權費用      |           |
  |  商戶 C  | <--------------> |           |
  | (品牌 C) |   (月費/年費)     |           |
  +----------+                   +-----------+

  每個商戶獨立運營，互不影響
  我們只需維護一套程式碼

核心優勢：

一次開發，多次銷售
每新增一個商戶，邊際成本極低
統一升級，所有商戶同步受益
商戶之間資料完全隔離，互不可見

第 2 章：核心能力

2.1 白牌架構（一套系統，無限品牌）

白牌架構是 C9 Platform 最重要的核心能力。這代表我們只開發一套程式碼，但可以同時支撐多個不同品牌的娛樂城網站。

每個商戶（站點）可以擁有：

獨立的域名（例如 brand-a.com、brand-b.com）
獨立的品牌 Logo（大 Logo、小 Logo、Favicon）
獨立的配色主題（全站色系一鍵切換）
獨立的功能開關（哪些功能要開、哪些要關）
獨立的玩家資料（用戶、交易、投注等）
獨立的營運配置（VIP 等級、反水比例、代理費率等）
獨立的客服管道（Line、Telegram、微信等）
獨立的遊戲商配置（每站可選擇開放哪些遊戲商）
獨立的金流設定（每站可配置不同的支付通道）

資料隔離：

系統中有 37 張以上的資料表帶有「站點代碼（siteCode）」欄位
所有查詢都會自動加上站點篩選條件
商戶 A 的管理員永遠看不到商戶 B 的資料
後台「超級管理員」可跨站切換查看所有站點

白牌運作示意：

  同一套 C9 Platform 程式碼
  ===========================

  +---------------------------+
  |       C9 Platform         |
  |    (一套程式碼)            |
  +--+--------+--------+-----+
     |        |        |
     v        v        v
  +------+ +------+ +------+
  | 站點 | | 站點 | | 站點 |
  |  A   | |  B   | |  C   |
  +------+ +------+ +------+
  | Logo | | Logo | | Logo |
  | 綠色 | | 藍色 | | 紫色 |
  | .com | | .net | | .io  |
  | 5級  | | 10級 | | 15級 |
  | VIP  | | VIP  | | VIP  |
  +------+ +------+ +------+

  外觀不同，品牌不同
  底層是同一套系統

2.2 多站點管理（統一後台，切換自如）

後台管理系統（c9-ims）提供強大的多站點管理能力，讓營運人員可以在同一個後台介面中管理所有站點。

操作方式：

後台頂部有「站點選擇器」下拉選單
可選擇「全部站點」或特定單一站點
選擇「全部站點」時，頁面會出現各站點的頁籤（Tab），可快速切換
選擇特定站點時，所有資料自動篩選為該站資料

多站點支援範圍：

模組分類	已支援頁面數	說明
財務管理	7 頁	存款、提款、調帳、銀行卡、信用卡、加密錢包
遊戲管理	2 頁	遊戲商管理、遊戲類型設定
VIP 管理	3 頁	VIP 等級、返水設定、VIP 玩家
玩家管理	4 頁	全部玩家、新註冊、線上玩家、登入失敗
活動管理	2 頁	優惠活動、活動標籤
報表	6 頁	投注紀錄、遊戲報表、總覽、玩家報表、損益、玩家簡表
風控管理	3 頁	IP 規則、IP 查詢、遊戲黑名單
代理中心	8 頁	代理列表、佣金、結算、提款、綁定、等級、里程碑、導覽
站內信	2 頁	收件匣、信件設定
系統管理	2 頁	雲端儲存、儲存日誌
站點設定	5 頁	三方登入、遊戲商、服務商、客服、域名
佈局配置	3 頁	底部導航列、頁尾、了解更多
合計	47 頁	佔後台總頁面的 69%

「同預設站點」功能：

新增站點時，可一鍵從「預設站點」複製配置
適用於：遊戲商、遊戲分類、VIP 等級、VIP 返水、客服、域名、三方登入等
大幅減少新站點上線的設定時間

2.3 多語系（五語覆蓋亞洲核心市場）

C9 Platform 全面支援五種語系，覆蓋亞洲主要市場：

語系代碼	語言	目標市場
zh-TW	繁體中文	台灣、香港、澳門
en-US	English	全球英語市場
zh-CN	簡體中文	中國大陸
th-TH	ภาษาไทย	泰國
vi-VN	Tieng Viet	越南

多語系特色：

前台（玩家端）：所有文字、按鈕、提示訊息均支援五語切換
後台（管理端）：所有管理介面均支援五語切換
後端（API）：錯誤訊息依請求語系自動回傳對應語言
活動內容：支援多語系富文本編輯（HTML 編輯器）
站內信：支援多語系通知內容
客服管道：每個管道的標題支援多語系
語系切換：基於 Cookie，不影響網址結構，切換即時生效

新增語系成本：僅需在各專案中新增一份翻譯檔案，無需修改程式碼。

2.4 主題客製化（每站獨立品牌形象）

每個站點可以擁有完全不同的視覺風格：

內建 6 組主題預設：

主題名稱	主色系	適合風格
Emerald（翡翠）	綠色系	經典、穩重
Amber（琥珀）	橙黃系	活力、熱情
Sky（天空）	藍色系	清新、專業
Violet（紫羅蘭）	紫色系	高貴、神秘
Rose（玫瑰）	粉紅系	時尚、溫暖
Cyan（青色）	青綠系	科技、現代

客製化範圍：

主色（Primary）：按鈕、連結、重點元素的顏色
強調色（Accent）：輔助色、特殊標記
表面色（Surface）：背景、卡片底色
文字色（Text）：標題、內文、說明文字
邊框色（Border）：分隔線、框線
共 30+ 個 CSS 變數可調整

主題管理：

後台可為每個站點新增、編輯、刪除主題
支援啟用/停用，隨時切換
前台即時套用，不需重新部署
支援明亮模式（Light）與深色模式（Dark）

2.5 功能開關（彈性控制各站功能）

每個站點可以獨立控制哪些功能要開啟、哪些要隱藏。這讓不同商戶可以依據自身需求，選擇性開放功能。

可控制的功能模組（13 項）：

功能開關	控制範圍	說明
遊戲大廳	前台 + 後台	是否開放遊戲功能
VIP 系統	前台 + 後台	是否啟用 VIP 會員機制
代理推廣	前台 + 後台	是否開放代理系統
活動促銷	前台 + 後台	是否開放優惠活動
任務系統	前台 + 後台	是否開放每日任務
站內信	前台 + 後台	是否啟用站內信功能
排行榜	前台	是否顯示排行榜
即時賽事	前台	是否顯示即時比分
KYC 驗證	前台	是否要求身份驗證
銀行卡入金	前台	是否開放銀行卡存款
信用卡入金	前台	是否開放信用卡存款
加密貨幣入金	前台	是否開放 USDT 存款
客服系統	前台	是否顯示客服入口

運作方式：

後台管理員在「站點設定」頁面開關功能
前台自動隱藏/顯示對應的選單項目與頁面
後台側邊欄自動隱藏/顯示對應的管理頁面
不需要修改程式碼，不需要重新部署

第 3 章：功能全景圖

3.1 前台功能（玩家端）— 20 個頁面

前台是面向終端玩家的網站，涵蓋玩家從註冊到遊戲、從儲值到提領的完整流程。

編號	頁面名稱	功能說明
1	首頁	橫幅輪播、即時賽事、熱門遊戲推薦、活動看板、吉祥物
2	遊戲大廳	8 種遊戲類型分類（體育/老虎機/真人/彩票/棋牌/電競/加密/捕魚），搜尋、篩選、收藏
3	遊戲頁面	嵌入遊戲商的遊戲視窗，支援試玩模式
4	活動中心	所有優惠活動列表，含分類標籤篩選
5	活動詳情	活動內容（多語系富文本）、參與條件、領取按鈕
6	聯盟專區	代理推廣入口、推廣碼管理、收益查詢
7	任務中心	每日/每週/每月任務列表、進度追蹤、獎勵領取
8	幫助中心	常見問題、使用指南、客服連結
9	OAuth 回調	Google / Telegram 三方登入的回調處理
10	個人設定	個人資料修改、密碼變更、2FA 設定、語系切換
11	存款頁面	法幣存款（ATM）、信用卡存款、加密貨幣存款（USDT）、即時匯率顯示
12	提領頁面	提領申請、提領紀錄查詢、提領狀態追蹤
13	錢包管理	銀行卡綁定/管理、信用卡綁定/管理、加密錢包地址管理
14	交易紀錄	所有存提款交易歷史、篩選與搜尋
15	VIP 中心	VIP 等級展示、升級進度、各等級權益、返水比例
16	代理中心	代理後台、下線管理、收益報表、推廣碼管理、提款
17	投注紀錄	歷史投注查詢、篩選（遊戲類型/日期/狀態）
18	收件匣	站內信列表、已讀/未讀、訊息詳情
19	KYC 驗證	四步驟身份驗證：基本資料 → 證件上傳 → 活體驗證 → 審核結果
20	挑戰賽	特殊挑戰活動、排行榜

3.2 後台功能（管理端）— 68 個頁面

後台是內部管理人員使用的控制台，功能按模組分為以下 14 大類：

儀表板（1 頁）

頁面	功能
儀表板首頁	營運數據總覽、圖表、快捷入口

系統管理（15 頁）

頁面	功能
管理員列表	檢視、新增、編輯、刪除後台管理員帳號
管理員新增	建立新管理員（帳號、密碼、所屬群組）
管理員編輯	修改管理員資料與權限群組
群組列表	權限群組管理（root / super_admin / general_admin / custom）
群組新增	建立新權限群組，勾選 16 模組 x 2 權限
群組編輯	修改群組名稱與權限配置
操作紀錄	所有後台操作的審計日誌（誰、什麼時間、做了什麼）
站點基本設定	站點名稱、域名、幣別、功能開關等基本配置
客服配置	8 種客服管道設定（Line/Telegram/微信/FB/IG/Twitter/Discord/自訂）
域名設置	各站點域名綁定與素材（Logo/Favicon）管理
遊戲商配置	各站點開放哪些遊戲供應商
三方登入配置	各站點的 Google/Telegram OAuth 設定
服務商配置	金流商、簡訊商等第三方服務設定
雲端儲存	Cloudflare R2 檔案管理（上傳、刪除、移動、建立資料夾）
雲端儲存日誌	檔案操作紀錄（上傳/刪除，含作業系統與瀏覽器解析）

佈局配置（3 頁）

頁面	功能
底部導航列	前台手機版底部 Tab 項目配置
頁尾配置	前台頁尾連結、版權資訊
了解更多	前台「了解更多」區塊內容管理

玩家管理（7 頁）

頁面	功能
全部玩家	所有玩家列表、搜尋、篩選（VIP 等級、狀態）
新註冊玩家	近期新註冊的玩家列表
線上玩家	當前在線玩家即時監控
登入失敗紀錄	登入失敗的詳細紀錄（IP、時間、帳號）
玩家標籤	為玩家分類標記（VIP、高風險、活躍等）
玩家詳情	單一玩家的完整資料與操作歷史
遊戲重新註冊	重新註冊玩家的遊戲商帳號

活動管理（4 頁）

頁面	功能
優惠活動列表	所有活動的管理（上架/下架/編輯/刪除）
活動新增	建立新活動（多語系內容、條件設定、打碼量）
活動編輯	修改現有活動內容與設定
活動標籤	活動分類標籤管理

站內信（2 頁）

頁面	功能
收件匣	站內信列表管理、發送新通知
信件設定	信件範本、自動通知設定

財務管理（7 頁）

頁面	功能
存款審核	存款訂單列表、審核通過/駁回
存款設定	金流群組與通道配置
提領管理	提領訂單列表、審核、上傳憑證、完成
手動調帳	手動調整玩家餘額（加幣/扣幣）
銀行卡管理	玩家銀行卡審核與管理
信用卡管理	玩家信用卡審核與管理
加密錢包管理	玩家加密貨幣地址審核與管理

遊戲管理（2 頁）

頁面	功能
遊戲商管理	遊戲供應商的新增、編輯、啟用/停用（每站獨立配置）
遊戲類型設定	8 種遊戲類型的排序、圖示、顯示設定（每站獨立配置）

VIP 管理（4 頁）

頁面	功能
VIP 等級	各站 VIP 等級配置（名稱、升級門檻、權益）——等級數量不限
返水設定	VIP 等級 x 8 遊戲類型的返水比例矩陣（每站獨立）
VIP 玩家	VIP 玩家列表與統計
VIP 里程碑	VIP 等級達標里程碑獎勵

報表（7 頁）

頁面	功能
總覽	每日營運數據摘要（存款/提款/投注/損益）+ 統計卡片
玩家報表	玩家維度的數據分析（含 VIP 等級篩選）
玩家簡表	單一玩家的摘要數據，支援排序
遊戲報表	按遊戲類型/遊戲商的數據分析
投注紀錄	所有投注的明細紀錄
損益報表	按日/週/月/遊戲類型的損益分析
活動報表	活動領取統計

風控管理（3 頁）

頁面	功能
IP 規則	IP 黑名單/白名單管理（每站獨立）
IP 查詢	透過 IP 或裝置指紋反查玩家
遊戲黑名單	禁止特定玩家進入特定遊戲

代理中心（8 頁）

頁面	功能
代理列表	所有代理的管理
佣金費率	代理等級 x 遊戲類型的佣金比例設定
佣金結算	佣金結算紀錄與審核
代理提款	代理提款申請的審核與處理
綁定紀錄	上下線綁定的歷史紀錄
代理等級	代理等級配置（銅/銀/金/白金）
VIP 里程碑	下線達到 VIP 等級的獎勵設定
代理導覽	代理推廣的說明頁面配置

用戶管理（4 頁）

頁面	功能
用戶列表	前台用戶的查詢與管理
用戶詳情	單一用戶的完整資料
用戶編輯	修改用戶資料
金流群組分配	指定用戶的金流通道群組

認證（1 頁）

頁面	功能
登入頁	管理員登入（帳號密碼 + Google Authenticator 2FA）

3.3 後端能力 — 205+ 個 API、23 個模組、49 張資料表

後端是整個平台的資料處理核心。所有前台和後台的操作，最終都透過後端 API 完成。

23 個業務模組：

模組	功能範圍	API 數量
auth	用戶註冊、登入、OAuth、2FA、頭像	17
game	遊戲商管理、遊戲啟動、試玩、回調處理	17 + 11
wallet	銀行卡、信用卡、加密錢包管理	9
vendor	金流通道配置、回調處理	6
deposit	存款訂單建立、匯率查詢	4
promo	活動 CRUD、領取、標籤管理	7
vip	VIP 等級、反水結算、保級檢查	13
affiliate	代理管理、佣金結算、風控	51
inbox	站內信發送、讀取、管理	7
site-config	站點配置、主題、客服、域名	8 + 12
withdrawal	提領申請、審核、完成	7
mission	任務系統、進度追蹤	3
admin	管理員 CRUD、權限、報表、風控、R2	76
bet-record	投注紀錄查詢	3
common	枚舉、健康檢查	2
live-sports	即時賽事數據	2
ranking	排行榜	2
r2	雲端檔案上傳（全域模組）	6

49 張資料表，涵蓋：

分類	表數量	涵蓋內容
用戶相關	2	用戶主表、登入日誌
金流相關	4	金流群組、通道、關聯、存款訂單
錢包相關	3	銀行卡、信用卡、加密地址
遊戲相關	6	供應商、類型配置、交易、遊玩紀錄、投注、投注明細
VIP 相關	3	等級、反水規則、反水日誌
活動相關	3	活動、領取、標籤
代理相關	7	佣金、結算、餘額、提款、點擊、綁定、風控
聯盟相關	5	佣金費率、代理等級、VIP 里程碑、里程碑日誌、推廣碼
站內信	2	通知、已讀紀錄
站點相關	2	站點配置、站點主題
提領	1	提領訂單
任務	3	任務、進度、領取
風控	2	IP 規則、遊戲黑名單
後台	3	管理員、群組、操作日誌
儲存	1	R2 操作日誌
排行	1	排行榜
合計	49

第 4 章：業務模組摘要

本章以非技術語言說明每個核心業務模組的運作方式。

4.1 遊戲系統

遊戲系統是娛樂城的核心，負責對接外部遊戲供應商，讓玩家可以在我們的平台上遊玩各種遊戲。

支援 8 種遊戲類型：

類型	說明	代表遊戲
體育（Sports）	運動賽事投注	足球、籃球、棒球等
老虎機（Slot）	電子遊戲機	各式主題老虎機
真人（Live）	真人荷官遊戲	百家樂、輪盤、骰寶
彩票（Lottery）	彩票類遊戲	各式彩種
棋牌（Chess）	棋牌類遊戲	德州撲克、麻將、象棋
電競（Esports）	電子競技投注	LOL、CS、DOTA2
加密（Crypto）	加密貨幣相關遊戲	幣價預測、Crash 等
捕魚（Fish）	捕魚類遊戲	各式捕魚機台

已對接遊戲供應商：

BetSolutions — 提供多種遊戲類型
RSG（含 DES 加密通訊） — 提供老虎機、真人等遊戲

遊戲運作流程：

  玩家點擊「進入遊戲」
        |
        v
  檢查風控黑名單 -----> 若被封鎖，顯示錯誤
        |
        | 通過
        v
  從平台錢包轉帳到遊戲錢包
        |
        v
  開啟遊戲商的遊戲視窗
        |
        v
  玩家在遊戲中下注/派彩
        |
        v
  遊戲商透過「回調」通知我們結果
        |
        v
  自動更新：
  - 錢包餘額
  - VIP 等級（投注累積）
  - 活動打碼量
  - 任務進度

每站獨立配置：

每個站點可以選擇開放哪些遊戲供應商
每個站點可以自訂遊戲類型的排序與顯示
支援「帶入模板」快速設定與「同預設站點」一鍵複製

4.2 金流系統

金流系統處理玩家的存款與提領，是平台營收的關鍵環節。

支援的存款方式：

方式	說明	金流商
ATM 轉帳	玩家透過銀行 ATM 轉帳入金	萬通金流
信用卡	玩家使用信用卡直接刷卡入金	萬通金流
加密貨幣	玩家使用 USDT 等加密貨幣入金	USDT 通道

金額處理規則：

系統內部所有金額統一使用**美元（USD）**記帳
入金時依台灣銀行即時匯率自動轉換
金額精度為小數點後 6 位（例如 100.123456 USD）
所有計算使用「無條件捨去」，確保平台不會多付

金流運作流程：

  玩家選擇存款方式
        |
        v
  系統自動分配金流通道
  （依據語系、群組設定）
        |
        v
  導向金流商支付頁面
        |
        v
  玩家完成付款
        |
        v
  金流商「回調」通知我們
        |
        v
  後台審核通過
        |
        v
  餘額入帳 + 自動觸發：
  - 存款任務進度更新
  - 活動條件檢查

提領流程（三階段）：

玩家提交提領申請
後台審核（通過/駁回）
財務處理出款 + 上傳憑證 → 完成

4.3 VIP 系統

VIP 系統是留住高價值玩家的核心機制，透過等級、返水、保級等設計，持續激勵玩家。

核心特色：

每站獨立配置：不同站點可以有不同的 VIP 等級數量和設定
等級數量不限：商戶可自由新增任意數量的 VIP 等級
只升不降：VIP 等級只會向上升級，不會因為短期不活躍就降級
自動升級：累積投注金額達到門檻時自動升級
每日反水：每天凌晨 00:05 自動結算返水獎勵

VIP 返水機制：

每個 VIP 等級 x 8 種遊戲類型都有獨立的返水比例，形成一個完整的矩陣：

  VIP 返水矩陣範例
  ================

          體育   老虎機  真人   彩票   棋牌   電競   加密   捕魚
  VIP 0   0.1%   0.2%   0.1%   0.1%   0.2%   0.1%   0.1%   0.2%
  VIP 1   0.2%   0.3%   0.2%   0.2%   0.3%   0.2%   0.2%   0.3%
  VIP 2   0.3%   0.4%   0.3%   0.3%   0.4%   0.3%   0.3%   0.4%
  VIP 3   0.5%   0.6%   0.5%   0.4%   0.5%   0.4%   0.4%   0.5%
  ...
  VIP N   依商戶設定

保級機制：

每月 1 號凌晨 01:00 自動執行保級檢查
VIP 5 級以上支援「保級鎖定」——即使投注量不足，也不會降級
保級規則各站獨立設定

4.4 代理推廣系統

代理系統是平台擴大用戶基礎的重要渠道，透過代理分傭模式吸引推廣人員。

三層代理結構：

  代理推廣結構
  ============

  上線代理（第 1 層）
        |
        +---> 下線代理 A（第 2 層）
        |           |
        |           +---> 玩家 A1（第 3 層）
        |           +---> 玩家 A2（第 3 層）
        |
        +---> 下線代理 B（第 2 層）
        |           |
        |           +---> 玩家 B1（第 3 層）
        |
        +---> 玩家 C（直屬下線）

  最多 3 層，每層都可獲得佣金分潤

四個代理等級：

等級	名稱	說明
Bronze	銅牌	初始等級，基本佣金比例
Silver	銀牌	中階等級，較高佣金比例
Gold	金牌	高階等級，優厚佣金比例
Platinum	白金	最高等級，頂級佣金比例

佣金費率矩陣：

4 等級 x 3 層級 x 8 遊戲類型 = 96 筆費率設定
每個站點獨立配置
支援「帶入模板」快速設定

推廣碼系統：

每位代理最多可建立 10 個推廣碼
支援雙重查找：聯盟碼 → 主代理碼
隱私保護：代理視角下，下線帳號自動遮罩顯示

結算機制：

佣金週結：每週一凌晨 03:00 自動結算
佣金日結：每日凌晨 03:30 自動結算
結算時自動執行風控檢測（檢查異常下線行為）
結算後需後台審核通過才發放

代理提款三階段：

待審核（代理提交提款申請）
已核准（後台審核通過）
已完成（財務處理出款完畢）

4.5 任務系統

任務系統透過每日/每週/每月的任務機制，激勵玩家持續存款和遊戲。

任務類型：

週期	存款任務	投注任務
每日	每日存款達標	每日投注達標
每週	每週存款達標	每週投注達標
每月	每月存款達標	每月投注達標

自動進度更新：

玩家存款確認後 → 自動更新存款任務進度
玩家投注結算後 → 自動更新投注任務進度
達標後玩家可主動領取獎勵

4.6 活動系統

活動系統用於管理各種優惠促銷活動，吸引新玩家並留住老玩家。

活動特色：

多語系內容：每個活動支援 5 種語言的富文本內容（HTML 編輯器）
條件設定：可設定參與條件（存款金額、VIP 等級、首存等）
打碼量追蹤：設定提領前需完成的投注倍數
分類標籤：活動可加標籤分類（新手、週末、VIP 專屬等）
每站獨立：不同站點可以有不同的活動

活動管理流程：

  建立活動（設定內容、條件、時間）
        |
        v
  上架（前台顯示）
        |
        v
  玩家瀏覽活動中心
        |
        v
  玩家參與（滿足條件後領取）
        |
        v
  系統記錄領取、追蹤打碼量
        |
        v
  下架或到期

4.7 風控系統

風控系統保護平台免受惡意行為侵害，每個站點獨立配置。

三大風控功能：

功能	說明	應用場景
IP 黑白名單	封鎖或允許特定 IP 地址	阻止已知惡意 IP、允許辦公室 IP
遊戲黑名單	禁止特定玩家進入遊戲	封鎖可疑帳號、限制特定遊戲類型
裝置指紋追蹤	追蹤玩家的裝置特徵	偵測多帳號、反查可疑行為

風控運作方式：

登入時記錄 IP 與裝置指紋
進入遊戲前自動檢查黑名單
後台可透過 IP 或裝置指紋反查所有關聯帳號
登入失敗紀錄完整保留，供分析使用
代理佣金結算時自動執行風控檢測

4.8 站內信系統

站內信是平台與玩家溝通的內部訊息管道。

功能特色：

多語系通知內容
支援單人發送與全站廣播
已讀/未讀狀態追蹤
後台可管理所有站內信
各站點獨立

4.9 客服系統

客服系統支援 8 種客服管道，滿足不同市場的溝通習慣。

支援管道：

管道	目標市場
Line	台灣、泰國、日本
Telegram	全球
WeChat（微信）	中國大陸
Facebook	東南亞、全球
Instagram	年輕用戶群體
Twitter (X)	全球
Discord	遊戲社群
自訂管道	任意客服工具

額外支援：LiveChat 嵌入腳本（獨立開關），提供即時線上客服。

每個管道均支援：

多語系顯示名稱
自訂圖示
連結設定
排序控制
啟用/停用開關
各站點獨立配置

4.10 KYC 身份驗證

KYC（Know Your Customer）是確認玩家真實身份的四步驟流程。

驗證流程：

  步驟 1：基本資料
  ├── 真實姓名
  ├── 出生日期
  └── 聯絡資訊

        |
        v

  步驟 2：證件上傳
  ├── 身份證正面
  ├── 身份證反面
  └── 自拍照

        |
        v

  步驟 3：活體驗證
  ├── 臉部辨識
  └── 動作指令配合

        |
        v

  步驟 4：審核結果
  ├── 通過 → 解鎖完整功能
  └── 駁回 → 說明原因，可重新提交

第 5 章：運營數據能力

5.1 七大報表類型

C9 Platform 提供七種報表，涵蓋營運的各個面向，幫助管理層做出數據驅動的決策。

報表一：總覽報表

項目	說明
功能	每日營運數據的整體視圖
展示方式	統計卡片 + 每日摘要表格
主要指標	當日存款總額、提款總額、投注總額、損益總額
篩選條件	開始日期、結束日期
多站點	支援（可切換各站點查看）

使用場景：每日晨會快速了解昨日營運狀況。

報表二：玩家報表

項目	說明
功能	以玩家為維度的數據分析
展示方式	資料表格
主要指標	註冊數、活躍數、存款數、投注數、各等級分布
篩選條件	關鍵字、VIP 等級、開始日期、結束日期
多站點	支援

使用場景：分析玩家結構、找出高價值玩家群體。

報表三：玩家簡表

項目	說明
功能	單一玩家的摘要數據
展示方式	逐一玩家列表，可排序
主要指標	個人存款/提款/投注/損益摘要
篩選條件	關鍵字、VIP 等級、排序方式、排序方向、日期範圍
多站點	支援

使用場景：快速查找特定玩家的營運數據。

報表四：遊戲報表

項目	說明
功能	按遊戲類型/遊戲商的數據分析
展示方式	資料表格
主要指標	各遊戲的投注額、派彩額、損益、玩家數
篩選條件	遊戲類型、遊戲平台、開始日期、結束日期
多站點	支援

使用場景：評估各遊戲的表現，決定是否新增或下架遊戲。

報表五：投注紀錄

項目	說明
功能	所有投注的逐筆明細
展示方式	資料表格（含分頁）
主要指標	投注時間、玩家、遊戲、金額、結果
篩選條件	關鍵字、遊戲類型、遊戲平台、狀態、日期範圍
多站點	支援

使用場景：稽核特定投注、處理玩家爭議。

報表六：損益報表

項目	說明
功能	平台損益的時間序列分析
展示方式	資料表格
主要指標	損益金額、投注額、派彩額、毛利率
篩選條件	分組方式（日/週/月）、遊戲類型、日期範圍
多站點	支援

使用場景：追蹤平台整體獲利趨勢，按週/月檢視經營成果。

報表七：活動報表

項目	說明
功能	各活動的領取與參與統計
展示方式	資料表格
主要指標	活動名稱、領取人數、發放金額、打碼量完成率
篩選條件	開始日期、結束日期
多站點	規劃中

使用場景：評估活動效果，調整活動策略。

5.2 其他數據能力

功能	說明
CSV 匯出	所有報表均支援一鍵匯出 CSV 檔案
線上玩家監控	即時查看當前在線玩家數量與列表
雲端儲存日誌	R2 檔案操作的完整審計紀錄
操作紀錄	所有後台操作的完整審計日誌
登入失敗紀錄	異常登入嘗試的監控

5.3 數據監控示意

  營運數據儀表板
  ==============

  +-------------+  +-------------+  +-------------+  +-------------+
  | 今日存款    |  | 今日提款    |  | 今日投注    |  | 今日損益    |
  | $125,000    |  | $45,000     |  | $890,000    |  | +$38,500    |
  |   +12%      |  |   -5%       |  |   +8%       |  |   +15%      |
  +-------------+  +-------------+  +-------------+  +-------------+

  +--------------------------------------------------+
  |  每日摘要                                         |
  +--------+--------+--------+--------+--------+-----+
  |  日期  | 存款   | 提款   | 投注   | 損益   | 新增 |
  +--------+--------+--------+--------+--------+-----+
  | 03/01  | 125K   | 45K    | 890K   | +38.5K | 42  |
  | 02/28  | 112K   | 47K    | 825K   | +33.5K | 38  |
  | 02/27  | 118K   | 43K    | 856K   | +36.2K | 45  |
  | ...    | ...    | ...    | ...    | ...    | ... |
  +--------+--------+--------+--------+--------+-----+

第 6 章：安全性

6.1 安全架構總覽

C9 Platform 在安全性上採用多層防護機制，確保平台、用戶、資料的安全。

  安全防護層級
  ============

  第 1 層：認證 (Authentication)
  ├── 前台：JWT Token（7 天過期）
  ├── 後台：AdminJWT（獨立金鑰）
  └── 雙因素認證：Google Authenticator

  第 2 層：授權 (Authorization)
  ├── RBAC 角色權限控制
  ├── 16 個權限模組
  └── 4 種群組類型

  第 3 層：風控 (Risk Control)
  ├── IP 黑白名單
  ├── 遊戲黑名單
  ├── 裝置指紋追蹤
  └── 代理結算風控

  第 4 層：稽核 (Audit)
  ├── 所有後台操作紀錄
  ├── IP + 瀏覽器資訊
  └── 操作內容詳情

  第 5 層：資料安全
  ├── 密碼雜湊儲存
  ├── JWT 簽名驗證
  └── 帳號遮罩顯示

6.2 雙重 JWT 認證

系統使用兩套獨立的 JWT（JSON Web Token）認證機制：

認證類型	適用對象	金鑰	有效期	特殊功能
JWT	前台玩家	前台專用金鑰	7 天	支援帳密/Google/Telegram 登入
AdminJWT	後台管理員	後台專用金鑰	依設定	payload 含 role:'admin'，支援 2FA

為什麼要分開：

即使前台 Token 被竊取，也無法存取後台
後台使用獨立的驗證邏輯和安全策略
可獨立設定不同的過期時間

6.3 RBAC 權限控制

RBAC（Role-Based Access Control，角色型存取控制）確保每個管理員只能操作被授權的功能。

16 個權限模組 x 2 種操作：

模組	讀取（Read）	寫入（Write）
admin	查看管理員列表	新增/編輯/刪除管理員
admin-group	查看群組列表	新增/編輯/刪除群組
admin-log	查看操作紀錄	-
user	查看用戶資料	編輯用戶
deposit	查看存款訂單	審核存款
withdrawal	查看提款訂單	審核提款
promo	查看活動列表	建立/編輯活動
promo-tag	查看標籤	管理標籤
affiliate	查看代理資料	管理代理
vip	查看 VIP 設定	修改 VIP 設定
game	查看遊戲設定	修改遊戲設定
risk	查看風控資料	管理風控規則
report	查看報表	匯出報表
vendor	查看金流設定	修改金流設定
finance	查看財務資料	財務操作
site-config	查看站點設定	修改站點設定

4 種預設群組：

群組	權限範圍	適用角色
root	全部權限（包含站點設定）	平台超級管理員
super_admin	全部權限（除站點設定）	商戶管理員
general_admin	僅唯讀權限	客服、營運查詢
custom	自訂任意組合	依需求設定

6.4 雙因素認證（2FA）

後台管理員可啟用 Google Authenticator 二步驟驗證，大幅提升帳號安全性。

啟用流程：

管理員在個人資料頁點擊「啟用 2FA」
系統產生 QR Code + Secret 金鑰
管理員用 Google Authenticator App 掃描 QR Code
輸入 App 顯示的 6 位驗證碼確認
啟用成功，之後每次登入都需輸入驗證碼

安全效果：

即使密碼被竊取，沒有手機也無法登入
驗證碼每 30 秒更新一次
支援停用（需驗證當前驗證碼）

6.5 操作稽核

所有後台操作都會被完整記錄：

記錄項目	說明
操作人	哪個管理員執行的
操作時間	精確到秒
操作內容	做了什麼（新增/修改/刪除/審核等）
IP 地址	從哪個 IP 操作
瀏覽器資訊	使用什麼瀏覽器（含作業系統解析）
操作詳情	具體修改了什麼資料

6.6 裝置指紋

前台使用 FingerprintJS v5 技術追蹤用戶裝置：

不依賴 Cookie（清除 Cookie 也能追蹤）
基於裝置硬體特徵產生唯一識別碼
用於偵測多帳號（同一裝置註冊多個帳號）
後台可透過指紋反查所有關聯帳號

6.7 強制登出機制

系統支援 tokenVersion 機制：

每個用戶的 Token 帶有版本號
管理員可在後台強制使某用戶的所有 Token 失效
用戶下次操作時會被強制登出
適用於帳號被盜、封鎖帳號等緊急情況

第 7 章：擴展性

C9 Platform 的架構設計重視擴展性，新增各種資源時所需的工作量極小。

7.1 新增站點

所需時間：約 10-30 分鐘（視配置複雜度而定）

步驟：

在後台「站點設定」點擊「新增站點」
填入站點名稱、代碼、域名
選擇主題配色（或從預設站點複製）
設定功能開關（哪些功能要開啟）
使用「同預設站點」一鍵複製：
- 遊戲商配置
- VIP 等級與返水規則
- 代理費率
- 客服管道設定
- 域名素材
完成——新站點立即可用

不需要：

不需要寫程式碼
不需要修改資料庫結構
不需要重新部署
不需要額外的伺服器

7.2 新增遊戲供應商

所需時間：約 1-3 個工作天（視遊戲商對接複雜度）

步驟：

在後端新增對應的遊戲模組（Controller + Service）
實作遊戲商的 S2S（Server-to-Server）回調介面
在後台「遊戲商管理」頁面新增供應商資料
完成——前台自動顯示新遊戲

不需要修改前台程式碼 — 前台根據後端回傳的遊戲商列表自動渲染。

7.3 新增金流供應商

所需時間：約 1-3 個工作天

步驟：

在後端新增對應的金流模組
實作金流商的回調介面
在後台「存款設定」配置金流通道
完成——前台存款頁自動顯示新支付方式

同樣不需要修改前台 — 模組化設計讓新增金流商的影響範圍最小。

7.4 新增語系

所需時間：約 1-2 個工作天（主要是翻譯工作）

步驟：

前台：在語系目錄中新增一份 JSON 翻譯檔
後台：在語系目錄中新增一份 JSON 翻譯檔
後端：在語系目錄中新增一份 JSON 翻譯檔
更新語系配置清單
完成——前後台自動出現新語系選項

翻譯內容：

前台約數百個翻譯 Key
後台約數百個翻譯 Key
後端錯誤訊息約數十個

7.5 新增佈局版本

目前狀態：前台使用 a1 佈局版本

擴展方式：

佈局系統支援版本化設計
可新增 a2、b1 等不同佈局
不同站點可選擇不同佈局
共用業務邏輯，僅 UI 佈局不同

7.6 擴展性總結

擴展項目	預估時間	需修改程式碼	需重新部署
新增站點	10-30 分鐘	否	否
新增遊戲商	1-3 天	僅後端	是
新增金流商	1-3 天	僅後端	是
新增語系	1-2 天	翻譯檔	是
新增佈局	3-5 天	前台	是
新增功能模組	依功能而定	前後端	是

第 8 章：技術棧概覽（非技術語言）

本章以商業語言說明平台使用的關鍵技術，以及選用它們的原因。

8.1 前台技術

技術	是什麼	為什麼選它
Nuxt 4.2	建立網站的框架	由 Vue.js 生態系最強框架，支援伺服器端渲染（SEO 友好），開發速度快
Vue 3.5	建立互動式網頁的工具	全球三大前端框架之一，學習曲線低，社群活躍，人才好找
TypeScript	加強版的 JavaScript	減少程式錯誤 50% 以上，程式碼更可靠
Tailwind CSS	快速設計網頁外觀的工具	開發速度提升 3-5 倍，一致的視覺風格
Pinia	管理應用程式狀態的工具	Vue 官方推薦，資料流清晰可追蹤
Zod v4	資料驗證工具	確保用戶輸入的資料符合格式，防止錯誤
FingerprintJS v5	裝置識別技術	精準追蹤裝置，防止多帳號濫用
Vitest + Playwright	自動化測試工具	確保程式品質，減少上線後的錯誤

8.2 後台技術

技術	是什麼	為什麼選它
Next.js 16	建立管理後台的框架	全球最流行的 React 框架，效能優異，生態系完整
React 19	建立互動式管理介面的工具	全球市佔率最高的前端框架，人才充沛
shadcn/ui	高品質的 UI 元件庫	提供專業級的表格、表單、對話框等元件，減少開發時間
TanStack Query v5	資料同步管理工具	自動快取、自動重新載入，讓後台資料始終最新
Zustand v5	輕量狀態管理	簡潔高效，用於管理站點選擇、UI 狀態等
NextAuth 5	認證框架	業界標準的認證解決方案，安全可靠
Recharts v3	圖表工具	豐富的圖表類型，用於報表視覺化
Tiptap v3	富文本編輯器	支援活動內容的多語系 HTML 編輯
React Hook Form	表單處理工具	高效能的表單驗證，68 頁管理頁面的表單基礎

8.3 後端技術

技術	是什麼	為什麼選它
NestJS v11	後端應用框架	企業級架構，模組化設計完美契合白牌需求
TypeScript 5.7	加強版 JavaScript	前後端統一語言，減少溝通成本
MySQL	關聯式資料庫	業界最成熟的開源資料庫，穩定可靠
Redis	高速快取資料庫	將頻繁存取的資料放在記憶體中，速度提升 10-100 倍
TypeORM	資料庫操作工具	用程式語言操作資料庫，減少 SQL 錯誤
JWT + Passport	認證框架	業界標準的 Token 認證機制
Swagger UI	API 文件工具	自動產生互動式 API 文件，方便前後端協作
Resend	郵件發送服務	可靠的交易郵件發送（驗證碼、通知）
Twilio	簡訊發送服務	全球覆蓋的簡訊驗證服務
speakeasy	2FA 驗證碼產生器	Google Authenticator 的後端實作

8.4 技術選型原則

  技術選型考量
  ============

  1. TypeScript 統一
     前台 + 後台 + 後端全部使用 TypeScript
     好處：團隊共用知識，人才可跨專案支援

  2. 現代化框架
     全部使用 2024-2025 年最新版本
     好處：效能最佳，安全性最高，社群支援最活躍

  3. 開源為主
     絕大多數技術為開源免費
     好處：無授權費用，社群持續維護

  4. 模組化設計
     後端 23 個獨立模組，前端元件化
     好處：新增功能不影響既有功能，維護成本低

第 9 章：團隊配置建議

9.1 建議團隊規模

以下為維持平台持續開發與運營所需的最小團隊配置：

角色	人數	職責
前端工程師（Vue）	1-2 人	負責前台（c9-ec）的開發與維護
前端工程師（React）	1-2 人	負責後台（c9-ims）的開發與維護
後端工程師	1-2 人	負責後端（c9-be）的開發與維護
UI/UX 設計師	1 人	負責介面設計、使用者體驗優化
QA 測試工程師	1 人	負責品質保證、自動化測試
專案經理（PM）	1 人	負責專案管理、需求溝通
DevOps 工程師	0.5 人	負責部署、監控、維運（可兼任）
合計	5.5 - 9.5 人

9.2 團隊結構建議

  團隊組織
  ========

  專案經理 (PM)
      |
      +------+------+------+
      |      |      |      |
      v      v      v      v
   前台組  後台組  後端組  支援組
   (1-2)  (1-2)  (1-2)  (2.5)
                          |
                          +--- UI/UX (1)
                          +--- QA (1)
                          +--- DevOps (0.5)

9.3 各階段人力需求

階段	前端	後端	其他	合計	說明
初期開發	3-4 人	2-3 人	2 人	7-9 人	功能密集開發期
穩定營運	2 人	1-2 人	2.5 人	5.5-6.5 人	日常維護 + 小功能迭代
快速擴張	3-4 人	2-3 人	3 人	8-10 人	大量新功能需求

9.4 技能需求

角色	必要技能	加分技能
前端（Vue）	Vue 3、TypeScript、Nuxt	Tailwind CSS、Pinia
前端（React）	React 19、TypeScript、Next.js	shadcn/ui、TanStack Query
後端	NestJS、TypeScript、MySQL	Redis、TypeORM、JWT
UI/UX	Figma、響應式設計	動效設計、Tailwind CSS
QA	手動測試、測試案例撰寫	Playwright、Vitest
DevOps	Docker、CI/CD	Cloudflare、Vercel

第 10 章：部署與維運

10.1 開發環境

開發環境在本機電腦上運行，三個子系統各佔一個端口：

服務	本機網址	用途
前台	http://localhost:3010	玩家端預覽
後台	http://localhost:3011	管理端預覽
後端 API	http://localhost:8080/api	API 服務
API 文件	http://localhost:8080/api/docs	Swagger 互動式文件

一鍵啟動：在根目錄執行 yarn dev 即可同時啟動三個服務。

10.2 正式部署選項

部署方式	說明	適合場景
Docker	容器化部署，環境一致	自有主機、雲端 VPS
Zeabur	台灣雲端平台，一鍵部署	快速上線、小型營運
Vercel	全球 CDN 平台	前端靜態部署
自建主機	完全掌控	大型營運、合規要求

10.3 依賴服務

服務	用途	必要性
MySQL	主資料庫	必要
Redis	快取、Session	必要
Node.js 18+	執行環境	必要
Cloudflare R2	檔案儲存（Logo、圖片）	必要
Resend	郵件發送	選配
Twilio	簡訊發送	選配
API-Football	即時賽事數據	選配

10.4 監控與維運

監控項目	工具/方式	說明
API 文件	Swagger UI	即時查看所有 API 端點狀態
操作日誌	後台「操作紀錄」	所有管理操作的完整記錄
錯誤監控	應用程式日誌	後端執行錯誤記錄
效能監控	Redis 快取	高頻查詢的快取命中率
檔案操作	R2 操作日誌	檔案上傳/刪除的完整記錄
登入異常	登入失敗紀錄	IP、帳號、時間的異常偵測

10.5 備份策略建議

備份項目	建議頻率	保留週期
MySQL 全量備份	每日	保留 30 天
MySQL 增量備份	每小時	保留 7 天
R2 檔案備份	每週	保留 90 天
環境配置備份	每次變更	永久保留
程式碼備份	每次提交	Git 永久保留

10.6 部署架構示意

  正式環境部署架構
  ================

                    +-------------------+
                    |   Cloudflare      |
                    |   DNS + CDN       |
                    +--------+----------+
                             |
              +--------------+--------------+
              |              |              |
              v              v              v
     +--------+----+ +------+------+ +-----+-------+
     |   c9-ec     | |   c9-ims   | |   c9-be     |
     |  前台網站   | |  後台管理  | |  後端 API   |
     | (Vercel /   | | (Vercel /  | | (Docker /   |
     |  Docker)    | |  Docker)   | |  VPS)       |
     +-------------+ +------------+ +------+------+
                                           |
                                    +------+------+
                                    |             |
                               +----+----+  +----+----+
                               |  MySQL  |  |  Redis  |
                               | (主庫)  |  | (快取)  |
                               +---------+  +---------+
                                    |
                               +----+----+
                               |  MySQL  |
                               | (備援)  |
                               +---------+

     外部服務：
     +------------+  +--------+  +-----------+  +--------+
     | Cloudflare |  | Resend |  | Twilio    |  | API-   |
     | R2 (檔案)  |  | (郵件) |  | (簡訊)   |  |Football|
     +------------+  +--------+  +-----------+  +--------+

第 11 章：系統排程

C9 Platform 有 5 個自動排程任務，在背景定時執行重要的業務邏輯，無需人工介入。

11.1 排程總覽

編號	排程名稱	執行時間	說明
1	VIP 每日反水結算	每日 00:05	計算並發放 VIP 返水獎勵
2	VIP 月度保級檢查	每月 1 號 01:00	檢查 VIP 會員是否達到保級門檻
3	代理佣金週結	每週一 03:00	結算上週的代理佣金
4	代理佣金日結	每日 03:30	結算昨日的代理佣金
5	即時賽事更新	每 30 分鐘	更新即時體育賽事數據快取

11.2 詳細說明

排程 1：VIP 每日反水結算（每日 00:05）

做什麼：

掃描所有站點的所有 VIP 玩家
計算每位玩家昨日在各遊戲類型的投注金額
依據該玩家的 VIP 等級和對應的返水比例，計算返水金額
將返水金額自動加入玩家餘額

運算邏輯：

  玩家 A（VIP 3）昨日投注：
  - 老虎機投注 $10,000，VIP 3 返水比例 0.6% → 返水 $60
  - 真人投注 $5,000，VIP 3 返水比例 0.5% → 返水 $25
  - 總返水：$85 → 自動入帳

重要特性：

每站獨立結算（不同站點有不同的 VIP 等級和返水比例）
支援動態等級（等級數量不固定，由各站自行設定）
8 種遊戲類型各自計算

排程 2：VIP 月度保級檢查（每月 1 號 01:00）

做什麼：

檢查所有 VIP 會員上月的投注量
如果未達保級門檻且等級低於 VIP 5，可能降級
VIP 5 及以上有「保級鎖定」保護，不會降級

為什麼重要：

激勵 VIP 玩家持續活躍
高等級玩家享有保級保護，增加忠誠度

排程 3：代理佣金週結（每週一 03:00）

做什麼：

計算所有代理上週的佣金收入
依據代理等級和遊戲類型的佣金費率計算
同時執行風控檢測（檢查是否有異常下線行為）
將計算結果存入結算紀錄，等待後台審核

風控檢測項目：

是否有下線大量集中投注
是否有下線異常的投注模式
是否有疑似刷佣金的行為

排程 4：代理佣金日結（每日 03:30）

做什麼：

與週結類似，但計算週期為每日
提供更即時的佣金數據

排程 5：即時賽事更新（每 30 分鐘）

做什麼：

從 API-Football 取得最新的體育賽事數據
更新 Redis 快取
前台即時賽事頁面自動顯示最新數據

為什麼 30 分鐘：

平衡即時性與 API 呼叫成本
賽事數據不需要秒級更新

11.3 排程時間線

  每日排程時間線（GMT+8）
  =======================

  00:00                                              24:00
    |                                                   |
    |  00:05                                            |
    |  [VIP 反水結算]                                   |
    |                                                   |
    |        01:00 (每月1號)                             |
    |        [VIP 保級檢查]                              |
    |                                                   |
    |              03:00 (每週一)                         |
    |              [代理佣金週結]                         |
    |                                                   |
    |                 03:30                              |
    |                 [代理佣金日結]                      |
    |                                                   |
    |  每 30 分鐘                                       |
    |  [即時賽事更新] .... [更新] .... [更新] ....       |
    |                                                   |

第 12 章：競爭優勢總結

12.1 七大核心優勢

優勢一：一套系統，無限站點

白牌架構讓同一套程式碼可支撐無限多個品牌
新增站點僅需 10-30 分鐘，無需額外開發
邊際成本趨近於零
每個站點完全獨立：域名、品牌、資料、配置
37+ 張資料表支援站點隔離

優勢二：功能模組齊全

88 個頁面覆蓋完整業務流程
205+ 個 API 端點處理所有業務邏輯
涵蓋遊戲、金流、VIP、代理、任務、活動、風控、報表等所有核心模組
開箱即用，不需從零開發

模組完整度對比：

  C9 Platform 功能覆蓋
  =====================

  遊戲系統    [##########] 100%  8 種遊戲類型，多供應商
  金流系統    [##########] 100%  ATM / 信用卡 / 加密貨幣
  VIP 系統    [##########] 100%  自動升級 + 反水 + 保級
  代理系統    [##########] 100%  3 層架構 + 週/日結算 + 風控
  活動系統    [##########] 100%  多語系 + 條件設定 + 打碼量
  任務系統    [##########] 100%  每日/週/月 + 自動進度
  風控系統    [##########] 100%  IP + 裝置 + 遊戲 黑名單
  報表系統    [########--]  80%  7 種報表（活動報表待強化）
  站內信      [##########] 100%  多語系 + 已讀追蹤
  客服系統    [##########] 100%  8 種管道 + LiveChat
  KYC 驗證    [##########] 100%  4 步驟完整流程
  後台管理    [##########] 100%  68 頁完整管理功能

優勢三：現代 TypeScript 全端架構

前台、後台、後端全部使用 TypeScript
統一語言降低團隊學習成本和溝通成本
使用 2024-2025 年最新框架版本
效能、安全性、開發效率均為業界頂級

優勢四：亞洲市場在地化

原生支援 5 種亞洲核心語系
台灣銀行即時匯率整合
亞洲主流客服管道支援（Line、Telegram、微信）
符合亞洲市場的 UI/UX 設計

優勢五：68 頁完整後台管理

68 個管理頁面覆蓋所有營運需求
47 頁支援多站點切換
強大的篩選與搜尋功能
CSV 匯出、統計圖表、即時數據
從儀表板到風控，一站式管理

優勢六：企業級安全防護

雙重 JWT 認證（前後台分離）
RBAC 細粒度權限控制（16 模組 x 2 操作）
Google Authenticator 雙因素認證
完整操作稽核日誌
裝置指紋追蹤
IP 與遊戲黑名單
代理結算風控檢測
強制登出機制

優勢七：模板系統快速設定

「帶入模板」一鍵載入預設配置
「同預設站點」一鍵複製設定到新站
涵蓋遊戲商、VIP、代理費率、客服等關鍵設定
新站上線時間從數天縮短至半小時

12.2 與自建系統的比較

比較項目	C9 Platform	自建系統
開發時間	已完成（可立即使用）	12-18 個月起步
開發成本	僅授權費用	團隊薪資 x 12-18 個月
功能完整度	88 頁、205+ API	依進度而定
多站點	原生支援	需額外開發
多語系	5 語內建	需額外開發
VIP 系統	完整（自動結算）	需額外開發
代理系統	完整（含風控）	需額外開發
安全性	6 層防護	依團隊經驗
維護成本	低（統一維護）	高（自行維護）
擴展性	模組化設計	依架構而定

12.3 投資報酬率預估

  ROI 簡易評估
  =============

  假設：
  - 第 1 個月上線 1 個站點
  - 之後每月新增 1 個站點
  - 每站每月產生 $X 收入

  月份    站點數    月收入      累積成本    累積收入
  M1       1       1X          C+1X         1X
  M2       2       2X          C+3X         3X
  M3       3       3X          C+6X         6X
  M6       6       6X          C+21X        21X
  M12     12       12X         C+78X        78X

  C = 平台取得成本
  站點越多，邊際成本越低，獲利倍數越高

附錄 A：術語表

術語	英文	說明
白牌	White-Label	一套產品貼上不同品牌銷售的商業模式
SaaS	Software as a Service	軟體即服務，客戶按期付費使用
多站點	Multi-Tenant / Multi-Site	一套系統同時服務多個獨立站點
siteCode	Site Code	站點代碼，用於區分不同站點的唯一識別碼
前台	Frontend (EC)	面向終端用戶的網站界面
後台	Admin Panel (IMS)	內部管理人員使用的管理界面
後端	Backend (BE)	處理業務邏輯和資料儲存的伺服器程式
API	Application Programming Interface	前後端之間的溝通介面
JWT	JSON Web Token	網路身份認證的令牌機制
RBAC	Role-Based Access Control	基於角色的存取控制權限系統
2FA	Two-Factor Authentication	雙因素認證（密碼 + 手機驗證碼）
TOTP	Time-based One-Time Password	基於時間的一次性密碼（Google Authenticator）
VIP	Very Important Person	貴賓會員等級系統
反水/返水	Rebate	依投注金額按比例返還的獎勵金
打碼量	Turnover Requirement	提領前需完成的投注金額倍數
保級	Tier Retention	維持 VIP 等級所需的最低投注量
代理	Affiliate / Agent	透過推廣碼招募新玩家並獲得佣金的推廣人員
佣金	Commission	代理從下線投注中獲得的分潤
週結	Weekly Settlement	每週結算一次佣金
日結	Daily Settlement	每日結算一次佣金
S2S	Server-to-Server	伺服器對伺服器的直接通訊
回調	Callback / Webhook	外部服務主動通知我們結果的機制
金流商	Payment Provider / Vendor	提供支付服務的第三方公司
遊戲商	Game Provider	提供遊戲內容的第三方公司
KYC	Know Your Customer	客戶身份驗證流程
站內信	Internal Notification / Inbox	平台內部的訊息通知系統
ORM	Object-Relational Mapping	用程式語言操作資料庫的工具
CDN	Content Delivery Network	全球內容分發網路（加速網站載入）
R2	Cloudflare R2	Cloudflare 的雲端檔案儲存服務
Cron	Cron Job	定時執行的背景排程任務
OAuth	Open Authorization	第三方登入授權協定（如 Google 登入）
USD	United States Dollar	美元，系統內部統一計價幣別
CSV	Comma-Separated Values	逗號分隔值檔案格式（報表匯出用）
功能開關	Feature Flag	動態控制功能啟用/停用的機制
裝置指紋	Device Fingerprint	基於裝置硬體特徵產生的唯一識別碼

附錄 B：系統規格摘要表

B.1 系統規模

類別	項目	數值
前台	頁面數	20
	UI 元件數	77
	Composables	45
	支援語系	5
後台	頁面數	68
	UI 元件數	41
	Hooks	15
	支援語系	5
	多站點頁面	47
後端	API 端點	205+
	業務模組	23
	資料表	49
	自動排程	5

B.2 業務能力

類別	項目	數值
遊戲	遊戲類型	8 種
	遊戲供應商	2+ 家（可擴充）
金流	支付方式	3 種（ATM/信用卡/加密）
	金流精度	小數 6 位
	匯率精度	小數 10 位
VIP	等級數量	每站自訂（無上限）
	返水結算	每日自動
	遊戲類型	8 種各自獨立比例
代理	代理層數	最多 3 層
	代理等級	4 級
	推廣碼數量	每人最多 10 個
	費率矩陣	96 筆（4 等級 x 3 層 x 8 類型）
活動	內容語系	5 種
	條件類型	存款/VIP/首存
任務	週期類型	每日/每週/每月
	任務類型	存款任務 + 投注任務
風控	黑名單類型	IP / 遊戲
	追蹤方式	IP + 裝置指紋
客服	管道數量	8 種
	即時客服	LiveChat 支援
報表	報表類型	7 種
	匯出格式	CSV

B.3 安全規格

類別	項目	規格
認證	前台 Token	JWT（7 天有效）
	後台 Token	AdminJWT（獨立金鑰）
	2FA	Google Authenticator TOTP
	三方登入	Google / Telegram
授權	權限模組	16 個
	權限操作	讀取 + 寫入
	群組類型	4 種（root/super_admin/general_admin/custom）
稽核	操作日誌	全部後台操作
	記錄項目	操作人/時間/IP/UA/內容
風控	IP 控制	黑名單 + 白名單
	裝置追蹤	FingerprintJS v5
	強制登出	tokenVersion 機制

B.4 技術規格

類別	項目	技術/版本
前台	框架	Nuxt 4.2 (Vue 3.5)
	語言	TypeScript
	UI 框架	Nuxt UI v4 + Tailwind CSS
	狀態管理	Pinia
	驗證	Zod v4
	測試	Vitest + Playwright
後台	框架	Next.js 16.1 (React 19.2)
	語言	TypeScript
	UI 框架	shadcn/ui + Tailwind CSS v4
	狀態管理	TanStack Query v5 + Zustand v5
	認證	NextAuth 5 beta
	圖表	Recharts v3
	編輯器	Tiptap v3
後端	框架	NestJS v11
	語言	TypeScript 5.7 (strict)
	資料庫	MySQL (utf8mb4, TZ +08:00)
	ORM	TypeORM 0.3.28
	快取	Redis (@keyv/redis)
	排程	@nestjs/schedule (Cron)
	API 文件	Swagger UI
基礎設施	檔案儲存	Cloudflare R2
	郵件	Resend API
	簡訊	Twilio
	匯率	台灣銀行即時匯率

B.5 資料表清單（49 張）

編號	分類	資料表名稱	說明
1	用戶	auth-user	前台用戶主表
2	用戶	auth-user-login-log	用戶登入日誌
3	金流	vendor-group	金流群組
4	金流	vendor-channel	金流通道
5	金流	vendor-group-channel	群組通道關聯
6	金流	deposit-order	存款訂單
7	錢包	bank-card	銀行卡
8	錢包	credit-card	信用卡
9	錢包	crypto-address	加密貨幣地址
10	遊戲	game-provider	遊戲供應商（含 siteCode）
11	遊戲	game-type-config	遊戲類型配置（含 siteCode）
12	遊戲	game-transaction	遊戲交易紀錄
13	遊戲	game-play-log	遊戲遊玩紀錄
14	遊戲	bet-order	投注訂單
15	遊戲	bet-detail	投注明細
16	VIP	vip-level	VIP 等級配置（含 siteCode）
17	VIP	vip-rebate	VIP 反水規則（含 siteCode）
18	VIP	vip-rebate-log	VIP 反水發放日誌
19	活動	promo	優惠活動
20	活動	promo-claim	活動領取紀錄
21	活動	promo-tag	活動標籤
22	排行	rank-list	排行榜
23	代理	affiliate-commission	代理佣金
24	代理	affiliate-settlement	代理結算紀錄
25	代理	affiliate-balance	代理餘額
26	代理	affiliate-withdrawal	代理提款
27	代理	affiliate-click	推廣連結點擊
28	代理	affiliate-bind-log	綁定紀錄
29	代理	affiliate-risk-log	風控檢測紀錄
30	聯盟	alliance-commission-rate	聯盟佣金費率
31	聯盟	alliance-agent-tier	代理等級配置
32	聯盟	alliance-vip-milestone	VIP 里程碑
33	聯盟	alliance-vip-milestone-log	VIP 里程碑日誌
34	聯盟	alliance-referral-code	推廣碼
35	站內信	notification	通知訊息
36	站內信	notification-read	已讀紀錄
37	站點	site-config	站點配置
38	站點	site-theme	站點主題
39	提領	withdrawal-order	提領訂單
40	任務	mission	任務定義
41	任務	mission-progress	任務進度
42	任務	mission-claim	任務領取
43	風控	risk-ip-rule	IP 黑白名單規則
44	風控	risk-game-blacklist	遊戲黑名單
45	後台	admin-user	管理員帳號
46	後台	admin-group	權限群組
47	後台	admin-operation-log	操作紀錄
48	儲存	r2-operation-log	R2 檔案操作日誌
49	排行	rank-list	排行榜紀錄

附錄 C：後台 68 頁功能詳細說明

本附錄逐一說明後台管理系統（c9-ims）所有 68 個頁面的詳細功能，方便讀者了解每個頁面能做什麼。

C.1 儀表板模組（1 頁）

頁面：儀表板首頁

項目	說明
路徑	/dashboard
權限	所有已登入管理員
多站點	規劃中

功能描述：儀表板是管理員登入後看到的第一個頁面，提供平台營運狀況的快速概覽。主要包含：

今日關鍵指標卡片（存款額、提款額、新註冊數、在線人數）
近期趨勢圖表
快捷入口（存款審核、提款審核、新玩家等待處理項目）
系統公告區域

C.2 系統管理模組（15 頁）

頁面：管理員列表

項目	說明
路徑	/system/admins
權限	admin:read
多站點	否（全站共用）

功能描述：列出所有後台管理員帳號，包含帳號名稱、所屬群組、建立時間、最後登入時間等資訊。支援搜尋和篩選。root 群組的管理員可在此新增、編輯、刪除其他管理員。

頁面：管理員新增/編輯

項目	說明
路徑	/system/admins/create、/system/admins/[id]/edit
權限	admin:write
多站點	否

功能描述：建立或修改管理員帳號。需填寫帳號、密碼、指派權限群組。編輯時可變更密碼、調整群組。

頁面：群組列表

項目	說明
路徑	/system/groups
權限	admin-group:read
多站點	否（全站共用）

功能描述：列出所有權限群組，顯示群組名稱、類型（root/super_admin/general_admin/custom）、管理員數量。可在此管理群組的建立與刪除。

頁面：群組新增/編輯

項目	說明
路徑	/system/groups/create、/system/groups/[id]/edit
權限	admin-group:write
多站點	否

功能描述：建立或修改權限群組。核心操作是勾選 16 個權限模組中，該群組被授予讀取和/或寫入權限的項目。提供 16 x 2 的權限矩陣勾選介面。

頁面：操作紀錄

項目	說明
路徑	/system/logs
權限	admin-log:read
多站點	否（全站共用）

功能描述：所有後台管理員操作的完整審計日誌。每條紀錄包含：操作人、操作時間、操作類型、目標資源、IP 地址、瀏覽器/作業系統資訊。支援關鍵字搜尋和日期範圍篩選。

頁面：站點基本設定

項目	說明
路徑	/system/site-config
權限	site-config:read / site-config:write
多站點	管理所有站點的基本設定

功能描述：管理所有站點的基本配置，包含：站點名稱、站點代碼、功能開關（13 項）、支援語系、幣別、時區等。可在此新增新站點或修改現有站點的基本設定。

頁面：客服配置

項目	說明
路徑	/system/site-customer-service
權限	site-config:write
多站點	是（模式 B，每站獨立設定）

功能描述：設定各站點的客服管道。每個站點可獨立配置 8 種客服管道（Line/Telegram/微信/Facebook/Instagram/Twitter/Discord/自訂），每個管道可設定多語系名稱、圖示、連結、排序、啟用狀態。另外可配置 LiveChat 嵌入腳本。支援「同預設站點」一鍵複製功能。

頁面：域名設置

項目	說明
路徑	/system/site-domains
權限	site-config:write
多站點	是（模式 B）

功能描述：管理各站點的域名綁定與品牌素材。包含：域名設定、大 Logo 上傳、小 Logo 上傳、Favicon 上傳、吉祥物管理。所有圖片上傳至 Cloudflare R2 雲端儲存。

頁面：遊戲商配置

項目	說明
路徑	/system/site-game-providers
權限	site-config:write
多站點	是（模式 B）

功能描述：設定各站點開放哪些遊戲供應商及其相關參數。支援「同預設站點」複製。

頁面：三方登入配置

項目	說明
路徑	/system/site-oauth
權限	site-config:write
多站點	是（模式 B）

功能描述：設定各站點的 Google OAuth 和 Telegram 登入的 Client ID、Secret 等參數。支援「同預設站點」複製。

頁面：服務商配置

項目	說明
路徑	/system/site-service-providers
權限	site-config:write
多站點	是（模式 B）

功能描述：設定各站點使用的第三方服務商（金流、簡訊等）的連線參數。支援「同預設站點」複製。

頁面：雲端儲存

項目	說明
路徑	/system/cloud-storage
權限	admin:read
多站點	是

功能描述： Cloudflare R2 雲端檔案管理介面，提供類似檔案總管的操作體驗。支援：上傳檔案、刪除檔案、移動檔案、建立資料夾、刪除資料夾。所有操作都會記錄到操作日誌。

頁面：雲端儲存日誌

項目	說明
路徑	/system/cloud-storage-logs
權限	admin:read
多站點	是

功能描述： R2 雲端儲存的所有操作紀錄，包含：操作類型（上傳/刪除）、檔案路徑、操作人、時間、檔案類型（mimeType）、作業系統、瀏覽器資訊。支援詳情彈窗查看完整資訊。

C.3 佈局配置模組（3 頁）

頁面：底部導航列

項目	說明
路徑	/system/layout-bottom-bar
權限	site-config:write
多站點	是（模式 B）

功能描述：配置前台手機版底部的 Tab 導航列項目。可設定每個 Tab 的圖示、文字（多語系）、連結目標、排序順序、是否顯示。

頁面：頁尾配置

項目	說明
路徑	/system/layout-footer
權限	site-config:write
多站點	是（模式 B）

功能描述：配置前台頁尾區域的內容，包含：版權文字、連結列表、合作夥伴 Logo 等。

頁面：了解更多

項目	說明
路徑	/system/layout-learn-more
權限	site-config:write
多站點	是（模式 B）

功能描述：配置前台「了解更多」區塊的內容與佈局。

C.4 玩家管理模組（7 頁）

頁面：全部玩家

項目	說明
路徑	/players/all
權限	user:read
多站點	是

功能描述：平台所有前台玩家的完整列表。顯示帳號、暱稱、VIP 等級、餘額、註冊時間、最後登入時間、狀態等資訊。支援多欄位篩選：關鍵字搜尋、VIP 等級下拉（動態取得，不限數量）、日期範圍。VIP 等級下拉選項會自動依照當前站點的 VIP 配置動態產生。

頁面：新註冊玩家

項目	說明
路徑	/players/new-registrations
權限	user:read
多站點	是

功能描述：顯示近期新註冊的玩家列表，幫助營運人員快速追蹤新用戶成長。支援篩選和日期範圍。

頁面：線上玩家

項目	說明
路徑	/players/online
權限	user:read
多站點	是

功能描述：即時顯示當前在線的玩家列表，包含最後活動時間、正在遊玩的遊戲等資訊。

頁面：登入失敗紀錄

項目	說明
路徑	/players/login-failures
權限	risk:read
多站點	是

功能描述：記錄所有登入失敗的嘗試，包含：嘗試的帳號、IP 地址、時間、失敗原因。可用於偵測暴力破解攻擊。支援關鍵字搜尋和日期範圍篩選。

頁面：玩家標籤

項目	說明
路徑	/players/tags
權限	user:write
多站點	規劃中

功能描述：管理玩家標籤系統，可建立自訂標籤（如：活躍、高風險、VIP 重點客戶等），並將標籤指派給玩家。

頁面：玩家詳情

項目	說明
路徑	/players/[id]
權限	user:read
多站點	否（依玩家所屬站點）

功能描述：單一玩家的完整詳情頁面，包含個人資料、帳號狀態、VIP 等級、餘額、交易歷史、投注紀錄、存提款紀錄、登入紀錄、綁定的錢包/銀行卡等所有相關資訊。

頁面：遊戲重新註冊

項目	說明
路徑	/players/game-reregistration
權限	user:write
多站點	規劃中

功能描述：當玩家的遊戲商帳號出現異常時，可在此重新註冊玩家的遊戲商帳號。

C.5 活動管理模組（4 頁）

頁面：優惠活動列表

項目	說明
路徑	/activity/promos
權限	promo:read
多站點	是

功能描述：所有優惠活動的管理列表。顯示活動標題、狀態（上架/下架）、時間範圍、參與人數等。可在此上架、下架、編輯、刪除活動。

頁面：活動新增/編輯

項目	說明
路徑	/activity/promos/create、/activity/promos/[id]/edit
權限	promo:write
多站點	否（由列表頁帶入 siteCode）

功能描述：建立或修改優惠活動。核心功能：

多語系富文本內容編輯（5 種語言各一份 HTML 內容）
活動圖片上傳
參與條件設定（存款金額門檻、VIP 等級門檻、首存限定等）
打碼量設定（領取獎勵後需完成的投注倍數）
時間範圍設定（開始/結束日期）
標籤分類

頁面：活動標籤

項目	說明
路徑	/activity/tags
權限	promo-tag:read / promo-tag:write
多站點	是

功能描述：管理活動的分類標籤。可建立新標籤、修改標籤名稱（多語系）、刪除標籤。前台活動中心會依據標籤分類顯示活動。

C.6 財務管理模組詳細說明（7 頁）

頁面：存款審核

項目	說明
路徑	/finance/deposit-review
權限	deposit:read / deposit:write
多站點	是

功能描述：所有存款訂單的管理與審核頁面。每筆訂單顯示：訂單編號、用戶帳號、金額、支付方式、狀態、建立時間。

篩選功能完整：

訂單 ID 搜尋
用戶 ID 搜尋
關鍵字搜尋
支付方式篩選（ATM/信用卡/加密貨幣）
狀態篩選（待處理/已通過/已駁回）
日期範圍篩選

審核操作：

通過：確認入金，餘額自動入帳
駁回：拒絕入金，附帶原因

頁面：存款設定

項目	說明
路徑	/finance/deposit-settings
權限	vendor:read / vendor:write
多站點	是

功能描述：金流群組與通道的配置頁面。管理金流群組（依語系分配）和金流通道（ATM/信用卡/加密貨幣）的啟用狀態、優先順序、限額等設定。

頁面：提領管理

項目	說明
路徑	/finance/withdrawals
權限	withdrawal:read / withdrawal:write
多站點	是

功能描述：所有提領訂單的管理頁面。提領流程為三階段：

待審核 → 審核通過或駁回
已核准 → 財務處理出款 + 上傳匯款憑證
已完成

篩選功能：訂單ID、狀態、用戶ID、關鍵字、網路類型、日期範圍。

頁面：手動調帳

項目	說明
路徑	/finance/adjust-balance
權限	finance:write
多站點	是

功能描述：手動調整玩家餘額的功能。可對指定玩家進行加幣或扣幣操作。每次調帳需填寫原因說明，操作紀錄會被完整記錄。適用於客訴處理、活動補發、系統錯誤更正等場景。

頁面：銀行卡管理

項目	說明
路徑	/finance/bank-cards
權限	finance:read / finance:write
多站點	是

功能描述：管理玩家綁定的銀行卡資訊。顯示：持卡人姓名、銀行名稱、帳號（遮罩顯示）、審核狀態。支援審核通過/駁回。篩選：關鍵字、用戶ID、狀態、銀行代碼、持卡人、日期範圍。

頁面：信用卡管理

項目	說明
路徑	/finance/credit-cards
權限	finance:read / finance:write
多站點	是

功能描述：管理玩家綁定的信用卡資訊。功能與銀行卡管理類似，顯示持卡人、卡號（遮罩）、到期日、審核狀態。篩選：關鍵字、用戶ID、狀態、持卡人、日期範圍。

頁面：加密錢包管理

項目	說明
路徑	/finance/crypto-addresses
權限	finance:read / finance:write
多站點	是

功能描述：管理玩家綁定的加密貨幣錢包地址。顯示：錢包地址、網路類型（TRC20/ERC20）、幣種（USDT）、審核狀態。篩選：關鍵字、用戶ID、狀態、網路、幣種、日期範圍。

C.7 遊戲管理模組詳細說明（2 頁）

頁面：遊戲商管理

項目	說明
路徑	/game/providers
權限	game:read / game:write
多站點	是（含「同預設站點」+ 「帶入模板」）

功能描述：管理各站點的遊戲供應商配置。每個站點可獨立設定開放哪些遊戲商、每個遊戲商的狀態（啟用/停用）、排序順序等。

特殊功能：

「帶入模板」：預覽預設模板內容 → 可編輯調整 → 確認後寫入當前站點
「同預設站點」：一鍵將預設站的遊戲商配置複製到目標站點（後端 API 直接寫入資料庫）

頁面：遊戲類型設定

項目	說明
路徑	/game/type-configs
權限	game:read / game:write
多站點	是（含「同預設站點」+ 「帶入模板」）

功能描述：管理各站點的 8 種遊戲類型的顯示設定。包含：類型名稱（多語系）、圖示、排序順序、是否顯示。同樣支援「帶入模板」和「同預設站點」功能。

C.8 VIP 管理模組詳細說明（4 頁）

頁面：VIP 等級

項目	說明
路徑	/vip/levels
權限	vip:read / vip:write
多站點	是（含「同預設站點」+ 「帶入模板」）

功能描述：管理各站點的 VIP 等級配置。每站獨立設定等級數量（不限）和每個等級的名稱、升級所需投注金額門檻、保級所需投注金額等。

運作原理：

玩家累積投注達到下一等級門檻時自動升級
等級只升不降（除非保級檢查未通過且等級低於 5）
每站可自由新增任意數量的等級

頁面：返水設定

項目	說明
路徑	/vip/rebates
權限	vip:read / vip:write
多站點	是（含「同預設站點」+ 「帶入模板」）

功能描述：設定各站點的 VIP 等級 x 8 遊戲類型的返水比例矩陣。以表格形式展示，行為 VIP 等級，列為遊戲類型，每個交叉格為返水百分比。支援批次修改和儲存。

頁面：VIP 玩家

項目	說明
路徑	/vip/players
權限	vip:read
多站點	是

功能描述：列出所有 VIP 玩家及其等級、升級日期、累積投注等資訊。

頁面：VIP 里程碑

項目	說明
路徑	/vip/milestones
權限	vip:read / vip:write
多站點	是

功能描述：設定 VIP 等級達標的里程碑獎勵。當玩家升級到特定 VIP 等級時，可自動或手動發放獎勵。

C.9 報表模組詳細說明（7 頁）

頁面：總覽報表

項目	說明
路徑	/reports/overview
權限	report:read
多站點	是

功能描述：營運數據的全景概覽。頂部為統計卡片區，顯示選定時間範圍內的存款總額、提款總額、投注總額、損益總額。下方為每日摘要表格，逐日列出各項指標。支援日期範圍篩選。

適合場景：每日晨會、週報、月報的數據來源。

頁面：玩家報表

項目	說明
路徑	/reports/players
權限	report:read
多站點	是

功能描述：以玩家為維度的數據分析報表。篩選條件：關鍵字搜尋、VIP 等級下拉篩選、開始/結束日期。展示各玩家的存款、提款、投注、損益摘要數據。

頁面：玩家簡表

項目	說明
路徑	/reports/player-summary
權限	report:read
多站點	是

功能描述：精簡版的玩家數據摘要，每位玩家一行。支援多維度排序（存款額、投注額、損益等）和排序方向（升序/降序）。方便快速找出高價值或異常玩家。

頁面：遊戲報表

項目	說明
路徑	/reports/games
權限	report:read
多站點	是

功能描述：按遊戲維度的數據分析。可按遊戲類型（8 種）或遊戲平台（供應商）篩選，顯示各遊戲的投注額、派彩額、損益、活躍玩家數等。有助於決定哪些遊戲應加強推廣、哪些應考慮下架。

頁面：投注紀錄

項目	說明
路徑	/reports/bet-records
權限	report:read
多站點	是

功能描述：所有投注的逐筆明細紀錄。每筆紀錄包含：投注時間、玩家帳號、遊戲名稱、遊戲類型、投注金額、派彩金額、結果。支援多維度篩選：關鍵字、遊戲類型、遊戲平台、投注狀態、日期範圍。支援 CSV 匯出。

頁面：損益報表

項目	說明
路徑	/reports/profit-loss
權限	report:read
多站點	是

功能描述：平台損益的時間序列分析報表。支援三種分組方式：按日、按週、按月。可按遊戲類型篩選。展示每個時間區間的投注額、派彩額、損益額、毛利率。適合追蹤營運趨勢和週期性表現。

頁面：活動報表

項目	說明
路徑	/reports/promos
權限	report:read
多站點	規劃中

功能描述：各優惠活動的參與統計報表。展示每個活動的領取人次、發放金額、打碼量完成率等。有助於評估活動效果、優化活動策略。

C.10 風控管理模組詳細說明（3 頁）

頁面：IP 規則

項目	說明
路徑	/risk-control/ip-rules
權限	risk:read / risk:write
多站點	是

功能描述：管理 IP 黑名單與白名單規則。每條規則包含：IP 地址（支援 CIDR 範圍）、類型（黑名單/白名單）、備註說明、建立時間。

篩選功能：

類型篩選（黑名單/白名單）
IP 關鍵字搜尋
日期範圍

操作功能：

新增規則
編輯規則
刪除規則

黑名單效果：該 IP 無法登入、無法存款、無法進入遊戲。白名單效果：允許該 IP 通過所有風控檢查（通常用於辦公室 IP）。

頁面：IP/FP 查詢

項目	說明
路徑	/risk-control/ip-check
權限	risk:read
多站點	是

功能描述：反向查詢工具。輸入 IP 地址或裝置指紋，可查出所有使用過該 IP 或裝置的玩家帳號。搜尋範圍：IP、裝置指紋、帳號、姓名、Email、手機號碼。

應用場景：

偵測多帳號（同一裝置多個帳號）
追蹤可疑行為（同一 IP 異常操作）
客訴處理（查找相關帳號）

頁面：遊戲黑名單

項目	說明
路徑	/risk-control/game-blacklist
權限	risk:read / risk:write
多站點	是

功能描述：管理遊戲黑名單，禁止特定玩家進入特定遊戲。支援三種封鎖粒度：

全封鎖：禁止進入所有遊戲
類型封鎖：禁止進入特定遊戲類型（如只封鎖老虎機）
特定遊戲封鎖：禁止進入某一款遊戲

篩選功能：用戶ID、用戶帳號、遊戲類型、日期範圍。

C.11 代理中心模組詳細說明（8 頁）

頁面：代理列表

項目	說明
路徑	/affiliate/agents
權限	affiliate:read
多站點	是

功能描述：所有代理的管理列表。顯示：代理帳號、等級（銅/銀/金/白金）、下線人數、累積佣金、註冊時間等。可手動綁定用戶成為代理。

頁面：佣金費率

項目	說明
路徑	/affiliate/commission-rates
權限	affiliate:read / affiliate:write
多站點	是

功能描述：管理佣金費率矩陣：4 代理等級 x 3 層級 x 8 遊戲類型 = 96 筆費率設定。以表格形式展示，可批次編輯和儲存。支援「帶入模板」快速設定。

頁面：佣金結算

項目	說明
路徑	/affiliate/settlements
權限	affiliate:read / affiliate:write
多站點	是

功能描述：佣金結算紀錄的管理與審核。每筆結算包含：代理帳號、結算週期、佣金金額、狀態（待審核/已核准/已駁回）、風控檢測結果。可查看每筆結算的風控紀錄詳情。支援手動觸發週結和日結。

頁面：代理提款

項目	說明
路徑	/affiliate/aff-withdrawals
權限	affiliate:read / affiliate:write
多站點	是

功能描述：代理提款申請的管理。三階段流程：待審核 → 核准 → 完成。篩選：狀態、支付方式。

頁面：綁定紀錄

項目	說明
路徑	/affiliate/bind-logs
權限	affiliate:read
多站點	是

功能描述：所有上下線綁定操作的歷史紀錄。顯示：操作類型（自動綁定/手動綁定/解綁）、上線代理、下線用戶、推廣碼、時間。篩選：操作類型、推廣碼、日期範圍。

頁面：代理等級

項目	說明
路徑	/affiliate/agent-tiers
權限	affiliate:read / affiliate:write
多站點	是

功能描述：管理代理等級配置（銅/銀/金/白金）。每個等級可設定名稱、升級條件、權益等。

頁面：VIP 里程碑

項目	說明
路徑	/affiliate/vip-milestones
權限	affiliate:read / affiliate:write
多站點	是

功能描述：設定下線達到 VIP 等級時的里程碑獎勵。例如：下線達到 VIP 3 時，代理可獲得 $10 獎勵。由 VIP 系統在玩家升級時自動觸發發放。

頁面：代理導覽

項目	說明
路徑	/affiliate/agent-tour
權限	affiliate:write
多站點	是（模式 B）

功能描述：配置前台代理推廣頁面的說明內容，包含推廣流程導覽、佣金說明、常見問題等。

附錄 D：前台 20 頁功能詳細說明

本附錄逐一說明前台（c9-ec）所有 20 個頁面的使用者體驗流程。

D.1 首頁

使用者體驗：玩家打開網站後看到的第一個頁面。頂部為品牌 Logo 和導航選單，接著是全幅橫幅輪播（展示最新活動和推廣資訊），下方依序為即時賽事資訊、熱門遊戲推薦區、最新活動看板、吉祥物互動區域。整體設計以吸引玩家注冊和存款為目標。

核心元素：

品牌 Logo（大 Logo / 小 Logo）
橫幅輪播（支援多張輪播圖，後台可配置）
即時賽事區（每 30 分鐘自動更新的體育賽事數據）
熱門遊戲推薦（動態排序，基於人氣）
最新活動看板（鏈接到活動中心）
吉祥物（品牌形象角色，後台可設定）

D.2 遊戲大廳

使用者體驗：遊戲的入口頁面。頂部為 8 種遊戲類型的分類標籤（體育/老虎機/真人/彩票/棋牌/電競/加密/捕魚），點擊可篩選。每種類型下顯示來自不同遊戲商的遊戲列表，以卡片形式展示遊戲縮圖、名稱、遊戲商。

支援搜尋功能，可用遊戲名稱搜尋。支援收藏功能，玩家可將喜愛的遊戲加入收藏夾。

D.3 遊戲頁面

使用者體驗：點擊遊戲卡片後進入的頁面。系統會先檢查風控黑名單（若被封鎖則顯示錯誤提示），通過後嵌入遊戲商的遊戲視窗。遊戲在 iframe 或新視窗中運行。

未登入的玩家可使用「試玩模式」體驗遊戲（不涉及真實金額）。

D.4 活動中心

使用者體驗：展示所有正在進行的優惠活動。頂部為活動分類標籤（由後台設定的活動標籤），可篩選特定類型的活動。每個活動以卡片形式展示，包含活動圖片、標題、簡短描述、時間範圍。點擊可進入活動詳情。

D.5 活動詳情

使用者體驗：展示單一活動的完整內容。包含活動圖片、多語系富文本內容（HTML 渲染）、參與條件說明、獎勵說明、打碼量要求。符合條件的玩家可點擊「參與」或「領取」按鈕。

D.6 聯盟專區

使用者體驗：代理推廣系統的入口頁面。展示代理系統的介紹、佣金說明、等級說明。已成為代理的玩家可在此管理推廣碼、查看下線列表和佣金收益。

D.7 任務中心

使用者體驗：展示所有可完成的任務。分為每日、每週、每月三個標籤頁。每個任務顯示：任務名稱、描述、目標值、當前進度（進度條）、獎勵金額、領取按鈕（達標後啟用）。任務進度會在存款和投注後自動更新。

D.8 存款頁面

使用者體驗：玩家選擇存款方式後進行入金操作。頂部為三種支付方式的標籤頁：

ATM 轉帳：顯示轉帳帳號資訊，玩家完成轉帳後回報
信用卡：導向金流商的信用卡付款頁面
加密貨幣（USDT）：顯示 USDT 接收地址和 QR Code

頁面上顯示即時匯率（台灣銀行即時匯率）和轉換後的金額。

D.9 提領頁面

使用者體驗：玩家申請提領資金。需選擇提領到哪個已綁定的銀行卡/信用卡/加密錢包，輸入提領金額。頁面顯示可提領餘額和打碼量完成狀態（若有未完成的活動打碼量，會提示需先完成）。提交後可在此查看提領紀錄和處理狀態。

D.10 錢包管理

使用者體驗：管理已綁定的支付工具。分為三個標籤頁：

銀行卡：綁定新銀行卡、查看已綁定列表、刪除銀行卡
信用卡：綁定新信用卡、查看已綁定列表、刪除信用卡
加密錢包：綁定新地址、查看已綁定列表、刪除地址

每個工具需經過後台審核才能使用。

D.11 VIP 中心

使用者體驗：展示 VIP 系統的完整資訊。包含：

當前 VIP 等級和升級進度條
所有 VIP 等級的列表與權益說明
各等級的返水比例表（8 種遊戲類型）
距離下一等級還需多少投注量

VIP 等級數量和內容依各站點設定動態顯示（不是固定的）。

D.12 代理中心

使用者體驗：代理的完整管理後台（嵌入在前台中）。功能包含：

下線列表（帳號遮罩顯示，保護隱私）
推廣碼管理（最多 10 個推廣碼）
收益報表（佣金統計、日/週/月報表）
提款功能（申請提款佣金）
等級資訊（當前等級、升級條件）

附錄 E：API 端點分類統計

本附錄整理系統所有 205+ 個 API 端點的分類統計。

E.1 前台 API（142 個端點）

模組	端點數	主要用途	認證要求
Auth	17	註冊、登入、OAuth、2FA、頭像、裝置指紋	部分需要
Game	17	遊戲商列表、啟動遊戲、試玩、S2S 回調、黑名單檢查	部分需要
Wallet	9	銀行卡/信用卡/加密錢包的 CRUD	需要
Vendor	6	金流通道配置、支付回調	部分需要
Deposit	4	存款訂單建立、匯率查詢	需要
Promo	7	活動列表、詳情、領取	部分需要
VIP	13	VIP 等級、返水規則、保級（含批量操作）	需要
Affiliate	51	代理管理、佣金、結算、聯盟、推廣碼	部分需要
Inbox	7	站內信列表、詳情、已讀標記	需要
SiteConfig	8	站點設定、主題查詢	不需要
Withdrawal	7	提領申請、紀錄查詢	需要
Mission	3	任務列表、進度、領取	需要
Common	2	枚舉查詢、健康檢查	不需要
Ranking	2	排行榜	不需要
BetRecord	2	投注紀錄查詢	需要
LiveSports	1	即時賽事數據	不需要

E.2 後台 Admin API（76 個端點）

分類	端點數	主要用途
認證管理	4	管理員登入、註冊、驗證碼
個人資料	4	Profile、Google Auth 2FA
權限	1	取得所有權限清單
管理員 CRUD	5	管理員增刪改查
群組 CRUD	5	權限群組增刪改查
操作紀錄	1	查詢操作紀錄
活動管理	8	活動 + 標籤 CRUD
存款審核	2	列表、審核
用戶管理	3	前台用戶查詢、編輯
餘額調整	1	手動調整餘額
金流群組	1	用戶金流群組分配
銀行卡	5	CRUD + 審核
信用卡	5	CRUD + 審核
加密地址	5	CRUD + 審核
提領	4	列表、審核、憑證、完成
金流商	9	群組 + 通道管理
報表	10	7 種報表 + 匯出 + R2 日誌
IP 規則	4	黑白名單 CRUD
風控其他	4	登入失敗、反查、遊戲黑名單
R2 檔案	6	上傳、刪除、移動、資料夾管理

E.3 遊戲 Admin API（11 個端點）

功能	端點數	說明
遊戲供應商 CRUD	4	列表、新增、更新、刪除
遊戲分類 CRUD	4	列表、新增、更新、刪除
模板功能	2	預覽模板、帶入模板
跨站複製	1	站點間資料複製

E.4 站點設定 Admin API（12 個端點）

功能	端點數	說明
站點 CRUD	4	列表、新增、更新、刪除
主題 CRUD	4	列表、新增、更新、刪除
素材上傳	2	Logo/Favicon、客服圖示
其他	2	吉祥物、客服設定

E.5 代理 Admin API（17 個端點）

功能	端點數	說明
代理管理	2	列表、新增代理
結算管理	3	列表、審核、風控紀錄
提款管理	3	列表、審核、完成
綁定管理	2	手動綁定、綁定紀錄
費率管理	2	佣金費率 CRUD
里程碑	1	VIP 里程碑 CRUD
等級管理	1	代理等級 CRUD
模板功能	2	預覽模板、帶入模板
手動操作	3	設定等級、觸發週結、觸發日結

附錄 F：業務流程圖集

本附錄彙整平台核心業務的完整流程圖。

F.1 玩家註冊流程

  玩家註冊流程
  ============

  方式一：帳號密碼註冊
  +--------+     +--------+     +--------+     +--------+
  | 填寫   | --> | 收到   | --> | 輸入   | --> | 註冊   |
  | 帳號   |     | 驗證碼 |     | 驗證碼 |     | 完成   |
  | 密碼   |     | (Email |     |        |     |        |
  | Email  |     |  /SMS) |     |        |     |        |
  +--------+     +--------+     +--------+     +--------+

  方式二：Google 登入
  +--------+     +--------+     +--------+
  | 點擊   | --> | Google | --> | 自動   |
  | Google |     | 授權   |     | 註冊   |
  | 登入   |     | 頁面   |     | 完成   |
  +--------+     +--------+     +--------+

  方式三：Telegram 登入
  +--------+     +--------+     +--------+
  | 點擊   | --> |Telegram| --> | 自動   |
  | TG     |     | 授權   |     | 註冊   |
  | 登入   |     | 頁面   |     | 完成   |
  +--------+     +--------+     +--------+

  所有方式最終都會：
  - 記錄 IP 地址
  - 記錄裝置指紋 (FingerprintJS)
  - 建立 JWT Token (7天有效)
  - 導向首頁

F.2 存款完整流程

  玩家存款完整流程
  ================

  [玩家]                    [前台]                    [後端]                 [金流商]
    |                         |                         |                      |
    |  選擇存款方式           |                         |                      |
    |------------------------>|                         |                      |
    |                         |  查詢匯率               |                      |
    |                         |------------------------>|                      |
    |                         |  回傳即時匯率            |                      |
    |                         |<------------------------|                      |
    |  顯示匯率，輸入金額     |                         |                      |
    |<------------------------|                         |                      |
    |                         |                         |                      |
    |  確認存款               |                         |                      |
    |------------------------>|  建立存款訂單            |                      |
    |                         |------------------------>|  建立支付請求          |
    |                         |                         |--------------------->|
    |                         |                         |  回傳支付頁面 URL     |
    |                         |                         |<---------------------|
    |                         |  導向支付頁面            |                      |
    |                         |<------------------------|                      |
    |  前往金流商付款          |                         |                      |
    |<------------------------|                         |                      |
    |                         |                         |                      |
    |  完成付款               |                         |                      |
    |---------------------------------------------------+--------------------->|
    |                         |                         |                      |
    |                         |                         |  支付結果回調          |
    |                         |                         |<---------------------|
    |                         |                         |                      |
    |                         |                         |  更新訂單狀態         |
    |                         |                         |  (待後台審核)         |
    |                         |                         |                      |

  [後台管理員]
    |
    |  審核存款訂單
    |  - 通過 → 餘額入帳
    |          → 存款任務進度更新
    |          → 活動條件檢查
    |  - 駁回 → 通知玩家

F.3 提領完整流程

  玩家提領完整流程
  ================

  階段 1：玩家提交
  +--------+     +--------+     +--------+     +--------+
  | 檢查   | --> | 選擇   | --> | 輸入   | --> | 提交   |
  | 打碼量 |     | 提領   |     | 提領   |     | 申請   |
  | 是否   |     | 錢包   |     | 金額   |     |        |
  | 達標   |     |        |     |        |     |        |
  +--------+     +--------+     +--------+     +--------+
       |
       | 未達標
       v
  +--------+
  | 提示   |
  | 需完成 |
  | 打碼量 |
  +--------+

  階段 2：後台審核
  +--------+     +--------+
  | 管理員 | --> | 通過   | --> 進入階段 3
  | 審核   |     |--------|
  |        |     | 駁回   | --> 通知玩家，退回餘額
  +--------+     +--------+

  階段 3：財務處理
  +--------+     +--------+     +--------+
  | 財務   | --> | 上傳   | --> | 標記   |
  | 出款   |     | 匯款   |     | 已完成 |
  |        |     | 憑證   |     |        |
  +--------+     +--------+     +--------+

F.4 代理佣金結算流程

  代理佣金週結流程（每週一 03:00 自動執行）
  ==========================================

  步驟 1：資料收集
  +------------------------------------------+
  | 掃描所有站點的所有代理                    |
  | 計算上週下線的投注金額                    |
  | 依代理等級 x 遊戲類型查表佣金費率         |
  +------------------------------------------+
              |
              v
  步驟 2：佣金計算
  +------------------------------------------+
  | 一級代理佣金 = 直屬下線投注 x 一級費率    |
  | 二級代理佣金 = 二級下線投注 x 二級費率    |
  | 三級代理佣金 = 三級下線投注 x 三級費率    |
  +------------------------------------------+
              |
              v
  步驟 3：風控檢測
  +------------------------------------------+
  | 檢查是否有異常下線行為：                  |
  | - 下線集中投注                            |
  | - 異常投注模式                            |
  | - 疑似刷佣金行為                          |
  +------------------------------------------+
              |
              +--- 異常 ---> 標記風控警告，人工審核
              |
              | 正常
              v
  步驟 4：建立結算紀錄
  +------------------------------------------+
  | 建立結算紀錄（狀態：待審核）              |
  | 等待後台管理員審核                        |
  +------------------------------------------+
              |
              v
  步驟 5：審核與發放
  +------------------------------------------+
  | 管理員審核 → 通過：佣金入帳代理餘額       |
  |            → 駁回：附帶原因，不發放        |
  +------------------------------------------+

F.5 VIP 反水結算流程

  VIP 每日反水結算（每日 00:05 自動執行）
  ========================================

  +------------------------------------------+
  | 1. 掃描所有站點                           |
  +------------------------------------------+
              |
              v (對每個站點)
  +------------------------------------------+
  | 2. 取得該站的 VIP 等級配置和返水規則       |
  +------------------------------------------+
              |
              v
  +------------------------------------------+
  | 3. 掃描該站所有有投注紀錄的玩家            |
  +------------------------------------------+
              |
              v (對每個玩家)
  +------------------------------------------+
  | 4. 查詢玩家的 VIP 等級                    |
  +------------------------------------------+
              |
              v
  +------------------------------------------+
  | 5. 計算昨日各遊戲類型的投注金額            |
  |    - 體育投注: $X1                        |
  |    - 老虎機投注: $X2                      |
  |    - 真人投注: $X3                        |
  |    - ... (8 種類型)                       |
  +------------------------------------------+
              |
              v
  +------------------------------------------+
  | 6. 查表返水比例，計算返水金額              |
  |    反水 = X1 * R1 + X2 * R2 + ... + X8*R8|
  |    (R = 該 VIP 等級該遊戲類型的返水比例)   |
  +------------------------------------------+
              |
              v
  +------------------------------------------+
  | 7. 返水金額 > 0 → 自動入帳玩家餘額        |
  |    記錄返水日誌                            |
  +------------------------------------------+

附錄 G：商戶上線檢查清單

新商戶（站點）上線時，依照以下檢查清單確認所有設定完成。

G.1 基本設定

序號	項目	檢查點	負責人
1	站點代碼	確認 siteCode 唯一且有意義	PM
2	站點名稱	確認品牌名稱正確	PM
3	域名	確認域名已購買並指向伺服器	DevOps
4	SSL 憑證	確認 HTTPS 正常運作	DevOps
5	功能開關	確認 13 項功能開關設定正確	PM
6	支援語系	確認開放哪些語系	PM

G.2 品牌設定

序號	項目	檢查點	負責人
7	大 Logo	已上傳至 R2	設計
8	小 Logo	已上傳至 R2	設計
9	Favicon	已上傳至 R2	設計
10	吉祥物	已設定（若需要）	設計
11	主題配色	已選擇或自訂主題	設計

G.3 遊戲設定

序號	項目	檢查點	負責人
12	遊戲商配置	已設定開放哪些遊戲商	營運
13	遊戲類型	已設定 8 種類型的顯示和排序	營運
14	遊戲測試	各遊戲類型至少測試一款遊戲	QA

G.4 金流設定

序號	項目	檢查點	負責人
15	金流通道	已配置至少一個存款通道	營運
16	金流群組	已設定語系分配規則	營運
17	存款測試	各支付方式至少測試一次	QA
18	提領測試	提領流程完整測試	QA

G.5 VIP 設定

序號	項目	檢查點	負責人
19	VIP 等級	已設定等級數量和升級門檻	營運
20	返水比例	已設定等級 x 遊戲類型的返水矩陣	營運
21	保級規則	已確認保級門檻設定	營運

G.6 代理設定

序號	項目	檢查點	負責人
22	代理等級	已設定 4 個等級配置	營運
23	佣金費率	已設定 96 筆費率矩陣	營運
24	里程碑	已設定 VIP 里程碑獎勵（若需要）	營運

G.7 客服設定

序號	項目	檢查點	負責人
25	客服管道	已設定至少一個客服管道	營運
26	管道圖示	已上傳各管道圖示	設計
27	LiveChat	已確認是否啟用	營運

G.8 認證設定

序號	項目	檢查點	負責人
28	三方登入	Google/Telegram OAuth 已設定	後端
29	管理員帳號	已為商戶建立管理員帳號	PM
30	權限群組	已為商戶建立對應的權限群組	PM

文件結束
如有任何問題或需要更詳細的說明，請聯繫技術團隊。
C9 Platform — 一套系統，無限可能。

C9 Platform — 營運總覽 ​

目錄 ​

第 1 章：平台概述 ​

1.1 什麼是 C9 Platform？ ​

1.2 平台三大組成 ​

1.3 系統架構圖 ​

1.4 關鍵數字總覽 ​

1.5 商業模式 ​

第 2 章：核心能力 ​

2.1 白牌架構（一套系統，無限品牌） ​

2.2 多站點管理（統一後台，切換自如） ​

2.3 多語系（五語覆蓋亞洲核心市場） ​

2.4 主題客製化（每站獨立品牌形象） ​

2.5 功能開關（彈性控制各站功能） ​

第 3 章：功能全景圖 ​

3.1 前台功能（玩家端）— 20 個頁面 ​

3.2 後台功能（管理端）— 68 個頁面 ​

儀表板（1 頁） ​

系統管理（15 頁） ​

佈局配置（3 頁） ​

玩家管理（7 頁） ​

活動管理（4 頁） ​

站內信（2 頁） ​

財務管理（7 頁） ​

遊戲管理（2 頁） ​

VIP 管理（4 頁） ​

報表（7 頁） ​

風控管理（3 頁） ​

代理中心（8 頁） ​

用戶管理（4 頁） ​

認證（1 頁） ​

3.3 後端能力 — 205+ 個 API、23 個模組、49 張資料表 ​

第 4 章：業務模組摘要 ​

4.1 遊戲系統 ​

4.2 金流系統 ​

4.3 VIP 系統 ​

4.4 代理推廣系統 ​

4.5 任務系統 ​

4.6 活動系統 ​

4.7 風控系統 ​

4.8 站內信系統 ​

4.9 客服系統 ​

4.10 KYC 身份驗證 ​

第 5 章：運營數據能力 ​

5.1 七大報表類型 ​

報表一：總覽報表 ​

報表二：玩家報表 ​

報表三：玩家簡表 ​

報表四：遊戲報表 ​

報表五：投注紀錄 ​

報表六：損益報表 ​

報表七：活動報表 ​

5.2 其他數據能力 ​

5.3 數據監控示意 ​

第 6 章：安全性 ​

6.1 安全架構總覽 ​

6.2 雙重 JWT 認證 ​

6.3 RBAC 權限控制 ​

6.4 雙因素認證（2FA） ​

6.5 操作稽核 ​

6.6 裝置指紋 ​

6.7 強制登出機制 ​

第 7 章：擴展性 ​

7.1 新增站點 ​

7.2 新增遊戲供應商 ​

7.3 新增金流供應商 ​

7.4 新增語系 ​

7.5 新增佈局版本 ​

7.6 擴展性總結 ​

第 8 章：技術棧概覽（非技術語言） ​

8.1 前台技術 ​

8.2 後台技術 ​

8.3 後端技術 ​

8.4 技術選型原則 ​

第 9 章：團隊配置建議 ​

9.1 建議團隊規模 ​

9.2 團隊結構建議 ​

9.3 各階段人力需求 ​

9.4 技能需求 ​

第 10 章：部署與維運 ​

C9 Platform — 營運總覽

目錄

第 1 章：平台概述

1.1 什麼是 C9 Platform？

1.2 平台三大組成

1.3 系統架構圖

1.4 關鍵數字總覽

1.5 商業模式

第 2 章：核心能力

2.1 白牌架構（一套系統，無限品牌）

2.2 多站點管理（統一後台，切換自如）

2.3 多語系（五語覆蓋亞洲核心市場）

2.4 主題客製化（每站獨立品牌形象）

2.5 功能開關（彈性控制各站功能）

第 3 章：功能全景圖

3.1 前台功能（玩家端）— 20 個頁面

3.2 後台功能（管理端）— 68 個頁面

儀表板（1 頁）

系統管理（15 頁）

佈局配置（3 頁）

玩家管理（7 頁）

活動管理（4 頁）

站內信（2 頁）

財務管理（7 頁）

遊戲管理（2 頁）

VIP 管理（4 頁）

報表（7 頁）

風控管理（3 頁）

代理中心（8 頁）

用戶管理（4 頁）

認證（1 頁）

3.3 後端能力 — 205+ 個 API、23 個模組、49 張資料表

第 4 章：業務模組摘要

4.1 遊戲系統

4.2 金流系統

4.3 VIP 系統

4.4 代理推廣系統

4.5 任務系統

4.6 活動系統

4.7 風控系統

4.8 站內信系統

4.9 客服系統

4.10 KYC 身份驗證

第 5 章：運營數據能力

5.1 七大報表類型

報表一：總覽報表

報表二：玩家報表

報表三：玩家簡表

報表四：遊戲報表

報表五：投注紀錄

報表六：損益報表

報表七：活動報表

5.2 其他數據能力

5.3 數據監控示意

第 6 章：安全性

6.1 安全架構總覽

6.2 雙重 JWT 認證

6.3 RBAC 權限控制

6.4 雙因素認證（2FA）

6.5 操作稽核

6.6 裝置指紋

6.7 強制登出機制

第 7 章：擴展性

7.1 新增站點

7.2 新增遊戲供應商

7.3 新增金流供應商

7.4 新增語系

7.5 新增佈局版本

7.6 擴展性總結

第 8 章：技術棧概覽（非技術語言）

8.1 前台技術

8.2 後台技術

8.3 後端技術

8.4 技術選型原則

第 9 章：團隊配置建議

9.1 建議團隊規模

9.2 團隊結構建議

9.3 各階段人力需求

9.4 技能需求

第 10 章：部署與維運