UI 並排驗收

使用者怎麼操作

1. 開啟 App → 進入登入頁。
2. 點「以 Google 繼續」→ 跳系統瀏覽器完成 Google 登入 → 自動帶回 App 建立登入。
3. 或點「以 LINE 繼續」（即將推出）。
4. 或點「使用 Email 登入 / 註冊」→ 輸入 Email → 系統判斷此 Email 是否已有帳號。
5. 登入成功 → 自動進入「選擇餐廳」。

判斷 / 邊界

• Email 已存在 → 顯示「登入」（輸入密碼）；不存在 → 顯示「註冊」（設定密碼 + 確認）。
• 註冊密碼少於 6 碼、或兩次密碼不一致 → 擋住並提示。
• 忘記密碼 → 寄出重設連結。

流程來源：ChefsMateShared/UI/Auth/SignInView.swift（登入頁本回直接讀 Flutter login_page.dart 對照）

使用者怎麼操作

1. 登入後 → 列出你加入的所有餐廳。
2. 可進入的餐廳（active）→ 點卡片 → 進入該店主控台開始工作。
3. 「搜尋並加入其他餐廳」→ 輸入店名搜尋 → 申請加入 → 等店家核准。

判斷 / 邊界

• 審核中（pending）→ 卡片變灰、顯示「申請審核中・等待店家核准」，不可點。
• 已停權（suspended）→ 卡片變灰、顯示「已停權」，不可點。
• 只有 active 的餐廳能被選為工作店家。

流程來源：ChefsMateShared/UI/Shared/WorkspaceSwitcher/WorkspaceSwitcherView.swift（Flutter 為 Stitch 重設計版）

怎麼看這個畫面

1. 頂部分頁切換功能：訂位 / 主控台 / 廚房 / 外場 / 菜單 / 戰情室 / LINE訂位 / 設定。
2. 統計卡：一眼看 空桌、未出完餐、未結帳 各幾桌。
3. 分區（1F / 2F…）顯示每桌的小卡，桌號 + 座位數。
4. 底部抽屜：上拉看「訂位 / 候位」清單；點「＋新增訂位」。

桌位中間的符號怎麼讀

• 形狀：圓形 = 訂位客人、菱形 = 散客（訪）。
• 顏色：待確認金黃 / 已確認灰藍 / 待入座綠 / 遲到橘 / 用餐灰藍 / 超時紅（閃）。
• 右上角數字：點餐狀態 — 紅 = 還有餐沒出完、灰 = 已全部出完。
• ✅ = 已結帳；🔔💧💳 = 服務鈴（呼叫 / 加水 / 結帳）；✎ = 有待審核的修改。
• 中央文字 = 姓氏（散客顯示「訪」）+ 人數（如「2大」「3大1小」）。

操作

• 空桌點一下 → 開始入座 / 點餐。
• 已入座的客人圓圈點一下 → 繼續點餐 / 結帳。
• 浮動鈕：星星（會員集點）、拆桌、出店刪除（把客人拖到此）。

桌位狀態怎麼來的（已對照 TableStatusGate 原始碼）

• 沒有在座 → 空桌。
• 有在座、已超過用餐門檻分鐘 → 超時（最優先提醒）。
• 有在座、沒開單 → 已入座；有開單、餐全出完 → 已出餐；還有沒出完 → 已點餐。
• 已結帳是結帳完成後的明確結果（寫入結帳時間），不是用時間推的。

流程來源：POSMainControlView.swift + Components/TableComponent.swift + GuestCircleView.swift + 桌位狀態 Gate（lib/shared/gates/table_status_gates.dart，已單元測試）

怎麼點一桌的餐

