Documentation Hub
操作文件總覽
HoolyHi直播交友一條龍源碼 完整操作文件。涵蓋四大部分：Flutter App、引流行銷網站、後台管理系統，以及可加購的付費擴充模組。
📱 App
- 首頁：直播秀場 & 語聊房操作
- 配對：左滑右滑 & 陌生語音配對
- 1 對 1 私密視訊 / 語音通話 & 送禮
- 動態牆：發布 & 審核機制說明
- 個人中心：星幣、鑽石、設定
🌐 引流網站
- hoolyhi.com 網站架構說明
- 各頁面區塊功能介紹
- 12 語系切換機制與新增方式
- 詢問表單串接指引
- Google Analytics 追蹤設定
🖥️ 後台管理
- 登入 & 權限管理
- 數據儀表板（即時刷新）
- 用戶 / 主播 / 內容審核
- 直播間 & 語聊房即時監控
- 財務、禮物、工具系統操作
💎 付費擴充功能
- 多人視頻（每人可開小視窗）
- 彈幕遊戲直播
- OBS 直播推流（RTMP）
- 付費解鎖影片 / 圖片內容
- 1 對 1 計時扣點 · 客製化美顏 · 第三方金流
Access Control
登入 & 權限管理
後台使用獨立管理員帳號，與 App 用戶帳號系統分離，確保安全性。
ℹ️管理員帳號由系統初始化時建立，密碼請妥善保管，建議定期更換。若需新增管理員，請透過後端 API 或資料庫直接操作。
登入方式
- 帳號（Email）+ 密碼
- 登入狀態以 JWT Token 維持
- Token 過期自動登出
安全注意事項
- 請勿在公共網路下登入後台
- 建議設定 IP 白名單限制
- 登入記錄可在 Activities 查詢
Dashboard
數據儀表板
提供平台運營數據總覽，支援自訂時間區間，今日數據每 10 秒自動刷新。
⚡選擇「今日」時，在線人數、直播數、語聊房數等即時指標會自動刷新，無需手動重載頁面。
時間區間選擇
今日昨日本週上週本月上月近 3 個月今年自訂區間
統計指標卡片
| 分類 | 指標名稱 | 說明 |
|---|---|---|
| 財務 | 正式環境充值（星幣） | App Store 正式付款累計星幣 |
| 沙盒環境充值（星幣） | 測試環境充值，不計入真實收益 | |
| 正式充值（美元） | 換算後的 USD 金額 | |
| 沙盒充值（美元） | 測試環境 USD 金額 | |
| 禮物總量（星幣） | 所有用戶送出的禮物星幣合計 | |
| 總提現（鑽石） | 主播申請提現的鑽石合計 | |
| 登入 | 在線用戶 即時 | 目前 App 在線人數（今日限定） |
| 總登入次數 | 含重複登入 | |
| 不重複用戶數 | 按 UID 去重 | |
| 新用戶登入 | 首次登入的新注冊用戶 | |
| 新用戶 | 注冊數 | 新建帳號總數 |
| Apple 注冊 | 透過 Sign in with Apple | |
| Google 注冊 | 透過 Google OAuth | |
| 轉換率 | 注冊用戶 / 總登入比例 | |
| 直播 | 直播場次 | 開播次數合計 |
| 當前直播數 即時 | 目前進行中的直播間數量 | |
| 總觀眾數 即時 | 所有直播間觀眾加總 | |
| 平均時長（分） | 每場直播平均持續時間 | |
| 語聊房 | 開房次數 | 建立語聊房總次數 |
| 活躍房間數 即時 | 目前進行中的語聊房數量 | |
| 在線成員數 即時 | 所有語聊房成員加總 | |
| 平均成員數 | 每間語聊房平均人數 |
趨勢圖表
折線趨勢圖
- 可選時間範圍：7 / 30 / 90 / 180 / 365 天
- 顯示：充值金額、禮物量、新用戶數
- 三條折線同圖比較
收益來源圓餅圖
- 充值收益 vs 禮物收益佔比
- 直觀了解平台收益結構
Third-Party Dependencies
第三方依賴
整套系統架構精簡，核心外部依賴僅以下五項。營運方在部署前須自行申請對應帳號與授權，並填入後端 .env 設定檔。
💳 RevenueCat
- 負責 iOS / Android 雙平台 iAP（App 內購）的統一驗證與訂閱管理
- 後端透過 RevenueCat REST API 驗證收據，確認付款成功後再發放星幣
- 需申請帳號並建立 App，取得 API Secret Key
- 官網：app.revenuecat.com
🔥 Firebase
- 提供 Apple / Google 第三方登入（Sign in with Apple / Google OAuth）
- 提供 FCM 推播通知（iOS APNs + Android FCM）
- 需在 Firebase Console 建立專案，下載設定檔（Android 與 iOS）
- 後端需配置 Firebase Admin SDK 金鑰以發送推播
🍎 iOS 開發者帳號
- 用於 App Store 上架、iAP 商品設定（星幣購買方案）
- 需申請 Apple Developer Program（年費 $99 USD）
- iAP 商品 ID 須與 RevenueCat 及後端 IAP_PRODUCTS 設定一致
- Sign in with Apple 的 Service ID / Key 亦在此申請
▶ Google Play 開發者帳號
- 用於 Android APK / AAB 上架 Google Play 商店
- 需申請 Google Play Developer 帳號（一次性費用 $25 USD）
- Google Play Billing 商品 ID 同樣須與 RevenueCat 保持一致
- 可在同一 Google Cloud Project 下啟用 Play Developer API
✨ 美顏 SDK （年繳授權）
- 提供直播 / 通話中的即時美顏、濾鏡、貼圖特效功能
- 採年繳授權模式，授權到期後美顏功能將自動停用
- 授權綁定 Bundle ID（iOS）與 Package Name（Android），換包須重新申請
- 需將 SDK 授權 Key 填入 App 原始碼對應設定位置並重新編譯
☁️ Google Cloud Storage （可替換）
- 用於儲存所有用戶上傳的媒體檔案：頭像、照片、影片、語音、禮物動畫
- 現行實作使用 GCS，以 Service Account JSON 金鑰授權上傳
- 若需替換為 AWS S3、Cloudflare R2 或自架 MinIO，只需修改驅動層，其餘業務邏輯不受影響
- 建議搭配 CDN（如 Cloudflare）加速靜態資源下載速度
📋
部署前準備清單
申請以上帳號後，將對應金鑰填入後端 .env，包含 REVENUECAT_API_KEY、FIREBASE_ADMIN_KEY（JSON 路徑）、GCS_BUCKET 與 GCS Service Account 金鑰路徑。Apple 登入尚需 APPLE_TEAM_ID、APPLE_KEY_ID、APPLE_PRIVATE_KEY。美顏 SDK Key 填入 App 原始碼（非 .env），需重新編譯 App 後生效。
申請以上帳號後，將對應金鑰填入後端 .env，包含 REVENUECAT_API_KEY、FIREBASE_ADMIN_KEY（JSON 路徑）、GCS_BUCKET 與 GCS Service Account 金鑰路徑。Apple 登入尚需 APPLE_TEAM_ID、APPLE_KEY_ID、APPLE_PRIVATE_KEY。美顏 SDK Key 填入 App 原始碼（非 .env），需重新編譯 App 後生效。