業績認列 Option A

又稱：業績跟著現金走 · Cash-basis performance recognition

Option A 是美業棧採用的業績認列模型：客戶當天付多少現金，當天業績就算多少；未付清部分留到後續還款日才認列。

完整定義

業績認列 Option A（Cash-Basis Performance Recognition）是美業棧 v1.0.x 起確立的設計理念：當客戶分次付款時，**業績認列時間點跟著現金實際入帳走**，而非服務當天一次性全認列。具體公式：`paidRatio = paidAmount / totalAmount`，當天認列業績 = totalAmount × paidRatio。剩餘未付部分透過 `Debt` 模組追蹤，還款日當作新一次業績認列。

為什麼存在這個概念

美業店常見分期付款場景（包期分 3 期、療程後再來付清）。若服務當天就全認列業績，美容師可能拿到「客戶後來欠款不還」的業績抽成，店家虧錢；若服務當天不認列，月底分潤又對不上「我做了卻沒業績」。Option A 折衷：跟著現金走，誰付錢誰先得業績；後續還款由原服務美容師繼續分潤（v1.0.18 多支援美容師亦同）。

美業棧如何處理

`src/lib/performanceCalc.ts` 是所有業績計算的 single source of truth。`treatmentPaidRatios(t)` 回傳 service / product 兩個獨立比例（包期、商品、單堂可獨立認列）。Dashboard / 報表 / 出勤薪資三處全部走同一個 helper。**永遠不要直接寫業績公式**——這是 AGENTS.md 的核心規範，違反過會導致 attendance 薪資頁與 dashboard 數字不一致（v1.0.38 修過）。

具體例子

客戶服務 NT$1,000，當天付 NT$600 現金 + NT$400 欠款。**Option A**：當天業績 NT$600；NT$400 進 Debt。客戶 3 天後回來付清 NT$400 → 還款日新增業績 NT$400（仍歸原美容師）。**對比 Option B**（不採用）：當天直接認列全部 NT$1,000，後續還款不再加業績——若客戶後來逃帳店家會虧錢。