C9 Platform — 專案文件總覽
C9 Entertainment City 線上娛樂城平台 — 白牌架構，包含前台、後台、後端三個子專案
平台簡介
C9 Platform 是一套完整的白牌線上娛樂城解決方案，採用前後端分離的三層架構：
| 專案 | 框架 | 用途 | 規模 |
|---|---|---|---|
| c9-ec (前台) | Nuxt 4.2 (Vue 3.5) | 面向用戶的遊戲平台 | 20 頁面、77 元件、45 composables |
| c9-ims (後台) | Next.js 16 (React 19) | 內部管理系統 | 68 頁面、41 元件、15 hooks |
| c9-be (後端) | NestJS v11 | 核心 API 服務 | 205+ 端點、49 資料表、23 模組 |
核心特色
- 白牌架構：一套系統服務多個商戶站點，每站獨立品牌/主題/配置
- 多站點管理：統一後台管理所有站點，支援站點間配置複製
- 多語系支援：繁體中文、英文、簡體中文、泰語、越南語
- 完整業務模組：遊戲(8類)、金流(3種)、VIP、代理推廣、任務、活動、風控、報表
文件清單
本目錄包含 6 份依角色分類的規格書文件，每份針對不同閱讀對象撰寫：
| # | 文件 | 目標讀者 | 核心價值 | 行數 |
|---|---|---|---|---|
| 1 | PROJECT_SPEC_BOSS.md | 老闆、高層主管、投資人 | 平台能力總覽、商業價值、競爭優勢 | ~3,000 |
| 2 | PROJECT_SPEC_PM.md | 產品經理、專案經理 | 功能全景、業務流程、模組清單 | ~8,000 |
| 3 | PROJECT_SPEC_MERCHANT.md | 商戶（白牌客戶）、商務對接 | 站點開通、配置指南、日常運營 | ~5,000 |
| 4 | PROJECT_SPEC_UI.md | UI 設計師、UX 設計師 | 設計系統、元件庫、色彩規範 | ~5,000 |
| 5 | PROJECT_SPEC_QA.md | QA 工程師、測試人員 | 測試案例、測試流程、驗收標準 | ~8,000 |
| 6 | PROJECT_SPEC_RD.md | 前後端工程師、全端工程師 | 技術架構、API 參考、開發指南 | ~15,000 |
各角色快速導航
老闆 / 高層主管
「這個平台能做什麼？有什麼優勢？怎麼擴展？」
- 第 1 章：平台概述（一頁式總覽）
- 第 2 章：核心能力（白牌、多站點、多語系）
- 第 4 章：業務模組摘要
- 第 7 章：擴展性
產品經理
「平台有哪些功能？業務流程怎麼走？開發到哪了？」
- 第 2 章：功能模組清單（完整功能列表與狀態）
- 第 3-4 章：前台/後台功能規格（88 頁面逐一說明）
- 第 5 章：業務流程圖（8 個核心流程）
- 第 9 章：API 端點總覽
商戶
「我要怎麼開一個自己的站點？怎麼配置？怎麼運營？」
- 第 2 章：站點開通流程（8 步驟）
- 第 3 章：後台操作手冊
- 第 4-12 章：各業務模組配置指南
- 第 14 章：常見問題 FAQ
UI/UX 設計師
「設計系統怎麼定義？有哪些元件可用？色彩怎麼管理？」
- 第 2 章：色彩系統（前台 6 主題 + 後台 OKLCH）
- 第 5-6 章：前台/後台元件庫（118 元件）
- 第 7 章：頁面佈局規範
- 第 8-9 章：表單/表格規範
QA 測試人員
「有哪些功能要測？測試案例怎麼寫？怎麼驗收？」
- 第 2 章：前台測試案例（15 個測試模組）
- 第 3 章：後台測試案例（68 頁面逐頁）
- 第 4 章：後端 API 測試案例（205+ 端點）
- 第 5 章：業務流程端對端測試
工程師
「架構怎麼設計？程式碼怎麼寫？API 怎麼串？」
- 第 2 章：開發環境建置
- 第 3 章：前台技術規格（Nuxt 4.2）
- 第 4 章：後台技術規格（Next.js 16）
- 第 5 章：後端技術規格（NestJS v11）
- 第 6 章：跨專案整合
文件維護
- 文件版本隨程式碼同步更新
- 新增功能時，相關角色的文件都需同步更新
- 文件使用 Markdown 格式，可直接在 GitHub 上預覽
最後更新：2026-03-01