跳到內容

S4N DONATE SYSTEM 2.0

這份文件描述 S4N DONATE SYSTEM 2.0:營運者登入、外掛管理、疊層事件,以及綠界與歐付寶的信用卡、ATM、超商代碼與超商條碼。

優先順序是安全、美感,然後才是開發容易。核心擁有帳本、付款介面、事件、疊層、外掛密鑰與權限。功能以外掛的形式掛上來。

儀表板、贊助頁與 OBS 提醒使用同一套本機字體:jf open 粉圓 2.1(justfont,SIL OFL 1.1)。檔案在 packages/design-tokens/fonts/,不連外部字型服務。

  • 第一位營運者的初次設定、登入、登出與伺服器端工作階段
  • 外掛市集:簽過名的官方索引、權限確認、安裝與更新。見 外掛市集
  • 外掛頁只負責啟用與密文。一般設定在側欄「外掛」,見 登入、外掛與疊層
  • 測試贊助:送到疊層,不寫入帳本
  • 帳本:待付款、待繳費、已付款、已過期、待人工處理、失敗,可依狀態篩選
  • 贊助頁:綠界與歐付寶的信用卡、ATM 虛擬帳號、超商代碼、超商條碼
  • 贊助提醒:一條 OBS 網址上的共用畫布。範本、顏色、動畫與提示音在外掛設定
  • 目標進度:依帳本已付款計算,經 WebSocket 推到同一張畫布
  • 跑馬燈:純文字,可接最近的贊助,跟其他疊層共用畫布
  • Twitch 聊天疊層:跟贊助提醒放在同一條網址、同一張畫布。伺服器以匿名身分讀取聊天室
  • 型別化事件,含 s4n.donation.test 與付款成功、失敗。事件寫在 PostgreSQL,斷線可以依序號補上
  • 以 S4N_MASTER_KEY 做 AES-256-GCM 的密文儲存
  • 付款回呼 /api/payments/:pluginId/callback。外掛只驗證,核心才寫帳
  • YouTube 聊天連接器(Twitch 已有。下一個來源沿用同一份聊天事件,不必改聊天疊層)
  • 多個 API 實例共用的登入限流(事件紀錄已經在 PostgreSQL,見 事件紀錄)

下一步請看 本機開發,登入與 OBS 見 登入、外掛與疊層,事件怎麼留下來見 事件紀錄,金流見 綠界與歐付寶。放到伺服器見 正式環境 與 CI 與映像。