1. 畫面最上方顯示桌號與人數；若該桌有預約獎勵，會跳紫色提示（已自動帶入廚房，不需在此加點）。
2. 店家同時有單點與套餐時，會出現「單點 / 套餐」切換（只有單點時不顯示）。
3. 用分類膠囊（可左右滑）切換分類，「全部」為預設，膠囊上顯示該分類品項數。
4. 搜尋欄輸入關鍵字即時過濾；點 X 清除。
5. 點卡片圖片 → 開該品項詳情；點右下「＋」加入購物車。
6. 若品項有選項（辣度／份量）→ 先跳「客製選項」彈窗選完才加入。
7. 加入後卡片右上出現數量徽章、亮起藍框，下方「－ 數量 ＋」浮現；歸 0 即移出。
8. 套餐卡（左上橘「套餐」標籤）加入時，若有更划算的升級套餐 → 跳「升級套餐」確認。
9. 點右上購物車圖示 → 全螢幕購物車：逐項加減、看小計、套餐可「更換」組件、可「清空」。
10. 按底部「送出訂單 (N 項) $金額」送單（預點餐情境為「送出預點餐」）。
11. 若有低消且未達標 → 跳「低消提醒」，可「仍要送出」或「返回修改」。

流程來源：POSOrderingView.swift（已對抗式驗證，verify accurate）

1. 加入購物車：有選項先彈客製 sheet；單品若有更貴的對應套餐先彈「升級套餐」。
2. 加入時即時扣當日供應量（品項 + 所屬分類；套餐連同每個組件一起扣），供應不足無法加入。
3. 同品項同選項自動合併數量；加購組合以一筆 deal 計。
4. 右上購物車圖示 → 全螢幕購物車：縮圖、單價、選項、套餐組件、小計。
5. －／＋ 調量；減到 0 移除該列（一般品項回補供應量，含預約獎勵會釋放當日 quota）。
6. 套餐組件可「更換」→ 開更換彈窗，差價依餐廳「更換價格政策」算（換便宜不退差等）。
7. 底部即時「總計 $金額」→ 按送單（一般「送出訂單」／預點「送出預點餐」）。
8. 低消未達標先跳「低消提醒」（差多少／缺哪類），可「仍要送出」或「返回修改」。
9. 成功：一般模式建立 Order/OrderItem 送廚房；預點模式上傳 pre_orders。清空購物車、通知主控台/廚房、關閉點餐頁。

POSOrderingView.swift（submitOrder / executeSubmitOrder 各路徑）

1. 切到「套餐」分頁（店家有設定套餐才看得到），卡片下方列出套餐子品項。
2. 加單品時若有對應更貴套餐 → 跳「升級為套餐更划算」：可「升級套餐 $價」或「維持單點」。
3. 套餐加入購物車後，那一列展開列出所有組成品項。
4. 可更換的組件後面有橘色「更換」鈕 → 開「更換品項」彈窗。
5. 彈窗可搜尋或從同分類可替換品項挑一個；右邊顯示要補（+$ 紅）或退（-$ 綠，依政策）的差價。
6. 想換回 → 彈窗按「恢復原品項」。
7. 送單時套餐展開成多個獨立廚房品項（共用 comboGroupId）；被換的組件在備註寫「原：A → B」。

POSOrderingView.swift（comboUpgrade / ComboSwapSheet / comboSwapPricePolicy）

1. 點有適用選項的品項 → 開客製 sheet（頂部縮圖／品名／原價）。
2. 各選項依序列出：單選＝點了覆蓋同組其他；多選＝可多選到上限，達上限再點無反應。
3. 金額即時更新：（原價 + 已選加價）× 數量；底部加減調數量（最少 1）。
4. 所有「必選」都選了之後，「加入購物車」才會亮起。
5. 按「加入購物車」→ 依數量把同份選項加進車並關閉；或「取消」不加入。

MenuItemOptionSheet.swift

1. 把訂位安排到「仍有未結帳客人」的桌 → 先彈桌位衝突 sheet。
2. 上方橘色警告說明要把哪位客人（含人數）安排到哪桌、該桌還有未結帳客人。
3. 中間列出該桌目前每組客人：姓名、人數、入座時間、已坐幾分鐘。
4. 三選一：「選其他桌」回重挑桌 ／「強制入座（前組視為同桌）」 ／「取消」不處理。

TableOccupiedSheet.swift

