Web3 社群自動化
管理平台

統一驗證引擎 × 多平台 Adapter × 12 週交付
TelegramDiscordLINE OpenChat
BitgetOKXBybitBinance

📋 Executive Summary

一句話產品

自動化交易所 API 驗證 + 跨平台社群管理，讓 Web3 VIP 社群運營自動化 90% 以上的人力成本。

12
大需求
77
驗收條件
35
任務項目
12
週交付

對標競品 NEX (nexcrypto)，以雙軸 Adapter 架構 + 完整後台，提供更易擴充、更具審計深度的企業級方案。

🎯 問題與機會

目前痛點

  • Web3 VIP 社群手動驗證 API Key 與交易量門檻
  • 跨平台（TG / Discord / LINE）成員狀態不同步
  • VIP 等級升降級需人工巡檢
  • 推薦獎勵計算依賴 Excel / 人工對帳
  • 無審計軌跡 → 合規風險高

市場機會

  • 市場僅 NEX 一家專注此領域
  • NEX 擴充新交易所需原廠開發（慢）
  • 中小型交易所對社群自動化導流有真實需求
  • 三個月即可切入、12 週可收費

👤 使用者畫像

TERMINAL USER
👩‍💻 Affiliate · Anna
痛點：傳統流程要提交交易所 UID 後等人工審核數天，期間無法進群錯過行情。
目標：提交 UID 後快速通過審核、自動加群、能隨時看 VIP 等級與交易量達標進度。
INTERNAL OPERATOR
👨‍💼 Admin · Kenneth
痛點：每天人工審核 UID、Excel 對帳交易量、手動踢人、規則變動要通知所有成員。
目標：設定一次規則全自動執行、異常即時告警、可追溯所有操作。
B2B CUSTOMER
🏢 交易所 BD · Sarah
痛點：要幫 KOL 客製 VIP 流程，每家 IT 人力不足，實作慢。
目標：一個月內接入新交易所、有完整 API 文件、支援品牌客製。

三個 Persona 對應三層生態位：Affiliate（流量）、Admin（運營）、交易所（付費方）。

🎪 產品定位

核心價值主張

“統一驗證引擎 + 多平台 Adapter”— 新增一個交易所或通訊平台只需實作介面，核心邏輯不動。

🔐 安全至上

API Key AES-256-GCM 加密 + 強制 Read-only 權限 + Admin MFA + 不可變 Audit Log

⚡ 即時同步

自建 Member_State_DB，跨平台狀態一致，定期資格重新驗證自動執行

🔌 高擴充

Exchange_Adapter + Platform_Adapter 雙軸抽象，新增僅需實作介面

🎯 OKR 與成功指標

North Star Metric

月活 Affiliate × 通過驗證率 × 在群率 — 一個指標同時反映獲客、驗證品質、留存。

指標BaselineQ2 目標Q4 目標
簽約交易所038
月活 Affiliate05003,000
驗證通過率—≥ 85%≥ 92%
驗證平均耗時—< 15 秒< 8 秒
系統可用性（SLA）—99.5%99.9%
年經常性營收（ARR）$0$60K$300K
Admin 人工介入次數 / 週100+< 10< 3

📐 範圍與非範圍

✅ In-Scope（12 週內）

  • 3 平台（TG / Discord / LINE OpenChat）Adapter
  • 3 交易所（Bitget / OKX / Bybit）Adapter
  • 統一 Verifier + Rule Engine + BullMQ Worker
  • Affiliate Dashboard + Admin Dashboard
  • VIP 等級自動升降級
  • 推薦獎勵追蹤與計算
  • 完整 Audit Log + MFA
  • 多語系（ZH / EN / JA）

⛔ Out-of-Scope（本期不做）

  • Binance 交易所 Adapter（留 v1.1 做）
  • KYC 本身（由交易所提供，我們取結果）
  • 自動提幣/下單（僅 Read-only，永不碰資金）
  • Web3 錢包驗證（僅交易所 API）
  • 原生 App（Web 響應式為主）
  • NFT / 代幣空投功能
  • 社群內容自動化（非本產品範疇）

**明確寫下「不做什麼」= 防止 scope creep 最有效的工具**。上面任何項目要列為 v1.1，需重新評估容量。

🧭 Affiliate 用戶旅程

