KDS 後廚看板
KDS（Kitchen Display System）後廚看板是廚房的即時出餐管理介面。服務人員於 POS 點餐並送單後，廚房看板立即顯示待製作品項，取代傳統紙本出單，減少出餐錯誤並提升作業效率。
進入路徑
兩個入口：
- 後台版：
餐飲 POS → KDS 後廚看板（/dashboard/modules/pos-restaurant/kds），有完整工作台 tab 切換。 - POS 介面版：
/pos/restaurant/kds，給平板專用、無後台選單包裝。
自動 polling 重撈未完成品項：後台版（`/kds` 頁）每 10 秒、POS 平板版（`/pos/restaurant/kds`）每 8 秒。建議於廚房平板或獨立螢幕全螢幕開啟。
廚房站 (工作台) 分流切換
頁面上方有一排 tab：全部 + 您在後台建立的每個廚房站（如：菜口、煎烤炸、熱炒、點心、燒臘…，依 排序 排列）。
- 切到某一站的 tab，看板只顯示屬於該站的品項；
全部tab 則一次看到所有站的品項。 - 每個廚房站可綁自己的出單機（分店獨立設定），KDS 分站與實體廚房單走同一套分流規則，畫面與紙本一致。
設成「不出單」的商品，KDS 照樣顯示
一個品項可同時出現在多個站
與廚房單邏輯完全一致：同一筆品項若跨多站製作，會同時出現在每一個相關站的看板上。
- 例：「片皮鴨」若設定要出到 燒臘站 + 總單，則燒臘 tab 與總單看板都會看到這筆品項。
- 品項的加購/副選項若各自指定了不同的站，該站看板也會收到對應品項（例：主餐在熱炒站、附加的甜點選項在點心站）。
- 站別解析順序：品項設定的出單機（可多站）優先 → 沒設定時退回品項的預設廚房站 → 再併入副選項各自指定的站。
未分配
完全對不到任何廚房站的品項會歸到 「未分配」 群組，只在 `全部` tab 顯示（提醒您該商品尚未設定廚房站），避免品項在分站畫面上被漏掉。
看板顯示規則
哪些訂單會出現在畫面上
- 已取消 / 已退款 / 已作廢的訂單，不會出現在後廚 KDS 與看板（那些餐本來就不用做）。若您在 POS 端取消或退掉一張單，廚房畫面上的對應品項會在下一次自動刷新後消失。
- 已按「完成」的品項、已標「已出餐」的訂單也不再顯示。
- 預購單在預購當日「轉出」為內用 / 外帶 / 外送之前不會進 KDS（見 POS 點餐總覽 › 預購）。
訂單本身不受影響：以上任何一種「不顯示」都只是廚房畫面不列出，訂單資料仍在，可於「訂單查詢 / 訂單管理」查得到。
訂單卡片
訂單按 order_no 分組，每張訂單卡片包含：
- 訂單編號：頂部顯示
#ORDXXXX - 品項格子：每筆品項一格，含品名、數量（x N）、所屬工作台名稱
- 加購選項：如有套用商品選單，會列出選項（如「甜度：少糖」）
- 等待時間：自送單起算，每秒 tick 更新（顯示
分 秒）
警告色階
依等待時間自動切換卡片背景：
| 時間 | 等級 | 顏色 |
|---|---|---|
| < 8 分鐘 | normal | 白底 |
| 8–14 分鐘 | warn | 琥珀色 |
| ≥ 15 分鐘 | danger | 紅色 + 粗體 |
閾值目前固定 8 / 15 分，無自訂設定。
操作按鈕
- 完成（每個品項格子底部）：標記該品項完成，自該品項從看板消失
- 全部出餐（訂單卡片頂部）：跳 confirm 後一鍵把整張訂單所有品項標完成，訂單卡片直接消失
一鍵清空（2026-08-10 修正）
POS 端的 後廚 KDS（/pos/restaurant/kds）與 看板（/pos/restaurant/dashboard）右上角有 一鍵清空 按鈕：
- 用途：把累積在畫面上的所有未處理單 / 待製作品項批次推到「已出餐」（品項一併標為完成）
- 典型場景：忙完一波，畫面上還有零星沒按完成的舊單想統一清掉
- 不刪訂單：只改廚房出餐狀態，不會刪掉訂單、不影響帳款與報表，訂單仍可在「訂單查詢」、「訂單管理」找到
- 清得乾淨：畫面上看得到的單，按下去都會被清掉，不會留下清不動的殘留（包含從未送過廚房的單）
- 只清目前所在門市：多分店的店家，清空只影響 POS 左側選單「當前門市」選到的那一間，不會動到其他分店。店長 / 店員帳號一律只會清到自己被綁定的分店；總部帳號若「當前門市」沒選任何一間，會一次清掉全部分店，請先選好門市再按
- 點按鈕後會跳確認視窗防誤觸，按下後即時刷新畫面
注意：清空後若同桌客人後續還有加點，新點的單會照常出現在畫面上，不影響後續流程。
訂單上沒有「桌號」標籤（顯示用訂單編號定位），如需在廚房單上看到桌號，請按 POS 端「點餐單」補印實體單。
看板顯示筆數與載入速度（2026-08-17 調整）
POS 的 看板（/pos/restaurant/dashboard，「訂單狀態流」頁簽）：
- 顯示上限由 30 筆放寬到 100 筆。先前畫面最多只列 30 張未完成訂單，導致右上角「未完成訂單：N」被截斷，跟一鍵清空實際會清掉的張數對不上（清空是整店清、不看那 30 張）。現在兩邊一致。
- 開頁與自動刷新變快：以前一次刷新最多要打 31 次資料請求（訂單列表 1 次 + 每張單再補撈 1 次），在平板上會互相排隊、偶爾出現數十秒才載完的情形；現在一次請求就把訂單與品項一起帶回來。畫面內容與操作方式完全沒變。
自動刷新頻率不變（看板每 10 秒、POS 平板版後廚 KDS 每 8 秒）。
外場出菜看板（2026-08-13 新）
POS 的 看板（/pos/restaurant/dashboard）上方多了兩個頁簽：
- 訂單狀態流：原本的看板（訂單流程 + 用餐倒數），內容完全沒變。
- 外場出菜：給外場服務生用的新畫面，記錄「這道菜已經送到桌了」。
外場出菜與後廚 KDS 是先後兩件事，不要混用
畫面看得到什麼
只顯示當日的內用訂單，每張桌一張卡片，卡片上有訂單編號與桌號，逐道列出品項、副選項與備註。
每道菜下方顯示 已 N 分（從該道菜點餐至今），顏色與後廚 KDS 一致：8 分鐘轉琥珀、15 分鐘轉紅，一眼看出哪一道拖太久還沒送。加點的菜各自從自己的點餐時間起算。
右上角兩顆切換：
| 頁簽 | 顯示範圍 |
|---|---|
| 進行中 | 今日內用單中，還有菜沒送出去的桌 |
| 已完成（當日） | 今日內用單中，所有菜都已送出的桌（已結帳的也留著，收完錢紀錄不會消失） |
左上角另有廚房站頁簽（全部 / 各站 / 未分站），括號內是該站待送出的道數，方便多人分工送餐。已取消 / 已退款 / 已作廢的訂單不會出現。
操作方式
逐道標記 每道菜右側按 已送出。按下去該道不會從畫面消失，只會變灰加刪除線，並顯示送出時間與「點餐後 N 分」，讓您隨時回頭核對。
按錯了 已送出的那道右側會變成 取消 按鈕，按一下即可還原成未送出。
整單送出 卡片下方的大按鈕：
- 在「全部」頁簽是 全部送出（N），一次把整張單所有未送的菜標記完成。
- 在某一站的頁簽是 本站全部送出（N），只送本站畫面上看得到的那幾道，不會誤送其他站的菜。
- 若本站送完但其他站還沒，會顯示「本站已送完，其他站尚未送畢」。
收掉卡片 整張單所有菜都送完後，大按鈕變成 全部完成，按下去卡片才從「進行中」移走，之後可在「已完成（當日）」找到。
為什麼送完了卡片還留著，要再按一次「全部完成」
看板用餐倒數設定
「訂單狀態流」頁簽卡片上顯示的剩餘用餐時間與外框變色門檻，在後台 餐飲 POS → 看板用餐倒數（/dashboard/modules/pos-restaurant/settings/board-countdown）設定，逐分店各自設定。
- 啟用看板用餐倒數：總開關，關閉時看板不顯示倒數，維持原本樣式。
- 預設用餐時長（分鐘）：沒有另外指定區域的桌位，用這個時長算倒數。起算點是訂位時間（沒有訂位就用開單時間）。
- 各區域用餐時長：本店桌位設定過的區域（例如「一樓」「包廂」）可以各自填一個分鐘數，留空就沿用預設時長。本店桌位還沒設定過「區域」時，這裡會提示先到「桌位管理」為桌位填區域。
- 外框變色門檻：可新增多段「剩 N 分 → 變成某色，標籤（選填）」，卡片外框依「剩餘時間 ≤ 門檻分鐘」取最緊急的那一段顏色。系統預設三段：剩 30 分（琥珀色「快到時間」）、剩 10 分（橘色「即將超時」）、剩 0 分（紅色「已超時」），這三段可以自行增減或改色。
儲存後立即生效，不需要重新整理看板。
只影響「訂單狀態流」頁簽
常見問題
Q1 POS 送單後 KDS 沒有出現新訂單
請確認 KDS 頁面的網路連線正常，並按右上「重新整理」或等待 8–10 秒（後台版 10 秒、POS 平板版 8 秒）自動 polling。若問題持續，請確認 KDS 與 POS 使用相同的商家帳號登入，且訂單確實送出（不是只加入購物車）。
Q2 某品項沒出現在某廚房站
進「商品管理」確認該商品已指定對應的「出單機 / 廚房站」。未設定廚房站的商品會歸到「未分配」群組，只在「全部」tab 出現。若品項應該同時出現在多個站卻只出現在一站，請確認商品的出單機是否勾選了多台。
Q3 按完成後品項仍留在看板
點擊 完成 後，前端會即時把該品項從畫面移除；若沒消失，可能是請求失敗，請按右上「重新整理」確認狀態。
Q4 按了一鍵清空，畫面上還是有幾張單清不掉
2026-08-10 之前確實會發生：已取消 / 已退款的訂單仍列在畫面上，但清空時被跳過，導致「按了好像沒反應、永遠剩幾張」。已修正 —
- 已取消 / 已退款 / 已作廢的訂單現在不會再出現在後廚與看板
- 一鍵清空會把畫面上看得到的全部清掉（含從未送過廚房的單）
若仍有殘留，請先按右上「重新整理」，並確認 POS 左側選單的「當前門市」切在您要清的那一間（清空只作用於當前門市）。
Q5 一鍵清空會不會把訂單刪掉、影響營業額？
不會。一鍵清空只把訂單的廚房出餐狀態推到「已出餐」、品項標「完成」，訂單、金額、付款與報表資料完全不變，仍可在「訂單查詢 / 訂單管理」查到並正常結帳、退款、開發票。
進階：KDS 監控 / 漏單 LINE 告警 / 自動 retry
廚房列印失敗、KDS 平板離線、KDS 沒收到結桌訂單時，要主動 LINE 通知老闆 + 自動重試列印失敗單，請參考：
→ KDS 監控與漏單告警
其他問題協助