POS 訂位介面（平板 / 收銀台）

POS 訂位介面是給現場店員 / 平板 / 收銀台用的當班操作畫面，跟「後台訂位列表」（管理用）相比是更精簡、更聚焦在「快速處理當下訂位」的設計。

進入路徑

POS 介面左側 sidebar 點 訂位（路徑 /pos/reservation）。

兩個視圖

頂部「當日 / 月曆」切換 tab：

當日視圖

預設視圖。顯示指定日期（預設今天）的訂位卡片，含：

• 大字時間 (如 13:30) + 日期
• 顧客姓名 + 狀態 chip + 電話 + 人數 + 桌位
• 備註
• 操作按鈕：確認 / 指派桌 / 到店 / 未到 / 修改 / 取消 / 離席 / 遞補（依狀態智能顯示）

操作按鈕已改為橫向排列、體積縮小的緊湊樣式，同一張卡片一排就放得下多顆按鈕，平板上更省空間、一眼看完。

各按鈕作用：

「到店 → 點餐」一條龍：客人報到按「到店」後，卡片會多一顆橘色 點餐 鈕，點下去直接進 POS 點餐並帶好會員與桌位，現場接待到開單不用切好幾個頁面。

日期可換成任意天，預設帶今天。日期欄兩側各有 ‹ / › 箭頭，一鍵跳前一天 / 後一天（跨月、跨年自動處理，時區以台北為準），現場翻看隔天訂位不用展開日曆。狀態 filter 可單選「待確認 / 已確認 / 已到店 / 已取消 / 未到」。

月曆視圖

顯示整月格子，每格：

• 日期數字（今日橙底；週日紅；週六藍）
• 「N 組」訂位數
• 「待 N」待確認數（橙字）

操作：

• 「‹ 上月 / 下月 ›」切月
• 「本月」一鍵跳回本月
• 點任一日期 → 下方展開該日訂位卡片列表（含確認/到店/取消按鈕）
• 「✕ 關閉」收起下方列表

取消訂位與「復原取消」

取消要輸入服務人員密碼

有建立服務人員的門市，按 取消 之後會先跳出選人 + 輸入 4 位數密碼的視窗，通過才會真的取消。這與「編輯後儲存」「指派桌位」是同一道驗證，目的是留下「這筆訂位是誰取消的」。

沒有建立服務人員的門市完全不受影響：按取消只會跳一般確認視窗「確定取消此訂位？取消後可在 30 分鐘內按『復原』救回。」，按確定即取消。

復原取消（誤按救回）

按錯取消時，該筆訂位的卡片上會多出一顆 復原取消。按下去（有服務人員的門市同樣要驗密碼），訂位會回到取消前的那個狀態——原本是「已確認」就回「已確認」，原本是「待確認」就回「待確認」，不會被隨便猜成別的狀態。

這顆按鈕只在三個條件同時成立時才出現：

復原後可能出現的兩種提醒

「原桌位（A5）已被占用，桌位指派已清除，請重新指派」 取消時桌位被釋放出去，這段期間可能已經被別筆訂位拿走、或現場已經有客人在那桌吃了。系統照樣把訂位復原（客人要來是既成事實，擋下來不會讓衝突消失），但不會硬把桌搶回來——桌位指派會被清空，請您重新指派一張桌。

若併了好幾張桌，只要其中一張被占用，整組指派都會清掉（只留半組併桌沒有意義）。

「注意：⋯⋯（取消時可能已遞補候補，請人工確認）」 如果該時段有候補客人，取消當下釋出的名額可能已經自動遞補給候補的客人，而且那位客人已經收到「候補已補上」的 LINE。系統刻意不把他退回候補（取消一位真實客人比帳面多一筆嚴重得多），所以復原之後該時段有可能超出容量一組。看到這個提醒請人工處理（加桌，或聯絡其中一組客人）。

復原會通知客人