1. 從訂單／通知開啟，傳入一筆待審核修改（客人請求／店家修改）。
2. 頂部顯示來源、狀態、共幾項、多久前送出。
3. 逐項看改了什麼：數量 2→3、新增 x1、移除、備註改、選項變更、替換為 XX、🎁 兌換獎勵變更…
4. 待審核才會出現底部「拒絕修改 / 核准修改」；非待審核只能查看。
5. 核准 → 呼叫後端套用 → 跳結果（全部成功／部分成功列出失敗項）。
6. 拒絕 → 先填（選填）原因 → 確認拒絕 → 跳結果。按「確定」關閉。

OrderModificationReviewSheet.swift

1. 候位區點訂位 → 選「先點餐」（店員代客，標題顯示「預點-姓名」、無桌位）或「自助先點餐」（產生 QR 給客人自己掃碼預點）。
2. 照常選分類、加菜（支援單點／套餐／加購）→ 按「送出預點餐 (N 項) $金額」。
3. 寫到雲端 pre_orders + pre_order_items，訂位標記「已預點」，主控台跳「預點餐已送出」。
4. 訂位詳情可看橘色「已點餐」+ 預點明細。
5. 客人到店、把訂位「安排入座」到某桌 → 系統自動把預點品項（+ 預約兌換獎勵）轉成真正廚房訂單送廚房。
6. 轉換完成 pre_order 狀態改 converted_to_order（防重複）；失敗則跳「預點訂單轉換失敗」請店員手動點餐。

POSOrderingView.swift + Services/PreOrderConversionService.swift + SeatingService.swift

怎麼出餐

1. 畫面分兩區：準備區（等指示）與可出餐區（已可製作/出餐）。
2. 把準備區的菜「移到可出餐區」：單道、整桌、或「全部可做」一次全移（播『登！』音）。移錯可往回移。
3. 插隊：「設為優先製作」丟到最前；「排在某桌之後」；「下一桌」依最早下單整桌移過去（FIFO）；「這張單最後做」壓到墊底。
4. 「催單」→ 標紅框、強制移到可出餐區、排到最前（並背景通知 server）。
5. 做好按綠勾「出餐」：需外場送 → 變「做好等送」播『叮』鈴；不需外場送 → 直接「已送到桌」。
6. 按錯了按「復原」可整批還原上一步（最多 30 步）。

等候時間色階（已對照原始碼）

• 每張卡顯示「下單到現在」的分鐘數，自動變色：≥30 分 紅、≥15 分 橘、其餘正常（依座綠／依品灰）。越久越紅。

ExpediteKitchenView.swift + ExpediteOrderCard/ExpeditePerDishCard.swift + ExpediteActionManager.swift（已對抗式驗證）

1. 點麥克風 → 要語音辨識權限（沒給就提示去設定開）。
2. 開始聆聽，畫面即時把你說的話轉成文字。
3. 說中文指令（例「A桌可以做了」「B桌牛排先做」「全部可以做」「下一桌」「暫停出餐」）→ 系統辨識出指令顯示綠色預覽。
4. 停說 2.5 秒自動完成；預設「自動執行」直接做，或關掉自動、按「執行」再做。
5. 執行後用語音唸出結果（如「已將 3 道餐點移到可出餐區」）；找不到對應餐點會唸「找不到匹配的餐點」。
6. 說「結束/關閉/停止」或按「結束」可關閉；按「重說」重新講。

ExpediteVoiceOverlay.swift + SpeechRecognitionService.swift + ExpediteActionManager.swift（已對抗式驗證）

怎麼結一桌的帳

