開始之前
庫存這條線有兩個互相獨立、不會互相同步的機制，先分清楚：
「庫存查詢」看到的即時數字（currentStock）跟「盤點作業」算出來的盤點結果是兩回事。盤點確認之後不會回寫更新即時庫存數字，盤點主要是給月結算成本／損益表用的「理論庫存 vs 實際盤點」對帳報表。要讓即時庫存數字變準，只能透過「庫存校正」手動輸入，或是靠系統自動記的進/出（訂購出貨、採購進貨、生產入庫、領料——見下方）。
v0.9.36 這次上線，才把「進貨單確認」「領料單確認」接上即時庫存的加/減（之前這兩個動作完全不會動到 currentStock）。只有這次上線之後新確認的單據才會反映到庫存數字上，之前已經確認過的舊單不會補算，所以現在原料的即時庫存可能還是 0 或不準，要等新單據陸續confirmed，或先用「庫存校正」把期初數字設定好。
庫存查詢
看所有品項（自製品／外購品分頁）目前的即時庫存數字，可以搜尋、依分類篩選、只看低於安全庫存的品項。
🏭 庫存管理→庫存查詢
| 目前庫存 | 就是 currentStock 這個即時數字，會被出貨/生產入庫/進貨/領料/庫存校正這幾個動作更動。 |
|---|---|
| 安全庫存 | 品項主檔①基本頁「庫存下限」設定的值，目前庫存低於這個值該列會標紅、算進「低於安全庫存」的警示計數。 |
庫存校正
手動把即時庫存數字改成你要的值，通常用在設定期初庫存，或是發現系統數字跟現場對不上時手動修正。
🏭 庫存管理→庫存查詢→庫存校正
空白欄位不異動，只有你填了數字的品項才會被更新成那個數字（不是「加多少」，是「改成多少」）。填了之後那一列會變黃色提示，最後按「確認校正」才真的送出。每一筆校正都會記錄在庫存異動流水帳裡，備註欄預設「期初庫存設定」可以自己改。
盤點作業
各單位（中廚／總部／直營店）月底做的正式盤點，用來核算當月成本／損益，跟上面的「庫存校正」是不同用途。角色會自動限定看得到哪個單位：央廚角色只看中廚盤點、會計角色看總部+直營店，admin/主管看全部。
🏭 庫存管理→盤點作業→＋ 新建盤點單
會自動帶入哪些品項，是看品項主檔③庫存頁「盤點設定」勾了「中廚盤點／總部盤點／直營店盤點」哪些——沒勾就不會出現在對應單位的盤點單裡。同一個月份＋單位（＋直營店的話還要選門市）只能建一張，重複建會擋掉。建好之後狀態是「盤點中」，逐一填入「盤點數量」，填完按確認，狀態變「已確認」就鎖定不能再改（除非退回）。
盤點報表
盤點單確認後才會出現「報表」連結，把「期初、本期進貨、本期出貨、理論庫存、實際盤點、盤差、單位成本」全部攤開，算出這個月的盤點總金額，可以直接列印。
盤點作業列表→報表（已確認的盤點單才有這個連結）
畫面上「※ 無上期確認盤點，期初顯示為 —」——理論庫存的計算需要上個月也有確認過的盤點單當期初基準，如果是第一次盤點或上個月沒做，期初/理論庫存/盤差這幾欄就只能顯示「—」，這不是bug，是資料不夠算不出來。
常見問題
Q做了盤點確認，為什麼庫存查詢的數字沒變
盤點跟即時庫存是分開的兩套，盤點確認不會回寫 currentStock。要更新即時庫存數字，盤完之後另外去「庫存校正」把數字改成盤點出來的實際數量。
Q原料的庫存查詢一直是 0
v0.9.36 之前，進貨單確認完全不會加庫存；這次上線後新確認的進貨單才會加。如果是舊的進貨單（上線前就確認過的），不會自動補回去，要用「庫存校正」手動把現有數量設定好當作期初值。
Q盤點單建不出來，說「此單位尚未設定盤點品項」
去品項主檔③庫存頁，把要納入這個單位盤點的品項「盤點設定」勾起來（中廚盤點／總部盤點／直營店盤點）。
Q盤點報表的理論庫存/盤差都顯示「—」
理論庫存要靠「上個月也有確認過的盤點單」當期初基準去推算，第一次盤點或上個月沒做就算不出來，屬正常情況。