# 咖啡店決策工具：計算與驗收規格

全部資料為虛構教學數字。只做單品假設試算，不做投資、真實營運預測或多品項組合損平。

## 材料與欄位
cafe-finance.csv：product 品項、price 售價（NTD/杯）、variable_cost 變動成本（NTD/杯）、fixed_cost 固定成本（NTD/月）。
固定成本是共享店面月成本，列在各品項只是供單品假設比較，不能把每列固定成本加總。

## 公式
每杯毛利＝售價－每杯變動成本。
毛利率＝每杯毛利／售價 ×100%。
月損益兩平杯數＝向上取整（月固定成本／每杯毛利）。
假設銷售杯數 q 的月損益＝q×每杯毛利－月固定成本。

## 驗證
品項不能空白。數字欄缺值、非數字、負成本或售價≤0：停止並指出列與欄，不補零。
每杯毛利≤0：沒有本模型的有限損平量，不能除以零或顯示負杯數。
月固定成本0且毛利>0：損平量0杯。
讀CSV缺必要欄位：停止整批；保留原可用資料，不只更新部分品項。

## 手算預期（須另記錄實際結果）
美式60、變動25、固定6000：毛利35、毛利率約58.33%、損平172杯；171杯損益-15，172杯20。
拿鐵80、變動40、固定6000：毛利40、毛利率50%、損平150杯。
更新資料美式65、29、7200：毛利36、損平200杯。拿鐵85、43、7200：毛利42、損平172杯。
錯誤資料四列：缺成本、負毛利、负固定成本、非數字售價，均不能進入正常損平計算。

## 開發與交付
先寫計算規格與手算預期，再請 Codex 生成 decision-tool.html。讓讀者能改數字、匯入CSV、看到限制與錯誤。開啟HTML，記錄上述實際測試，换入新資料重測。
交付 decision-tool.html、README.md、analysis-tests.md、兩份正常CSV與錯誤CSV。報名席數不是銷售量，不可直接帶入為營收預測。