1
收到推薦連結
透過 KOL / 交易所活動連結進入 Dashboard
2
提交交易所 UID
填寫 Bitget UID（無需 API Key，安全零風險）
3
自動 / 半自動審核
系統比對交易所回傳的綁定關係 + 交易量門檻，異常案件 Admin 介入
4
加入 TG 群
通過 → Bot 自動邀請入群、賦 VIP 角色
5
定期再驗
每週自動重新驗證交易量、升降級
6
推薦獎勵
推薦新人 → 自動計算並顯示累積獎金

異常分支

• UID 未正確綁定推薦碼 → 提示重新綁定流程
• 交易量不足 → 顯示「還差 $X 達標」+ 引導
• 定期重驗失敗 → 3 天寬限期 + 提醒，第 4 天自動移出

🏗️ 雙軸 Adapter 架構

Layer 1 · 用戶介面
Affiliate Dashboard終端用戶
Admin Dashboard管理員後台
▼
Layer 2 · Exchange Adapter（交易所，可水平擴充）
BitgetPhase 1
OKXPhase 2
BybitPhase 3
Binance · …實作介面即可
▼
Layer 3 · 核心引擎（6 大服務）
VerifierUID 驗證
Rule Engine規則比對
Community Manager群組同步
BullMQ Worker非同步任務
Audit Log不可變日誌
Notification節流通知
▼
Layer 4 · Platform Adapter（通訊平台，可水平擴充）
TelegramPhase 1
DiscordPhase 2
LINE OpenChatPhase 3
…實作介面即可

✨ 新增交易所或平台 = 實作 4 個方法介面，不動核心引擎，雙軸獨立演進。

📦 12 大需求清單

#需求Phase
R1交易所 UID 驗證P1
R2驗證規則管理P1
R3通訊平台社群管理P1
R4VIP 等級自動升降級P2
R5定期資格重新驗證P1
R6推薦獎勵追蹤P3
#需求Phase
R7Affiliate DashboardP1
R8Admin DashboardP1
R9通知機制P1
R10安全性與存取控制P1
R11非功能需求P1
R12錯誤恢復P2

所有 AC 遵循 EARS 記號法（WHEN / IF / THEN / SHALL），共 77 條。

🗺️ 三階段路線圖

Phase 1 · Week 1–4 · MVP（Telegram + Bitget）

基礎建設 + Bitget Adapter + TG Bot + Admin Dashboard 核心功能。

交付門檻：Affiliate 可提交 Bitget API → 驗證通過 → 加入 TG 群 → Audit Log 完整。

Phase 2 · Week 5–8 · 擴展（Discord + OKX + VIP）

Discord Bot + OKX Adapter + VIP 等級升降級自動化 + 錯誤恢復（DLQ）。

交付門檻：跨兩平台兩交易所，VIP 分層自動運行，異常可自動恢復。

Phase 3 · Week 9–12 · 亞洲市場 + 商業模式

LINE OpenChat Bot + Bybit Adapter + 推薦獎勵計算 + 多語系。

交付門檻：三平台三交易所，Affiliate 推薦鏈計算完整，可正式簽約客戶。

⚙️ 技術棧

前端

  • Next.js 15（App Router + Server Components）
  • Tailwind + shadcn/ui
  • TanStack Query
  • Vercel

後端

  • Hono on Bun
  • Drizzle ORM + Neon Postgres
  • BullMQ + Upstash Redis
  • Railway

資料模型（11 張表）

  • affiliates（用戶）
  • api_keys（加密儲存）
  • rules / rule_versions
  • verifications（驗證結果快照）
  • platforms / community_groups
  • member_states（自建成員狀態）
  • vip_tiers（等級分層）
  • referrals（推薦關係）
  • audit_logs（不可變日誌）
  • admins（MFA + RBAC）

📅 12 週 Sprint 規劃

SprintWeekGoal關鍵交付
S1W1基礎建設GitHub / CI/CD / DB Schema / 加密工具
S2W2核心後端Bitget Adapter / Admin Auth + MFA
S3W3驗證引擎Rule Engine / Verifier Worker
S4W4Phase 1 上線TG Bot + Phase 1 全功能整合
S5W5擴展起手Discord Adapter / VIP 等級設計
S6W6OKX 串接OKX Adapter / DLQ
S7W7VIP 自動化VIP 升降級 + 緩衝週
S8W8Phase 2 上線Discord Bot + Phase 2 整合
S9W9亞洲市場LINE OpenChat Adapter
S10W10Bybit 串接Bybit Adapter
S11W11商業模式推薦鏈計算 + 多語系
S12W12Phase 3 上線LINE Bot + 全部整合 + GA