1. 主畫面點桌 → 結帳，進結帳大廳。頂部顯示桌號／人數；若客人用過會員獎勵，跳紫色「結帳提醒」（提醒店員告訴客人已扣 N 點、折抵 $X）。
2. 選結帳方式：全額結帳 ／ 分帳（除以大人數／總人數／自訂人數／按點餐人）／ 按餐點結帳（勾選要結的餐點）。
3. 看訂單摘要：單點一列；套餐成一張分組卡（含子品項、換品項差價 +紅/-綠）。已結的品項會劃線並標「已結帳」。
4. 加折扣（百分比／固定金額）、選優惠券（未達門檻會擋住、標「未達門檻」）、視需要加收服務費（預設 10%）。
5. 金額即時算：小計 − 折扣 ＋ 服務費 − 訂金折抵 ＝ 訂單總額；部分付清時顯示「已結金額／剩餘金額」。
6. 收款：線上付款（出 QR 給客人掃，藍新金流）或 現金收款（展開數字盤：輸入收取金額、按「剛好 $X」、台灣常用面額一鍵帶入＋自動算找零、顯示應找零，按「確認收款」）。
7. 開發票：選發票內容（逐項列出／只寫餐費）、載具類型（手機條碼／自然人憑證／捐贈碼／列印）、可填統一編號。
8. 全部付清 → 綠色「全部付清」橫幅：可掃會員 QR 發點數、傳送明細連結給客人、回到主畫面。

CheckoutSheet（POSMainControlView.swift）+ CheckoutTypes.swift（已對抗式驗證）。✅ 球員證段位折扣／會員優惠兌換已補做（Swift 端 feature flag 仍關閉）。

• 信用卡付款：金額卡＋ TapPay 卡片表單（卡號／到期／CCV）＋確認付款。⚠️ Tap to Pay 因 Apple 帳號限制暫關，固定走手動輸入。
• 線上結帳 QR：出 QR 給客人手機掃結帳；收到付款通知即切換「付款成功」綠勾。可分享連結。
• 客人端結帳監看：分帳時店員即時看一桌每位客人的付款狀態（已線上付款／已收現金／處理中／未付款），可代收現金、重發 QR、刷載具；全員付清可關桌。
• 點數要給誰：結帳人非會員時，問要不要把點數累積給同桌會員（列候選人）；或出 QR 請客人自己加入會員。
• 刷載具：相機掃客人手機發票載具（手機條碼／自然人憑證）→ 辨識後確認綁定到這筆結帳。

CreditCardPaymentSheet / CheckoutQRCodeSheet / CustomerCheckoutMonitorSheet / LoyaltyChooseSheet / CarrierScannerSheet（皆已對抗式驗證）。

怎麼關一天的帳

1. 每天打烊按「關帳」進入；系統自動算好今天的營收、各支付方式金額、訂單/來客數。想中途看數字但不鎖帳 → 用「小結」。
2. 確認 調整項目（折扣／服務費／稅）與 營業統計（含作廢、退款筆數）。
3. 現金盤點：系統先算「預期現金 ＝ 零用金 ＋ 現金收入 − 現金退款」；再用幣值計數器逐張點鈔（$2,000…$1 紙鈔/硬幣各自加減），或切「直接輸入」打總額。
4. 系統算出差異並用顏色提示：一致＝綠勾、±$100 內＝橘、超過 $100＝紅三角並要求確認。關帳當天若現金短缺，需填「虧損原因」才能關。
5. 選營業額要存入哪個帳戶（錢包/銀行；沒有就自動建「營業額錢包」）。
6. 按「確認關帳」→ 二次確認 → 鎖定當日帳務並同步雲端。當日僅能關一次。
7. 忘記關帳：主控台會跳橘色漏關帳橫幅，可「逐日補」或「批次補」一次補關好幾天（補關帳算式不含零用金）。

SettlementSheet.swift + SettlementHeroCard/QuickStats/Section/ActionBar + CashDenominationCounter.swift + BatchRetroCloseSheet.swift（已對抗式驗證）。✅ DailyCloseEditSheet（編輯關帳）／PayoutReconciliationView（金流對帳）／歷史關帳挑選 已補做。

