舊帳收款

又稱：legacy_debt · 歷史欠款補收

客戶在系統上線前累積的舊欠款收回紀錄；計入收款流水但**不計入業績**——避免店家用「補登歷史欠款」灌虛業績。

完整定義

舊帳收款（Legacy Debt Payment）指美業棧使用前客戶就積欠的歷史款項。例如店家紙本記帳時客戶欠 NT$5,000，上系統後想記錄這筆還款，但因服務本身發生在系統外、無對應 treatment 紀錄，所以不應算進「上線後業績」。系統設計上特別把這類紀錄標記 `serviceType: 'legacy_debt'` 與 `awardsPerformance: false`，從業績計算源頭排除。

為什麼存在這個概念

系統剛上線時很多店家有未結算的舊欠款。如果這些「補登」直接計入新系統業績：(1) 美容師會誤領到「歷史已賺到」的業績抽成，店家虧錢；(2) Dashboard 數字會因為「補登動作」誇大上線後績效，誤導決策；(3) 月度趨勢圖會有不真實的起始高峰。明確區分「舊帳補收 = 不入業績」是商業誠信也是運營正確。

美業棧如何處理

Treatment.serviceType 加入 `legacy_debt` 列舉值。`isPerformanceEligible(svc)` 在所有業績計算入口統一過濾（v1.0.38 抽出共用 helper 後永久解決三套 mirror impl 漂移問題）。**Reports「店家業績」報表特殊路由**：舊帳收款若標 `awardsPerformance=true`（罕見店家政策）→ 算「商品費用」；標 false → 算「包期費用」（呼應 i18n 文案「不認列業績（視為包期收入）」）。客戶頁 / dashboard / attendance 薪資頁則完全不計入這類紀錄。

具體例子

店家 2026-04 上線美業棧前，客戶 A 紙本欠 NT$3,000。上線後店家在客戶 A 頁建立「舊帳收款 NT$3,000、付款日 2026-05-01、付款方式 = 現金」紀錄。客戶帳上 +NT$3,000、店家收到 NT$3,000 現金、但美容師業績 +0、儀表板業績 +0。月底 reports 報表「店家業績」會顯示這 NT$3,000 在「商品／包期費用」欄位（依政策設定）但「美容師業績」表絕對為 0。