【專案｜單層分潤系統】
2026-10-18 交接卡補錄｜README_備份_20261018.md
#### 【有效技巧】
- 技術棧選用 better-sqlite3 單檔資料庫（fission.db），免裝資料庫伺服器；前端 public/index.html＋admin.html 皆原生 JS、零建置步驟，一台 Windows 機就能跑完整會員＋後台。
- DEV_MODE=true 時自動 seed 示範資料（AI 課程＋會員 A→B→C），前台可一鍵切「小美/小明/小華」示範帳號，開發免打金流就能跑流程。
- 獎勵狀態機刻意設計成「買家付款→pending（due_at=成交日+10天退貨期）→過期且訂單有效→ready→推薦人選購物金(立即入錢包)/點數卡(後台登記卡號)→fulfilled」；到期處理服務啟動跑一次後每小時自動，另可
npm run due 或後台按鈕手動補跑。 - 合規上直接用「單層、僅直接推薦、金額固定 NT$3,000、退貨期後才發、購物金不可提现不找零」把系統釘死在台灣《多層次傳銷管理法》單層聯盟行銷免報備界線內。
- webhook 安全設計：僅在金鑰齊全且驗證 CheckMacValue 後才更新訂單，避免偽造回呼。
- 後台「獎勵發放」可匯出 CSV 台帳（誰/何時/哪筆/卡號），做為點數卡準貨幣來源與稅務申報憑證。
#### 【踩坑／避開的錯誤】
- 金流 webhook 絕不可在未驗證 CheckMacValue 下信任回呼更新訂單，否則可被偽造成付款成功。
- 一旦把計酬改成「下線的下線也分潤」（兩層以上）即屬《多層次傳銷管理法》§3 多層次傳銷，須實施前向公平會報備；有「拉夠人回本/入會費為主要對價」話術會落入 §18 變質傳銷（§29 刑責）。改架構前必先確認這條紅線。
- 退貨期內退貨要 void 不發獎勵；若購物金已先行發出，退貨時必須追回/沖正，不能只擋未發的。
- 上線前 .env 的 ADMIN_TOKEN、JWT_SECRET 必改隨機長字串，且正式環境 DEV_MODE=false＋設 HTTPS 與 BASE_URL，否則示範帳號與除錯入口對外開放。
- 綠界/藍新特店、平台、銀行帳戶皆須本人/公司統編註冊驗證，無法由他人代開；信用卡費率約 2.45%–2.75%。
- 點數卡屬準貨幣，來源須合法並留存取得憑證；推薦回饋達稅務申報標準須辦所得申報；數位課程留意消保法退貨/已開始收看之規則。