復原成功後，系統會推一則 LINE 圖卡給該筆訂位的會員（標題「訂位仍然有效」），告訴他訂位還在、不用重新預約。詳細規則與開關見「[訂位通知](./08-notifications.md#復原取消時也會通知客人)」。

備註欄會留下痕跡

取消原因與復原紀錄都會附加在訂位備註裡（例如 [取消原因] 客人來電說不來了、[取消已復原] 由 阿美 復原為「已確認」），既有內容不會被刪掉，歷史只增不減。這些內部標記不會出現在推給客人的 LINE 訊息裡。

指派桌與拆分子桌

點卡片上的 → 指派桌 會跳出選桌視窗，把桌位預留給這筆訂位（客人還沒入座，桌位標為「預留」）。

拆分子桌（大桌臨時拆開用）

若某張桌子在後台「桌位設定」被設為可拆的母桌，選桌視窗中它旁邊會出現 拆分 按鈕：

• 點 拆分 → 母桌展開成幾張子桌（例如 A11 拆成 A11a、A11b；實際子桌名稱由後台桌位設定決定），可以只把其中一張子桌指派給這筆訂位。
• 展開後母桌會顯示「已拆分」且不可整桌選取，避免母子桌重複佔用。
• 想還原 → 點 併回整桌，子桌收回、母桌恢復整桌可選。

拆分只是這次選桌當下的臨時操作，不會改動後台的桌位設定；下次開視窗預設仍是整桌。

和 POS 點餐同一套操作：餐飲 POS 點餐畫面的「選擇桌位」視窗也是同樣的 拆分 / 併回整桌 操作，兩邊邏輯一致。適合「一張大桌臨時坐兩組不同客人、要分開記帳」的情境。

每日公告（交接留言）

若後台開了「每日公告」（訂位設定 → 訂位規則，見 訂位設定），頁面上方會多一塊藍色公告欄，給店長 / 店員留言給下一班，或記錄臨時狀況（例：A 區包場到 20:00、冷氣維修中）。

• 每一天各自獨立：公告跟著頁面上的日期走，切到別天就顯示那天的公告，不會互相蓋掉。標題會標出對應日期（當天顯示「今日 M/D 公告」）。
• 打完自動存：沒有「儲存」按鈕 —— 停止打字約半秒後系統自動存檔，標題右邊會閃一下 已儲存。交接留言這種東西，多一顆按鈕就多一個忘記按的機會。
• 上限 500 字：目前字數顯示在標題右側（如 48/500），達上限就打不進去。
• 展開 / 收合：內容較長（超過一行或有換行）時，標題右邊會出現 展開 / 收合，展開後輸入框變高，方便一次讀完或大段編輯。
• 顯示位置：有開烤鴨備料的門市，公告與烤鴨備料卡左右並排；沒開烤鴨的門市，公告單獨顯示在日期列上方。

這是每間門市各自的設定：沒開這個開關的門市，畫面上完全不會出現公告欄。公告內容也是各分店分開存，不會跨店看到別店的留言。

公告只給店內人員看：標題旁的 僅店內可見 徽章就是在講這件事 —— 顧客在 LINE 線上訂位頁看不到這裡的內容。要給客人看的公告（例如節慶套餐內容、加購品項），請到 訂位設定 → 公休/特殊，在該日期的「顧客端公告」欄位填寫。

烤鴨備料彙總（單租戶專屬）

若後台開了「烤鴨選項」（訂位設定 → 訂位規則，見 訂位設定），頁面上方會多一張橘色師傅備料彙總卡，幫烤鴨師傅抓當天要備幾隻鴨：

• 跟著日期走：當日視圖看今天、月曆點某天就看那天；卡片標題會顯示對應日期。
• 午 / 晚分開算：依訂位時段自動分「午」「晚」，各顯示 全鴨 / 半鴨 隻數（1.5 隻 = 1 全 + 1 半）。
• 輸入準備數量算剩餘：卡片上可填「準備 N 隻」，系統即時算「已訂 X · 剩餘 Y 隻」；訂超過準備量會標紅「超訂」。準備量存在各分店設定，隔天 / 換台開機都在。
• 單行精簡顯示：整張卡壓成一行（日期 · 午全半 · 晚全半 · 準備 · 剩餘），不佔畫面。

沒訂鴨的日子也能先填準備量看剩餘，方便提前抓量。此功能為單租戶專屬，未開烤鴨選項的店不會出現這張卡。

若同時也開了「每日公告」，備料卡與公告欄會左右並排顯示在同一列。

通知鈴鐺

Header 右上有鈴鐺按鈕，新訂位累積在這裡，不會錯過：

• 紅色數字 badge：未讀新訂位筆數（脈動動畫，> 99 顯示 99+）
• 點鈴鐺 → 下拉清單，顯示所有未讀（最新在最上）：

- 顧客名 + 狀態 chip + LINE 來源標籤 - 日期時間 + 人數 + 電話 + 備註

• 點清單一筆 → 自動跳到當日視圖該日 + 標已讀 + 關閉清單
• 「全部已讀」 一鍵清空

已讀狀態跨頁保留

鈴鐺已讀記錄存在瀏覽器本機（localStorage），重整頁面 / 隔天開機都不會丟失。換瀏覽器或別台 POS 主機則各有獨立的已讀狀態。

通知音效

新訂位進來會：

1. 顯示頂端 toast 通知條
2. 響 880Hz 「叮」一聲
3. 鈴鐺 badge +1

通知觸發條件：任何新出現的非取消訂位（線上 LINE 預約 / 店員手動建立 / 別台 POS 開的單）都會觸發。

自動刷新

每 30 秒靜默重新撈一次資料，新訂位會自動進入鈴鐺通知池。

多分店行為

登入帳號綁定的分店 → 只看該分店的訂位通知。超管 / 多店店長依本身權限會看到對應分店資料。

常見問題

Q1　鈴鐺 badge 紅色數字一直在

代表還有未讀新訂位沒處理。處理方式三選一：

1. 點開鈴鐺一筆筆看 → 系統自動標已讀
2. 點「全部已讀」 一鍵清空
3. 處理完訂位後等下一次 polling

Q2　別台 POS 開的訂位這裡也會響嗎

會。任何來源（線上 / 別台 POS / 後台 / 這台）的新訂位 polling 撈到都會觸發通知，避免漏接。

Q3　月曆某天點不開

該日沒有任何訂位（包括待確認），點也不會展開列表。改點有「N 組」標示的日期即可。

Q4　切月後資料看起來慢

切月會重新撈整月資料，第一次切過去要 1-2 秒。回到本月則直接從快取顯示。

Q5　怎麼新增訂位

右上「+ 新增訂位」按鈕，跳出表單填姓名/電話/人數/日期/時間/備註 → 確認即可。新建的訂位 status 預設 confirmed。

注意：電話必須是 09 開頭的 10 碼台灣手機號（例：0912345678），格式錯誤會跳提醒無法送出；空白 / 連字號會自動去除。 唯一例外：勾了電話欄旁的「還不知道」就可以不填電話（見下方）。

電話「還不知道」（2026-08-22 起）：客人現場還沒給電話、或是別人代訂時，勾電話欄右邊的小勾選框 還不知道，電話欄會變灰顯示「未提供（之後可補填）」，這樣就能直接建單，不用再編一個假號碼。

• 建好之後，卡片與列表的電話顯示 未提供（琥珀色字），不是空白
• 之後補：編輯該筆訂位 → 取消勾選 → 填入電話 → 儲存（存檔會重跑一次自動連結會員）
• 取消勾選卻不填電話送不出去，會提示「請填寫電話」
• 要一次把待補的撈出來，請到後台訂位列表用「未提供電話」篩選
• 顧客自己在 LINE 上訂位沒有這個選項，線上訂位的電話仍然必填（原因見黑名單）

桌位用卡片格挑：表單的「桌位」欄點一下會彈出卡片格，可一次點多桌併桌、時段已占用的桌反灰標「已預定」、可拆的母桌按 拆分 選子桌（和上面「指派桌」同一套操作）。

備註有編輯器：「備註」欄點開是備註編輯器，左邊打字、下方一排常用備註（生日 / 包廂 / 靠窗 / 過敏…可自訂增減），右邊列最近使用備註，點任一個就插入到游標位置，不用每次重打。常用備註存各分店設定，全店共用。