👥 團隊配置

Captain · PM

需求定義、Sprint 規劃、風險管理、對外協調、驗收把關

Pixel · 設計

UI/UX 稿、Design System、Figma → Storybook 串接

Stack · 前端

Dashboard 兩後台、Affiliate 流程、元件庫、E2E 測試

Core · 後端

Adapter 架構、Verifier、Worker、安全、DB、審計

每人每週 5 工作天容量。緩衝週 S7 吸收前期延遲，避免末期爆炸。

⚠️ 風險登記簿（Top 5）

#風險影響機率緩解策略
1交易所 API rate limit / 文件不全高中Mock 先行、Adapter 獨立測試、多交易所分攤 quota
2BullMQ + Redis 穩定性高低Upstash 專業版、DLQ 機制、冪等設計
3TG/Discord/LINE 成員狀態漂移中中自建 Member_State_DB、每日對帳 job、異常告警
4Stack 單點滿載（S3 / S7）中高P2 任務可砍、外包 UI 實作、緩衝週吸收
5合規需求變動（KYC / 資料保護）高低Audit Log 保留 1 年以上、API Key 加密可追溯

💰 商業模式 & Go-to-Market

📦 定價結構

🚀 基礎訂閱方案（初階用戶）

單一交易所 × 單一通訊平台 · 標準功能組合 · 月訂閱固定費用，自助開通、適合 KOL 個人或中小型 BD 起步驗證。

🏢 客製化方案（商業客戶 / 交易所）

多平台多交易所 · 白牌 / 自訂 VIP 規則 · 專屬 SLA 與 on-call · 依規模、合約年限、客製深度洽談計價，由 BD 直接對接。

🤝 合作彈性

支援 PoC 試行、年度合約折扣、KOL 推薦分潤；費用結構可改為月費 + Affiliate 階梯抽成的混合模式。

🚀 Go-to-Market 策略

  • Month 1：接洽 3 家目標交易所（Bitget BD / OKX Taiwan / 港台中型 KOL 社群）
  • Month 2：Phase 2 上線 → 1 家簽約（基礎訂閱方案）
  • Month 3：案例曝光 + 跨三平台優勢 → 2-3 家加簽
  • Month 4+：KOL 分潤（5% 首年合約）、Case Study、SEO 白皮書

🎁 差異化優勢

  • 同時支援 Telegram / Discord / LINE OpenChat，跨平台一站式運營
  • Adapter 架構 → 新交易所 7 天可接入（vs NEX 4-6 週）
  • 完整 Audit Log + MFA → 歐日合規友善

✅ 驗收與上線 Checklist

Phase 1 驗收

  • Affiliate 提交 Bitget UID → 驗證通過
  • 自動加入 TG 群組
  • 不合規自動移出
  • Admin 可改規則並即時生效
  • 所有操作有 Audit Log
  • E2E 測試涵蓋 90%+ 路徑

Phase 2 驗收

  • Discord Bot 串接完成、VIP 角色自動指派
  • OKX Adapter 通過 UID 驗證流程
  • VIP 等級自動升降級規則生效
  • BullMQ DLQ 機制與重試策略驗證
  • 跨平台成員狀態每日對帳零落差
  • 異常告警可在 5 分鐘內觸達 on-call

Phase 3 全量上線

  • 三平台三交易所串接完成
  • VIP 自動升降級 72 小時零故障
  • 推薦鏈計算與會計對帳一致
  • 多語系（ZH / EN / JA）覆蓋
  • 合約商業模式 SOP 就緒
  • On-call 輪值 + 告警 SOP

下一步

1. 確認需求規格書（requirements.md · 846 行 / 77 AC）

2. 確認設計文件（design.md · 3395 行）

3. 確認 Sprint 規劃（sprint-plan.md · 468 行）

4. 啟動 Sprint 1 · Week 1

Captain：啟動 kickoff