• 未結帳訂單詳情：補關帳時逐筆處理沒結到帳的單，四種處理 — 補結帳（客人補付走正常結帳）／列為耗損（員工忘結記損失）／店家請客（金額視為 0）／刪除訂單（純錯誤單）。各自有權限門檻。
• 臨時收支：臨時支出/收入記帳（金額隨方向變紅/綠）＋ 6 分類（文具/食材/維修/員工餐/小費/其他）＋ 帳戶 ＋ 日期。
• 退款：退付款／退訂金／其他退款三種，依類型出不同欄位 ＋ 金額 ＋ 原因。
• 即時營收條：主控台頂部可摺疊，今日營收（已結＋未結）；展開看支付別、訂金、客數/均消/折扣/退款。金額 ≥1萬用「X.X萬」縮寫。
• 漏關帳橫幅：哪天沒關帳就在主控台跳橘色橫幅，可「逐日補」或「批次補」。

UnsettledOrderDetailSheet / AdHocTransactionSheet / RefundSheet / LiveRevenueBarView / MissedCloseBannerView（皆已對抗式驗證）。

怎麼管理菜單

1. 上方切「單點 / 套餐 / 批量新增」。單點與套餐各自一個卡片格，依分類分段。
2. 搜尋即時過濾；分類膠囊（可左右滑）切分類；按「新增」開編輯畫面、按「批量管理」進多選（可批次設限量 / 刪除）。
3. 長按卡片可拖到分類膠囊 / 分類標題＝改分類。卡片長按選單可：標售完 / 恢復、設「剩 5/10/20 份」或不限量、回復預設份量、編輯。
4. 編輯品項：填品名、廚房簡稱、英文名、選分類（藍膠囊）與廚房站別（橘膠囊）、上傳照片、寫介紹、設售價與每日限量。食譜與成本唯讀（在 ChefsMate App 輸入），利潤率 ≥50% 綠、否則橘。
5. 編輯套餐：套餐內容是一串組件品項，每項可加減數量、標「可更換」（客人可換）；其餘欄位同單點。
6. 標售完前若該餐點今天有客人點過 → 跳「售完通知」讓你勾選寄信給受影響的客人（見下）。

POSMenuTabView / POSSingleItemsView / POSMenuItemCard / POSMenuItemEditSheet / POSComboEditSheet（已對抗式驗證）。

• 分類管理：分類列（icon 依名稱自動推斷 + 名 + N 項目 + 拖曳排序），「未分類」鎖定。沒有顏色/icon 自選。
• 客製選項設定：選項群組（辣度/加料…），各有必選（紅標）/多選（藍標）+ 選項內容預覽。
• 出餐規則：用群組排出餐順序，排越前越優先；「隨時出餐」群組（綠）不受順序限制。
• 當日供應品項：設今天哪些品項供應 + 每項/每類的份量上限（數量加減 + 眼睛可見度），可設類別限量。
• 批量新增：2 欄快速卡，逐張填名稱/售價/分類/區站/簡稱，一次「全部儲存」。
• 標售完 + 通知：標餐點售完前，列出今天會受影響的訂位讓你勾選寄信（已點此餐點＝必通知綠標、預估會點＝橘標）。客人收信可換餐/減量/取消（免取消費）。

POSMenuCategoryManagerView / POSMenuOptionsSheet / POSServingOrderSheet / POSDailyMenuSheet / POSBatchAddView / POSItemSoldOutCommunicationSheet（皆已對抗式驗證）。✅ 加購優惠（POSAddonDealsSheet）已補做。

怎麼處理訂位

1. 打開訂位＝看「待處理 Agenda」。系統把每位客人的訂位整理成卡片，並直接給判斷：可訂（綠）、需訂金（土黃）、需審核 / 不可接（紅）。
2. 桌位夠又無備註無訂金 → 按「直接確認」一鍵接單；需訂金 → 「核准訂位」並可「催繳訂金」；接不了 → 「婉拒」（可 AI 產生禮貌訊息或靜默封存）。
3. 想看整月忙閒 → 切「月曆」（熱區色 + 每天人數），長按某天可「暫停接訂位」。
4. 想排桌 → 切「日檢視時間軸」，把訂位方塊拖到別桌或別時段；手動釘的位子不會被新訂位動到，系統安排會自動重排。
5. 客人到店 → 報到 → 智慧安排入座（見下）。客人改人數 → 跳「核准修改」看會不會撞到別桌再決定。

