什麼算一筆有效訂單

Teachify payment_state = paid。排除三類：

• manual_enrolled —— 教育部數位精進方案的批次授權， 20.0 萬筆、6.3 萬個學校帳號。那是 B2G 授權不是消費行為， 混進來顧客數會膨脹近 3 倍、客單價崩掉。
• 未完成的結帳嘗試（not_paid / failed）—— 同一個人重試會各算一筆。
• 全額退款。部分退款不排除，但金額已從營收扣掉。

顧客怎麼認

• 主鍵是 Teachify user.id，不是 email —— 用 email 當主鍵的話，同一個人換過信箱就會被算成兩個人。 這也是這裡不用後台匯出 CSV 的原因（匯出檔只有 email）。
• 還要 email 格式正確（「寄得出去」是名單的最低門檻）。
• 同一天的多筆訂單算「回來一次」。看板上凡是講「買幾次」——回購率、 RFM 的 F 軸、NES 的新客／主力分界——都是不同購買日數，不是訂單數。 分拆結帳、加購另開一筆，都不是回購行為。實測有 21% 的顧客存在同日多筆， 用訂單數算回購率會虛高約 12 個百分點。「訂單數」與「客單價」仍以筆數計， 那兩個問的是交易本身。

選日期區間會改變什麼

• 所有指標都只用區間內的訂單重算。「顧客數」是區間內有買的人， 不是全站累積會員；一個人在區間外買過三次、區間內只買一次，在這裡就是首購客。
• 回購率會隨區間變短而下降，因為回購需要時間。 不同長度的區間不要直接比大小，要比就比同樣長度的兩段。
• NES 的沉睡天數從區間結束日起算，不是今天。
• 12 個月滾動回購率需要完整的 12 個月窗口落在區間內， 所以選 3 個月會畫不出來 —— 那是刻意的，不是壞掉。

個資

• 這一頁不含任何個資。顧客在資料裡只是一個序號。
• 姓名與 email 只留在本機 crm/data/identity.jsonl（權限 600、已 gitignore）。 要撈名單跑 python3 crm/export_list.py nes S1 或 python3 crm/export_list.py rfm 高頻 近期，輸出到 crm/out/。

重算

source ~/twb-dashboard/.env 之後跑 python3 crm/fetch_payments.py 2023-01-01 <今天>（約 3 分鐘）， 再跑 python3 crm/build.py。程式在 ~/twb-dashboard/crm/， 口徑改動看 analyze.py 與 app.js 的 compute()。