ReservationAgendaView / POSReservationListView / POSReservationMonthCalendarView / ReservationDayTimelineView（已對抗式驗證）。

• 客人報到：QR 報到後檢視客人資訊 + 特殊需求 + 備註，按「智慧安排入座」或手動選座。
• 現場候位：散客現場登記人口組成（大人/小孩/長輩/孕婦/寵物），有位就入座、沒位就加候位。
• 智慧安排入座：演算法建議桌位（推薦標 + 入座鈕），有衝突會變橘並提示影響哪幾筆。
• 核准修改：客人改人數時，顯示同時段其他訂位 + 桌位安排，看會不會撞再「同意修改」或「拒絕」。
• LINE/FB 訊息匣：智慧客服收件匣 + 單一對話（會員資訊 + 新訂位待接單卡確認接單/調整 + 聊天泡泡 + 可編輯回覆模板）。AI 自動回覆旗標目前關閉。

POSCheckInSheet / POSWalkInSheet / SmartSeatingSheet / ReservationApprovalContextSheet / POSLineInboxView（皆已對抗式驗證）。喬喬看併桌 / 暫停接單 / 售完暫停 / 婉拒 / LINE 設定·範本 / 時序進度 見下方「訂位 · 邊緣 sub-sheet」一欄。

• 喬喬看併桌：人數多需要擠一擠時的桌位選擇（多選 + 容量徽章 剛好/+N/-N）→ 每桌人數分配（stepper）+ 客人將收到的通知預覽。
• 暫停接單：暫停線上訂位（今日/指定日期 + 暫停餐期多選 + 快速理由 chip）。已暫停會顯示膠囊並改「更新暫停設定」。
• 售完暫停 banner：餐點售完自動暫停接訂位的頂部橫幅 +「我已備新料」→ 補貨 sheet（設新份量、解除暫停）。
• 婉拒訂位：三出口 — AI 婉拒（自動產生禮貌訊息）/ 手動回覆（自編 + 送出並封存）/ 靜默封存（不發訊息）。
• LINE 設定 / 範本：回覆模板入口、接自己的 AI、記憶庫、問答庫、審核權限；8 情境模板可改＋還原預設。⚠️ AI 自動回覆旗標關閉，改用按鈕送可編輯模板。
• 時序進度：訂位生命週期時間軸（已完成綠 / 進行中藍 / 未來灰），嵌在訂位詳情捲動內。

POSSqueezeTableSelectionSheet / PauseBookingSheet / POSSelloutPauseBanner / ReservationAgendaView(declineSheet) / POSLineSettingsSheet / POSLineReplyTemplatesView / ReservationProgressTimeline。

• 戰情室：一眼看今天賺多少、來幾組客、客單價、翻桌率（含跟昨日比的趨勢箭頭）+ 折扣/營收警示 + 時段忙閒 + 熱賣/滯銷 + 員工小費次數。
• 營收趨勢：日別（近 7 日水平條，今日實心）/ 時段（heatmap + 圖例 + 午晚尖峰卡）/ 付款方式（各管道金額 + %）。
• 菜品表現：銷售排行（可依 營收/數量/利潤率 排序 + 排名圈 + 利潤率色）+ 類別營收佔比（進度條 7 色循環）。
• 營運日誌：訂單 / 作廢 / 付款 三分頁（帶數量 badge）+ 搜尋；付款分成功（綠 ✓）與退款（紅 ↩ + 末四碼）。
• 資料匯出：日期範圍 + 6 種資料類型多選 + CSV/Excel + 產生報表（N 項）+ 已產生檔案分享列。
• 資料健康檢查：15 種歷史 Model 的記錄狀態（正常綠 / 無資料橘 / 未實作紅）+ 今日/本月/總計 + 最後記錄。

ReportsDashboardView / RevenueTrendView / MenuPerformanceView / OperationLogView / DataExportView / DataHealthCheckView（+ 共用 ReportComponents）。